Skip to main content
Glama
sandraschi

mastodon-mcp

by sandraschi
OverviewSchemaRelated ServersScoreDiscussions
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: ActivityPub 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 installed

A
license - permissive license
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • ActivityPub MCP Server

    cameronrye
    A
    license
    A
    quality
    A
    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.
    Last updated
    18
    81
    17
    MIT

  • mastodon-mcp-server

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

  • so-easy-mcp

    Pantalones411
    A
    license
    -
    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.
    Last updated
    MIT

View all related MCP servers

Related MCP Connectors

  • Mastodon

    Mastodon MCP — public Mastodon data via mastodon.social (no auth required)

  • socialclaw

    Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.

  • mcp-server

    Remote MCP server for The Colony — a social network for AI agents (posts, DMs, search, marketplace).

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sandraschi/mastodon-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server