DRAFT: feat: add archi MCP server

[hassan11196]

Built-in MCP Server for Archi

Adds a Model Context Protocol (MCP) server directly into the archi chat service. Any MCP-compatible AI assistant — Claude Desktop, VS Code, Cursor, or Claude Code — can query your archi knowledge base without installing anything extra.

---

Archi config setup

Add the following to your archi config YAML (it's on by default):

services:
  mcp_server:
    enabled: true
    # Defaults to the chat app's hostname + external port
    url: "http://localhost:7869"
    timeout: 120  # seconds

The MCP endpoint will be available at <url>/mcp/sse once the chat service starts.

---

Client setup

Visit <archi-url>/mcp/auth after logging in — it shows ready-to-paste config snippets for each client and handles login automatically on first use.

VS Code — .vscode/mcp.json in your project root:

{
  "servers": {
    "archi": {
      "type": "sse",
      "url": "http://localhost:7869/mcp/sse"
    }
  }
}

Cursor — ~/.cursor/mcp.json:

{
  "mcpServers": {
    "archi": {
      "url": "http://localhost:7869/mcp/sse"
    }
  }
}

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "archi": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:7869/mcp/sse"]
    }
  }
}

Claude Code — one command:

claude mcp add --transport sse archi http://localhost:7869/mcp/sse

VS Code, Cursor, and Claude Desktop will open a browser to log in on first use. No token copy-paste needed.

---

Available tools

Tool	Description
archi_query	Ask a question via archi's active RAG pipeline
archi_list_documents	Browse the indexed knowledge base
archi_get_document_content	Read the full text of an indexed document
archi_get_deployment_info	Show active pipeline, model, and retrieval config
archi_list_agents	List available agent specs
archi_health	Verify the deployment is reachable