Brightbean - Youtube intelligence MCP for AI agents
BrightBean - YouTube intelligence MCP server
Homepage: https://brightbean.xyz
Docs: https://brightbean.xyz/docs/mcp/
MCP endpoint: https://api.brightbean.xyz/mcp
Transport: Streamable HTTP
Auth: Bearer API key (bb_…) or OAuth 2.1 (Claude Desktop native connector)
Pricing: Free tier - 350 credits/month, no card required. Paid plans from $19/mo (Hobby) → $399/mo (Growth).
Hosting: Fully hosted by BrightBean, no install, no local dependencies.
BrightBean is a YouTube intelligence API exposed as an MCP server. It predicts click-through rate for title and thumbnail combinations, scores video hooks (the first ~6 seconds), surfaces ranked content gaps inside YouTube niches, and benchmarks channels and individual videos against their niche baselines. Calls draw from a shared credit balance the agent sees inline (credits_remaining is returned with every successful call) so agents can self-regulate spend.
Tools (6)
| Tool | Credits | What it does |
|---|---|---|
score_packaging | 1–3 | Score a YouTube title and/or thumbnail for predicted CTR. Mode auto-detected: title only = 1cr, thumbnail only = 2cr, combined = 3cr. |
score_video_hook | 10 | Analyze the first ~6 seconds of a YouTube video. Returns hook archetype + 5 dimension scores (clarity, specificity, tension, visual_energy, pace) + suggestions. |
research_content_gaps | 5 | Ranked content opportunities for a YouTube niche. Filter by gap_type (underserved / stale / competitive), min_score, limit. |
list_niches | 1 | List all catalogued YouTube niches with gap counts. Returned slugs are valid inputs to research_content_gaps. |
benchmark_channel | 5 | Benchmark a YouTube channel against its niche. Fetches the last 10 videos, returns engagement percentiles, title patterns, exemplar channels. |
benchmark_video | 3 | Benchmark a single YouTube video against its niche. Engagement percentiles + title-pattern fit. |
Credits are charged only on success (2xx responses). Failures cost nothing.
Connect in 60 seconds
Step 1 - Get an API key. Sign up at https://app.brightbean.xyz, open https://app.brightbean.xyz/dashboard/keys/, click Create key. The key starts with bb_ and is shown once.
Step 2 - Pick a client.
Claude Desktop / Claude Code (config file)
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
```json { "mcpServers": { "brightbean": { "command": "npx", "args": [ "mcp-remote", "https://api.brightbean.xyz/mcp", "--header", "Authorization:${BRIGHTBEAN_KEY}" ], "env": { "BRIGHTBEAN_KEY": "Bearer bb_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } } } } ```
Fully quit Claude Desktop (⌘Q) and reopen. The six BrightBean tools appear under the MCP tools control next to the message box.
The key goes in
env(not inline in--header) becausemcp-remotemis-parses a--headervalue containing a space.
Cursor
Edit ~/.cursor/mcp.json (or .cursor/mcp.json for project scope):
```json { "mcpServers": { "brightbean": { "url": "https://api.brightbean.xyz/mcp", "headers": { "Authorization": "Bearer bb_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } } } } ```
Save - Cursor connects and lists the tools.
Claude Desktop - Native custom connector (no config file)
If you'd rather sign in through a browser instead of pasting a key:
- Customize in the left sidebar → Add custom connector.
- Name:
BrightBean. Server URL:https://api.brightbean.xyz/mcp. Click Add. - A BrightBean sign-in window opens - log in / sign up → approve access. Tool calls draw credits from the account you signed in with.
Generic MCP client (LangChain, agent runtimes, custom)
- Endpoint:
https://api.brightbean.xyz/mcp - Headers:
Authorization: Bearer bb_… - Transport: Streamable HTTP
Verifying
Ask your client:
Use the brightbean tools to score the title "I bought a $0.99 keyboard so you don't have to" with thumbnail https://i.ytimg.com/vi/EXAMPLE/hqdefault.jpg in the tech-reviews niche.
A working setup returns a score envelope with score_id and credits_remaining populated.
Tags
youtube, analytics, ctr, thumbnails, video, creator-tools, content-research, benchmarks, remote, hosted, oauth
Category
Analytics
Notes for the reviewer
- BrightBean is a hosted remote MCP there is no install command and no public source repository at this time. The endpoint above is the canonical surface.
- CORS is intentionally disabled on
/mcp; MCP clients are expected to be server-side processes or local desktop apps. - Full tool reference: https://brightbean.xyz/docs/mcp/
Server Config
{
"mcpServers": {
"brightbean": {
"command": "npx",
"args": [
"mcp-remote",
"https://api.brightbean.xyz/mcp",
"--header",
"Authorization:${BRIGHTBEAN_KEY}"
],
"env": {
"BRIGHTBEAN_KEY": "Bearer bb_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}Recommend Servers
View Allsummarize chat message