MCP Server

Mastodon MCP Server Let any AI agent post to Mastodon

Let AI agents publish text, photos and video to any Mastodon instance, schedule posts and keep your fediverse presence active — from a single prompt.

Start free, no card Full MCP server guide

mcp.json

{
  "mcpServers": {
    "upload-post": {
      "url": "https://mcp.upload-post.com/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

Mastodon tools the agent can call

Part of the Upload-Post MCP server. The agent picks the right tool from your prompt.

Tool	What it does
upload_text	Publish a text status (toot) to your timeline
upload_photos / upload_video	Publish image (up to four per status) and video posts
list_scheduled / edit_scheduled / cancel_scheduled	Manage scheduled posts
get_status / get_history	Track what was posted and when

Looking for another way to post? See the Mastodon API page or the Claude Code Mastodon skill.

Works with every MCP client

Same server, same tools. Pick your AI client and follow its 3-step guide.

ChatGPT Claude Gemini Cursor Copilot OpenCode

Try these Mastodon prompts

No commands to memorize. Describe what you want.

“Cross-post my latest X thread to Mastodon.”

“Post this screenshot to Mastodon with alt text and hashtags.”

“Schedule 3 Mastodon posts across the week.”

“Publish the release announcement to Mastodon, Bluesky and Threads at once.”

Frequently asked questions

Mastodon + AI agents, answered. Last updated June 2026.

What is a Mastodon MCP server?

A Mastodon MCP server is a Model Context Protocol server that exposes Mastodon publishing as tools an AI agent can call. The Upload-Post MCP server lets ChatGPT, Claude, Gemini or any MCP client post text, photos and video to your instance — no custom code.

Can AI agents post to Mastodon?

Yes. Connect your instance URL and access token to Upload-Post once, add the MCP server to your AI client, and the agent can publish statuses with media and scheduling from a prompt.

Does it work with self-hosted instances?

Yes. It works with mastodon.social or any self-hosted Mastodon instance — you provide the instance URL and a personal access token when connecting.

Is the Mastodon MCP server free?

The MCP server is free and open-source (MIT). It works with any Upload-Post plan, including the free tier.