Claude & MCP

A hosted MCP server already exists. You do not build one. Connect it once and Claude can read the wallet, pick a project, generate posts, and publish them.

01Install

Mint a key with write at Developer settings. Always the www host.

Terminal

claude mcp add --transport http brainpercent \
  https://www.brainpercent.app/api/mcp \
  --header "Authorization: Bearer bp_your_key"

02Tools

Tool	Spends	What it does
check_credits	0	Wallet, plan, used this period
list_projects	0	Projects the key owns
demo_post_from_url	0	Anonymous sample. Does not land in the account.
generate_posts	0.6 / platform	URL to branded posts. Returns a content_id.
get_content	0	Poll that content_id
publish	0	Publish or schedule connected channels

03Generate, then poll

generate_posts is async. Ask Claude to call get_content until the row is ready. Captions sit on platforms as an object. Images sit on image_urls.

04Publish

Channels are connected in the app, not over MCP. publish can take scheduled_at as a full ISO timestamp.