laravel-mcp

Laravel MCP

Comprehensive guide for building MCP (Model Context Protocol) servers with Laravel. Contains 7 rules across 5 categories for exposing tools, prompts, and resources to AI clients.

When to Apply

Reference these guidelines when:

• Creating MCP servers (web or local)
• Building tools that AI clients can call
• Defining prompts for reusable AI interactions
• Exposing resources for AI context
• Protecting MCP servers with OAuth or Sanctum
• Testing MCP servers, tools, prompts, and resources

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	Servers	CRITICAL	server-
2	Tools	HIGH	tool-
3	Prompts & Resources	MEDIUM	prompt-, resource-
4	Authentication	HIGH	auth-
5	Testing	HIGH	test-

Quick Reference

1. Servers (CRITICAL)

• server-create-register - Create and register web or local MCP servers

2. Tools (HIGH)

• tool-create - Create tools with input/output schemas, DI, and annotations
• tool-responses - Text, error, structured, streaming, and multi-content responses

3. Prompts & Resources (MEDIUM)

• prompt-create - Create prompts with arguments, validation, and responses
• resource-create - Create resources and resource templates with URI patterns

4. Authentication (HIGH)

• auth-protect - Protect servers with OAuth 2.1, Sanctum, or custom auth

5. Testing (HIGH)

• test-unit - Test with MCP Inspector and unit tests

Essential Patterns

Creating an MCP Server

<?php

namespace App\Mcp\Servers;

use Laravel\Mcp\Server;
use Laravel\Mcp\Server\Attributes\Instructions;
use Laravel\Mcp\Server\Attributes\Name;
use Laravel\Mcp\Server\Attributes\Version;

#[Name('Weather Server')]
#[Version('1.0.0')]
#[Instructions('This server provides weather information.')]
class WeatherServer extends Server
{
    protected array $tools = [
        CurrentWeatherTool::class,
    ];

    protected array $resources = [];

    protected array $prompts = [];
}