mastodon-blade-mcp

Mastodon operations — timelines, statuses, notifications, search, interactions, multi-instance

certified v0.1.0 social-v1 uv MIT

Authorgroupthink-dev

Setuptrivial

Authapi_key

Repositorygroupthink-dev/mastodon-blade-mcp

Service Contract

social

Conformance

Required4/4

Recommended6/6

Optional4/4

Last tested2026-04-04

Setup

Generate an access token at Preferences > Development > New Application on your Mastodon instance. Grant read scopes for read-only use, or read+write for full interaction.

MASTODON_INSTANCE Instance URL

MASTODON_TOKEN Access Token secret

MASTODON_WRITE_ENABLED Enable Write Operations

Creating Access Tokens →Mastodon API Documentation →OAuth Scopes Reference →

Scenarios

Build a social workflow

Use the Forge to design an automation pack powered by mastodon-blade-mcp for social operations.

Install

sidereal install mastodon-blade-mcp