Connect BrainTube to Any AI

Your knowledge base becomes a universal MCP server. Set up in 60 seconds.

Works with: Claude · Cursor · Windsurf · ChatGPT · Obsidian

What is MCP?

Model Context Protocol (MCP) is a standard that lets AI tools connect to external data sources. Think of it as USB-C for AI — one protocol, every tool.

When you connect BrainTube via MCP, your AI can search your saved content, chat with your brains, and retrieve knowledge — all from within the AI tool you're already using.

BrainTube → MCP Server → Claude / Cursor / Windsurf / ChatGPT / Obsidian

Setup Guides

Claude Desktop

1. Open Claude Desktop settings — Go to Settings → Developer → Edit Config.

2. Add BrainTube to your MCP config — add this to claude_desktop_config.json:

   {
     "mcpServers": {
       "braintube": {
         "url": "https://braintube-mcp-production.up.railway.app/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_API_KEY"
         }
       }
     }
   }
   

3. Replace YOUR_API_KEY — generate an API key at brain-tube.com/settings → API Keys.

4. Restart Claude Desktop — close and reopen to load the new MCP server.

5. Try it! — ask Claude: "Search my BrainTube brains for information about transformers".

Cursor

1. Open Cursor settings — go to Settings → MCP Servers → Add Server.

2. Add BrainTube MCP config:

   {
     "braintube": {
       "url": "https://braintube-mcp-production.up.railway.app/mcp",
       "headers": {
         "Authorization": "Bearer YOUR_API_KEY"
       }
     }
   }
   

3. Replace YOUR_API_KEY — generate at brain-tube.com/settings → API Keys.

4. Use in any chat — ask: "What do my BrainTube brains say about [topic]?".

Windsurf

1. Open Windsurf MCP settings — navigate to the MCP server configuration panel.

2. Add server config:

   {
     "braintube": {
       "url": "https://braintube-mcp-production.up.railway.app/mcp",
       "headers": {
         "Authorization": "Bearer YOUR_API_KEY"
       }
     }
   }
   

3. Replace YOUR_API_KEY and restart — generate at brain-tube.com/settings → API Keys, then restart Windsurf.

ChatGPT (API)

ChatGPT doesn't natively support MCP yet, but you can use BrainTube's REST API directly.

1. Generate an API key at brain-tube.com/settings → API Keys.

2. Use the search endpoint:

   curl -X POST https://braintube-mcp-production.up.railway.app/api/v1/search \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"query": "your question", "limit": 5}'
   

3. Feed results into your prompt — pass the search results as context in your ChatGPT conversation. See the full API docs for all endpoints.

Obsidian

1. Install the BrainTube plugin — go to Community Plugins → Search "BrainTube" → Install.
2. Configure — navigate to Settings → BrainTube and enter your API key.
3. Sync — your BrainTube items sync to your vault as Markdown files — one folder per brain, frontmatter with metadata.

Available MCP Tools

Tool	Description
search	Semantic search across all brains
smart_resurface	Get items due for spaced repetition review
get_knowledge_graph	Retrieve knowledge graph connections
brain_chat	Chat with a specific brain
list_brains	List all user brains with stats
get_item	Get full item details with enrichment data

Endpoint & Authentication

• MCP endpoint: https://braintube-mcp-production.up.railway.app/mcp
• REST API base: https://braintube-mcp-production.up.railway.app/api/v1
• Auth: Authorization: Bearer YOUR_API_KEY header on every request.
• Get a key: sign in at brain-tube.com and visit Settings → API Keys.

Don't have an account yet? Sign up free — setup takes 60 seconds.