PHPackages                             cboxdk/statamic-mcp - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. cboxdk/statamic-mcp

ActiveLibrary[API Development](/categories/api)

cboxdk/statamic-mcp
===================

MCP (Model Context Protocol) server for Statamic CMS v6 — gives AI assistants structured access to content, blueprints, assets, and more.

v2.0.2(1mo ago)225.6k—0%7[1 PRs](https://github.com/cboxdk/statamic-mcp/pulls)MITPHPPHP ^8.3CI passing

Since Sep 3Pushed 1mo agoCompare

[ Source](https://github.com/cboxdk/statamic-mcp)[ Packagist](https://packagist.org/packages/cboxdk/statamic-mcp)[ Docs](https://github.com/cboxdk/statamic-mcp)[ RSS](/packages/cboxdk-statamic-mcp/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (8)Versions (28)Used By (0)

Statamic MCP Server
===================

[](#statamic-mcp-server)

A comprehensive MCP (Model Context Protocol) server for Statamic CMS v6 that provides AI assistants with structured access to Statamic's content management capabilities through a modern router-based architecture.

Requirements
------------

[](#requirements)

- PHP 8.3+
- Laravel 12+
- Statamic 6.6+
- Laravel MCP ^0.6

Installation
------------

[](#installation)

```
# Install via Composer
composer require cboxdk/statamic-mcp

# Run the installation command
php artisan mcp:statamic:install
```

### Recommended: Laravel Boost Integration

[](#recommended-laravel-boost-integration)

We recommend installing **Laravel Boost** alongside this addon for the best experience:

```
composer require laravel/boost --dev
```

**Laravel Boost** provides Laravel-specific tools (Eloquent, database, debugging), while **Statamic MCP Server** provides Statamic-specific tools (blueprints, collections, entries, assets). Together they give your AI assistant complete coverage.

Web MCP Endpoint
----------------

[](#web-mcp-endpoint)

The web MCP endpoint is **enabled by default** after installation. To customize the path:

```
STATAMIC_MCP_WEB_PATH="/mcp/statamic"
```

Create a token in the CP dashboard (Tools > MCP > Tokens), then configure your AI client:

```
{
    "mcpServers": {
        "statamic": {
            "url": "https://your-site.test/mcp/statamic",
            "headers": {
                "Authorization": "Bearer "
            }
        }
    }
}
```

See [Getting Started](docs/getting-started/quickstart.md) for detailed setup or [AI Client Setup](docs/getting-started/ai-clients.md) for client-specific instructions (Claude, Cursor, ChatGPT, Windsurf).

Features
--------

[](#features)

The MCP server organizes Statamic's capabilities into domain routers with action-based routing:

### Blueprint Management — `statamic-blueprints`

[](#blueprint-management--statamic-blueprints)

Actions: `list`, `get`, `create`, `update`, `delete`, `scan`, `generate`, `types`, `validate`

List, inspect, create, and modify blueprints. Generate TypeScript/PHP types from field definitions. Validate blueprints for conflicts and structural integrity.

### Entry Management — `statamic-entries`

[](#entry-management--statamic-entries)

Dedicated entry operations with filtering, search, pagination, status filtering, merge strategies, and bulk operations.

### Term Management — `statamic-terms`

[](#term-management--statamic-terms)

Taxonomy term operations with slug conflict prevention, dependency validation, and relationship mapping.

### Global Management — `statamic-globals`

[](#global-management--statamic-globals)

Global set structure and values management with multi-site support, change tracking, and field-level filtering.

### Structure Management — `statamic-structures`

[](#structure-management--statamic-structures)

Collection, taxonomy, navigation, and site configuration management.

### Asset Management — `statamic-assets`

[](#asset-management--statamic-assets)

Asset container and file operations: upload, move, copy, rename, delete with metadata management.

### User Management — `statamic-users`

[](#user-management--statamic-users)

User CRUD, role assignment, group management with RBAC support.

### System Management — `statamic-system`

[](#system-management--statamic-system)

System info, health checks, cache management (clear/warm), and configuration access.

### Content Workflow Facade — `statamic-content-facade`

[](#content-workflow-facade--statamic-content-facade)

High-level workflow operations: `content_audit` and `cross_reference`.

### Agent Education Tools

[](#agent-education-tools)

- `statamic-system-discover` — Intent-based tool discovery
- `statamic-system-schema` — Tool schema inspection

Architecture
------------

[](#architecture)

### Router-Based Design

[](#router-based-design)

- **11 domain routers** instead of 140+ individual tools
- **Action-based routing**: Each router handles multiple related operations
- **Better AI performance**: Fewer tools to choose from, clearer purposes
- **Single file per domain**: Easy maintenance and testing

### Security

[](#security)

- Scoped API tokens with 21 granular permissions
- OAuth 2.1 authorization server with PKCE and dynamic client registration
- Bearer token + Basic Auth authentication
- Rate limiting per token
- Audit logging for all operations
- Path traversal protection
- PHPStan Level 8 strict typing

### CP Dashboard

[](#cp-dashboard)

Vue 3 dashboard in the Statamic CP (Tools > MCP) with:

- **Connect** — Endpoint URL, client config snippets for Claude/Cursor/ChatGPT/Windsurf
- **Tokens** — Create, list, and revoke API tokens with scope selection
- **Activity** — Audit log of MCP tool calls
- **Settings** — System stats, endpoint status, rate limiting

Configuration
-------------

[](#configuration)

```
php artisan vendor:publish --tag=statamic-mcp-config
```

Key settings in `config/statamic/mcp.php`:

- Web endpoint (enabled, path, HTTPS enforcement)
- Authentication (scoped tokens, token lifetime, audit logging)
- Security (force web mode, audit logging)
- Rate limiting (max attempts per minute)
- Per-domain tool enablement

Development
-----------

[](#development)

```
# Run tests
./vendor/bin/pest
composer test

# Code formatting
./vendor/bin/pint
composer pint

# Static analysis (Level 8)
./vendor/bin/phpstan analyse
composer stan

# Full quality check
composer quality
```

### Quality Standards

[](#quality-standards)

- PHPStan Level 8 with zero errors
- Laravel Pint formatting
- Strict types on all PHP files
- Comprehensive test suite

Example Usage
-------------

[](#example-usage)

```
"What version of Statamic is installed?"
"Show me all blueprints and generate TypeScript types"
"Create a new blog entry with title and content fields"
"List all global sets and their current values"
"Clear all caches and show me the status"
"Analyze this Antlers template for performance issues"

```

Contributing
------------

[](#contributing)

1. Fork the repository
2. Install: `composer install`
3. Test: `./vendor/bin/pest`
4. Quality: `composer quality`
5. Submit pull request

License
-------

[](#license)

MIT License

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance90

Actively maintained with recent releases

Popularity36

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 96.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~12 days

Total

17

Last Release

51d ago

Major Versions

v0.11.0 → v1.0.0-alpha.12025-12-12

v1.0.0-alpha.3 → v2.0.02026-03-18

### Community

Maintainers

![](https://www.gravatar.com/avatar/b9761a79e61f2d5b9d650510dfb3555da18daf38f027aa84012c937e397e39a7?d=identicon)[cboxdk](/maintainers/cboxdk)

---

Top Contributors

[![sylvesterdamgaard](https://avatars.githubusercontent.com/u/2431914?v=4)](https://github.com/sylvesterdamgaard "sylvesterdamgaard (82 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (2 commits)")[![ruttydm](https://avatars.githubusercontent.com/u/5909558?v=4)](https://github.com/ruttydm "ruttydm (1 commits)")

---

Tags

aiclaudeclaude-codedeveloper-toolsdevelopmentlaravel-packagemcpmcp-serverstatamiclaravelmcpaidevelopmenttoolsstatamiccursorclaude

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/cboxdk-statamic-mcp/health.svg)

```
[![Health](https://phpackages.com/badges/cboxdk-statamic-mcp/health.svg)](https://phpackages.com/packages/cboxdk-statamic-mcp)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.2M720](/packages/statamic-cms)[php-mcp/laravel

Laravel SDK for building Model Context Protocol (MCP) servers - Seamlessly integrate MCP tools, resources, and prompts into Laravel applications

47283.1k1](/packages/php-mcp-laravel)[claude-php/claude-php-sdk-laravel

Laravel integration for the Claude PHP SDK - Anthropic Claude API

5010.8k](/packages/claude-php-claude-php-sdk-laravel)[vectorifyai/vectorify-laravel

Vectorify package for Laravel. The fastest way to ask AI about your data.

206.1k](/packages/vectorifyai-vectorify-laravel)[mateffy/laravel-codebase-mcp

An MCP server to give Cursor, Aider, etc. the ability to introspect your Laravel codebase directly, by querying for your models, views, routes and classes without raw file search.

201.1k](/packages/mateffy-laravel-codebase-mcp)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)