module:mcp

Module: MCP Server

Implement a complete Model Context Protocol (MCP) server on any Laravel project. Gives LLMs and AI agents (Claude Code, Codex, Cursor, etc.) full programmatic access to the application's domain.

Reference implementation: Agent Fleet — 61 tools across 14 domains, dual transport, role-based auth.

---

Usage

/module:mcp [action]

Quick Examples

/module:mcp                    # Full implementation (analyze → scaffold → implement)
/module:mcp analyze            # Only analyze the project and produce a tool plan
/module:mcp add <domain>       # Add MCP tools for a specific domain
/module:mcp sync               # Sync tools with current domain — find missing coverage

---

Actions

1. Full Implementation (Default)

Analyzes the project, scaffolds the MCP server, and implements all tools.

Process:

Phase 1: Analyze the Project

1. Read CLAUDE.md (or README.md) to understand the domain, models, and architecture.

2. Discover domain models — scan for Eloquent models, their relationships, and fillable fields:

# Find all models
find app -name "*.php" -path "*/Models/*" | head -50

# Or use Laravel Boost if available
php artisan model:show

1. Discover actions/services — scan for action classes, service classes, and controllers:

# Find action classes
find app -name "*Action.php" | head -30

# Find controllers
find app -name "*Controller.php" -path "*/Controllers/*" | head -30

1. Discover existing API routes — map what's already exposed:

php artisan route:list --columns=method,uri,name,action --json

1. Identify domain boundaries — group models/actions into logical domains. Example:

User domain:      User, Role, Team
Product domain:   Product, Category, Variant
Order domain:     Order, OrderItem, Payment, Refund

1. Produce a tool plan — for each domain, list the tools to create:

Domain: Order (6 tools)
  - order_list (read) — List orders with status/date filters
  - order_get (read) — Get order details with items
  - order_create (write) — Create a new order
  - order_update (write) — Update order details
  - order_cancel (destructive) — Cancel an order
  - order_refund (write) — Initiate a refund