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();
</code-snippet>Creating MCP Primitives
Create MCP tools, resources, prompts, and servers using artisan commands:
<code-snippet name="MCP Artisan Commands" lang="bash">{{ $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
</code-snippet>After creating primitives, register them in your server's $tools, $resources, or $prompts properties.
Tools
<code-snippet name="MCP Tool Example" lang="php">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']); } }
</code-snippet>Verification
- •Check
routes/ai.phpfor proper registration - •Test tool via MCP client
Common Pitfalls
- •Running
mcp:startcommand (it hangs waiting for input) - •Using HTTPS locally with Node-based MCP clients
- •Not using
search-docsfor the latest MCP documentation - •Not registering MCP server routes in
routes/ai.php - •Do not register
ai.phpinbootstrap.php; it is registered automatically.