Download the PHP package lucianotonet/laravel-telescope-mcp without Composer

On this page you can find all versions of the php package lucianotonet/laravel-telescope-mcp. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package laravel-telescope-mcp

Latest Version on Packagist Downloads

Laravel Telescope MCP

An extension for Laravel Telescope that exposes telemetry data via the Model Context Protocol (MCP) to AI assistants (e.g., Cursor, Claude, Copilot Chat). Ideal for developers who use Telescope to inspect application metrics and require quick, precise insights.

Overview

Telescope MCP exposes all Laravel Telescope telemetry data via the Model Context Protocol (MCP), enabling AI assistants to directly access and analyze application metrics. This provides developers with instant insights into logs, slow queries, HTTP requests, exceptions, jobs, and more through natural language queries.

Status: ✅ 19 MCP tools fully operational and integrated

Installation

Make sure you have Laravel Telescope properly installed and configured in your application before proceeding

  1. Add the package via Composer:

  2. Publish the configuration (optional):

  3. Update your .env (optional):

    You can now verify the installation by accessing http://localhost:8000/telescope-mcp/manifest.json in your browser

Connecting an AI Client

For Cursor (example):

  1. Open Cursor command palette (Cmd/Ctrl+Shift+P).
  2. Run View: Open MCP Settings.
  3. Add this configuration:

    Important: Use 127.0.0.1 instead of localhost to avoid IPv6 connection issues Make sure the URL matches your .env configuration, combining APP_URL with TELESCOPE_MCP_PATH

  4. For HTTPS, you can omit --allow-http and NODE_TLS_REJECT_UNAUTHORIZED like this:

Troubleshooting

Connection Refused Error

If you encounter ECONNREFUSED errors when trying to connect:

Problem: The MCP client is trying to connect via IPv6 (::1) but your Laravel server only accepts IPv4 connections.

Solution: Use 127.0.0.1 instead of localhost in your MCP configuration URL.

Example:

Alternative: If you prefer using localhost, you can start your Laravel server with IPv6 support:

MCP Tool Issues

Problem: Some tools may show empty results or errors.

Solutions:

  1. Ensure Telescope is recording data: Check if your application is generating the type of data you're querying
  2. Verify tool parameters: Some tools require specific parameters (e.g., slow: true for queries)
  3. Check data freshness: Some tools may not have recent data depending on your application activity

Tool-specific notes:

Quick Start

1. Install and Configure

2. Connect MCP Client

Add to your Cursor MCP settings:

3. Start Using MCP Tools

Usage Examples

Direct MCP Tool Usage (Recommended)

Once connected, you can use the MCP tools directly in your AI assistant:

Natural Language Queries

The AI will automatically use the appropriate MCP tools to fetch and analyze the data.

Available Tools

All 19 MCP tools are fully operational and provide structured responses with both human-readable text and JSON data.

Tool Status Description Key Parameters
Requests Records incoming HTTP requests id, limit, method, status, path
Exceptions Tracks application errors with stack traces id, limit
Queries Monitors database queries with performance metrics id, limit, slow (boolean)
Logs Records application logs with filtering id, limit, level, message
HTTP Client Monitors outgoing HTTP requests id, limit, method, status, url
Mail Monitors email operations id, limit, to, subject
Notifications Records notification dispatches id, limit, channel, status
Jobs Tracks queued job executions id, limit, status, queue
Events Monitors event dispatches id, limit, name
Models Tracks Eloquent model operations id, limit, action, model
Cache Monitors cache operations id, limit, operation, key
Redis Tracks Redis operations id, limit, command
Schedule Monitors scheduled task executions id, limit
Views Records view renders id, limit
Dumps Records var_dump and dd() calls id, limit, file, line
Commands Tracks Artisan command executions id, limit, command, status
Gates Records authorization checks id, limit, ability, result
Batches Lists and analyzes batch operations id, limit, status, name
Prune ⚠️ Removes old Telescope entries hours

Legend: ✅ Fully Operational | ⚠️ Minor Issues

Current Status & Features

MCP Integration Status

🚀 Key Benefits

📊 Response Format

Each MCP tool provides:

🔧 Tool Capabilities

Configuration

Advanced

See config/telescope-mcp.php for:

Performance & Monitoring

Real-time Insights

Data Retention

Contributing

Contributions are welcome. Please submit issues or pull requests following our CONTRIBUTING.md guidelines.

License

Licensed under MIT. See LICENSE for details.


All versions of laravel-telescope-mcp with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
laravel/framework Version ^10.0|^11.0|^12.0
laravel/telescope Version ^4.0|^5.0|^6.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package lucianotonet/laravel-telescope-mcp contains the following files

Loading the files please wait ....