# Scout Mcp Local

> Scout’s local MCP puts metrics, traces and errors right in your AI agent. For teams that do it all.

- **Type:** MCP server
- **Install:** `agentstack add mcp-scoutapp-scout-mcp-local`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [scoutapp](https://agentstack.voostack.com/s/scoutapp)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 2025.11.4
- **License:** MIT
- **Upstream author:** [scoutapp](https://github.com/scoutapp)
- **Source:** https://github.com/scoutapp/scout-mcp-local
- **Website:** https://www.scoutapm.com/mcp

## Install

```sh
agentstack add mcp-scoutapp-scout-mcp-local
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Scout Monitoring MCP

  

[](https://lobehub.com/mcp/scoutapp-scout-mcp-local)

 Claude Code

```sh
claude mcp add scoutmcp -e SCOUT_API_KEY=your_scout_api_key_here -- docker run --rm -i -e SCOUT_API_KEY scoutapp/scout-mcp-local
```

Cursor

[](https://cursor.com/en/install-mcp?name=scout-apm&config=eyJjb21tYW5kIjoiZG9ja2VyIHJ1biAtLXJtIC1pIC0tZW52IFNDT1VUX0FQSV9LRVkgc2NvdXRhcHAvc2NvdXQtbWNwLWxvY2FsIiwiZW52Ijp7IlNDT1VUX0FQSV9LRVkiOiJ5b3VyX3Njb3V0X2FwaV9rZXlfaGVyZSJ9fQ%3D%3D)

MAKE SURE to update the `SCOUT_API_KEY` value to your actual api key in
  `Arguments` in the Cursor Settings > MCP

VS Code Copilot

- [VS Code Copilot docs](https://code.visualstudio.com/docs/copilot/customization/mcp-servers#_add-an-mcp-server)
    - We recommend the "Add an MCP server to your workspace" option

Claude Desktop

Add the following to your claude config file:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "scout-apm": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--env", "SCOUT_API_KEY", "scoutapp/scout-mcp-local"],
      "env": { "SCOUT_API_KEY": "your_scout_api_key_here"}
    }
  }
}
```

## Using the Scout Monitoring MCP

Scout's MCP is intended to put error and performance data directly in the... hands? of your AI Assistant.
Use it to get traces and errors with line-of-code information that the AI can use to target
fixes right in your editor.

Most assistants will show you both raw tool calls and perform analysis. Desktop assistants
can readily create custom JS applications to explore whatever data you desire.
Assistants integrated into code editors can use trace data and error backtraces to make
fixes right in your codebase.

Combine Scout's MCP with your AI Assistant's other tools to:

- Create rich GitHub/GitLab issues based on errors and performance data
- Make JIRA fun - have your AI Assistant create tickets with all the details
- Generate PRs that fix specific errors and performance problems

### Tools

The Scout MCP provides the following tools for accessing Scout APM data:

- **`list_apps`** - List available Scout APM applications, with optional filtering by last active date
- **`get_app_metrics`** - Get individual metric data (response_time, throughput, etc.) for a specific application
- **`get_app_endpoints`** - Get all endpoints for an application with aggregated performance metrics
- **`get_endpoint_metrics`** - Get timeseries metrics for a specific endpoint in an application
- **`get_app_endpoint_traces`** - Get recent traces for an app filtered to a specific endpoint
- **`get_app_trace`** - Get an individual trace with all spans and detailed execution information
- **`get_app_error_groups`** - Get recent error groups for an app, optionally filtered by endpoint
- **`get_app_insights`** - Get performance insights including N+1 queries, memory bloat, and slow queries

### Resources

The Scout MCP provides configuration templates as resources that your AI assistant can read and apply:

- **`scoutapm://config-resources/{framework}`** - Setup instructions for supported framework or library (rails, django, flask, fastapi)
- **`scoutapm://config-resources/list`** - List all available configuration templates
- **`scoutapm://metrics`** - List of all available metrics for Scout APM

### Useful Prompts

#### Setup & Configuration
- "Help me set up Scout monitoring for my Rails application"
- "Create a Scout APM config file for my Django project with key ABC123"

#### Performance & Monitoring
- "Summarize the available tools in the Scout Monitoring MCP."
- "Find the slowest endpoints for app `my-app-name` in the last 7 days. Generate a table
  with the results including the average response time, throughput, and P95 response time."
- "Show me the highest-frequency errors for app `Foo` in the last 24 hours. Get the
  latest error detail, examine the backtrace and suggest a fix."
- "Get any recent n+1 insights for app `Bar`. Pull the specific trace by id and help me
  optimize it based on the backtrace data."

### Token Usage

We are currently more interested in expanding available information than strictly
controlling response size from our MCP tools. If your AI Assistant has a configurable
token limit (e.g. Claude Code `export MAX_MCP_OUTPUT_TOKENS=50000`), we recommend
setting it generously high, e.g. 50,000 tokens.

## Local Development

We use `uv` and `taskipy` to manage environments and run tasks for this project.

### Run with Inspector
```bash
uv run task dev
```
Connect within inspector to add API key, set to STDIO transport

### Build the Docker image
```bash
docker build -t scout-mcp-local .
```

## Release

1. Branch and bump versions with `uv run python bump_versions.py`
1. Get that merged
1. Create a GitHub release with the new version (`gh release create v2025.11.3 --generate-notes --draft`)

For the bots:

mcp-name: com.scoutapm/scout-mcp-local

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [scoutapp](https://github.com/scoutapp)
- **Source:** [scoutapp/scout-mcp-local](https://github.com/scoutapp/scout-mcp-local)
- **License:** MIT
- **Homepage:** https://www.scoutapm.com/mcp

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v2025.11.4 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **2025.11.4** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-scoutapp-scout-mcp-local
- Seller: https://agentstack.voostack.com/s/scoutapp
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.