Skip to main content

Model Context Protocol (MCP) Overview

🎯Architecture Clarification

Archon's MCP implementation follows a clear separation of concerns:

  • The Server service contains ALL business logic, ML models, and data operations
  • The MCP service is a lightweight HTTP-based wrapper that exposes Server functionality as MCP tools
  • MCP communicates with Server exclusively via HTTP APIs - maintaining true microservices separation

What is MCP?​

The Model Context Protocol (MCP) is an open standard that enables AI applications to securely access external data sources and tools. Archon implements both sides of MCP:

  • MCP Server: Exposes 14 tools following action-based patterns for knowledge management and task organization
  • MCP Client: Universal SSE-based client for connecting to any MCP server using Streamable HTTP transport

MCP Server

Archon as an MCP Server - Expose your knowledge base to AI clients

  • 14 comprehensive tools using flexible action-based patterns
  • Real-time Logfire monitoring of all tool calls
  • Compatible with Cursor, Windsurf, Claude Desktop
  • SSE transport for all clients (stdio via docker exec)

MCP Server Documentation

MCP Client

Universal MCP Client - Connect to any SSE-based MCP server from Archon's UI

  • Connect to any MCP server using Streamable HTTP (SSE) transport
  • Interactive tool testing with real-time results
  • Socket.IO real-time updates for collaborative workflows
  • Simple configuration - just provide the SSE endpoint URL

MCP Client Documentation

Archon MCP Architecture​

Quick Start Guide​

Connect your AI client to Archon's knowledge base:

  1. Start Archon (Docker or local)
  2. Configure your AI client (Cursor, Windsurf, etc.)
  3. Begin using 14 comprehensive tools

For Cursor:

MCP Settings
{
  "mcpServers": {
    "archon": {
      "uri": "http://localhost:8051/sse"
    }
  }
}

For Claude Code:

claude mcp add --transport sse archon http://localhost:8051/sse

For Windsurf:

{
  "mcp.servers": {
    "archon": {
      "uri": "http://localhost:8051/sse"
    }
  }
}

Available capabilities:

  • RAG queries across your crawled knowledge
  • Create and manage tasks/projects
  • Search code examples with AI summaries
  • Document management with versioning

📊 Tool Distribution​

📊Complete Tool Overview

Archon provides 14 comprehensive MCP tools following modern patterns:

CategoryToolsDescriptionKey Features
🧠 RAG & Knowledge Management7 toolsSearch, crawl, and manage knowledgeRAG queries, web crawling, document upload, code search, source management
📊 Project & Task Management5 toolsComplete project lifecycle managementConsolidated action-based patterns for projects, tasks, documents, and versions
🏥 System Health2 toolsHealth monitoring and diagnosticsComprehensive system status and session management

Tool Categories Deep Dive​

🧠 RAG & Knowledge Tools (7)

  • perform_rag_query - Semantic search
  • search_code_examples - Code-specific search
  • crawl_single_page - Web page indexing
  • smart_crawl_url - Intelligent crawling
  • upload_document - Document processing
  • get_available_sources - Source management
  • delete_source - Source cleanup

📊 Project Tools (5)

  • manage_project - Create, list, get, delete projects
  • manage_task - Create, list, get, update, delete, archive tasks
  • manage_document - Add, list, get, update, delete documents
  • manage_versions - Create, list, get, restore versions
  • get_project_features - Retrieve project features

🏥 System & Monitoring (2)

  • health_check - System health diagnostics
  • session_info - Session management info
  • Real-time Logfire tracing for all tools
  • Performance metrics and timing
  • Client identification (Cursor, Windsurf, etc.)
  • Error tracking and debugging

🔥 Why Choose Archon's MCP Implementation?​

🏆 Industry-Leading Features​

⚡ Performance & Reliability

  • 🚀 Sub-second response times for most queries
  • 🔄 Automatic reconnection and error recovery
  • 📊 Comprehensive monitoring with Logfire
  • 🏥 Health checks and system diagnostics
  • ⚖️ Load balancing for high-volume usage

🛡️ Security & Scalability

  • 🔐 Encrypted credential storage in Supabase
  • 🌐 Multi-transport support (stdio, SSE)
  • 🔄 Real-time synchronization across clients
  • 📈 Horizontal scaling ready
  • 🎯 Rate limiting and abuse protection

🔧 Developer Experience​

🔥Built for Developers, by Developers

Archon's MCP implementation prioritizes developer experience with comprehensive tooling, detailed documentation, and real-time debugging capabilities.

  • 📝 Extensive Documentation: Every tool documented with examples
  • 🧪 Interactive Testing: Test tools directly in the UI
  • 🔍 Real-time Debugging: Logfire traces for every operation
  • ⚡ Hot Reloading: Development-friendly configuration
  • 🌐 Universal Compatibility: Works with any MCP client

📚 Documentation Structure​

📖 Detailed Guides​

DocumentPurposeAudience
🛠️ MCP Server GuideComplete server setup, configuration, and troubleshootingDevelopers using Archon as an MCP server
🔌 MCP Client GuideUniversal client usage, server connections, and testingDevelopers connecting to MCP servers

🎯 Quick Navigation​

🚀 Getting Started

🔧 Troubleshooting

📊 Advanced Usage

🎉 Ready to Get Started?​

Choose your path based on how you want to use Archon's MCP capabilities:

You want to connect external AI clients (Cursor, Windsurf, etc.) to Archon's knowledge base

👉 Start with MCP Server Documentation

🔥 Ready to experience the most powerful MCP implementation available?

Join thousands of developers already using Archon's MCP tools to supercharge their AI workflows!