Mastodon MCP server

What an agent can do on Mastodon

• Post. create_post sends text to your Mastodon connection now. Limit: The instance's own limit, read when you connect (500 by default). A link counts 23, a mention its local part.
• Schedule and queue. The same tool takes scheduledFor for a set time, or queue for the connection's next free slot. set_connection_queue sets the weekly slots.
• Drafts. Save a draft for the user to review, then publish_draft sends it, or update_post edits it first.
• Image cards. render_image and draw_card make an image card in the connection's look, and upload_media stores your own picture. Mastodon images: Up to 4 per post (png, jpeg, gif, webp), alt text sent.
• Threads. Yes, up to 24 replies under the head status. Send the follow-ups in the thread field of create_post.
• Metrics. get_post_metrics reads a post's numbers over time. Yes.
• Delete. delete_post removes a draft, cancels a scheduled post, or takes a sent post down. Yes.

Not available on Mastodon: a first comment.

Example prompts

• post this to my Mastodon account: new release is out, notes are on the blog
• Queue this for my Mastodon for the next free slot, then show me what is waiting.
• Save a draft for Mastodon so I can review it first.

Set up your client

The server URL is https://api.yeetpost.com/api/v2/mcp. Step by step for: Claude, Cursor, Codex, n8n, Windsurf, VS Code. The tool list is on the MCP docs page.

FAQ

Can an AI agent post to Mastodon?

Yes. Add the yeetpost MCP server to your AI client, connect Mastodon once in the yeetpost console, and the agent posts to it with create_post.

How do I connect Mastodon?

Type your instance's host in the yeetpost dashboard and approve the request on your instance. yeetpost registers itself on the instance the first time, so you need no developer app of your own.

What does posting to Mastodon cost?

Posting to Mastodon is free. Billing is per connected account: the first 2 are free.