API documentation

Two access styles: REST for simple GETs, JSON-RPC 2.0 for tool calls.

REST

  • GET /api/mcp — Server info, methods, examples
  • GET /api/mcp/sites — List sites (category, q, page, pageSize, sortBy, lang)
  • GET /api/mcp/sites/:id — Site detail + relatedSites
  • GET /api/mcp/sites/:id/skills — Skills for one site
  • GET /api/mcp/rankings — Ranked list (limit, lang)
  • GET /api/mcp/categories — Categories with counts
  • GET /api/mcp/search?q= — Search sites and skills

JSON-RPC 2.0

POST /api/mcp with jsonrpc: "2.0", method, params, and id.

curl -X POST http://localhost:3000/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "list_sites",
    "params": { "category": "ai", "lang": "en" },
    "id": 1
  }'

MCP handshake

initialize, tools/list, and tools/call are available on the same POST endpoint. Streamable HTTP / SSE is not implemented in this version.