Statamic Boost

Statamic-specific MCP tools and AI guidelines for Laravel Boost. Provides AI assistants with deep knowledge of your Statamic site's structure, content, and configuration.

Features

• 12 MCP Tools for querying Statamic content, blueprints, and configuration
• AI Guidelines for Antlers templating, blueprints, and Statamic best practices
• Environment Detection automatically excludes database tools for flat-file sites
• Seamless Integration with Laravel Boost's MCP server

This package focuses on providing read-only context to AI agents about your Statamic site. If you need full CRUD operations, template analysis, or addon scaffolding, check out cboxdk/statamic-mcp which offers 100+ tools with write capabilities.

Requirements

• PHP 8.2+
• Laravel 11 or 12
• Statamic 5 or 6
• Laravel Boost ^2.0

Installation

composer require chrisvasey/statamic-boost --dev

Then run the Boost installer to generate your AI context files:

php artisan boost:install

This is Laravel Boost's install command. It auto-discovers Statamic Boost's guidelines and includes them in your generated CLAUDE.md / agent context files.

Note: There is also a php artisan statamic-boost:install command (or php please statamic-boost:install). This is a separate command that configures your environment type (Statamic-only, hybrid, or Laravel-only) and then calls boost:install for you. Run it instead of boost:install if you want to be prompted for your environment type.

To install the MCP into your preferred editor/cli, follow the instructions on the Laravel Boost Install Guide.

Available MCP Tools

Tool	Description
statamic_list_collections	List all collections with routes, blueprints, and entry counts
statamic_get_collection_entries	Query entries with filtering by collection, status, and limit
statamic_get_blueprint	Get field definitions for any blueprint
statamic_list_navigations	List navigation trees and their structure
statamic_list_globals	List global sets with their current values
statamic_list_taxonomies	List taxonomies with term counts
statamic_get_asset_containers	List asset containers and their configuration
statamic_list_forms	List forms with fields and submission counts
statamic_list_fieldtypes	List all available fieldtypes
statamic_list_addons	List installed addons with versions
statamic_stache_info	Get Stache cache status and store information
statamic_search_docs	Search Statamic documentation

Configuration

Publish the config file:

php please vendor:publish --tag=statamic-boost-config

Exclude Tools

Disable specific tools in config/statamic-boost.php:

'tools' => [
    'exclude' => [
        \ChrisVasey\StatamicBoost\Mcp\Tools\StacheInfo::class,
    ],
],

Environment Detection

By default, Statamic Boost detects whether your site is "Statamic-centric" (pure flat-file) or a hybrid Laravel app. For Statamic-centric sites, it automatically excludes Laravel Boost's database tools since they're not relevant.

A site is considered Statamic-centric when:

• No custom Eloquent models (beyond User.php)
• Runway addon is not installed
• Users are stored as flat files

Disable auto-detection:

'auto_detect' => false,

AI Guidelines

Statamic Boost includes guidelines for AI assistants covering:

• Antlers templating syntax and patterns
• Blueprint field definitions
• Collection and taxonomy configuration
• Common tags and modifiers
• Statamic CLI commands (php please)
• Best practices for Statamic development

Guidelines are automatically included when you run php please boost:install.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

License

The MIT License (MIT). Please see License File for more information.