Building Powerful AI Tools with Laravel: A Complete Guide to MCP Integration

composer create-project laravel/laravel mcp-laravel-demo
cd mcp-laravel-demo
composer require php-mcp/laravel

php artisan vendor:publish --provider="PhpMcp\Laravel\McpServiceProvider"

// app/Services/CalculatorService.php
<?php

namespace App\Services;

class CalculatorService
{
    public function add(float $a, float $b): float
    {
        return $a + $b;
    }

    public function multiply(float $x, float $y): float
    {
        return $x * $y;
    }
}

// app/Services/EmailService.php
<?php

namespace App\Services;

use Illuminate\Mail\Mailable;
use Illuminate\Support\Facades\Mail;

class EmailService
{
    public function __invoke(
        string $to,
        string $subject,
        string $message,
        ?string $from = null
    ): array {
        try {
            // In a real application, you'd create a proper Mailable
            Mail::raw($message, function ($mail) use ($to, $subject, $from) {
                $mail->to($to)
                     ->subject($subject);
                if ($from) {
                    $mail->from($from);
                }
            });

            return [
                'success' => true,
                'message' => 'Email sent successfully',
                'to' => $to,
                'subject' => $subject
            ];
        } catch (\Exception $e) {
            return [
                'success' => false,
                'error' => $e->getMessage()
            ];
        }
    }
}

// app/Services/UserService.php
<?php

namespace App\Services;

class UserService
{
    public function getSettings(): array
    {
        return [
            'app_name' => config('app.name'),
            'timezone' => config('app.timezone'),
            'locale' => config('app.locale'),
            'debug' => config('app.debug'),
        ];
    }

    public function getUserProfile(string $userId): array
    {
        // In a real application, you'd fetch from database
        return [
            'id' => $userId,
            'name' => "User {$userId}",
            'email' => "user{$userId}@example.com",
            'created_at' => now()->toISOString(),
        ];
    }
}

// app/Services/PromptService.php
<?php

namespace App\Services;

class PromptService
{
    public function generate_prompt(string $context): string
    {
        $templates = [
            'business' => "Welcome to our professional platform! We're here to help you achieve your business goals with {$context}.",
            'casual' => "Hey there! Great to see you here. Let's explore {$context} together!",
            'technical' => "Welcome to the system. You now have access to {$context} functionality.",
        ];

        $style = array_rand($templates);
        return $templates[$style];
    }
}

// === VALIDATION TOOLS ===

// Email validation
Mcp::tool(function (string $email): array {
    $isValid = filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
    return [
        'email' => $email,
        'is_valid' => $isValid,
        'domain' => $isValid ? explode('@', $email)[1] : null,
    ];
})
    ->name('validate_email')
    ->description('Validate email address and extract domain');

// Phone validation with country support
Mcp::tool(function (string $phone, string $country = 'FR'): array {
    $cleaned = preg_replace('/[^0-9+]/', '', $phone);
    $patterns = [
        'FR' => '/^(\+33|0)[1-9](\d{8})$/',
        'US' => '/^(\+1)?[2-9]\d{2}[2-9]\d{6}$/',
        'UK' => '/^(\+44|0)[1-9]\d{8,9}$/',
    ];

    $pattern = $patterns[$country] ?? $patterns['FR'];
    $isValid = preg_match($pattern, $cleaned);

    return [
        'phone' => $phone,
        'cleaned' => $cleaned,
        'is_valid' => (bool) $isValid,
        'country' => $country,
    ];
})
    ->name('validate_phone')
    ->description('Validate phone number for different countries');

// JSON validation and parsing
Mcp::tool(function (string $jsonString): array {
    json_decode($jsonString);
    $error = json_last_error();

    return [
        'json' => $jsonString,
        'is_valid' => $error === JSON_ERROR_NONE,
        'error' => $error !== JSON_ERROR_NONE ? json_last_error_msg() : null,
        'parsed' => $error === JSON_ERROR_NONE ? json_decode($jsonString, true) : null,
    ];
})
    ->name('validate_json')
    ->description('Validate JSON string and parse it');

// URL validation with component extraction
Mcp::tool(function (string $url): array {
    $isValid = filter_var($url, FILTER_VALIDATE_URL) !== false;
    $parsed = $isValid ? parse_url($url) : null;

    return [
        'url' => $url,
        'is_valid' => $isValid,
        'scheme' => $parsed['scheme'] ?? null,
        'host' => $parsed['host'] ?? null,
        'path' => $parsed['path'] ?? null,
        'is_https' => ($parsed['scheme'] ?? '') === 'https',
    ];
})
    ->name('validate_url')
    ->description('Validate URL and extract components');

php artisan serve --host=127.0.0.1 --port=8000

{
  "mcpServers": {
    "my-laravel-app": {
      "command": "curl",
      "args": [
        "-X", "POST",
        "-H", "Content-Type: application/json",
        "http://127.0.0.1:8000/mcp"
      ]
    }
  }
}