Skip to content

GUIDE

One social media API for AI agents

Last updated

Short answer

Instead of integrating every network's API, an agent can call one social media API. Mynahcast's REST API (OpenAPI at https://api.mynahcast.xyz/v1/openapi.json) and MCP server publish one post to many channels, check each channel's limits first, never post twice on a retry, and read every post back to confirm it is live. 13 channels are live today.

Why agents need more than the raw platform APIs

Each network has its own auth, character limits, media rules and failure modes. An agent calling them directly has to handle all of it, and a timeout halfway through a request leaves it guessing whether the post went out. Retrying can double-post; not retrying can drop it.

A posting API built for agents takes that off the agent: one schema for every channel, validation before anything is saved, an Idempotency-Key so retries are safe, and a per-channel delivery state the agent can read back.

Post to several channels with one request

  • Validate first with POST /v1/posts/validate (mynahcast_validate_post over MCP) to see each channel's limits and problems without saving.
  • Posts created with an Agent key wait in Approvals; Publisher keys can schedule directly.
  • Read GET /v1/posts/{postId} for per-channel delivery state, and the timeline for every attempt.
Create a post for Bluesky and Mastodon
curl -X POST "https://api.mynahcast.xyz/v1/posts" \
  -H "Authorization: Bearer $MYNAHCAST_KEY" \
  -H "Idempotency-Key: launch-post-01" \
  -H "Content-Type: application/json" \
  -d '{
    "brandId": "<brand-uuid>",
    "content": { "body": "Rye sourdough is back on Thursday." },
    "targets": [{ "channelId": "<bluesky-channel-uuid>" }, { "channelId": "<mastodon-channel-uuid>" }]
  }'

Channels you can post to today

Bluesky, Mastodon, Telegram, Discord, Nostr, Lemmy, Misskey, Slack, Matrix, DEV, Hashnode, WordPress and Listmonk. LinkedIn and Tumblr are waiting on platform app approval; X needs a paid API tier; Instagram, Facebook, Threads, TikTok, YouTube, Pinterest and Reddit are planned. Each channel page lists its exact limits and how to connect it.

Frequently asked questions

Is there an API to post to Bluesky, Mastodon and Telegram at once?
Yes. Mynahcast's REST API takes one post with several targets (for example a Bluesky, a Mastodon and a Telegram channel) and publishes it once to each, reading each post back afterwards. The API is described at https://api.mynahcast.xyz/v1/openapi.json.
How do I stop an AI agent from posting duplicates?
Send an Idempotency-Key header with every write. Repeating a request with the same key returns the first response instead of creating a second post, and each delivery to a platform has its own idempotency key on Mynahcast's side.
Is the Mynahcast API free?
The API and MCP server are included on every paid plan at no extra cost, from $12 per month (1,000 calls a day on Creator, up to 100,000 on Agency), with a 7-day free trial.