How do I save my first item?

Paste any YouTube URL, article, or PDF into the capture bar. BrainTube extracts the transcript, generates a summary, and indexes everything within a minute.

How do I connect BrainTube to Claude or Cursor?

Open /connect in the app to get your MCP URL and API key, then paste it into Claude Desktop's config or Cursor's MCP settings. Your library becomes a tool the AI can call.

A Brain is a focused group of items you can chat with. Dashboard → Brains → New, pick items, give it a name. You can keep it private or share it publicly via a slug.

How does billing work?

Plans run monthly or annually with a 7-day trial. BrainTokens cover AI usage on top of your plan. Refunds within 14 days, no questions asked.

Where is my data stored?

EU-region infrastructure. You own your data, you can export it as JSON anytime, and account deletion purges backups within 30 days.

REST API Quickstart — Help

Get started with BrainTube's REST API — authentication, endpoints, and first call.

Access your BrainTube corpus programmatically via the REST API.

Authentication

Generate an API key from Settings → API Keys. Include it in requests:

Authorization: Bearer bt_sk_your_api_key_here

Example: Search Your Corpus

POST to the brain-api endpoint with your query and authorization header.

Available Endpoints

Endpoint	Method	Description
/brain-api	POST	Main API — search, list, manage
/brain-chat	POST	Chat with a specific brain
/graph-enhanced-search	POST	Advanced semantic + graph search

Response Format

All responses return JSON with success, data, and meta fields.

Error Handling

Status	Meaning
200	Success
401	Invalid or missing API key
403	Insufficient permissions
429	Rate limit exceeded
500	Server error