# mcp-development

> 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.

- Author: Renato Dehnhardt
- Repository: baconfy/docker-starter-kit
- Version: 20260208164019
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-08
- Source: https://github.com/baconfy/docker-starter-kit
- Web: https://mule.run/skillshub/@@baconfy/docker-starter-kit~mcp-development:20260208164019

---

---
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`:

<code-snippet name="Register MCP Server" lang="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

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.