Skip to main content
AppSignal MCP is currently in preview. Join our Discord community to help test and shape this implementation.
Model Context Protocol (MCP) enables AI agents, code editors, and chat apps like Claude, Cursor, Windsurf, Zed, VS Code, and GitHub Copilot to interact with external tools and data sources. AppSignal MCP gives those agents direct access to your monitoring data: errors, traces, logs, metrics, and more. AppSignal MCP is a public HTTP endpoint at https://appsignal.com/api/mcp. Most agents connect to it directly. If you’d rather run a local proxy — for example, in an environment that restricts outbound traffic — an optional Docker image is available.

​
Connect your AI tool

Pick your AI tool to set up AppSignal MCP:

Claude Code

Add the endpoint with claude mcp add.

Cursor

Add AppSignal to ~/.cursor/mcp.json.

Windsurf

Add AppSignal to your Windsurf MCP config.

Zed

Add AppSignal to Zed’s context_servers.

VS Code

Add AppSignal to .vscode/mcp.json.

GitHub Copilot CLI

Add the endpoint with copilot mcp add.

Gemini CLI

Add AppSignal to ~/.gemini/settings.json.

Claude app

Add AppSignal as a custom connector.

OpenAI Codex

Add the streamable HTTP endpoint in Codex.

​
What you can access

AppSignal MCP exposes read and write access to your monitoring data across seven areas. Each area maps to a permission you can configure when authenticating: with an MCP token, set each area to read, write, or disabled; with OAuth, all read and write tools are exposed at once. What you get back depends on what your apps send to AppSignal. If your app is not sending logs, get_log_lines will not return anything. AppSignal MCP is a gateway to data AppSignal already has, such as the following:
  • Error incidents (read + write): list and search exceptions, inspect stack traces, update state and severity, assign handlers, and add notes
  • Performance (read): rank slowest actions, pull traces, walk span trees, and inspect span attributes. Sample-based for standard Ruby and Elixir apps; OpenTelemetry traces for apps sending OTel data
  • Anomaly detection (read + write): browse alerts, list existing triggers, and create, update, or archive triggers
  • Logging (read + write): query log lines with AppSignal’s expression syntax, and set up log ingestion rules: filter, trigger, and metrics actions. Particularly powerful for stitching together a customer journey across log sources, errors, and traces in one prompt — see reconstructing a customer journey
  • Metrics (read): discover metric categories (including host_metrics), list metric names and tags, and pull timeseries or aggregated values
  • Dashboards (read + write): create dashboards, and add or update chart visuals
  • App discovery (read): list your applications, environments, namespaces, users, notifiers, log sources, log line actions, deploy markers, and uptime monitors
For the full list of tools, parameters, and example prompts, see the MCP Tool Reference. To set AppSignal MCP up in your editor or app, see Set up AppSignal MCP.