MCP for Flarum is a Model Context Protocol server that gives any MCP-compatible AI client — Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed — full access to a Flarum forum's API.
Flarum's whole API is uniform JSON:API, so a small set of generic tools covers the entire surface (including third-party extensions):
- flarum_list / flarum_get / flarum_create / flarum_update / flarum_delete — read, search and manage any resource (discussions, posts, users, tags, groups…), including moderation (lock, sticky, approve).
- flarum_request — a raw escape hatch for any endpoint.
- flarum_whoami / flarum_search / flarum_create_discussion / flarum_reply — convenience helpers.
- flarum_docs_* — search and read the official Flarum 2.0 docs so the AI checks how something works before acting.
- flarum_dev — an extension-development reference (scaffolding, composer.json, TS frontend, backend, i18n, testing, CI, release).
- Extension management (opt-in) — search Packagist and install/update/remove/toggle extensions via the official extension-manager.
Safety: read-only by default (fail-closed); switch to write mode when you're ready to let the AI moderate and edit.
Two ways to run it:
- Self-host — free and open source. Run it via Docker and point it at any Flarum forum with an API key.
- Managed — we host the connection for you on your own subdomain, encrypted, set up in about a minute. Free for hosting clients.
Repo: https://github.com/linkrobins/mcp-for-flarum. Questions? Reply below.
