Mastodon BulkPublish

Mastodon MCP Server

Connect an AI assistant to Mastodon and run it in plain language: draft posts, schedule them, upload media and check how they did. The assistant uses the same account and the same checks as the API.

Get started free Connect your assistant

Connect your assistant

Connect Mastodon in BulkPublish, then add the server address below to your assistant and approve access once. Pick your assistant for the exact steps.

Server address

https://mcp.bulkpublish.com/mcp

See all supported assistants

Things to ask for on Mastodon

Copy any of these into your assistant. The tools it runs are listed under each one. Replace the [brackets] with your own details.

Which of my channels are on Mastodon, and what is scheduled on them this week?

Runs: list_channels, list_posts
Draft three Mastodon posts about [topic], then schedule them for my next free slots.

Runs: get_queue_slot, create_post
Upload [file] and schedule it to Mastodon for tomorrow at 9am.

Runs: upload_media, create_post
How did my last five Mastodon posts perform?

Runs: list_posts, get_post_metrics
Which Mastodon posts failed this week? Retry them.

Runs: list_posts, retry_post
Every Monday at 9am, post [text] to Mastodon.

Runs: create_schedule Full tool set
Show the new comments on my latest Mastodon post and draft replies for me to approve.

Runs: list_post_comments, reply_to_comment Full tool set
List my unread Mastodon messages and draft replies.

Runs: list_conversations, reply_to_conversation Full tool set
Is my Mastodon connection healthy?

Runs: get_channel_health Full tool set

What the assistant can do on Mastodon

Each row shows the tool the assistant runs. It is the same capability the Mastodon API page lists.

Capability	Tools
Create, schedule, update and publish posts	`create_postupdate_postpublish_postdelete_postretry_post`
Upload images and video	`upload_mediacreate_media_uploadfinalize_media_uploadlist_media`
Find the next free slot in your queue	`get_queue_slot`
Create repeating schedulesFull tool set	`create_schedule`
Publish new items from an RSS feedFull tool set	`create_rss_feed`
Post a first comment automatically	`create_post`
Publish multi-part threads	`create_post`
Read per-post metrics	`get_post_metricsget_analytics`
Read and reply to comments on published postsFull tool set	`list_post_commentsreply_to_comment`
Read and answer direct messagesFull tool set	`list_conversationsget_conversationreply_to_conversation`
Check that the connection is healthyFull tool set	`get_channel_health`
Check your plan usageFull tool set	`get_quota_usage`

Hosted connection and the full tool set

The hosted server covers channels, posts, media and analytics. Repeating schedules, RSS feeds, option lookups, stories, comments, messages and plan checks are in the full tool set, which you run on your own machine with an API key. Prompts and rows marked "Full tool set" need it.

Setup for the full tool set

Prefer code?

Everything the assistant does goes through the same REST API, which you can call directly.

See the Mastodon API

Prefer a calendar?

The same Mastodon account can be scheduled from the app.

See the Mastodon scheduler

Frequently asked questions

Common questions about using Mastodon with an AI assistant.

How do I connect Mastodon to Claude or ChatGPT?

Connect Mastodon in BulkPublish, then add the server address https://mcp.bulkpublish.com/mcp to your assistant and approve access once. The page for each assistant shows the exact steps.

What can the assistant do on Mastodon?

It can draft, schedule and publish Mastodon posts (Post), upload media, find your next free queue slot and retry failed posts. The table above shows the tool behind each one.

Does it need an API key?

You approve access once, using your BulkPublish API key. A server you run yourself reads the key from its environment instead.

Can the assistant read and answer Mastodon comments or messages?

Yes, with the full tool set: it can read and reply to comments on published posts and read and answer direct messages. The hosted connection covers publishing, media and analytics.

Is it safe to let an assistant publish for me?

Ask for drafts first. A post created as a draft does not publish until you schedule or publish it, and posts can be held for team approval.

Which plans include it?

Every plan, the Free plan included.

The same server works for 15 networks.