> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AppSignal MCP

<Tip>
  AppSignal MCP is currently in preview. Join our{" "}
  <a href="https://discord.gg/fT2cbMuQSJ">Discord community</a> to help test and
  shape this implementation.
</Tip>

[Model Context Protocol (MCP)][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][github-repo] is available.

## Connect your AI tool

Pick your AI tool to set up AppSignal MCP:

<CardGroup cols={3}>
  <Card title="Claude Code" icon="terminal" href="/mcp/setup#claude-code">
    Add the endpoint with `claude mcp add`.
  </Card>

  <Card title="Cursor" icon="i-cursor" href="/mcp/setup#cursor">
    Add AppSignal to `~/.cursor/mcp.json`.
  </Card>

  <Card title="Windsurf" icon="wind" href="/mcp/setup#windsurf">
    Add AppSignal to your Windsurf MCP config.
  </Card>

  <Card title="Zed" icon="bolt" href="/mcp/setup#zed">
    Add AppSignal to Zed's `context_servers`.
  </Card>

  <Card title="VS Code" icon="code" href="/mcp/setup#vs-code">
    Add AppSignal to `.vscode/mcp.json`.
  </Card>

  <Card title="GitHub Copilot CLI" icon="github" href="/mcp/setup#github-copilot-cli">
    Add the endpoint with `copilot mcp add`.
  </Card>

  <Card title="Gemini CLI" icon="terminal" href="/mcp/setup#gemini-cli">
    Add AppSignal to `~/.gemini/settings.json`.
  </Card>

  <Card title="Claude app" icon="comment" href="/mcp/setup#claude-app">
    Add AppSignal as a custom connector.
  </Card>

  <Card title="OpenAI Codex" icon="robot" href="/mcp/setup#openai-codex">
    Add the streamable HTTP endpoint in Codex.
  </Card>
</CardGroup>

## 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](/mcp/reference#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](/mcp/reference). To set AppSignal MCP up in your editor or app, see [Set up AppSignal MCP](/mcp/setup).

[mcp]: https://modelcontextprotocol.io/introduction

[github-repo]: https://github.com/appsignal/appsignal-mcp