Skip to main content
Glama
alanhoff

newrelic-mcp

by alanhoff
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

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.

Related MCP server: New Relic MCP Server

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

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/alanhoff/newrelic-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server