statamic-mcp: Instructions file for Claude Code

CLAUDE.md

statamic-mcp CLAUDE.md is an instructions file for Claude Code from cboxdk/statamic-mcp. It costs 15,202 tokens per session, scanned A, original, MIT.

Project instructions for a Statamic add-on that provides an MCP server, a standard way for software tools to share context and actions. It covers the add-on's Laravel, PHP, authentication, dashboard, and testing setup.

In plain words
What is it for?
Use it when developing or maintaining the Statamic MCP add-on, especially its API-token access control, Vue dashboard, web endpoints, and tests.
Why use it?
It gives a coding agent the project-specific rules and dependencies needed to work on the add-on without guessing how it is structured.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: mentions CLAUDE.md; mentions Claude Code.

This is cboxdk/statamic-mcp's own configuration. It tells Claude Code how to work on statamic-mcp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything statamic-mcp configures →

Reuse

Borrowing it

Nothing to install: this file belongs to cboxdk/statamic-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/cboxdk/statamic-mcp/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/cboxdk/statamic-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for statamic-mcp CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/cboxdk/statamic-mcp/claude-md/github.svg)](https://agentmods.dev/instructions/cboxdk/statamic-mcp/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/cboxdk/statamic-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/cboxdk/statamic-mcp/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for statamic-mcp CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/cboxdk/statamic-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/cboxdk/statamic-mcp/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 15,202 This file is loaded in full into every session.
When invoked 15,202 The same file — it is already loaded in full.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.15202 $0.15202
Opus 5.5 $0.06081 $0.06081
Sonnet 5.5 $0.03040 $0.03040
Haiku 4.5 $0.01520 $0.01520

Measured 7d ago against content hash 29f5d7207a04, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

statamic-mcp CLAUDE.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

so they never depend on DNS; `Http::fake()` bypasses curl, so the pinning itself is only
CLAUDE.md · 1,480 lines

How it starts

The opening of the file, as written. The whole thing — 1,480 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a Statamic addon that functions as an MCP (Model Context Protocol) server, built on top of Laravel's MCP server. The addon extends Statamic CMS v6.6+ and requires laravel/mcp ^1.0 as a runtime dependency. It includes scoped API token authentication, a Vue 3 CP dashboard, and web MCP endpoints.

Key Dependencies

  • PHP: ^8.3
  • Statamic CMS: ^6.6 (v6 only — v5 support was removed in v2.0)
  • Laravel: ^12.0 || ^13.0 (via Statamic v6)
  • Laravel MCP: ^1.0 (required - must be in require section, not require-dev)
  • Orchestra Testbench: ^10.0 || ^11.0 (dev dependency for testing)
  • Pest: ^4.1 (stable release with PHP 8.3 requirement)
  • Symfony YAML: ^7.0 || ^8.0 (for YAML processing)

Authentication System

Scoped API Tokens

The addon provides scoped API tokens for fine-grained MCP access control:

  • Token Management: Via Statamic CP dashboard (Tools → MCP → Tokens)
  • Token Storage: Eloquent model (McpToken) with SHA-256 hashed tokens
  • Guard: Custom McpTokenGuard registered as the mcp auth guard
  • Scopes: 21 granular scopes via TokenScope enum (e.g., content:read, content:write, *)

Key Auth Classes

  • src/Auth/TokenScope.php — Backed string enum with scope helpers
  • src/Auth/McpToken.php — Eloquent model with UUID primary keys
  • src/Auth/TokenService.php — Token CRUD, validation, and pruning
  • src/Auth/McpTokenGuard.php — Laravel Guard implementation for Bearer tokens
  • src/Auth/AuthServiceProvider.php — Registers singletons and auth guard

Scope Availability

src/Auth/ScopeAvailability.php decides which scopes a user is offered (dashboard picker, token create/edit, OAuth consent). It mirrors every router's getRequiredPermissions() by hand — a router that changes its permissions must change the matching line there too, or editors get offered dead scopes or lose live ones. It never grants access; the per-call check in checkWebPermissions() still runs. getRequiredPermissions() may return a nested list, meaning "any one of these" (used by the blueprint read actions).

Read the full file on GitHub · 1,480 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago Changed · +11 lines · +186 tokens per session 29f5d7207a04
  2. 17d ago Changed · +67 lines · +1,062 tokens per session 1959050c3928
  3. 24d ago Changed · +10 lines · +203 tokens per session 05bc56df92d5
  4. 1mo ago Changed · +8 lines · +121 tokens per session 7ed669bdfcf6
  5. 1mo ago Changed · +57 lines · +814 tokens per session d735e6a6a5b1
  6. 1mo ago Changed · +143 lines · +2,010 tokens per session d80cbce180ee
  7. 1mo ago Changed · +26 lines · +409 tokens per session d67fcedbeb42
  8. 1mo ago Changed · +45 lines · +707 tokens per session 12e3cc5e5ff5
  9. 2mo ago First seen · 1,113 lines · 9,690 tokens per session scan A 422a0679b9d1

Subscribe to this mod's changes

statamic-mcp CLAUDE.md is an instructions file published in the GitHub repository cboxdk/statamic-mcp (39 stars, last pushed yesterday), licensed MIT. It adds 15,202 tokens to every session, about $0.0608 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

statamic-mcp CLAUDE.md compared with instructions from other repositories

statamic-mcp CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
statamic-mcp CLAUDE.mdcboxdk/statamic-mcpInstructions file39yesterdayMITA15,202Claude Code
data-scientist copilot-instructions.mdrealnghon/data-scientistInstructions file24mo agoMITA373GitHub Copilot
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot