● Live now — no app review

Post to Mastodon via API: connect once, post with one call (2026)

To post to Mastodon via API, create an access token under Preferences › Development on your instance, give PostWire your instance URL and that token, and PostWire posts a status via the Mastodon REST API. One REST call or one MCP tool — live today, no app review.

How Mastodon posting works

Mastodon is a federated network: each server (instance) runs the same open REST API. To post you create an application + access token in Preferences › Development on your instance, then POST to /api/v1/statuses. PostWire does this for you across any instance — you just supply the instance URL and token once.

No central approval, no OAuth audit. Connect and post immediately.

1. Connect your Mastodon account

Create the token at your-instance › Preferences › Development › New application with the write:statuses scope. PostWire stores it encrypted and uses it only to post. You can also connect from the dashboard without writing code.

curl -X POST https://postwire.io/api/connect \
  -H "Authorization: Bearer $POSTWIRE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"mastodon","credentials":{"instance_url":"https://mastodon.social","access_token":"your_access_token"}}'

2. Post with one REST call

Once connected, publishing is a single request. Add more networks by putting more strings in platforms — same payload, one call.

curl -X POST https://postwire.io/api/post \
  -H "Authorization: Bearer $POSTWIRE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platforms":["mastodon"],"text":"Hello from PostWire 👋"}'

Response: {"results":[{"ok":true,"platform":"mastodon", ...}]}

3. Or let an AI agent post it (MCP)

PostWire ships a first-class MCP server — not docs-only. Add it to any MCP client (Claude, Cursor, your own agent):

{
  "mcpServers": {
    "postwire": {
      "command": "npx",
      "args": ["-y", "postwire-mcp"],
      "env": { "POSTWIRE_API_KEY": "pw_live_xxx" }
    }
  }
}

Then the agent just calls the tool — no HTTP plumbing:

{
  "name": "post_to_social",
  "arguments": { "platforms": ["mastodon"], "text": "Shipped today 🚀" }
}

Mastodon via API: build it yourself vs PostWire

 Direct integrationPostWire
SetupImplement Mastodon's API + authConnect once
Credential storageYou secure itEncrypted (AES-256-GCM)
AI agent supportBuild your own toolMCP tool out of the box
Other networksOne integration each9 networks, one API

Pricing: flat per brand

PlanPriceBrands
Free$01 brand · 30 posts/mo
Starter$93 brands · 300/mo
Pro$2910 brands · 2,000/mo
Agency$9950 brands
Scale$299200 brands

Running 50 brands on Ayrshare costs roughly $779 — and its MCP is docs-only, so an agent can't actually post. See PostWire vs Ayrshare.

Connect Mastodon — free →

FAQ

Can I post to Mastodon via API?
Yes. Every Mastodon instance exposes the same REST API. You create an access token in Preferences > Development and POST to /api/v1/statuses. PostWire wraps this behind one endpoint and one MCP tool and works across any instance.
How do I get a Mastodon access token?
On your instance go to Preferences > Development > New application, give it the write:statuses scope, and copy the access token. Provide PostWire your instance URL and the token; PostWire stores it encrypted.
Is Mastodon live on PostWire right now?
Yes. Mastodon is live today on any instance, with no app review, alongside Bluesky, Telegram, and Discord.
How does an AI agent post to Mastodon?
PostWire ships an MCP server (postwire-mcp). The agent calls post_to_social with platforms set to mastodon and the text. PostWire posts the status to your connected instance and returns the result.
How much does it cost to post to Mastodon?
Free plan: 1 brand, 30 posts/month. Paid plans are flat per brand: Starter $9, Pro $29, Agency $99 for 50 brands, Scale $299.