README

MCP server and REST API for Laravel application introspection.

Connect your MCP client directly to your Laravel app. Check health, read logs, inspect queues, run commands - all through natural conversation.

Documentation

Installation

composer require stumason/laravel-kick

Add to .env:

KICK_ENABLED=true
KICK_TOKEN=your-secure-random-token

MCP Setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "my-app": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://your-app.com/mcp/kick",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer your-kick-token"
      }
    }
  }
}

Then ask the LLM:

• "Check the health of my app"
• "Show me the last 20 ERROR entries in the logs"
• "What's failing in the queue?"
• "Clear the config cache"

Available Tools

REST API

The same functionality is available via HTTP:

curl -H "Authorization: Bearer $TOKEN" https://app.com/kick/health
curl -H "Authorization: Bearer $TOKEN" https://app.com/kick/stats
curl -H "Authorization: Bearer $TOKEN" "https://app.com/kick/logs/laravel.log?level=ERROR"
curl -X POST -H "Authorization: Bearer $TOKEN" -d '{"command":"cache:clear"}' https://app.com/kick/artisan

See the API documentation for all endpoints.

Security

• Disabled by default (KICK_ENABLED=false)
• Token-based authentication with scopes
• Artisan command whitelist
• Path traversal protection
• Automatic PII scrubbing from logs

Requirements

• PHP 8.4+
• Laravel 12

License

MIT