Laravel Loop

What is Laravel Loop?

Laravel Loop is a Model Context Protocol (MCP) server built specifically for Laravel applications. It connects Laravel applications with AI assistants (e.g. Claude Code, Cursor, Windsurf) by exposing tools via the MCP protocol, using Prism behind the scenes to build the tools.

How to use Laravel Loop?

Install via Composer (composer require kirschbaum-development/laravel-loop), publish the config (php artisan vendor:publish --tag="loop-config"), and register tools in a service provider (e.g. Loop::toolkit(...)). Then connect an MCP client using STDIO (php artisan loop:mcp:start) or Streamable HTTP/SSE, optionally authenticating with middleware like Sanctum.

Key features of Laravel Loop

• Pre-built toolkits for Laravel models, factories, and Stripe
• Create custom tools with string, number, and other parameters
• Supports STDIO, Streamable HTTP, and HTTP+SSE transports
• Integration with Claude Code, Cursor, Windsurf, and more
• Built-in artisan commands for MCP configuration and testing
• Middleware support to secure HTTP endpoints

Use cases of Laravel Loop

• Connect an AI assistant to your Laravel app to query model data
• Generate test data on demand via Laravel factories from an MCP client
• Build custom AI-powered tools that interact with your application logic
• Expose a Stripe tool to manage payments through natural language commands
• Use Streamable HTTP to avoid running PHP processes for each MCP request

FAQ from Laravel Loop

What transports does Laravel Loop support?

It supports STDIO, Streamable HTTP, and the deprecated HTTP+SSE transport. STDIO is the easiest setup; Streamable HTTP is newer and not yet supported by all MCP clients.

How do I connect Laravel Loop to Claude Code?

Use claude mcp add laravel-loop-mcp php /full/path/to/artisan loop:mcp:start (with optional --user-id, --user-model, and --debug flags).

How can I secure Laravel Loop’s HTTP endpoints?

Configure the streamable_http.middleware or sse.middleware config option. Sanctum is the default middleware recommended for authentication.

Why do I get “Connection failed: MCP error -32000: Connection closed”?

This usually indicates an application error. Check your Laravel logs for more details.

What does “Error: spawn php ENOENT” mean?

The php binary is not in the PATH used by the MCP client. Either add PHP to your shell configuration or use the full path to the PHP binary (find it with which php).