Connector guide2-minute read10 MCP toolsEnglish · Deutsch · Italiano

Mastodon su MCP — Pilota Mastodon da qualsiasi agente AI

Read & post on any Mastodon instance from any AI agent. 10 tools, Bearer token auth.

HCBy HelpCode teamUpdated 2 min read Open source on GitHub

No credit card · 7-day trial · Self-host alternative available

MCP connector

Mastodon

Read & post on any Mastodon instance from any AI agent. 10 tools, Bearer token auth.

Tools

10

Region

INTL

Category

social

Authentication

Required env vars

MASTODON_INSTANCE_URLMASTODON_ACCESS_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Source-available BSL-1.1
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

No install? Use cloud.anythingmcp.com directly.

Sign in, install the Mastodon in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.

Open Cloud

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Mastodon, inserisci le credenziali, genera una MCP API key — fatto. Niente Docker, niente git clone, niente server locale.

Mastodon

Read & post on any Mastodon instance from any AI agent. 10 tools, Bearer token auth.

Setup

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.

…(continued in the in-app connector instructions)

Prerequisiti: MASTODON_INSTANCE_URL, MASTODON_ACCESS_TOKEN

Installazione locale del connettore

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Apri http://localhost:3000/connectors/store, scegli Mastodon e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

ToolWhat it does
mastodon_verify_credentialsReturn the authenticated account: id, username, acct (full handle), display_name, note, avatar, statuses_count, followers_count, following_c
mastodon_get_accountFetch a public account by ID
mastodon_account_statusesGet a user's recent statuses (toots)
mastodon_home_timelineGet the authenticated user's home timeline (their follows)
mastodon_public_timelineGet the public timeline
mastodon_hashtag_timelineGet statuses tagged with a hashtag (no # prefix)
mastodon_searchFull-text search across accounts, statuses and hashtags
mastodon_get_statusFetch a single status by ID
mastodon_post_statusPost a new status (toot)
mastodon_delete_statusDelete one of your own statuses

Prossimi passi

Ready to ship

Your Mastodon agent is one click away.

Install the connector, paste the key, prompt any MCP client. Free for 7 days, no credit card.