What is Laravel Telescope Mcp

laravel-telescope-mcp is an extension for Laravel Telescope that exposes telemetry data via the Model Context Protocol (MCP) to AI assistants, enabling developers to gain quick insights into application metrics.

Use cases

Use cases include querying application logs, analyzing slow queries, monitoring HTTP requests, handling exceptions, and managing jobs through an AI interface.

How to use

To use laravel-telescope-mcp, install it via Composer, optionally publish the configuration, and update your .env file. Connect an AI client like Cursor to access telemetry data through the MCP interface.

Key features

Key features include natural-language query translation into MCP operations, retrieval of Telescope records, and concise responses for logs, slow queries, HTTP requests, exceptions, and jobs.

Where to use

laravel-telescope-mcp can be used in web application development environments where Laravel is employed, particularly for monitoring and debugging applications.

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 translates natural-language queries into MCP operations, retrieves Telescope records, and returns concise responses. This enables developers to query logs, slow queries, HTTP requests, exceptions, jobs, and more using an AI interface.

Installation

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

1. Add the package via Composer:

   composer require lucianotonet/laravel-telescope-mcp
   

2. Publish the configuration (optional):

   php artisan vendor:publish --provider="LucianoTonet\TelescopeMcp\TelescopeMcpServiceProvider"
   

3. Update your .env (optional):

   TELESCOPE_MCP_ENABLED=true
   TELESCOPE_MCP_PATH=telescope-mcp
   

   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:

   {
     "mcpServers": {
       "Laravel Telescope MCP": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "http://localhost:8000/telescope-mcp",
           "--allow-http"
         ],
         "env": {
           "NODE_TLS_REJECT_UNAUTHORIZED": "0"
         }
       }
     }
   }
   

   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:

   {
     "mcpServers": {
       "Laravel Telescope MCP": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "https://example.com/telescope-mcp"
         ]
       }
     }
   }
   

Usage Examples

• “Using your MCP tools, fetch the last 5 error logs.”
• “Identify SQL queries longer than 100ms in the past twenty minutes.”
• “Show all last failed jobs.”
• “Summarize HTTP requests with status >=500 since last hour.”

The AI will parse the query, call the MCP endpoint, analyze results, and return a summary.

Available Tools

Configuration

• Authentication: Protect the MCP endpoint using middleware (e.g., auth:sanctum, auth.basic).
• Endpoint Path: Customize TELESCOPE_MCP_PATH or modify in config/telescope-mcp.php.
• Logging: Enable or disable internal MCP logging.
• Timeouts & Limits: Adjust request timeouts and payload limits as needed.

Advanced

See config/telescope-mcp.php for:

• Custom middleware stacks
• Operation-specific settings
• Route and namespace overrides

Contributing

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

License

Licensed under MIT. See LICENSE for details.