mcpField
B
Breakreach

Breakreach

Remote
breakreach.comSocial Media0Updated 3w ago
RepositoryVisit website

About Breakreach

The Breakreach developer and agent kit provides SDKs, a CLI, an agent skill, and a hosted MCP server for scheduling and publishing social posts, analytics, and replies. Its TypeScript and Python SDKs are generated from the API spec and retry POST requests with idempotency keys.

Key features

  1. 01Schedule and publish social posts
  2. 02Read analytics and reply to interactions
  3. 03Use TypeScript and Python SDKs
  4. 04Publish posts through the CLI
  5. 05Retry POST requests idempotently

Use cases

  1. 01Schedule content across social accounts
  2. 02Publish posts with media from the CLI
  3. 03Let an agent handle social media tasks

MCP support

Breakreach offers a hosted OAuth MCP server for MCP clients to access its social media API. The project also provides a Claude Code plugin combining the MCP server and agent skill.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://api.breakreach.com/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Details

From the project README

Breakreach developer and agent kit

Everything to use Breakreach from code and from AI agents: schedule and publish social media posts to Instagram, TikTok, X, LinkedIn, YouTube, Facebook, Threads, Pinterest, Bluesky, Reddit, Telegram, Discord, Slack, Mastodon, WordPress, Ghost, Dev.to, Hashnode and Tumblr.

Install
TypeScript SDK + CLInpm install breakreach · npx breakreach post …Node 18+, no dependencies
Python SDKpip install breakreachPython 3.9+, standard library only
Agent skillnpx skills add breakreach/breakreachClaude Code, Codex, Cursor, OpenClaw and other agents that read SKILL.md
Claude Code plugin (skill + MCP server)claude plugin marketplace add breakreach/breakreach then claude plugin install breakreach@breakreach
MCP serverhttps://api.breakreach.com/mcphosted, OAuth; setup per client

The SDKs are generated from the OpenAPI spec the API serves (a copy is in openapi.json), so every endpoint has a typed method. Both retry network errors and restarts with an Idempotency-Key on each POST: a retry never publishes a post twice.

import { Breakreach } from "breakreach";

const br = new Breakreach(); // BREAKREACH_API_KEY
const { accounts } = await br.listAccounts();
await br.createPost({ content: "Out tomorrow.", accountIds: accounts.map((a) => a.id), useNextSlot: true });

npx breakreach login
npx breakreach post "Out tomorrow." --to instagram,linkedin --media ./launch.jpg --next-slot

An API key comes from Breakreach, Settings → API & MCP. Docs: breakreach.com/developers.

Working on it

npx tsx scripts/generate.mts          # after an API change: types, methods and README tables from the spec
npx tsx scripts/generate.mts --check  # fails when the generated files are out of date
cd typescript && npm install && npm run build

In the Breakreach monorepo the generator reads the spec from apps/api/src/lib/openapi.ts; elsewhere from openapi.json, or --spec https://api.breakreach.com/v1/openapi.json. scripts/e2e.sh (monorepo only) drives both SDKs and the CLI against the real API code on a local database. Releasing: RELEASING.md.

MIT licensed.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.