Statamic Boost Icon

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 10, 11, or 12
  • Statamic 5 or 6

Installation

composer require chrisvasey/statamic-boost --dev

Then run the Boost installer to configure your AI tools:

php please boost:install

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.