Breakreach
LoginRegister
Claude Code · MCP server

Post to social media from Claude Code.One command, fifteen networks.

Add Breakreach's hosted MCP server with one command, sign in with /mcp, and Claude Code can publish and schedule on Instagram, TikTok, LinkedIn, X, YouTube and 10 more networks, answer comments and DMs, and read your numbers. It writes the post from your repo (the changelog, the blog post, the release notes) and schedules it in the same session.

Get started freeSetup guide
Terminal
claude mcp add --transport http \  breakreach https://api.breakreach.com/mcp

Then run /mcp in Claude Code and sign in to Breakreach.

Checked against Claude Code's docs on October 7, 2026. Breakreach is our product.

~/northbeam-shop · claude
>Read CHANGELOG.md and announce coffee subscriptions on X, LinkedIn and Threads tomorrow at 9 AM, with the page's image
⏺Read(CHANGELOG.md)
⎿Reading…
⏺breakreach - list_accounts (MCP)
⎿Running…
⏺breakreach - create_post (MCP)(scheduledAt: "2026-10-08T09:00:00")
⎿Running…
⏺
Scheduled · Thu, 9:00 AM
northbeam· now

Coffee subscriptions are live. Morning Light every month, any bag size, skip a month whenever you like. northbeam.coffee/subscribe

29 tools
Publish, schedule, comments, DMs, analytics and accounts.
15 networks
Instagram, TikTok, LinkedIn, X, YouTube, Facebook, Threads and 8 more.
Hosted
One URL, nothing to install. Scheduled posts go out with the session closed.

Add Breakreach to Claude CodeSign in with OAuth, or pass an API key.

Sign in with OAuth

Recommended

Nothing to copy but the command. Claude Code registers itself with Breakreach, opens your browser to sign in, and keeps the token fresh.

  1. 1
    Add the server

    This adds it to the current project (the local scope). Add --scope user to have it in every project, or --scope project to write it to .mcp.json for your team, where each person signs in with their own account.

    Terminal
    claude mcp add --transport http breakreach https://api.breakreach.com/mcp
  2. 2
    Sign in

    Start Claude Code and run /mcp. Pick breakreach, choose Authenticate, and allow access in the browser tab that opens. Access tokens last 30 days and refresh on their own.

  3. 3
    Connect your social accounts

    Connect Instagram, TikTok, LinkedIn and the rest once in Breakreach (Settings, Accounts). Or ask the agent for a link: create_connect_link returns a page where you, or a client, connect accounts without a Breakreach login.

Use an API key

For claude -p in CI, a server, or a machine where nobody can click through a browser sign-in.

  1. 1
    Create an API key

    In Breakreach, open Settings, API & MCP and create a key. It starts with br_ and reaches every workspace you're a member of. Keep it out of files you commit.

  2. 2
    Add the server with the header

    Your shell fills in the key when you run the command, and Claude Code saves it in ~/.claude.json, outside the repo.

    Terminal
    claude mcp add --transport http breakreach https://api.breakreach.com/mcp \  --header "Authorization: Bearer $BREAKREACH_API_KEY"
  3. 3
    Or share it in .mcp.json

    Claude Code expands ${BREAKREACH_API_KEY} from each person's environment, so this file can be committed without the key in it.

    .mcp.json
    {  "mcpServers": {    "breakreach": {      "type": "http",      "url": "https://api.breakreach.com/mcp",      "headers": {        "Authorization": "Bearer ${BREAKREACH_API_KEY}"      }    }  }}

Check it works. claude mcp list should show breakreach as connected, and /mcp in a session lists its 29 tools.

What to ask Claude CodeRequests that work today, and the tools they call.

  • Read CHANGELOG.md and announce the new release on X and LinkedIn tomorrow at 9 AMcreate_post
  • Post https://northbeam.coffee/img/launch.jpg to Instagram, TikTok and LinkedIn tomorrow at 9 AM with a short caption about Morning Lightupload_media, create_post
  • Reply to my latest Instagram comments. Show me each reply before you send itlist_recent_comments, reply_to_comment
  • How did last week's posts do? Write a short summary to reports/week-40.mdget_content_performance
  • Create a workspace for Acme Bakery and give me a link to connect their Instagram and TikTokcreate_workspace, create_connect_link

What Claude Code can do with BreakreachThe same tools in every client.

Publish

  • create_postPublish now, schedule, take the next free slot or save a draft, on one or many accounts
  • update_postEdit, reschedule, approve a draft or retry a failed post
  • delete_postUnschedule and remove a post from Breakreach
  • list_postsPosts with status, time and numbers
  • upload_mediaCopy a public image or video URL to Breakreach storage
  • get_next_slotThe next free slot of the posting schedule
  • list_pinterest_boardsBoards a pin can go to

Accounts

  • list_workspacesWorkspaces, one per brand or client
  • create_workspaceA new workspace for a new brand or client
  • list_accountsConnected accounts, with a warning before one expires
  • create_connect_linkA link where you or a client connect accounts, no Breakreach login needed
  • get_account_statsFollowers and 28-day numbers per account
  • get_account_trendsDay by day reach and views

Analytics

  • get_content_performanceEvery post's numbers over N days, sorted the way you ask
  • get_post_insightsEverything about one post, against the account average
  • get_post_metricsOne Breakreach post's views, likes, comments and shares
  • get_analyticsTotals and top posts made with Breakreach

Comments and DMs

  • list_recent_commentsNew comments across Instagram, Facebook, Threads and X
  • get_post_commentsThe comments on one post
  • reply_to_commentAnswer as the account
  • hide_commentHide or unhide (Instagram, Facebook, Threads)
  • delete_commentDelete for good (Instagram, Facebook)
  • list_conversationsDMs on Instagram, Facebook Messenger and X
  • get_conversation_messagesRead one conversation
  • send_messageReply to a DM as the account

Comment to DM

  • list_comment_dm_rulesInstagram keyword rules, their stats and latest DMs
  • create_comment_dm_ruleDM everyone who comments a keyword on a post or reel
  • update_comment_dm_ruleNew keywords or message, or pause the rule
  • delete_comment_dm_ruleRemove a rule and its activity

Why post from Claude Code?The source of the post is already in your repo.

A launch post is a summary of something that already exists as text: the changelog entry, the release notes, the blog post in content/, the pricing page. Claude Code reads it, writes the post for each network, and schedules it without you copying anything into a scheduler. The facts stay right because they come from the file that shipped.

  • Release notes to launch posts“Announce v2.4 from CHANGELOG.md on X and LinkedIn, tomorrow 9 AM.” One request, a post per network.
  • A blog post to a week of posts“Turn content/blog/morning-light.mdx into three posts and put them in my next free slots.” Each lands in your posting schedule.
  • Numbers into a file“How did September go? Write it to reports/september.md.” The analytics tools return the data, Claude Code writes the report.
  • Comments while a build runs“Any questions in today's comments? Draft answers, I'll approve them.”

Will Claude Code post without asking?Not unless you let it.

Claude Code asks before it calls an MCP tool, and shows the arguments: the text, the accounts, the time. You approve once, or allow a tool for the rest of the project. A sensible split is to allow the reading tools (list_accounts, list_posts, get_content_performance) and keep create_post, reply_to_comment and send_message on ask.

For a second pair of eyes, ask for a draft: “save it as a draft” sends draft: true, and the post waits in Breakreach until someone schedules it there. Breakreach also never deletes a post from the network itself: delete_post removes it from Breakreach only.

Can I run it in CI with claude -p?Yes, with an API key and the tools allowed up front.

In print mode there is nobody to approve a tool call, so list the tools Claude Code may use. MCP tools are named mcp__breakreach__<tool>, and mcp__breakreach alone allows every tool of the server. Load the server from a file with --mcp-config so the job doesn't depend on a local setup, and pass the key as a secret.

.github/workflows/announce.yml (step)
claude -p "Announce the release in CHANGELOG.md on X and LinkedIn, now" \  --mcp-config .claude/breakreach.json \  --allowedTools "Read,mcp__breakreach__list_accounts,mcp__breakreach__create_post"

.claude/breakreach.json holds the same mcpServers object as the .mcp.json above, with ${BREAKREACH_API_KEY} read from the job's secrets. Scheduled posts publish from Breakreach's servers, so the job can end as soon as the call returns.

Can Claude Code post an image from my repo?Through a public URL.

The MCP server takes media as public URLs, not files from your disk. Point Claude Code at a URL that already works: the image on your deployed site, a CDN, a bucket. upload_media copies it to Breakreach's storage, so a scheduled post still finds it after a deploy or an expiring signed link. Uploading a local file through the server isn't supported yet.

Instagram, TikTok, YouTube and Pinterest need a photo or a video; X, LinkedIn, Threads, Facebook, Bluesky, Reddit, Telegram, Discord, Slack, Mastodon and WordPress also take text alone. The posting API page lists what each network takes.

What does it cost?

Creating a Breakreach account and connecting your first social account is free. Scheduling and publishing need a plan, from $29 a month ($23 billed yearly) for 5 accounts, or the Developer plan at $5 per connected account. Signed in with OAuth before you subscribe, the reading tools work and the publishing ones answer with a link to the plans. An API key needs an active plan or trial, and answers 402 otherwise. Claude Code's own plan is separate.

Troubleshooting Breakreach in Claude Code

  • /mcp shows breakreach as failed or needing authenticationPick it in /mcp and authenticate again. If it keeps failing, claude mcp remove breakreach and add it again.
  • 401 Invalid API keyThe key was deleted or mistyped. claude mcp get breakreach shows what Claude Code sends.
  • 402: API access requires an active subscriptionAPI keys need a plan or a trial. Sign in with OAuth instead to try the reading tools first.
  • “No social accounts connected yet”Connect them in Breakreach, or ask Claude Code for a connect link, then ask again.
  • “Media is required for: instagram”Instagram, TikTok, YouTube and Pinterest need a photo or video URL in the request.

The same server in other agents

CursorOne entry in mcp.json, then Connect.CodexOne command, then sign in.OpenClawPost and answer comments from your chat app.HermesOne command, OAuth or an API key.GrokGrok Build, the xAI API, or Grok Bot.ChatGPTThe plugin in ChatGPT.ClaudeThe connector in Claude's app.Any MCP clientThe URL and both ways to sign in.
FAQ

Questions, answered.

Short answers about Breakreach in Claude Code.

Yes. Breakreach is a hosted MCP server at https://api.breakreach.com/mcp. Add it with claude mcp add --transport http, sign in with /mcp, and Claude Code gets 29 tools to post, schedule, answer comments and DMs and read analytics on 15 networks.

No. Claude Code signs in with OAuth through /mcp. An API key is for print mode in CI, or a machine where nobody can sign in through a browser.

Yes. Add it with --scope project to write .mcp.json, commit it, and each person signs in with their own Breakreach account, or sets their own BREAKREACH_API_KEY.

Instagram, TikTok, X, LinkedIn, YouTube, Facebook, Threads, Pinterest, Bluesky, Reddit, Telegram, Discord, Slack, Mastodon and WordPress. Instagram, TikTok, YouTube and Pinterest need a photo or video.

Yes, the same server and the same tools as the Breakreach connector in Claude's directory, so posts, accounts and settings are shared.

Creating an account and connecting your first social account is free. Scheduling and publishing need a plan, from $29 a month for 5 accounts, or the Developer plan at $5 per connected account.

Keep reading

Breakreach in CursorOne entry in mcp.json.Breakreach in CodexOne table in config.toml.Breakreach in OpenClawPost from WhatsApp or Telegram.Posting APIThe same publishing, over REST.Post to LinkedIn from ClaudeThe connector in Claude's app.Best MCP servers for social mediaSeven servers compared.
Instagram
TikTok
LinkedIn
YouTube
X
Facebook
Threads

Give Claude Code your social accounts.Set up in two minutes.

Get started

Your first account is free to connect. Plans from $29 a month.