Breakreach
LoginRegister
Grok · MCP server

Post to social media from Grok.From the terminal or the xAI API.

Grok reaches Breakreach's MCP server two ways we've checked: Grok Build, xAI's coding agent, with grok mcp add, and the xAI API's remote MCP tool with your API key. Grok can then post and schedule on X, Instagram, TikTok, LinkedIn, YouTube and 10 more networks, answer comments and DMs, and read your numbers. Grok Bot and grok.com take the same URL as a custom connector.

Get started freeSetup guide
Terminal (Grok Build)
grok mcp add --transport http \  breakreach https://api.breakreach.com/mcp

Then run /mcps in Grok Build and sign in to Breakreach. Using the xAI API instead? See the request below.

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

~/northbeam-site · grok
>How did yesterday's X post do? Then post the Morning Light launch on X and Threads now
•Called breakreach.get_content_performance({"platform":"x","days":2})
└Running…
•Called breakreach.create_post({"publishNow":true})
└Running…
•
Published · just now
northbeam· now

Morning Light is out. Honey, orange and cocoa, roasted this week. northbeam.coffee/morning-light

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 GrokGrok Build, the xAI API, or a custom connector.

In Grok Build

Recommended

Grok Build is xAI's open-source coding agent for the terminal. It signs in with OAuth, or sends an API key.

  1. 1
    Add the server

    It's saved in ~/.grok/config.toml under [mcp_servers.breakreach].

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

    In Grok Build, run /mcps, pick breakreach and sign in in the browser tab that opens.

  3. 3
    Or pass an API key

    For a machine without a browser. The single quotes keep ${BREAKREACH_API_KEY} as written; Grok Build reads the variable each time it loads its config.

    Terminal
    grok mcp add --transport http breakreach https://api.breakreach.com/mcp \  --header 'Authorization: Bearer ${BREAKREACH_API_KEY}'
  4. 4
    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.

With the xAI API

Your code asks Grok, and Grok calls Breakreach's tools from xAI's servers during the request, with your Breakreach API key. There's no sign-in and no approval step, so list the tools it may use in allowed_tools.

  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
    Send the request

    authorization is the whole Authorization header, Bearer included. Without allowed_tools, Grok can call any of Breakreach's tools.

    POST /v1/responses
    curl https://api.x.ai/v1/responses \  -H "Authorization: Bearer $XAI_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "grok-4.7",    "input": [{ "role": "user",      "content": "Post our launch on X and Bluesky now" }],    "tools": [{      "type": "mcp",      "server_url": "https://api.breakreach.com/mcp",      "server_label": "breakreach",      "authorization": "Bearer br_YOUR_API_KEY",      "allowed_tools": ["list_accounts", "create_post"]    }]  }'
  3. 3
    Or with xAI's Python SDK

    The SDK calls the list allowed_tool_names. This one can only read: it lists accounts and reports numbers.

    report.py
    import osfrom xai_sdk import Clientfrom xai_sdk.chat import userfrom xai_sdk.tools import mcp client = Client(api_key=os.environ["XAI_API_KEY"])chat = client.chat.create(model="grok-4.7", tools=[mcp(    server_url="https://api.breakreach.com/mcp",    server_label="breakreach",    authorization="Bearer " + os.environ["BREAKREACH_API_KEY"],    allowed_tool_names=["list_accounts", "get_content_performance"],)])chat.append(user("How did last week's posts do?"))print(chat.sample().content)

In Grok Bot or on grok.com

Both add a remote MCP server by its URL and sign you in with OAuth. We haven't completed that sign-in from them ourselves yet, so we don't promise it: if it fails, Grok Build and the API are the routes we've checked.

  1. 1
    Grok Bot

    Ask your Bot: “Add this MCP server: https://api.breakreach.com/mcp”, then sign in when it asks. On a team, the admin's list of allowed MCP servers must include it.

  2. 2
    grok.com

    Open grok.com/connectors, choose New Connector, then Custom, paste the URL and complete the sign-in. On Grok Business, an admin adds the connector first in the xAI console.

Check it works. grok mcp doctor breakreach checks the connection from Grok Build, and /mcps lists its 29 tools. With the API, ask “list my connected social accounts” first.

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

  • How did yesterday's X post do? Then post the Morning Light launch on X and Threads nowget_content_performance, create_post
  • Post https://cdn.northbeam.coffee/launch.jpg to Instagram, TikTok and LinkedIn tomorrow at 9 AM with a short captioncreate_post
  • Answer the questions in the replies to this week's X postslist_recent_comments, reply_to_comment
  • Which of last month's posts got the most views on each network?get_content_performance
  • Answer my unread X DMs, and show me each reply firstlist_conversations, send_message

What Grok 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

Which Grok should I use?Three ways in, for three kinds of work.

Who it's forSign-inAsks before posting
Grok BuildDevelopers in the terminal, next to their repoOAuth, or an API keyDepends on its approval settings
xAI APIYour own code: a script, a job, a productYour Breakreach API keyNo, limit it with allowed_tools
Grok Bot, grok.comChatting with GrokOAuth, not tested by us yetDepends on the app
Checked on October 7, 2026, against xAI's documentation and the Grok Build source.

Grok inside the X app doesn't take custom MCP servers: xAI documents connectors for grok.com and Grok Bot only.

Can Grok post to X for me?Yes, through Breakreach and X's official API.

Grok being X's assistant doesn't give it your account. Breakreach connects your X account through X's official API with your sign-in, and Grok calls Breakreach's tools: text with up to 4 images, a GIF or a video, at once or at a time. X threads and polls aren't supported yet. The same request can go to Bluesky, Threads, LinkedIn and the other 11 networks, each counting its own limit.

Replies to your X posts published through Breakreach come back with list_recent_comments, and X DMs with list_conversations, so Grok can answer both.

What should I know before using the xAI API?

  • It doesn't stop to askTool calls run on xAI's servers inside the request, with no approval step. Give each job only the tools it needs with allowed_tools, and ask for drafts (draft: true) when a person should check the post.
  • Your key travels with the requestxAI sends the Authorization value you pass to Breakreach. Keep it in an environment variable, never in code you commit.
  • Posts don't depend on the requestA scheduled post is held by Breakreach and goes out at its time, after your script and Grok's request are long gone.

Can Grok post images?

Through public URLs. Breakreach downloads media from the web, so give Grok the address of the image on your site, a CDN or a bucket; upload_media keeps a copy for scheduled posts. Images Grok generates need a public URL before they can be posted. Instagram, TikTok, YouTube and Pinterest need a photo or a video; the other networks also take text alone.

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. Grok and the xAI API are billed by xAI.

Troubleshooting Breakreach in Grok

  • grok mcp doctor breakreach failsCheck the server was added with --transport http and the URL ends in /mcp, then sign in again with /mcps.
  • 401 from the xAI API callauthorization must be the full header value: Bearer br_…, with your Breakreach key, not your xAI key.
  • 402: API access requires an active subscriptionAPI keys need a plan or a trial on the Breakreach account.
  • The sign-in fails in Grok Bot or on grok.comUse Grok Build or the API, and write to hello@breakreach.com with what you saw: we'll make it work.
  • “Media is required for: instagram”Give an image or video URL Breakreach can download.

The same server in other agents

Claude CodeOne command, then /mcp to sign in.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.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 Grok.

Yes, through Grok Build (grok mcp add --transport http breakreach https://api.breakreach.com/mcp, then /mcps to sign in) and the xAI API's remote MCP tool with a Breakreach API key. Grok then gets 29 tools for 15 social networks.

Yes, through Breakreach, which posts with X's official API on the account you connected: text with up to 4 images, a GIF or a video. X threads and polls aren't supported yet.

Both add custom MCP servers by URL with OAuth, so Breakreach's URL goes in the same way. We haven't completed that sign-in from them ourselves yet; Grok Build and the xAI API are the routes we've checked.

No. Remote MCP tools run on xAI's servers without an approval step, so limit them with allowed_tools and ask for drafts when a person should check.

Not that we know of: xAI documents custom connectors for grok.com and Grok Bot, not for Grok inside the X app.

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 Claude CodeOne command, then /mcp.Breakreach in CodexOne table in config.toml.Breakreach in HermesWeekly numbers, drafted posts.Posting APIThe same publishing, over REST.Analytics APIPer-post and account metrics.Social media for AI agentsEvery client, one MCP server.
Instagram
TikTok
LinkedIn
YouTube
X
Facebook
Threads

Give Grok your social accounts.Set up in two minutes.

Get started

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