The Mastodon MCP server

Let Claude, ChatGPT, Cursor or any MCP client schedule posts and threads on any Mastodon instance, from mastodon.social to your own server.

Cancel anytime · or self-host for free

Claude scheduling to Mastodon through Postbase

Claude

Reply to Claude…

Postbase
Calendar
New post
21 – 27 Sep 2026Today
Mon
21
Tue
22
Wed
23
Thu
24
Fri
25
Sat
26
Sun
27
09:00
10:00
11:00
12:00
13:00
14:00
15:00
Manage channels

How posting to Mastodon works

Post
412 / 500
Length
500
Characters per post, the default on most instances. Hashtags work as you type them.
Your instance
fosstodon.orgSign in
Instances
Any server
Works with any instance you've connected: mastodon.social, fosstodon.org or your own.
1
2
3
Threads
Threads
Send a thread array and each post is published as a reply to the one before.
Checked first

Problems go back to the agent, not out to your followers

Too long
A scheduled post over 500 characters is refused when the agent calls the tool, with the reason.
In the past
A time in the past is refused rather than posted straight away.
Drafts
Leave out the time and the post is saved as a draft for you to check first.

The tools

The same ten tools on every network.

list_channelsRead only
List channelsPostbase

The accounts connected to the workspace: id, network, handle and status. The agent calls it first to get channel ids.

No arguments.

create_postWrites
Create or schedule a postPostbase

Saves a draft, or schedules a post or a thread, on one or more channels. The post lands on your Postbase calendar and publishes through each network's official API.

body or thread, channel_ids, scheduled_at (ISO 8601 with an offset) or schedule_in_minutes, media_ids from list_media or media_urls, channel_bodies for per-channel text, and an idempotency_key so a retried call can't post twice. Leave both times out to save a draft.

get_postRead only
Get a postPostbase

One post and how it went on each channel: published with its live link, or failed with the reason and when it will be retried.

post_id, from create_post or list_scheduled.

update_postWrites
Edit a postPostbase

Edits or reschedules a draft or scheduled post before it goes out. Only the fields you pass change.

post_id, plus any of create_post's fields. scheduled_at null turns it back into a draft.

retry_postWrites
Retry failed channelsPostbase

Sends a post again to the channels where it failed. Channels where it already published are left alone.

post_id.

get_analyticsRead only
Get post analyticsPostbase

How published posts performed: impressions, likes, comments, shares and saves per channel, with totals for the range.

from and to (YYYY-MM-DD, default the last 30 days), or post_id; channel_id, platform, sort (date or a metric), order, limit.

list_mediaRead only
List mediaPostbase

The images and videos in your Postbase media library, newest first. The agent passes their ids to create_post to attach them.

type (optional): image or video. search (optional): part of a file name.

add_mediaWrites
Add media from a URLPostbase

Adds an image or video to your media library from a public link, for attaching to posts.

url (https). name (optional).

list_scheduledRead only
List scheduled postsPostbase

Posts in the workspace with their text, time and channels. Scheduled posts by default, or drafts, published or failed ones.

status (optional): scheduled, draft, published or failed.

cancel_postWrites
Cancel a scheduled postPostbase

Cancels a scheduled post before it goes out. It goes back to being a draft, so nothing is deleted.

post_id, from list_scheduled.

Frequently asked questions

Does it work with my instance?

Yes. Connect your Mastodon account to Postbase with your instance URL and approve it on your server, and the agent can post to it like any other channel.

Do I have to run the MCP server myself?

No. The server is hosted at mcp.postbase.so. If you'd rather self-host everything, Postbase and its MCP package are open source.

Can it boost or reply to other posts?

No. It schedules your own posts and threads only. There are no tools for boosts, favourites, replies to others or DMs.

Related

Ready to get started?

Connect your AI tool in a minute. It schedules your Mastodon posts, and you see every one in your calendar.

Cancel anytime · or self-host for free

Postbase

Copy your key now — you won't see it again.

pb_live_Qm7xT2vLr9KcH0sWbN8y…4f2aCopy
MCP client configuration

Authentication

Sign in with PostbaseAPI key

Client

Claude DesktopCursorVS Code
Connected apps
Claude
Halden Coffee · connected just now
Revoke
Cursor
Halden Coffee · connected 14 Sep 2026
Revoke
✓Claude connected to Halden Coffee