| name | mcp-development |
| description | Develops MCP servers, tools, resources, and prompts. Activates when creating MCP tools, resources, or prompts; setting up AI integrations; debugging MCP connections; working with routes/ai.php; or when the user mentions MCP, Model Context Protocol, AI tools, AI server, or building tools for AI assistants. |
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
- Check
routes/ai.php for proper registration
- 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.
