Mastodon
Read & post on any Mastodon instance from any AI agent. 10 tools, Bearer token auth.
7-day free trial · No credit card · EU-hosted
Ask Mastodon anything
Try a real prompt against Mastodon via AnythingMCP — Claude calls the tools, returns the answer. Press Enter on your own message to install on Cloud.
Install Mastodon on CloudClaude is AI and can make mistakes. Please double-check responses.
Setup in 2 minutes
- 1Start a free trial on cloud.anythingmcp.com.
- 2Click Mastodon in the connector store. Paste credentials when prompted.
- 3Mint an MCP API key and point your AI client at the generated MCP URL.
Guides for Mastodon
Step-by-step setup for the most popular AI clients.
Setting up Mastodon
From the connector definition itself: where to find the credentials, what they need to be allowed to do, and which API this adapter talks to.
This connector wraps the Mastodon REST API (any instance — set baseUrl to your instance).
Setup:
- Pick your instance (e.g.
https://mastodon.social,https://fosstodon.org, your self-hosted one). - Log in → Preferences → Development → New application.
- Name it (e.g. 'mcp'). Scopes:
read,write,follow,push— tick whatever your use case needs (don't over-grant). - Save → copy the Your access token value (shown only once). This is a personal access token tied to your account.
- Set
MASTODON_INSTANCE_URL(e.g.https://mastodon.social) andMASTODON_ACCESS_TOKEN.
Authentication: Authorization: Bearer ${MASTODON_ACCESS_TOKEN} on every request.
Per-instance API: Mastodon is federated — every instance hosts its own API. baseUrl is your home instance. To read posts from other instances, the API will federate transparently when you provide a status ID OR you can use the public timeline endpoints.
IDs are per-instance: a status ID from mastodon.social is NOT the same as the same status on fosstodon.org (each instance assigns its own internal ID even if the status was federated). To look up cross-instance: use mastodon_search with the full URL.
Post (toot) limits: most instances allow 500 characters; some configure more. Polls have separate rules.
Pagination: cursor-based via Link headers (max_id, min_id, since_id). The adapter exposes max_id / since_id as parameters.
Visibility: when posting, visibility is one of public, unlisted, private (followers-only), direct (mentioned-only). Default per-account.
Rate limits: 300 req / 5min per token on most instances. 429 with X-RateLimit-Reset header.
Out of scope here: image/video upload multipart (use the dedicated media endpoint with a separate flow), instance admin, lists CRUD, push subscriptions.
Your AI is two clicks away from Mastodon.
Install the connector, paste your credentials, ask your AI a question. 7-day free trial, no credit card.