One API.
Every network.

Saymany's social media posting API is a standard MCP endpoint. AI apps call it through a connector; your own code calls the same tools with an API key.

How the social media API works

Everything goes through one endpoint, https://saymany.com/mcp, using the Model Context Protocol (JSON-RPC over HTTP). There is no separate REST API: the tools your AI app uses are the same ones your scripts call, so they stay in step.

Sign in with an API key

Create a key in the dashboard under Settings, API keys, or ask Saymany in a chat to "create an API key for my script". The key is shown once. Send it as Authorization: Bearer sm_live_…. A key acts for one workspace with your role, and you can revoke it at any time.

Schedule a post

Call a tool with tools/call. Publishing and scheduling need confirm: true; leave it out and you get a preview back instead.

POST https://saymany.com/mcp
Authorization: Bearer sm_live_…
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_post",
    "arguments": {
      "text": "We are open late on Friday.",
      "platforms": [
        "x",
        "bluesky"
      ],
      "scheduled_at": "2026-12-05T18:00",
      "confirm": true
    }
  }
}

What you can call

  • Accounts: list_accounts, check_account, connect_account (sends a sign-in link)
  • Media: media_upload_inline, media_import_url, media_create_upload for large videos
  • Posts: preview_post, validate_post, create_post, update_post, reschedule_post, cancel_post, retry_post, get_post, list_posts
  • Rules: get_platform_rules returns each network's limits
  • Workspace: brands, members, usage and billing

Send tools/list to get every tool with its full input schema.

Networks

Live today: X, Bluesky, Telegram, Discord. Rolling out while each network finishes reviewing our app: Instagram, Facebook, Threads, LinkedIn, TikTok, YouTube, Pinterest, Google Business Profile. Posts to X are billed at X's own per-post price, passed on at cost.

Retries without double posts

Pass an idempotency_key with create_post. The same key returns the same post instead of publishing twice.

When another tool fits better

If you need a plain REST API with webhooks for every post event, or white-label sign-in for your own customers' accounts, a dedicated social media API provider may suit you better. Saymany is built for teams posting to their own accounts from AI apps and scripts.