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)

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) because mcp-remote mis-parses a --header value 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:

1. Customize in the left sidebar → Add custom connector.
2. Name: BrightBean. Server URL: https://api.brightbean.xyz/mcp. Click Add.
3. 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/