newrelic-mcp

newrelic-mcp

MCP server for New Relic workflows (NRQL, NerdGraph, entity lookup, logs, alerts, dashboards, and service levels).

Prerequisites

• Node.js 22+ (this repo uses npx; .nvmrc is v24)
• New Relic account ID
• New Relic user API key

Required environment variables:

• ACCOUNT_ID (numeric account id)
• API_KEY (New Relic user API key)
• NERDGRAPH_URL (usually https://api.newrelic.com/graphql)

EU region: If your New Relic dashboard is at one.eu.newrelic.com, use https://api.eu.newrelic.com/graphql as your NERDGRAPH_URL instead.

Quick Start

Run the MCP server directly:

# US region (default)
ACCOUNT_ID=123456 \
API_KEY=your_new_relic_user_key \
NERDGRAPH_URL=https://api.newrelic.com/graphql \
npx -y git@github.com:alanhoff/newrelic-mcp.git

# EU region
ACCOUNT_ID=123456 \
API_KEY=your_new_relic_user_key \
NERDGRAPH_URL=https://api.eu.newrelic.com/graphql \
npx -y git@github.com:alanhoff/newrelic-mcp.git

This server speaks MCP over stdio, so it is normally started by an MCP client/agent.

Install In Common CLI Agents

EU region: Replace https://api.newrelic.com/graphql with https://api.eu.newrelic.com/graphql in all configs below if your account is on the EU region.

Codex CLI

Add this to ~/.codex/config.toml:

[mcp_servers.newrelic]
command = "npx"
args = ["-y", "git@github.com:alanhoff/newrelic-mcp.git"]
env = { ACCOUNT_ID = "123456", API_KEY = "your_new_relic_user_key", NERDGRAPH_URL = "https://api.newrelic.com/graphql" }

Verify:

codex mcp list

Claude Code CLI

Use the CLI installer:

claude mcp add-json newrelic '{"type":"stdio","command":"npx","args":["-y","git@github.com:alanhoff/newrelic-mcp.git"],"env":{"ACCOUNT_ID":"123456","API_KEY":"your_new_relic_user_key","NERDGRAPH_URL":"https://api.newrelic.com/graphql"}}'

Verify:

claude mcp get newrelic

Multiple Environments (Staging + Prod)

Name each MCP server with an environment suffix to run staging and prod configs side by side — Claude Code treats each name as a separate server.

claude mcp add-json newrelic-staging '{"type":"stdio","command":"npx","args":["-y","git@github.com:alanhoff/newrelic-mcp.git"],"env":{"ACCOUNT_ID":"111111","API_KEY":"your_staging_api_key","NERDGRAPH_URL":"https://api.newrelic.com/graphql"}}'

claude mcp add-json newrelic-prod '{"type":"stdio","command":"npx","args":["-y","git@github.com:alanhoff/newrelic-mcp.git"],"env":{"ACCOUNT_ID":"222222","API_KEY":"your_prod_api_key","NERDGRAPH_URL":"https://api.newrelic.com/graphql"}}'

Verify both:

claude mcp get newrelic-staging
claude mcp get newrelic-prod

Both servers stay registered and available at same time — pick per query which one (newrelic-staging or newrelic-prod) tool calls target. Same pattern works for any env split (dev/prod, region A/region B), just swap suffix and ACCOUNT_ID/API_KEY/NERDGRAPH_URL per env.

Gemini CLI

Add this to ~/.gemini/settings.json (or .gemini/settings.json for project scope):

{
  "mcpServers": {
    "newrelic": {
      "command": "npx",
      "args": ["-y", "git@github.com:alanhoff/newrelic-mcp.git"],
      "env": {
        "ACCOUNT_ID": "123456",
        "API_KEY": "your_new_relic_user_key",
        "NERDGRAPH_URL": "https://api.newrelic.com/graphql"
      }
    }
  }
}

Verify inside Gemini CLI:

/mcp

Cursor (cursor-agent CLI)

Add this to ~/.cursor/mcp.json (or .cursor/mcp.json for project scope):

{
  "mcpServers": {
    "newrelic": {
      "command": "npx",
      "args": ["-y", "git@github.com:alanhoff/newrelic-mcp.git"],
      "env": {
        "ACCOUNT_ID": "123456",
        "API_KEY": "your_new_relic_user_key",
        "NERDGRAPH_URL": "https://api.newrelic.com/graphql"
      }
    }
  }
}

Verify:

cursor-agent mcp list
cursor-agent mcp list-tools newrelic

Install The Skills

This repo ships three skills:

• newrelic-entity-scout
• newrelic-incident-correlation
• newrelic-nrql-debug-ladder

If you are running inside this repository with AGENTS.md, they are already available from .agents/skills/.

To install them globally for Codex:

mkdir -p ~/.codex/skills
for skill in newrelic-entity-scout newrelic-incident-correlation newrelic-nrql-debug-ladder; do
  cp -R ".agents/skills/$skill" "$HOME/.codex/skills/$skill"
done

Alternative (keep them synced to this repo with symlinks):

mkdir -p ~/.codex/skills
for skill in newrelic-entity-scout newrelic-incident-correlation newrelic-nrql-debug-ladder; do
  ln -sfn "$(pwd)/.agents/skills/$skill" "$HOME/.codex/skills/$skill"
done

Local Development

npm install
npm test

Main server entrypoint: index.js