Tools: действия агента

php artisan make:mcp-tool LookupOrder

namespace App\Mcp\Tools;

use Laravel\Mcp\Tool;
use Laravel\Mcp\Tool\Response;

class LookupOrder extends Tool
{
    protected string $description = 'Находит заказ по ID.';

    public function handle(Request $request): Response
    {
        $order = Order::find($request->get('order_id'));

        if (!$order) {
            return Response::error('Заказ не найден');
        }

        return Response::text("Заказ #{$order->id}: {$order->status}");
    }
}

public function schema(JsonSchema $schema): array
{
    return [
        'order_id' => $schema->integer()->required(),
        'include_items' => $schema->boolean(),
    ];
}

protected array $tools = [
    LookupOrder::class,
    CreateOrder::class,
];

return Response::text('Текст');
return Response::json(['data' => $value]);
return Response::error('Ошибка');

public function handle(Request $request): Response
{
    $orderId = $request->get('order_id');

    if (!is_int($orderId)) {
        return Response::error('order_id должен быть числом');
    }

    // ...
}