PHPackages                             inspector-apm/mcp-server - 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 &amp; Monitoring](/categories/logging)
4. /
5. inspector-apm/mcp-server

AbandonedLibrary[Logging &amp; Monitoring](/categories/logging)

inspector-apm/mcp-server
========================

Inspector MCP Server

1.2.3(8mo ago)71972MITPHPPHP ^8.1CI passing

Since Aug 19Pushed 8mo agoCompare

[ Source](https://github.com/inspector-apm/mcp-server)[ Packagist](https://packagist.org/packages/inspector-apm/mcp-server)[ RSS](/packages/inspector-apm-mcp-server/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (9)Dependencies (6)Versions (11)Used By (0)

Inspector MCP Server
====================

[](#inspector-mcp-server)

Inspector MCP Server was built specifically for the PHP ecosystem; this server provides tools to allow AI coding agents to access production errors data with comprehensive context, to automatically fix issues, and to provide actionable recommendations for root cause analysis and resolution strategies.

STDIO Transport (install in your local machine)
-----------------------------------------------

[](#stdio-transport-install-in-your-local-machine)

### Install

[](#install)

You can install the MCP server as a dev-dependency in your project:

```
composer require inspector-apm/mcp-server --dev

```

### Client Configuration

[](#client-configuration)

The configuration below is for the MCP client like coding agents (Claude Code, Gemini Code Assist, etc), or agentic IDEs like Jetbrains, Windsurf, Cursor, etc.

```
{
    "mcpServers": {
        "inspector": {
            "command": "php",
            "args": [
                "absolute-path-to-your-app-vendor-folder/inspector-apm/mcp-server/server.php"
            ],
            "env": {
                "INSPECTOR_API_KEY": "xxxx", // Inspector API key (https://app.inspector.dev/account/api)
                "INSPECTOR_APP_ID": "xxxx" // The App ID on the Inspector dashboard
            }
        }
    }
}
```

You need three information to complete this configuration:

- **Absolute path of the vendor folder**: This is the root path where the vendor folder of your project is located in your computer. The next part is the path to point to the file that runs the MCP server (inspector-apm/mcp-server/server.php)
- **INSPECTOR\_API\_KEY**: [Click Here](https://app.inspector.dev/account/api) to generate a new API key
- **INSPECTOR\_APP\_ID**: This is the unique identifier of your application inside Inspector. You can get this information in the Application Settings menu in the Inspector dashboatrd

You can get the MCP configuration for your application by navigating to the *Application Settings* section in the [Inspector dashboard](https://app.inspector.dev).

### Claude Code Configuration

[](#claude-code-configuration)

Once you have the information above you can connect the Inspector MCP server to Claude Code with the command below:

```
claude mcp add inspector --env INSPECTOR_API_KEY=YOUR_KEY --env INSPECTOR_APP_ID=YOUR_APP_ID -- php absolute_path_to_your_app_vendor_folder/inspector-apm/mcp-server/server.php

```

For other agents check out their documentation on how to connect to local (STDIO) MCP servers.

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

[](#available-tools)

NameDescriptionPropertiesget\_production\_errorsGet recent production errors to debug and fix application issues. Returns a comprehensive analysis of errors, including frequency, severity, affected code locations, and AI-powered recommendations for resolution. Use this tool when investigating application problems, performance issues, or when you need to understand what's currently broken in production. Essential for proactive debugging and maintaining application reliability.(int) $hours
(int) $limitget\_error\_analysisGet detailed error analysis from the production environment including the actual application source file (not just library stack traces), error patterns, code context, occurrence frequency, and structured debugging guidance to help you fix the issue quickly.(string) $group\_hashworst\_performing\_transactionsRetrieve the list of the ten worst performing transactions in the selected time range (24 hours by default). A transaction represents an execution cycle of the application. It could be an HTTP request, a background job, or a console command.(int) $hours
(int) $limittransaction\_detailsRetrieve the transaction details and the timeline of all tasks executed during the transaction. The timeline includes the start and duration of each task (database queries, cache commands, call to external http services, and so on).(int) $hoursWhat It Does
------------

[](#what-it-does)

Transform your AI coding assistant into a production-aware debugging partner:

- **🔍 Smart Error Analysis** - AI agents can fetch and analyze recent production errors with comprehensive context
- **📊 Intelligent Prioritization** - Automatic error classification by frequency, severity, and recency
- **💡 Actionable Recommendations** - AI-powered suggestions for root cause analysis and resolution strategies
- **🎯 Code-Level Insights** - Direct integration with stack traces and application source code locations
- **⚡ Developer Experience** - Optimized for modern PHP development workflows, including Neuron AI framework

Key Features
------------

[](#key-features)

### Production Error Monitoring

[](#production-error-monitoring)

- Retrieve errors from the last 24 hours with detailed context
- Frequency analysis and trend detection
- Real-time error status and recency indicators

### AI-Optimized Reporting

[](#ai-optimized-reporting)

- LLM-friendly error formatting for maximum comprehension
- Pattern detection for recurring issues
- Automated categorization of error types (API issues, database problems, performance bottlenecks)

### Developer-Centric Design

[](#developer-centric-design)

- Framework-agnostic PHP integration
- Comprehensive stack trace analysis
- Direct code location references for faster debugging

Perfect For
-----------

[](#perfect-for)

- **PHP Developers** building modern applications who want AI-assisted debugging
- **Teams using Inspector.dev** for production monitoring
- **[Neuron AI Framework](https://neuron-ai.dev)** users leveraging AI agents in their development workflow
- **DevOps Engineers** seeking intelligent error analysis and resolution guidance

About
-----

[](#about)

This MCP server is developed by the team behind [Inspector.dev](https://inspector.dev)and the [Neuron AI framework](https://neuron.dev), bringing enterprise-grade monitoring capabilities to AI-powered applications.

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance59

Moderate activity, may be stable

Popularity20

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~1 days

Total

9

Last Release

258d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/320345fbe48c7cff2b3a25992c8207e959ae7817fb2fb97bb176dc6e559aacf5?d=identicon)[valerione](/maintainers/valerione)

---

Top Contributors

[![ilvalerione](https://avatars.githubusercontent.com/u/13559278?v=4)](https://github.com/ilvalerione "ilvalerione (79 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/inspector-apm-mcp-server/health.svg)

```
[![Health](https://phpackages.com/badges/inspector-apm-mcp-server/health.svg)](https://phpackages.com/packages/inspector-apm-mcp-server)
```

###  Alternatives

[honeybadger-io/honeybadger-php

Honeybadger PHP library

381.5M4](/packages/honeybadger-io-honeybadger-php)

PHPackages © 2026

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