PHPackages                             skylence/laravel-telescope-mcp - 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. [API Development](/categories/api)
4. /
5. skylence/laravel-telescope-mcp

ActiveLibrary[API Development](/categories/api)

skylence/laravel-telescope-mcp
==============================

A simple MCP (Model Context Protocol) server package for Laravel - Easy to extend with custom tools and JSON-RPC 2.0 compliant

v1.3.0(2mo ago)0348↓33.3%MITPHPPHP ^8.1|^8.2|^8.3|^8.4

Since Nov 2Pushed 2mo agoCompare

[ Source](https://github.com/skylence-be/laravel-telescope-mcp)[ Packagist](https://packagist.org/packages/skylence/laravel-telescope-mcp)[ Docs](https://github.com/skylence-be/telescope-mcp)[ RSS](/packages/skylence-laravel-telescope-mcp/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (10)Versions (6)Used By (0)

Laravel Telescope MCP
=====================

[](#laravel-telescope-mcp)

A powerful MCP (Model Context Protocol) server for Laravel Telescope, providing real-time monitoring, performance analysis, and debugging through Claude Code and other MCP clients.

Features
--------

[](#features)

- **STDIO &amp; HTTP Support** - Use with Claude Code (stdio) or any HTTP client
- **Route Type Filtering** - Separate analysis for API vs Web routes (including Filament panels)
- **Performance Monitoring** - Request times, query analysis, N+1 detection
- **Health Scoring** - Context-aware health scores with different thresholds per route type
- **Exception Tracking** - Monitor and analyze application errors
- **Queue Monitoring** - Track job execution and failures
- **Cache Analysis** - Hit rates and operation tracking

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

[](#installation)

```
composer require skylence/laravel-telescope-mcp
```

Publish configuration (optional):

```
php artisan vendor:publish --tag=telescope-mcp-config
```

Configuration
-------------

[](#configuration)

### Claude Code (STDIO Mode)

[](#claude-code-stdio-mode)

Add to your `.mcp.json`:

```
{
  "mcpServers": {
    "telescope": {
      "type": "stdio",
      "command": "php",
      "args": ["artisan", "mcp:start", "telescope"]
    }
  }
}
```

### Environment Variables

[](#environment-variables)

```
TELESCOPE_MCP_ENABLED=true
TELESCOPE_MCP_AUTH_ENABLED=false
TELESCOPE_MCP_SLOW_REQUEST_MS=1000
TELESCOPE_MCP_SLOW_QUERY_MS=100
```

Route Type Filtering
--------------------

[](#route-type-filtering)

Routes are automatically categorized by middleware for separate analysis:

```
// config/telescope-mcp.php
'overview' => [
    'route_groups' => [
        'api' => [
            'middleware' => ['api'],
        ],
        'web' => [
            'middleware' => ['web', 'panel:*'], // Includes Filament panels
        ],
    ],
    'thresholds' => [
        'api' => [
            'slow_request_ms' => 500,      // APIs should be fast
            'acceptable_error_rate' => 0.01,
        ],
        'web' => [
            'slow_request_ms' => 1500,     // Web pages can be slower
            'acceptable_error_rate' => 0.05,
        ],
    ],
],
```

The `panel:*` wildcard matches Filament panel middleware (e.g., `panel:app`, `panel:admin`).

Available Tools
---------------

[](#available-tools)

### telescope\_overview

[](#telescope_overview)

System health overview with performance metrics and route breakdown.

```
telescope_overview(period="1h", route_type="all", include_breakdown=true)

```

### requests

[](#requests)

HTTP request analysis with filtering by route type.

```
requests(action="stats", route_type="api", period="1h")
requests(action="slow", route_type="web", min_duration=1000)

```

### queries

[](#queries)

Database query analysis and N+1 detection.

```
queries(action="stats", period="1h")
queries(action="slow", min_time=100)
queries(action="duplicates")

```

### exceptions

[](#exceptions)

Exception and error tracking.

```
exceptions(action="list", period="24h")
exceptions(action="stats")

```

### jobs

[](#jobs)

Queue job monitoring.

```
jobs(action="stats", period="1h")
jobs(action="failed")

```

### cache

[](#cache)

Cache operation analysis.

```
cache(action="stats", period="1h")

```

### logs

[](#logs)

Application log entries.

```
logs(action="list", level="error", period="1h")

```

Quick Examples
--------------

[](#quick-examples)

**Health check:**

```
telescope_overview(period="1h", route_type="all")

```

**API-specific monitoring:**

```
telescope_overview(period="1h", route_type="api")
requests(action="stats", route_type="api")

```

**Find slow endpoints:**

```
requests(action="slow", route_type="api", min_duration=500)

```

**Detect N+1 queries:**

```
queries(action="duplicates", period="1h")

```

Health Scoring
--------------

[](#health-scoring)

Health scores (0-100) are calculated with context-aware thresholds:

ScoreStatusDescription90-100healthyEverything optimal70-89goodMinor issues50-69warningNeeds attention0-49criticalImmediate action requiredAPI and web routes use different thresholds - APIs are judged more strictly.

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

[](#requirements)

- PHP 8.1+
- Laravel 10, 11, or 12
- Laravel Telescope

License
-------

[](#license)

MIT

###  Health Score

45

—

FairBetter than 93% of packages

Maintenance87

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 82.1% 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 ~45 days

Total

4

Last Release

60d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8ad0eeb3e0f0183e243d7edf649313243750f8048918eb00c9c041c5dc379149?d=identicon)[skylence](/maintainers/skylence)

---

Top Contributors

[![jonasvanderhaegen-xve](https://avatars.githubusercontent.com/u/216873699?v=4)](https://github.com/jonasvanderhaegen-xve "jonasvanderhaegen-xve (23 commits)")[![jonasvanderhaegen](https://avatars.githubusercontent.com/u/7755555?v=4)](https://github.com/jonasvanderhaegen "jonasvanderhaegen (5 commits)")

---

Tags

apilaravelmcpaijson-rpctoolscursorclaudeModel Context Protocol

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/skylence-laravel-telescope-mcp/health.svg)

```
[![Health](https://phpackages.com/badges/skylence-laravel-telescope-mcp/health.svg)](https://phpackages.com/packages/skylence-laravel-telescope-mcp)
```

###  Alternatives

[cboxdk/statamic-mcp

MCP (Model Context Protocol) server for Statamic CMS v6 — gives AI assistants structured access to content, blueprints, assets, and more.

225.6k](/packages/cboxdk-statamic-mcp)[wordpress/mcp-adapter

Adapter for Abilities API, letting WordPress abilities to be used as MCP tools, resources or prompts

74855.8k1](/packages/wordpress-mcp-adapter)[php-mcp/laravel

Laravel SDK for building Model Context Protocol (MCP) servers - Seamlessly integrate MCP tools, resources, and prompts into Laravel applications

47283.1k1](/packages/php-mcp-laravel)[vizra/vizra-adk

Vizra Agent Development Kit - A comprehensive Laravel package for building intelligent AI agents.

29026.1k](/packages/vizra-vizra-adk)[mozex/anthropic-laravel

Anthropic PHP for Laravel is a supercharged PHP API client that allows you to interact with the Anthropic API

71226.4k1](/packages/mozex-anthropic-laravel)[claude-php/claude-php-sdk-laravel

Laravel integration for the Claude PHP SDK - Anthropic Claude API

5010.8k](/packages/claude-php-claude-php-sdk-laravel)

PHPackages © 2026

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