BrainAPI Docs MCP

This is the documentation MCP — search and fetch public docs as markdown. It is separate from the product MCP that exposes BrainAPI graph tools on your API host (typically :8001).

Endpoint: https://brain-api.dev/mcp
Discovery: https://brain-api.dev/.well-known/mcp.json
Machine index: /docs/llms.txt · append .md to any docs URL for markdown

Tools

Cursor

Add to .cursor/mcp.json (or Cursor Settings → MCP):

{
  "mcpServers": {
    "brainapi-docs": {
      "url": "https://brainapi.lumen-labs.ai/docs/mcp"
    }
  }
}

Claude Desktop / Claude Code

If your client supports streamable HTTP MCP natively, point it at the same URL. Otherwise use a stdio→HTTP adapter:

{
  "mcpServers": {
    "brainapi-docs": {
      "command": "npx",
      "args": ["-y", "@pyroprompts/mcp-stdio-to-streamable-http-adapter"],
      "env": {
        "URI": "https://brainapi.lumen-labs.ai/docs/mcp",
        "MCP_NAME": "brainapi-docs"
      }
    }
  }
}

No BrainPAT is required — this server only serves public documentation.

Agent workflow

1. Prefer V2 (search_docs with tag: "v2", or start from /docs/llms/v2.txt).
2. get_page with a path like /v2/ingestion/tasks.
3. For API calls: expect ingest 202 + task_id; poll GET /tasks/{id}; 404 means unknown task, not pending.
4. Optional skill summary: /docs/skill.md

Related

• Product MCP — tools against a live BrainAPI instance
• llms.txt — short TOC for agents
• Ingestion tasks — async poll contract