@ceobrain/mcp

CEO Brain MCP server for Claude Desktop and any Model Context Protocol client.

Exposes the CEO Brain API as MCP tools so Claude Desktop users can use CEO Brain natively in chat — no shell access required. Same auth as the CLI; tokens shared at ~/.config/ceobrain/credentials, so signing in once on either surface authenticates both.

Install

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ceo-brain": {
      "command": "npx",
      "args": ["-y", "@ceobrain/mcp"]
    }
  }
}

Restart Claude Desktop. CEO Brain tools should appear in the tool list.

First-time login

Ask Claude in chat: "Help me sign in to CEO Brain."

The agent will:

1. Call ceo_login_start and present you with a verify URL
2. You open the URL in your browser, sign in via LinkedIn (Clerk-hosted at clerk.ceobrain.org)
3. Agent calls ceo_login_poll until your session is confirmed
4. Agent calls ceo_terms_summary and reads the ~150-word plain-English Terms summary to you in chat
5. After you confirm, agent calls ceo_verify (passes your LinkedIn URL when you have it) — verification runs synchronously, ~30-60 seconds, returns one of verified / evidence_requested / rejected

After that, every CEO Brain tool just works.

Tools

| Tool | What | |---|---| | ceo_login_start | Begin device-code OAuth. Returns verify URL. | | ceo_login_poll | Poll until user confirms in browser. | | ceo_terms_summary | Fetch ToS + Privacy summary (~150 words). Read VERBATIM to user before they accept membership. | | ceo_verify | AI-driven CEO/CTO verification (Claude agent + web_search). Synchronous, ~30-60s. Pass linkedin_url when you have it. | | ceo_verify_status | Poll claim status: verifying / verified / evidence_requested / rejected / no_claim. | | ceo_status | Credit state + countdown + next_action. Read this first each session. | | ceo_questions_menu | Top 3-5 question menu sorted by expertise + funnel-fill. | | ceo_answer_submit | Submit user's chosen answer; renews 7-day pack-pull credit. | | ceo_pull_pack | Get latest pack (gated by credit). 200 with files when active; 402 with menu when expired; 410 if retracted. | | ceo_account_delete | Permanently delete membership (anonymize-in-place). REQUIRES confirm: true. |

Daily flow

You:     "what's open on CEO Brain?"
Claude:  [calls ceo_status, then ceo_questions_menu, presents 3-5 options]

You:     "I'll take the hiring one."
Claude:  [helps you draft an answer; calls ceo_answer_submit]
         "Submitted. Pack credit renewed for 7 days."

You:     "pull the latest pack into context"
Claude:  [calls ceo_pull_pack, adds files to active context]

Auth interop with the CLI

Run ceo login from the terminal once (or use ceo_login_start/_poll from chat) — the resulting token at ~/.config/ceobrain/credentials is read by both the CLI and this MCP server. No need to log in twice.

The CLI's distribution is via curl -sSL install.ceobrain.org | sh (single-binary download from GitHub Releases — no Node or npm required for the CLI itself). MCP genuinely is npm-native because Claude Desktop's MCP install pattern is npx -y @ceobrain/mcp.

License

UNLICENSED. v1 internal use only.

Links

• Web: https://ceobrain.org
• CLI: curl -sSL install.ceobrain.org | sh
• Issues: https://github.com/oliverpople/ceobrain-releases/issues