home / mcp / appsignal mcp server

Appsignal MCP Server

Fetches incident data from AppSignal via MCP, including incidents, samples, and analysis prompts.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "c20020207-mcp-appsignal": {
      "command": "npx",
      "args": [
        "mcp-appsignal"
      ],
      "env": {
        "APPSIGNAL_APP_ID": "YOUR_APP_ID",
        "APPSIGNAL_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

You can connect to AppSignal through this MCP server to fetch incident details, samples, and the full list of incidents. It provides practical endpoints and tools to analyze incidents and suggest fixes, enabling you to build workflows that monitor and respond to AppSignal errors efficiently.

How to use

You use an MCP client to interact with the AppSignal MCP server. Start by ensuring the server is running with your AppSignal credentials. You can then list incidents, fetch a specific incident by number, or retrieve samples for deeper analysis. For enhanced workflows, you can run analysis prompts to gain insights and recommended fixes based on incident data.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

Install the AppSignal MCP server globally with npm.

npm install -g mcp-appsignal

Run the server using the CLI and provide your AppSignal credentials as environment variables.

export APPSIGNAL_API_TOKEN=your-api-token
export APPSIGNAL_APP_ID=your-app-id

mcp-appsignal

Alternatively, you can configure the server to run via Cursor by specifying the stdio command and environment variables.

{
  "mcp": {
    "servers": {
      "appsignal": {
        "command": "npx",
        "args": ["mcp-appsignal"],
        "env": {
          "APPSIGNAL_API_TOKEN": "your-api-token",
          "APPSIGNAL_APP_ID": "your-app-id"
        }
      }
    }
  }
}

Additional content

Configuration for what you can access includes the following MCP resources and tools. Use these to fetch details, samples, or to list incidents, and to run analytical prompts.

MCP Resources
- `appsignal://incident/{incidentNumber}` — Get details about a specific incident
- `appsignal://incident/{incidentNumber}/sample/{sampleId?}` — Get a sample for a specific incident
- `appsignal://incidents` — List all incidents

MCP Tools - getIncident — Fetch an incident by number - getIncidentSample — Fetch a sample for a specific incident - listIncidents — List incidents with optional filtering

MCP Prompts - analyzeIncident — Analyze an incident and provide insights - suggestFixes — Suggest fixes for an error

Available tools

getIncident

Fetch an incident by its number from AppSignal via the MCP server.

getIncidentSample

Fetch a sample for a specific incident to inspect details or replicate issues.

listIncidents

List incidents with optional filtering to help you monitor current and past issues.

analyzeIncident

Analyze an incident and provide actionable insights based on incident data.

suggestFixes

Provide suggested fixes for identified errors or incidents.