PHPackages                             stumason/laravel-kick - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging & Monitoring](/categories/logging)
4. /
5. stumason/laravel-kick

ActiveLibrary[Logging & Monitoring](/categories/logging)

stumason/laravel-kick
=====================

Secure remote introspection and control for Laravel applications via HTTP API and MCP

v0.4.0(3mo ago)2374[1 PRs](https://github.com/StuMason/laravel-kick/pulls)MITPHPPHP ^8.4CI passing

Since Jan 23Pushed 2mo agoCompare

[ Source](https://github.com/StuMason/laravel-kick)[ Packagist](https://packagist.org/packages/stumason/laravel-kick)[ RSS](/packages/stumason-laravel-kick/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (8)Versions (8)Used By (0)

Laravel Kick
============

[](#laravel-kick)

[![Tests](https://github.com/StuMason/laravel-kick/actions/workflows/tests.yml/badge.svg)](https://github.com/StuMason/laravel-kick/actions/workflows/tests.yml)[![Code Style](https://github.com/StuMason/laravel-kick/actions/workflows/lint.yml/badge.svg)](https://github.com/StuMason/laravel-kick/actions/workflows/lint.yml)[![Latest Version](https://camo.githubusercontent.com/09bda461d7cd491a00fccce4b55335b98f95b5a50c467c9687918ae7554e353e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7374756d61736f6e2f6c61726176656c2d6b69636b2e737667)](https://packagist.org/packages/stumason/laravel-kick)[![License](https://camo.githubusercontent.com/1539f3b48d31a064cbd12310f3357628808e7077cdbb491c0208f1b8c52c8249/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7374756d61736f6e2f6c61726176656c2d6b69636b2e737667)](LICENSE)

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](https://stumason.github.io/laravel-kick/)**

Installation
------------

[](#installation)

```
composer require stumason/laravel-kick
```

Add to `.env`:

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

MCP Setup
---------

[](#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
---------------

[](#available-tools)

ToolDescription`kick_health`Database, cache, storage, redis connectivity`kick_stats`CPU, memory, disk, uptime`kick_logs_list`List log files`kick_logs_read`Read logs with filtering`kick_queue_status`Queue overview, failed jobs`kick_queue_retry`Retry failed jobs`kick_artisan_list`List available commands`kick_artisan_run`Execute whitelisted commandsREST API
--------

[](#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](https://stumason.github.io/laravel-kick/api/endpoints/) for all endpoints.

Security
--------

[](#security)

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

Requirements
------------

[](#requirements)

- PHP 8.4+
- Laravel 12

License
-------

[](#license)

MIT

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance84

Actively maintained with recent releases

Popularity20

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 77.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

6

Last Release

107d ago

PHP version history (2 changes)v0.1.0PHP ^8.2

v0.3.0PHP ^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/81944ec9cc7c6d5f0380f888fd5e34f1481dbba5bfdd5af01809529aad5762b4?d=identicon)[StuMason](/maintainers/StuMason)

---

Top Contributors

[![StuMason](https://avatars.githubusercontent.com/u/21249318?v=4)](https://github.com/StuMason "StuMason (14 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")

---

Tags

aidevopshealth-checkintrospectionlaravelmcpmonitoringobservabilityphpself-hostedlaravelmonitoringmcpdevopsintrospection

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/stumason-laravel-kick/health.svg)

```
[![Health](https://phpackages.com/badges/stumason-laravel-kick/health.svg)](https://phpackages.com/packages/stumason-laravel-kick)
```

###  Alternatives

[spatie/laravel-health

Monitor the health of a Laravel application

85810.0M83](/packages/spatie-laravel-health)[inspector-apm/inspector-laravel

Code Execution Monitoring, built for developers.

2332.0M2](/packages/inspector-apm-inspector-laravel)[jackwh/laravel-new-relic

Monitor your Laravel application performance with New Relic

112827.2k](/packages/jackwh-laravel-new-relic)[yadahan/laravel-authentication-log

Laravel Authentication Log provides authentication logger and notification for Laravel.

416632.8k5](/packages/yadahan-laravel-authentication-log)[lucianotonet/laravel-telescope-mcp

MCP Server extension for Laravel Telescope

198.6k](/packages/lucianotonet-laravel-telescope-mcp)[shaffe/laravel-mail-log-channel

A package to support logging via email in Laravel

1286.2k](/packages/shaffe-laravel-mail-log-channel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)