Skip to main content
Glama
sandraschi

mastodon-mcp

by sandraschi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python

mastodon-mcp

Fediverse Mastodon client (ActivityPub) — full webapp + MCP agent automation, including a human-approved outbox for promotion drafts from fleet-public-relations-mcp.

v0.1.1 · Ports 10754 / 10755 · Sibling of discord-mcp · AT Proto sibling bluesky-mcp

FastMCP 3.4+ · full portmanteau (reply/boost/media/webhooks) · SOTA webapp · dry-run default · Windows CI + local just ci

Mastodon = ActivityPub. Not Bluesky. Primer: docs/FEDIVERSE.md.

Principle

Agents draft and assist. Humans approve fleet promotion posts. Interactive client use still respects dry-run until you go live.

Tone: FLEET_PROMOTION.md.

Related MCP server: mastodon-mcp-server

Features

  • Full Mastodon web client: Inbox, Timelines, Compose (AI assist), Chat, Accounts, Skills, Tools, Settings, Help

  • Agent automation via mastodon_social portmanteau + Prefab cards

  • Human-approved outbox + fleet-PR REST handoff (safety gate — not the only job)

  • Dry-run default; inbound webhooks with shared secret

  • Ruff + Biome + pytest gate; Windows-only CI workflow

Quick start

cd D:\Dev\repos\mastodon-mcp
Copy-Item .env.example .env
# Edit MASTODON_INSTANCE + MASTODON_ACCESS_TOKEN
.\start.bat

Dashboard: http://127.0.0.1:10755 · MCP: http://127.0.0.1:10754/mcp

Documentation

Doc

Contents

INSTALL.md

Install paths

docs/ONBOARDING.md

First-timer: account, money/CC, pitfalls, sanity check

docs/CONFIGURATION.md

Env vars

docs/TOOLS.md

MCP + REST reference

docs/DEVELOPMENT.md

Lint, just ci, packaging

docs/TROUBLESHOOTING.md

Symptom → fix

Ports

Service

Port

Backend

10754

Webapp

10755

MCP tools

Portmanteau mastodon_social — all operations implemented (see docs/TOOLS.md). Also mastodon_help, mastodon_shutdown, show_outbox_card.

Quality

just ci

Private repos: GitHub Actions stay disabled at account level (billing). Workflow file is still required; run just ci locally.

License

MIT (see LICENSE if present)

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • ActivityPub MCP Server

    cameronrye
    A
    license
    B
    quality
    C
    maintenance
    A comprehensive MCP server that enables LLMs like Claude to explore and interact with the existing Fediverse through standardized MCP tools, resources, and prompts.
    18
    58 npm
    17
    MIT

  • mastodon-mcp-server

    VitexSoftware
    A
    license
    C
    quality
    A
    maintenance
    Comprehensive MCP server for Mastodon integration, enabling AI assistants to read timelines, post statuses, manage accounts, search, and more on any Mastodon instance.
    54
    3
    MIT

  • so-easy-mcp

    Pantalones411
    A
    license
    Not graded
    quality
    C
    maintenance
    A full social media management MCP server enabling post, read, schedule, and analyze across Facebook, Instagram, LinkedIn, X/Twitter, Pinterest, and YouTube from any MCP-compatible AI client.
    MIT

  • ilo

    iannuttall
    A
    license
    Not graded
    quality
    A
    maintenance
    A local-first MCP server for social publishing on X (Twitter), enabling draft management, scheduling, and posting via CLI or AI agents.
    41 npm
    5
    MIT