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.1(1mo ago)2593[1 issues](https://github.com/StuMason/laravel-kick/issues)[2 PRs](https://github.com/StuMason/laravel-kick/pulls)MITPHPPHP ^8.4CI failing

Since Jan 23Pushed 6d 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 3d ago

READMEChangelog (3)Dependencies (16)Versions (13)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 88% of packages

Maintenance85

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 60% 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 ~18 days

Recently: every ~27 days

Total

7

Last Release

51d 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 (15 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (10 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

[laravel/boost

Laravel Boost accelerates AI-assisted development by providing the essential context and structure that AI needs to generate high-quality, Laravel-specific code.

3.5k21.5M601](/packages/laravel-boost)[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[laravel/horizon

Dashboard and code-driven configuration for Laravel queues.

4.2k95.4M307](/packages/laravel-horizon)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

77022.3M151](/packages/laravel-mcp)[illuminate/database

The Illuminate Database package.

2.8k54.9M11.7k](/packages/illuminate-database)[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M201](/packages/laravel-ai)

PHPackages © 2026

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