For Developers

Plug BrainTube into your stack

One MCP endpoint. Connect Claude, ChatGPT, Cursor or any MCP client to the knowledge base you've already compiled.

Get an API Key Connection guide
MCP Server
One endpoint, every MCP client. AI-agnostic by design — connect once and query your library from the tool you already work in.
Read and write tools
Over forty tools live today: semantic and multi-hop search, knowledge-graph traversal, corpus diagnostics, spaced resurfacing — and write-back, so an assistant can save, note, tag and import for you.
bt_ API keys
For clients that don't do OAuth. Created in Settings, hashed one-way, shown once, revocable any time.
Import what you already have
Kindle, Readwise, Obsidian, Pocket, browser bookmarks, Notion two-way, and YouTube channels — from the in-app Import Hub.
EU data residency
Your library is stored in EU regions, encrypted at rest.
Export anytime
Export your library from Settings whenever you want. No lock-in.

Connect in 30 seconds

Setup for every client — Claude.ai over OAuth, Cursor, Claude Desktop, CLI tools — lives on the connection guide, kept current in one place.

Open the connection guide AI-readable version

HTTP interface

Unversioned

Alongside MCP, the same backend speaks plain HTTP. MCP is the door for AI clients that discover tools at runtime; this is the door for code that already knows what it wants — our own web app, the Chrome extension and the chat widget all call it.

Base URL

https://mcp.brain-tube.com

Auth

Authorization: Bearer <token>

Eighteen operations across search, corpus stats, ingest, tagging, notes, bookmarks and Brains. The MCP endpoint exposes considerably more than the HTTP interface does — if a capability is missing here, check MCP first. Full schemas, parameters and auth details live in the spec.

View the OpenAPI spec →

Not versioned and not covered by a stability guarantee. It powers our own clients, so it changes when they need it to. Tell us if you are building on it and we will warn you before it moves.

Ready to build?

Free to start. No credit card required.

Start Building

Frequently asked

How do I connect BrainTube to Claude or ChatGPT?
For Claude.ai: add https://mcp.brain-tube.com/mcp as a custom connector and sign in with your BrainTube account — OAuth handles the rest, there's no key to paste. ChatGPT support is in testing. The step-by-step walkthrough for every client is on the connection guide.
What can an assistant actually do with my library?
Over forty tools are live, and the current list is always at https://brain-tube.com/connect.md — that page is generated from the server itself, so it never goes stale. Beyond search and retrieval, an assistant can traverse your knowledge graph, find the path between two saved items, run corpus health and gap checks, and resurface what you have not revisited. It can also write back: save, bulk save, note, tag, and import from Notion, Readwise or an Obsidian vault.
When do I need an API key?
Only for clients that don't do OAuth — Cursor, CLI tools, your own scripts. Create one in Settings → API Keys. It starts with bt_, it's shown once, and you send it as the X-BrainTube-Token header. We store a one-way hash, so if you lose it, revoke it and create a new one.
Is there a REST API or an SDK?
There is an HTTP interface at https://mcp.brain-tube.com, with a public OpenAPI spec at https://mcp.brain-tube.com/openapi.json. It is what BrainTube's own web app, extension and chat widget call, and it covers search, corpus stats, ingest, tagging, notes, bookmarks and Brains. It is not versioned yet and we do not guarantee stability, so treat it as available rather than supported — build on it and we may change it under you. There is no typed SDK; that remains on the roadmap without a date.
Are there rate limits?
We don't publish per-tier API limits today. Sustained automated traffic may be throttled — if you're building something heavy, tell us what it is and we'll flag anything that would hit a wall.
Where is my data stored, and can I get it out?
Your library is stored in EU regions, encrypted at rest. You can export it from Settings at any time.
Can I bring in a library from another tool?
Yes — the in-app Import Hub takes Kindle clippings, Readwise CSV exports, Obsidian and markdown files, Pocket and Instapaper exports, browser bookmarks, and YouTube channels, plus a two-way Notion connection.