Kirby MCP
JSON →CLI-first MCP server for composer-based Kirby CMS projectsâinspect blueprints/templates/plugins, interact with a real Kirby runtime, and use a bundled Kirby knowledge base.
Tools · 37
- kirby_blueprint_read read a single blueprint by id
- kirby_blueprints_index index blueprints, includes plugin-registered ones when runtime is installed
- kirby_blueprints_loaded list blueprint ids loaded at runtime
- kirby_cache_clear clear in-memory caches for this MCP session (StaticCache, config, composer, roots, tool index)
- kirby_cli_version run `kirby version` and return stdout, stderr and exit code
- kirby_composer_audit parse composer.json for scripts and quality tools
- kirby_collections_index index named collections, includes plugin-registered ones when runtime is installed
- kirby_controllers_index index controllers, includes plugin-registered ones when runtime is installed
- kirby_online search official Kirby docs (online fallback) and optionally fetch markdown pages
- kirby_online_plugins search the official Kirby plugins directory (online fallback) and optionally fetch plugin details
- kirby_dump_log_tail tail `.kirby-mcp/dumps.jsonl` written by `mcp_dump()`
- kirby_eval execute PHP in Kirby runtime for quick inspection, requires enable plus confirm
- kirby_query_dot evaluate Kirby query language (dot-notation) strings, requires confirm and can be disabled via config
- kirby_generate_ide_helpers generate regeneratable IDE helper files into `.kirby-mcp/`
- kirby_ide_helpers_status report missing template/snippet PHPDoc `@var` hints + helper file freshness (mtime-based)
- kirby_info project runtime info, composer audit and local environment detection
- kirby_init session guidance plus project-specific audit, call once per session
- kirby_search search the bundled local Kirby knowledge base markdown files (preferred)
- kirby_models_index index registered page models with class and file path info
- kirby_plugins_index index loaded plugins, prefers runtime truth when installed
- kirby_read_file_content read file content/metadata by id or uuid
- kirby_read_page_content read page content by id or uuid
- kirby_read_site_content read site content
- kirby_read_user_content read user content by id or email
- kirby_render_page render a page by id or uuid and return HTML plus errors
- kirby_roots resolved Kirby roots via `kirby roots`
- kirby_routes_index list registered routes with best-effort source location (config/plugin)
- kirby_run_cli_command run a Kirby CLI command, guarded by an allowlist
- kirby_runtime_install install project-local Kirby MCP runtime CLI commands into the project
- kirby_runtime_status check whether runtime command wrappers are installed
- kirby_snippets_index index snippets, includes plugin-registered ones when runtime is installed
- kirby_templates_index index templates, includes plugin-registered ones when runtime is installed
- kirby_tool_suggest suggest the best next Kirby MCP tool/resource for a task
- kirby_update_file_content update file metadata/content, plus confirm (see `kirby://blueprint/file/update-schema` + `kirby://field/{type}/update-schema` for payload shapes)
- kirby_update_page_content update page content, plus confirm (see `kirby://blueprint/page/update-schema` + `kirby://field/{type}/update-schema` for payload shapes)
- kirby_update_site_content update site content, plus confirm (see `kirby://blueprint/site/update-schema` + `kirby://field/{type}/update-schema` for payload shapes)
- kirby_update_user_content update user content, plus confirm (see `kirby://blueprint/user/update-schema` + `kirby://field/{type}/update-schema` for payload shapes)
Environment variables
KIRBY_MCP_HTTP_REMOTE_TOKENKIRBY_MCP_HTTP_REMOTE_TOKEN_IDKIRBY_HOSTKIRBY_MCP_HOSTKIRBY_MCP_HTTP_TOKENKIRBY_MCP_HTTP_HOSTKIRBY_MCP_HTTP_PORT
Links
★ 53 GitHub stars