MCP server

Your agent talks to scatterpost through the Model Context Protocol: it can draft, check, adapt, publish and read back analytics without leaving your normal tool loop.

Connect with sign-in

The simplest route: add the connector address in your AI app, sign in to scatterpost and click Approve. No API key to copy. Tested with Claude, ChatGPT and Gemini. Other AI apps that support remote MCP connectors with sign-in can use the same address. The address:

https://app.scatterpost.io/api/mcp/mcp

Claude

  1. In Claude, open Customize, then Connectors.
  2. Click + Add, then Add custom connector.
  3. Name it scatterpost, paste the connector address above, and click Continue, then Add.
  4. Click Connect. You go to scatterpost's page "Connect Claude to scatterpost": sign in if asked and click Approve.
  5. Back in Claude you will see "Connected to scatterpost". Claude asks permission before each action: choose Allow once or Always allow.

On Team and Enterprise, Claude's help centre says an owner adds it once under Organization settings, then Connectors, and members click Connect.

ChatGPT

  1. In ChatGPT, open your profile, then Settings, then Security and login, and switch on Developer mode.
  2. Open Plugins, click +, then Add custom MCP server, then Create MCP App. Name it scatterpost, paste the connector address above as the Server URL, set Authentication to OAuth, tick the box to confirm you understand, then click Create.
  3. In Settings, then Plugins, open scatterpost, choose Connect another account, then Sign in with scatterpost.
  4. On scatterpost's page "Connect ChatGPT to scatterpost", click Approve.
  5. Back in ChatGPT your scatterpost account shows as Primary. A banner may say not all permissions were granted: that is expected, as publishing is off unless you allow it.
  6. In a chat, type @, pick scatterpost, then ask, for example, "Using scatterpost, list my channels".

Needs Developer mode, which ChatGPT labels as elevated risk. Tested on the Free plan: connecting and creating drafts work. Publishing is off unless you allow it when you sign in, and has not yet been tested in ChatGPT.

Gemini

  1. Open Connected apps in Gemini and choose Custom apps.
  2. Under "Add a custom app link to get started", paste the connector address above, then Next.
  3. On "Connect this MCP server", tick the box accepting the security and privacy risks, then Connect.
  4. On "Link your Google Account", choose Agree and continue, then click Approve on scatterpost's page.
  5. Click Connect on "Save your custom app". scatterpost then appears under Custom apps.
  6. In a chat, type @Scatterpost and your request. Gemini asks Allow or Deny before each action.

Needs a personal Google account and you must be 18 or over; work and school accounts are not supported. Availability is set by Google.

Other agents

  1. Open your app's settings for custom MCP connectors (sometimes called connectors, tools or MCP servers).
  2. Add a new connector and paste the connector address above.
  3. Sign in to scatterpost and click Approve when asked.
  4. Check that the scatterpost tools appear, then ask your assistant to draft a post.

Steps differ by app, and your app must support remote MCP servers with sign-in (OAuth). Tested with Claude, ChatGPT and Gemini.

In the dashboard, Settings, Connect your AI shows the same steps, and lists the apps you have connected so you can disconnect one at any time.

Claude Code

Add the remote endpoint, then sign in. In Claude Code, type /mcp, pick scatterpost and choose Authenticate.

claude mcp add --transport http scatterpost https://app.scatterpost.io/api/mcp/mcp

Sign-in from Claude Code is new and still being tested. If Authenticate does not finish, use an API key instead (below).

Or use an API key instead. Create one in the scatterpost dashboard under Settings, Connect your AI, Advanced, then add the server over stdio (it runs through npx, nothing to install first):

claude mcp add scatterpost -e SCATTERPOST_API_KEY=sp_live_... -- npx -y @scatterpost/mcp

Or connect straight to the remote endpoint over Streamable HTTP with the same key:

claude mcp add --transport http scatterpost https://app.scatterpost.io/api/mcp/mcp \
  --header "Authorization: Bearer sp_live_..."

Cursor

Create an API key in the dashboard under Settings, Connect your AI, Advanced, then add this entry to Cursor's mcp.json, with your key in place of the placeholder:

{
  "mcpServers": {
    "scatterpost": {
      "command": "npx",
      "args": ["-y", "@scatterpost/mcp"],
      "env": { "SCATTERPOST_API_KEY": "sp_live_..." }
    }
  }
}

We have not yet tested this end to end in Cursor. If it does not connect, tell us through Settings, Feedback.

API keys and scopes

Create keys from Settings in the dashboard. Each key carries a subset of articles:read, articles:write, channels:read, channels:write, publications:read, publications:write and publish, so a key handed to one agent can be limited to, for example, drafting and reading without the ability to publish. A key can never act with more access than its creator currently has in the workspace: if its creator is later moved to a viewer, the key keeps only its read scopes.

A key belongs to one workspace, and every call it makes acts there. The scatterpost_settings action list_workspaces lists the workspaces the connection can see but never opens them. Signed in with OAuth, it lists every workspace you can reach, such as an agency's client workspaces; with an API key, it lists that key's own workspace only. To work in another workspace, create a key in that workspace: an agency uses one key per client.

Tools

The key never appears in a tool result or a log line.

scatterpost_draft
Save a new article as a draft.
scatterpost_update
Edit an existing article's title, body, canonical URL, tags or SEO fields. Deleting an article is done by a workspace owner in the dashboard; agents can cancel scheduled publications instead.
scatterpost_list
List articles, with a status filter and cursor paging.
scatterpost_get
Fetch one article with its body and its publications.
scatterpost_preview_publication
Dry run: the exact payload a publication will send.
scatterpost_publish_now
Publish to the chosen channels, website first.
scatterpost_schedule
Queue a publish for a future time, same canonical-first rule.
scatterpost_channels
List channels, or connect Dev.to and a website.
scatterpost_analytics
Per-channel views, reactions, comments, reposts and clicks for one article, plus totals.
scatterpost_optimise
Deterministic SEO and/or GEO report, plus JSON-LD and an llms.txt entry. Pro and Team only.
scatterpost_adapt
A starting draft for one platform, with its character limit and notes. Pro and Team only.
scatterpost_publications
List publications awaiting approval, approve or reject them (owners only), or cancel a scheduled publication.
scatterpost_bulk_schedule
Queue up to 50 publications in one call, or one article across channels on staggered slots. Team only.
scatterpost_retry_publication
Retry one failed publication. Never re-sends a published one; the website goes first.
scatterpost_test_channel
Check that a channel's saved credentials still work, without posting anything.
scatterpost_approvals
Review the approvals queue, or what changed since a publication entered review. Read-only.
scatterpost_media
Upload an image (PNG, JPEG, WebP or GIF) or a short video (MP4 or WebM, up to 100 MB and 3 minutes, for Mastodon, Bluesky, LinkedIn (profile and Page), Facebook Page, Instagram (Reels), TikTok (inbox), X, YouTube and Threads) with alt text, to use as a cover or attach per channel. Private until published. Delete an item you no longer need, unless it is attached to something scheduled or being published.
scatterpost_settings
Read or change which emails you get, read the workspace or change its timezone (owners only), and list the other workspaces you can reach. Changing needs a key with a write scope.
scatterpost_feedback
Report a bug, something not working, or a feature request, with the error code and request id. A person reads every report; check its status later.
scatterpost_canonical_check
Check any public page's canonical tag, og:url, noindex, redirects and sitemap entry, and whether a cross-post's canonical points back to the original. Every plan.
scatterpost_community_rules
Read or save the posting rules for one community (Reddit, Hacker News, Product Hunt, Indie Hackers). Pro and Team only.
scatterpost_community_check
Check a post against a community's saved rules and your spacing there, without saving anything. You post it yourself. Pro and Team only.
scatterpost_community_draft
Save, list, read or delete the drafts you write for each community, with the checks run on save. Pro and Team only.
scatterpost_community_mark_posted
Record the link to a post you made yourself, so spacing between posts is tracked. Pro and Team only.