Laravel Loop

Use Composer to add Laravel Loop to your Laravel project. This installs the MCP server package and its dependencies.

composer require kirschbaum-development/laravel-loop

Publish the Loop configuration file to your app's config directory so you can customize transport settings, middleware, and driver options.

php artisan vendor:publish --tag="loop-config"

Edit config/loop.php or your .env file to choose between stdio (for local MCP clients), Streamable HTTP, or the legacy SSE transport. For local development, stdio requires no additional setup.

# For Streamable HTTP transport (optional)
LOOP_STREAMABLE_HTTP_ENABLED=true

# For legacy SSE transport (deprecated)
LOOP_SSE_ENABLED=true

In your AppServiceProvider or a dedicated service provider, register built-in toolkits (such as the Laravel Model Toolkit or Filament Toolkit) and define any custom tools your AI assistant should have access to.

use Kirschbaum\Loop\Facades\Loop;

public function boot(): void
{
    Loop::toolkit(\Kirschbaum\Loop\ModelTools\ModelToolkit::make());
    Loop::toolkit(\Kirschbaum\Loop\Filament\FilamentToolkit::make());

    // Custom tool example
    Loop::tool(
        CustomTool::make(name: 'greet', description: 'Greet a user by name')
            ->withStringParameter(name: 'name', required: true)
            ->using(fn(string $name) => "Hello, {$name}!")
    );
}

Run the artisan command to generate the JSON config snippet you'll paste into your MCP client (Claude Desktop, Claude Code, etc.).

php artisan loop:mcp:generate-config

Launch the Loop MCP server for a specific user. The --user-id flag authenticates the session so model tools run with that user's permissions.

php artisan loop:mcp:start --user-id=1

Use the loop:mcp:call artisan command to manually invoke any registered tool and verify it responds correctly before connecting a client.

php artisan loop:mcp:call