Mastodon MCP server for AI agents
Read timelines, search, post and reply, favourite and boost, follow accounts and manage notifications on any Mastodon server.
Runs with your users' own Mastodon accounts. Credentials stay on prompt-tm.com.
26 tools · 0 triggers
- Auth
- Access token · OAuth 2.0 (sign in with the app)
- Tools
- 26
- Triggers
- 0
- Category
- Communication, Media
Tools and triggers
Verify the account
MASTODON_VERIFY_CREDENTIALS
Returns the signed-in account: ID, username, display name, counts and profile fields.read-only
Get the instance
MASTODON_GET_INSTANCE
Returns the server's title, version, rules and limits, such as the maximum characters per status, media attachments and poll options.read-only
Get an account
MASTODON_GET_ACCOUNT
Returns one account by its ID.read-only
Look up an account
MASTODON_LOOKUP_ACCOUNT
Finds a local account by username, or a remote one by its address (`user@example.social`), and returns it with its ID.read-only
List an account's statuses
MASTODON_LIST_ACCOUNT_STATUSES
Lists an account's statuses. Private statuses show only if the token's account may see them.read-only
List an account's followers
MASTODON_LIST_FOLLOWERS
Lists the accounts that follow this account.read-only
List the accounts an account follows
MASTODON_LIST_FOLLOWING
Lists the accounts this account follows.read-only
Get relationships with accounts
MASTODON_GET_RELATIONSHIPS
Returns whether the signed-in account follows, is followed by, blocks or mutes each of the given accounts.read-only
Follow an account
MASTODON_FOLLOW_ACCOUNT
Follows an account, or sends a follow request if it is locked. Returns the new relationship.
Unfollow an account
MASTODON_UNFOLLOW_ACCOUNT
Stops following an account. Returns the new relationship.
Get the home timeline
MASTODON_HOME_TIMELINE
Lists the statuses from the accounts the signed-in account follows. A 206 answer means the feed is still being rebuilt.read-only
Get the public timeline
MASTODON_PUBLIC_TIMELINE
Lists public statuses: this instance's and the ones it has seen from others, or only local ones with `local`. Some instances require sign-in for this.read-only
Get a hashtag timeline
MASTODON_TAG_TIMELINE
Lists public statuses with a hashtag. `any`, `all` and `none` add other tags to match or exclude.read-only
Get a list timeline
MASTODON_LIST_TIMELINE
Lists the statuses from the accounts in one of the signed-in account's lists.read-only
Post a status
MASTODON_CREATE_STATUS
Posts a status (a toot) as the signed-in account. Needs `status` or `media_ids`. Send an `idempotency_key` so a retry doesn't post twice; Mastodon remembers it for an hour. Polls aren't supported here.
Get a status
MASTODON_GET_STATUS
Returns one status by its ID.read-only
Get a status's thread
MASTODON_GET_STATUS_CONTEXT
Returns the statuses before (`ancestors`) and after (`descendants`) a status in its conversation.read-only
Delete a status
MASTODON_DELETE_STATUS
Deletes one of the signed-in account's statuses and returns its text so it can be redrafted. Set `delete_media` to remove attached media at once instead of within about a day.destructive
Favourite a status
MASTODON_FAVOURITE_STATUS
Adds a status to the signed-in account's favourites.
Boost a status
MASTODON_BOOST_STATUS
Boosts (reblogs) a status to the signed-in account's followers.
Bookmark a status
MASTODON_BOOKMARK_STATUS
Adds a status to the signed-in account's private bookmarks.
Search
MASTODON_SEARCH
Searches accounts, hashtags and statuses. Accounts and hashtags are always searchable; searching statuses depends on the instance and needs sign-in. `resolve` and `offset` need the `read:search` scope.read-only
List notifications
MASTODON_LIST_NOTIFICATIONS
Lists the signed-in account's notifications (mentions, boosts, favourites, follows).read-only
Get a notification
MASTODON_GET_NOTIFICATION
Returns one notification by its ID.read-only
Dismiss a notification
MASTODON_DISMISS_NOTIFICATION
Removes one notification from the signed-in account's list.
Clear all notifications
MASTODON_CLEAR_NOTIFICATIONS
Removes every notification from the signed-in account's list.destructive
Try Mastodon now
Sign in, connect your account and run any of these in the playground, or ask your agent through the router.
- “Verify the account”MASTODON_VERIFY_CREDENTIALS
- “Get the instance”MASTODON_GET_INSTANCE
- “Get an account”MASTODON_GET_ACCOUNT
Connect via MCP
Create an MCP server for Mastodon in the dashboard, then add its URL to your client. This is the Claude Code command; the client guide has the others.
claude mcp add --transport http mastodon \
"https://www.prompt-tm.com/mcp/<server id>?user_id=<your user>" \
--header "x-api-key: ptm_…"Connect via REST
Run a tool with one request. The response is { data, error, successful, log_id } for every tool.
curl -X POST https://www.prompt-tm.com/api/v3/tools/execute/MASTODON_VERIFY_CREDENTIALS \
-H "x-api-key: $PROMPT_TM_KEY" -H "content-type: application/json" \
-d '{ "user_id": "alice", "arguments": {} }'