Mastodon MCP server for AI agents

Read timelines, search, post and reply, favourite and boost, follow accounts and manage notifications on any Mastodon server.

MastodonBEARER_TOKENOAUTH2

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.

Try it free

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.

terminal
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.

terminal
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": {} }'

Mastodon questions