newrelic-mcp

An MCP server for New Relic — query your observability data from any AI agent or LLM client that supports the Model Context Protocol.

No official New Relic MCP exists yet. This fills that gap.

Tools

Related MCP server: New Relic MCP Server

Quick Start

1. Install

# With uv (recommended)
uv pip install .

# Or with pip
pip install .

2. Configure

Create a .env file (or set environment variables):

NEW_RELIC_API_KEY=NRAK-XXXXXXXXXXXXXXXXXXXXXXXXXXXX
NEW_RELIC_ACCOUNT_ID=1234567
NEW_RELIC_REGION=US

You need a New Relic User API key.

3. Run

# stdio mode (for local MCP clients like Claude Desktop, Kiro, Cursor)
newrelic-mcp

# HTTP mode (for remote access)
newrelic-mcp --transport http --port 8000

4. Connect to your MCP client

Claude Desktop / Kiro / Cursor

Add to your MCP config (e.g. ~/.kiro/settings/mcp.json):

{
  "mcpServers": {
    "newrelic": {
      "command": "newrelic-mcp",
      "env": {
        "NEW_RELIC_API_KEY": "NRAK-XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "NEW_RELIC_ACCOUNT_ID": "1234567"
      }
    }
  }
}

With uvx (no install needed)

{
  "mcpServers": {
    "newrelic": {
      "command": "uvx",
      "args": ["newrelic-mcp"],
      "env": {
        "NEW_RELIC_API_KEY": "NRAK-XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "NEW_RELIC_ACCOUNT_ID": "1234567"
      }
    }
  }
}

Docker

docker compose up -d

Examples

Once connected, you can ask your AI agent things like:

• "What's the error rate for my payments-api in the last hour?"

• "Show me open incidents"

• "What deployed recently to the checkout service?"

• "Run this NRQL: SELECT count(*) FROM Transaction SINCE 1 day ago FACET appName LIMIT 10"

• "What are the golden signals for auth-service?"

Requirements

• Python 3.11+

• A New Relic account with a User API key

EU Region

If your account is in the EU datacenter, set:

NEW_RELIC_REGION=EU

Development

uv sync --all-extras
uv run ruff check .
uv run mypy src/
uv run pytest

See CONTRIBUTING.md for details.

License

MIT — see LICENSE.