# Atractio Agent MCP Hub — Full Guide

## Overview

agent.atractio.lol is a self-documenting MCP (Model Context Protocol) hub that provides
a suite of AI agent tools behind a single authenticated domain. Any MCP-compatible
client (Claude Desktop, Cursor, Oh My Pi, Codex, OpenCode, Hermes, etc.) can connect
and use these tools.

## Base URL

https://agent.atractio.lol

## Authentication

All /mcp/* endpoints require a Bearer token:

  Authorization: Bearer $AGENT_MCP_TOKEN

Public documentation endpoints (/, /llms.txt, /mcp.json, /config/*) do NOT require auth.

## Available MCP Servers

### /mcp/about — Hub Documentation (auth required)
An MCP server that explains the hub itself. Tools:
  - list_servers(): List all available MCP servers
  - get_server(server_id): Get details for one server
  - get_all_client_configs(): Get config URLs for common clients
  - get_universal_mcp_config(): Get a ready-to-use mcpServers JSON
  - get_usage_examples(): Get example prompts for agents
  - get_security_notes(): Get security best practices

### /mcp/memory — Mnemosyne (auth required)
Shared long-term memory for agents. Store and recall facts, preferences,
project context across sessions. Tools include remember, recall, forget,
graph queries, scratchpad, sync, and more.

### /mcp/search — SearXNG (auth required)
Privacy-focused web search through a self-hosted SearXNG instance.
  - search_web(query): Search the web

### /mcp/docs — Context7 / Docs RAG (auth required)
Fresh documentation lookup for libraries and frameworks.
  - resolve-library-id(library_name): Find a library ID
  - query-docs(library_id, topic): Query documentation

### /mcp/code — Serena (auth required)
Semantic code navigation and editing. 29 tools including symbol search,
references, diagnostics, renaming, file operations. Uses LSP backends.

### /mcp/repo — Repomix (auth required)
Repository packing for LLM context. Pack entire repos into a single
optimized file for analysis. 8 tools available.

### /mcp/git — Forgejo (auth required)
Forgejo git platform integration. List repos, get/create issues,
get pull requests, read file contents. 5 tools available.

## Quick Start

1. Set your token:
   export AGENT_MCP_TOKEN="your-token-here"

2. Point your MCP client to any endpoint, e.g.:
   https://agent.atractio.lol/mcp/about

3. For SSE-based clients (Oh My Pi, etc.), use the /sse suffix:
   https://agent.atractio.lol/mcp/memory/sse

## Client Configurations

Ready-made configs are available at:
- /config/universal-mcp.json — Universal mcpServers format
- /config/hermes.yaml — Hermes Agent YAML format
- /config/oh-my-pi.mcp.json — Oh My Pi MCP config
- /config/codex.toml — Codex TOML format
- /config/opencode.json — OpenCode JSON format
- /config/cursor.mcp.json — Cursor MCP config
- /config/claude-desktop.json — Claude Desktop config
- /config/README.md — Setup instructions for all clients

## SSE vs Streamable HTTP

This hub supports SSE (Server-Sent Events) transport:
  - SSE endpoint: /mcp/{service}/sse
  - Message endpoint: /mcp/{service}/message?sessionId={id}

For clients that need streamable-http or local stdio, use a local bridge proxy.

## Security Notes

- All /mcp/* endpoints require Bearer authentication
- Public docs never include real tokens
- Browser, code, memory, and git tools are never exposed without auth
- Use separate tokens per client if possible
- Rotate AGENT_MCP_TOKEN if it is leaked
- Prefer read-only access for git/repo tools unless write is explicitly needed