MCP Development

When to Apply

Activate this skill when:

• •Creating MCP tools, resources, or prompts
• •Setting up MCP server routes
• •Debugging MCP connection issues

Documentation

Use search-docs for detailed Laravel MCP patterns and documentation.

Basic Usage

Register MCP servers in routes/ai.php:

use Laravel\Mcp\Facades\Mcp;

Mcp::web();

Creating MCP Primitives

Create MCP tools, resources, prompts, and servers using artisan commands:

{{ $assist->artisanCommand('make:mcp-tool ToolName') }}        # Create a tool

{{ $assist->artisanCommand('make:mcp-resource ResourceName') }} # Create a resource

{{ $assist->artisanCommand('make:mcp-prompt PromptName') }}    # Create a prompt

{{ $assist->artisanCommand('make:mcp-server ServerName') }}    # Create a server

After creating primitives, register them in your server's $tools, $resources, or $prompts properties.

Tools

use Laravel\Mcp\Server\Tool;
use Laravel\Mcp\Server\Request;
use Laravel\Mcp\Server\Response;

class MyTool extends Tool
{
    public function handle(Request $request): Response
    {
        return new Response(['result' => 'success']);
    }
}

Verification

1. •Check routes/ai.php for proper registration
2. •Test tool via MCP client

Common Pitfalls

• •Running mcp:start command (it hangs waiting for input)
• •Using HTTPS locally with Node-based MCP clients
• •Not using search-docs for the latest MCP documentation
• •Not registering MCP server routes in routes/ai.php
• •Do not register ai.php in bootstrap.php; it is registered automatically.