v0.5.0 — beta

First tagged release. MCP server for Automad v2 over stdio — verified against a live automad/automad:v2 (beta.51) and covered by unit + opt-in live E2E tests.

Highlights

7 tools (each dispatches on an action):

• automad_pages — list, get, create, update, delete, move, duplicate, publish, batch_update (create/update auto-publish unless publish:false)
• automad_media — list, upload
• automad_shared — get, set
• automad_config — get, set
• automad_site — info, search, health
• automad_docs — offline bundled knowledge base (list/search/get), works with no live instance
• automad_theme — list, install, activate, uninstall, scaffold, build, read, write, files, analyze, validate, schema, diff, generate

4 resources: automad://themes, automad://themes/{slug}/schema, automad://docs, automad://docs/{slug}

5 workflow prompts: create_blog_post, scaffold_theme, analyze_theme, check_headless_setup, find_docs

Two modes via AUTOMAD_MODE: full (live instance) and docs (standalone docs + theme tooling, no credentials).

Notable fixes

• pages.list no longer 403s ("CSRF token mismatch") — the body-less POST now attaches __csrf__.
• Cold-start login false negative fixed — AuthManager retries the auth probe on a transient 403 while the session/CSRF settle; genuine failures still fail fast.

Install

npx @automadcms/mcp-server

See the README for Claude Desktop/Code, Cursor, Cline, and Zed configs. Full changelog: CHANGELOG.md.

Beta: functional and live-verified; not yet published to npm.