Mastodon

This connector wraps the Mastodon REST API (any instance — set baseUrl to your instance).

Setup:

1. Pick your instance (e.g. https://mastodon.social, https://fosstodon.org, your self-hosted one).
2. Log in → Preferences → Development → New application.
3. Name it (e.g. 'mcp'). Scopes: read, write, follow, push — tick whatever your use case needs (don't over-grant).
4. Save → copy the Your access token value (shown only once). This is a personal access token tied to your account.
5. Set MASTODON_INSTANCE_URL (e.g. https://mastodon.social) and MASTODON_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.