MCP Overview

The Model Context Protocol (MCP) lets AI agents access your RAG system as standard tools. GuidedMind implements MCP over SSE (Server-Sent Events) transport.

Architecture

Connection Endpoints

Connecting

Step 1: Open SSE Connection

curl -N "https://api.guidedmind.ai/api/v1/mcp/sse?api_key=rk_your_key_here"

Response:

event: open
data: {"session_id": "uuid-here", "message_endpoint": "/api/v1/mcp/messages?session_id=uuid-here"}

Step 2: Send JSON-RPC Messages

curl -X POST "https://api.guidedmind.ai/api/v1/mcp/messages?session_id=YOUR_SESSION_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

JSON-RPC Format

All messages follow JSON-RPC 2.0:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "rag_search",
    "arguments": {
      "query": "What is RAG?"
    }
  }
}

Available Tools

See MCP Per Tool for detailed parameter documentation.

Authentication

Pass your API key as a query parameter on the SSE connection:

/api/v1/mcp/sse?api_key=rk_your_key_here

The session ID from the open event is then used for all subsequent message requests.

Error Handling

Errors are returned as JSON-RPC error responses:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "Method not found"
  }
}

Valid Methods