What it does
Secure, self-hosted New Relic observability and administration tools for MCP clients
- Connects Runs on your computer
- Account or key Needs NEW_RELIC_API_KEY
- Category Developer tools
Use together with
Skills that teach the AI this kind of work; they work alongside this one
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Why it ranks here
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 0/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 3/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 3/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Install
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install New Relic MCP Server. Follow https://mcp.popnx.com/i/meet-bhalodiya-newrelic-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Let AI install it
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server New Relic MCP Server for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "newrelic": { "command": "npx", "args": [ "-y", "@meet-bhalodiya/newrelic-mcp" ], "env": { "NEW_RELIC_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For NEW_RELIC_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the New Relic MCP Server tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install Node.js (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
node -v- A version number such as v26.13.1 = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
node -vInstall once; it works for everything that needs Node.js
Sign up and create a New Relic MCP Server key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Open the Claude desktop app’s settings file
SettingsDeveloperEdit Config
Paste these settings and save the file
{ "mcpServers": { "newrelic": { "command": "npx", "args": [ "-y", "@meet-bhalodiya/newrelic-mcp" ], "env": { "NEW_RELIC_API_KEY": "your-value" } } } }Paste the key only into the app’s field, never into a chat or to anyone
Quit Claude and open it again
Try it
Use New Relic MCP Server and tell me what you can do for me, then show me one thing✓ If Claude says it is using New Relic MCP Server or shows a New Relic MCP Server tool in the answer, you are connected
3 optional setting(s) (works without them)
The command above works without these. Add them only if you want to change something, following the maker’s description.
NEW_RELIC_REGIONNew Relic data region: US, EU, or JP. · default USNEW_RELIC_DEFAULT_ACCOUNT_IDOptional default account ID used when a tool omits accountId.NEW_RELIC_ACCOUNT_ALLOWLISTOptional comma-separated account IDs this deployment may access.
Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect New Relic MCP Server yet
New Relic MCP Server runs on your computer, but ChatGPT can only connect servers that run on the web
What you can do instead
A · Use an app that can connect New Relic MCP Server
- You need a New Relic MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
- You need a New Relic MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time)
- You need a New Relic MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time)
- You need a New Relic MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time)
B · Others in Developer tools that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Works with Claude Code, with some setup first
You need a New Relic MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Let AI install it
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server New Relic MCP Server for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user newrelic --env NEW_RELIC_API_KEY=your-value -- npx -y @meet-bhalodiya/newrelic-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For NEW_RELIC_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the New Relic MCP Server tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install Node.js (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
node -v- A version number such as v26.13.1 = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
node -vInstall once; it works for everything that needs Node.js
Sign up and create a New Relic MCP Server key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Paste this command and press Enter
claude mcp add --scope user newrelic --env NEW_RELIC_API_KEY=your-value -- npx -y @meet-bhalodiya/newrelic-mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
Type /mcp in Claude Code
You should see New Relic MCP Server listed as connected
Try it
Use New Relic MCP Server and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using New Relic MCP Server or shows a New Relic MCP Server tool in the answer, you are connected
3 optional setting(s) (works without them)
The command above works without these. Add them only if you want to change something, following the maker’s description.
NEW_RELIC_REGIONNew Relic data region: US, EU, or JP. · default USNEW_RELIC_DEFAULT_ACCOUNT_IDOptional default account ID used when a tool omits accountId.NEW_RELIC_ACCOUNT_ALLOWLISTOptional comma-separated account IDs this deployment may access.
Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a New Relic MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Let AI install it
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server New Relic MCP Server for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "newrelic": { "command": "npx", "args": [ "-y", "@meet-bhalodiya/newrelic-mcp" ], "env": { "NEW_RELIC_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For NEW_RELIC_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the New Relic MCP Server tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install Node.js (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
node -v- A version number such as v26.13.1 = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
node -vInstall once; it works for everything that needs Node.js
Sign up and create a New Relic MCP Server key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Fill in your key
In the New Relic MCP Server settings, NEW_RELIC_API_KEY is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Open the AI chat in Cursor in Agent mode
Try it
Use New Relic MCP Server and tell me what you can do for me, then show me one thing✓ If Cursor says it is using New Relic MCP Server or shows a New Relic MCP Server tool in the answer, you are connected
3 optional setting(s) (works without them)
The command above works without these. Add them only if you want to change something, following the maker’s description.
NEW_RELIC_REGIONNew Relic data region: US, EU, or JP. · default USNEW_RELIC_DEFAULT_ACCOUNT_IDOptional default account ID used when a tool omits accountId.NEW_RELIC_ACCOUNT_ALLOWLISTOptional comma-separated account IDs this deployment may access.
Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a New Relic MCP Server key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Let AI install it
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server New Relic MCP Server for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "newrelic": { "type": "stdio", "command": "npx", "args": [ "-y", "@meet-bhalodiya/newrelic-mcp" ], "env": { "NEW_RELIC_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For NEW_RELIC_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the New Relic MCP Server tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install Node.js (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
node -v- A version number such as v26.13.1 = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
node -vInstall once; it works for everything that needs Node.js
Sign up and create a New Relic MCP Server key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Fill in your key
In the New Relic MCP Server settings, NEW_RELIC_API_KEY is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Open the AI chat in VS Code in Agent mode
Try it
Use New Relic MCP Server and tell me what you can do for me, then show me one thing✓ If VS Code says it is using New Relic MCP Server or shows a New Relic MCP Server tool in the answer, you are connected
3 optional setting(s) (works without them)
The command above works without these. Add them only if you want to change something, following the maker’s description.
NEW_RELIC_REGIONNew Relic data region: US, EU, or JP. · default USNEW_RELIC_DEFAULT_ACCOUNT_IDOptional default account ID used when a tool omits accountId.NEW_RELIC_ACCOUNT_ALLOWLISTOptional comma-separated account IDs this deployment may access.
Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
For developers: Terminal commands and JSON settings
Installed on your computer
Claude Code
claude mcp add --scope user newrelic --env NEW_RELIC_API_KEY=your-value -- npx -y @meet-bhalodiya/newrelic-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"newrelic": {
"command": "npx",
"args": [
"-y",
"@meet-bhalodiya/newrelic-mcp"
],
"env": {
"NEW_RELIC_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"newrelic": {
"command": "npx",
"args": [
"-y",
"@meet-bhalodiya/newrelic-mcp"
],
"env": {
"NEW_RELIC_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"newrelic": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@meet-bhalodiya/newrelic-mcp"
],
"env": {
"NEW_RELIC_API_KEY": "your-value"
}
}
}
}Values you fill in
NEW_RELIC_API_KEYsecret required envNew Relic user key. Create a dedicated least-privilege key.NEW_RELIC_REGIONenvNew Relic data region: US, EU, or JP.NEW_RELIC_DEFAULT_ACCOUNT_IDenvOptional default account ID used when a tool omits accountId.NEW_RELIC_ACCOUNT_ALLOWLISTenvOptional comma-separated account IDs this deployment may access.
Descriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
At a glance
- Downloads per weeki
- 52/wk
- Connection
- Runs on your computer
- Latest versioni
- 1.0.0
- Categoryi
- Developer tools
- Published to registryi
- Aug 18, 2026
- Code last changedi
- Aug 18, 2026
- Maker
- Meet-Bhalodiya
- Packages
npm: @meet-bhalodiya/newrelic-mcp- Website
- github.com
- Registry status
- Active
Which apps can use it
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Related guides
What it can do
Runs on your computer; the tool list appears in your AI app after you install it.
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
- ✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account Meet-Bhalodiya, which owns the repo
- ✓ Pass
Still maintained
Code last changed 3 months ago
- ✓ Pass
Has a licence
Uses Apache-2.0
- – Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
- – Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
- … Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints
Published vulnerabilities (OSV.dev)
No entries on OSV.dev for @meet-bhalodiya/newrelic-mcp@1.0.0
Checks only this package version, not every dependency · checked Nov 16, 2026
Makers: ask for a re-check or report wrong info
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/meet-bhalodiya-newrelic-mcp)Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
User reviews
No reviews yet
Compared with others in Developer toolsi
- More stars than 0% of the other 6136 servers in this category
- Published to the registry more recently than 27% of the other 6136 servers in this category
- Basic checks equal to or better than 99% of the other 6136 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is New Relic MCP Server safe?
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
You need to fill in: NEW_RELIC_API_KEY
Does it run on my computer or in the cloud?
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
Is it still maintained?
The GitHub repo last changed 3 months ago, and the latest version (1.0.0) reached the registry 3 months ago.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
What can I use instead?
In the same category: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
Similar alternatives
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP
Cloudflare MCP servers
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| This one New Relic MCP Server | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Cloud or install on your computer |
| Needs a key | Yes | No | No | No | No | No |
| Add with + in Claude | No | No | No | Yes | No | No |
| Basic checks | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| License | Apache-2.0 | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
README from the maker
Open the README
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
New Relic MCP Server
Connect your AI assistant to New Relic — safely.
A production-oriented, self-hostable Model Context Protocol (MCP) server that gives Claude, Cursor, Codex, and other MCP clients typed, read-only-by-default access to NRQL, logs, metrics, traces, errors, entities, alerts, incidents, dashboards, synthetics, workloads, service levels, and selected administration APIs — all over New Relic's NerdGraph.
It deliberately does not expose arbitrary GraphQL, forward client credentials to New Relic, or accept New Relic keys as tool arguments. Mutations are absent unless their feature gates are explicitly enabled, and every write uses a dry-run, confirmation phrase, and post-write readback workflow.
Highlights
- 🔒 Safe by default — read-only out of the box; writes are opt-in, gated, and run a dry-run → confirmation-phrase → post-write readback flow.
- 🧱 Bounded API surface — a fixed, documented set of NerdGraph operations; no arbitrary GraphQL and no credentials passed as tool arguments.
- 🔌 Works with any MCP client — Claude Code, Claude Desktop, Cursor, Codex, and more, over stdio or stateless Streamable HTTP.
- 📈 Usage telemetry built in — a Prometheus
/metricsendpoint with per-tool call counts, durations, and outcomes, plus upstream NerdGraph, queue-depth, retry, rate-limit, and cache metrics. - 🏢 Enterprise-ready — bearer/OIDC authentication, Host/Origin allowlists, account allowlists, secret and PII redaction, Docker, and Helm.
- 🧰 Broad coverage — independently selectable toolsets for NRQL, entities, alerts, dashboards, synthetics, workloads, service levels, logs, and metrics.
- 📚 Documented and tested — architecture docs, ADRs, and a unit/integration/contract/security/load test suite that gates every change in CI.
What you can ask
Once connected, ask your MCP client in plain language — it selects and calls the right read-only tools for you:
- "What are the slowest transactions for the checkout service in the last hour?"
- "Summarize the open incidents for the payments team and their likely causes."
- "Which service levels are at risk of missing their objective this week?"
- "Review my alert policies and point out coverage gaps."
- "Why did the login synthetic monitor fail overnight?"
See the tool catalog for the complete set of capabilities.
Why this MCP?
New Relic offers an official, New Relic-hosted MCP server (New Relic AI MCP, currently in preview). This project is a complementary, self-hostable and open-source alternative. Choose it when you want:
- Self-hosting and control — run the MCP bridge inside your own network with your own credentials; only outbound NerdGraph calls leave your perimeter. (New Relic's preview is not offered for FedRAMP-regulated accounts.)
- Read-only by default, with gated writes — every mutation is opt-in and runs a dry-run → confirmation-phrase → readback flow.
- A fixed, auditable operation surface — a documented set of NerdGraph operations, with no arbitrary GraphQL and no New Relic keys passed as tool arguments.
- Your own controls — bearer/OIDC auth, Host/Origin and account allowlists, secret redaction, and independently selectable toolsets.
- First-class telemetry — Prometheus metrics for tool usage and upstream calls that you can scrape into your existing observability stack.
- Apache-2.0 and forkable — inspect, pin, and extend exactly what you deploy.
If you'd rather have a zero-operations, New Relic-managed experience integrated with New Relic AI, the official server may be the better fit. This project trades that convenience for self-hosting, control, and auditability.
Project status: 1.0.0. Review the supported operation matrix
and validate permissions against a non-production New Relic account before enabling
writes. The MCP Registry, npm, container, and MCPB metadata are prepared, but this
repository does not publish artifacts without maintainer credentials.
Requirements
- Node.js 22.7.5 or newer; Node 24 LTS is recommended for production.
- A New Relic user key with only the permissions the enabled toolsets require.
- A New Relic account using the US or EU endpoint, or a verified JP compatibility endpoint deployment (see configuration).
- An MCP client supporting stdio or Streamable HTTP.
New Relic applies a limit of 25 concurrent NerdGraph requests per user across all keys owned by that user. This server defaults to 20 total requests and five complex NRQL queries. See performance and scaling before adding replicas. Ordinary HTTP calls are sessionless; prompt SDK cancellation across multiple replicas additionally requires deterministic load-balancer affinity.
Quick start: stdio
Install the package globally:
npm install --global @meet-bhalodiya/newrelic-mcp
export NEW_RELIC_API_KEY='NRAK-...' export NEW_RELIC_REGION='US' newrelic-mcp doctor --json newrelic-mcp
Or let the MCP client invoke the pinned package through npx:
NEW_RELIC_API_KEY='NRAK-...' \
npx -y @meet-bhalodiya/newrelic-mcp@1.0.0 doctor --json
Stdio reserves stdout for MCP frames. Runtime diagnostics and logs go to stderr.
Quick start: authenticated HTTP
Create two files readable only by the service account:
install -m 0700 -d ./secrets
printf '%s' "$NEW_RELIC_API_KEY" > ./secrets/new_relic_api_key openssl rand -hex 32 > ./secrets/mcp_bearer_token chmod 0400 ./secrets/*
Start a loopback-only container:
docker compose up --build
The MCP endpoint is http://127.0.0.1:3000/mcp; health probes are at /healthz and /readyz. Docker Compose deliberately enables static bearer authentication. Read the token from ./secrets/mcp_bearer_token and send it in Authorization: Bearer .
For a native process:
export NEW_RELIC_API_KEY_FILE="$PWD/secrets/new_relic_api_key"
export MCP_AUTH_MODE=bearer export MCP_BEARER_TOKEN_FILE="$PWD/secrets/mcp_bearer_token" newrelic-mcp http --host 127.0.0.1 --port 3000
Non-loopback HTTP must use bearer or OIDC auth, an explicit Host allowlist, TLS at the reverse proxy, and an Origin allowlist for browser clients. See deployment and security.
Client setup
These short examples use the read-only stdio server. The full guide includes remote bearer and OAuth setups plus client-specific caveats.
Claude Code
claude mcp add --transport stdio --scope user \
--env NEW_RELIC_API_KEY="$NEW_RELIC_API_KEY" \ --env NEW_RELIC_REGION=US \ newrelic -- npx -y @meet-bhalodiya/newrelic-mcp@1.0.0
Use /mcp inside Claude Code to verify the connection.
Claude Desktop
For the safest local installation, build or download the .mcpb bundle and use Settings → Extensions → Advanced settings → Install Extension. Claude Desktop stores fields marked sensitive in OS secure storage. A manual local stdio JSON example is in client configuration. Remote servers must be added through Settings → Connectors, not claude_desktop_config.json.
Cursor
Copy examples/cursor.mcp.json to .cursor/mcp.json for one project or ~/.cursor/mcp.json globally. Launch Cursor from an environment where NEW_RELIC_API_KEY is available, then enable the server under MCP settings.
Codex
codex mcp add newrelic \
--env NEW_RELIC_REGION=US \ --env NEW_RELIC_API_KEY="$NEW_RELIC_API_KEY" \ -- npx -y @meet-bhalodiya/newrelic-mcp@1.0.0 codex mcp list
Codex CLI, the Codex IDE extension, and the ChatGPT desktop app on the same Codex host share config.toml. See the Codex examples for Streamable HTTP bearer and OAuth modes.
CLI
newrelic-mcp [stdio]
newrelic-mcp http [--host HOST] [--port PORT] newrelic-mcp doctor [--json] newrelic-mcp tools [--json]
stdio(or no subcommand) starts the local transport.httpserves sessionless Streamable HTTP at/mcpplus health endpoints; its bounded cancellation registry is process-local.doctorvalidates configuration, credentials, region, accessible accounts, and one bounded fixed-query schema selection for every effectively enabled toolset; it never issues mutations or prints secrets.toolsreports enabled toolsets and safety gates without contacting New Relic.
Safety model
| Capability | Default | Required setting |
|---|---|---|
| Read tools | enabled by selected toolsets | NEW_RELIC_TOOLSETS |
| Ordinary writes | off | NEW_RELIC_ENABLE_WRITES=true |
| Delete, cancel, revoke, replacement update, public exposure, suppression | off | writes plus NEW_RELIC_ENABLE_DESTRUCTIVE=true |
| Organization administration | off | NEW_RELIC_ENABLE_ADMIN=true and appropriate auth scope |
| Preview data-management APIs | off | NEW_RELIC_ENABLE_PREVIEW_APIS=true |
| Experimental AI issue actions | off | NEW_RELIC_ENABLE_EXPERIMENTAL_AI_ISSUES=true |
Enabling a gate registers the corresponding tool; it does not bypass New Relic permissions or HTTP authorization scopes. Writes still default to dry-run. Apply the exact confirmation phrase returned by the dry-run using otherwise identical arguments. Confirmation phrases bind to the normalized change and the pre-read state; another state change requires a fresh dry-run.
The project deliberately excludes API-key creation, synthetic secure-credential mutation, live-dashboard passwords and resets, historical-export URLs, Slack destination creation, arbitrary entity deletion, telemetry ingest, and raw GraphQL.
Toolsets and MCP capabilities
The default read surface is split into independently selectable toolsets:
corenrqlentitiesalertsdashboardssyntheticsworkloadsservice-levelslogsmetricsadmin(never enabled implicitly)
Use newrelic-mcp tools --json for the exact runtime catalog and tool-catalog.md for descriptions. Resources include server capabilities, accounts, and typed entity/configuration templates. Static prompts cover incident triage, service health, alert policy review, SLO review, dashboard design, and synthetic failure analysis. Tools remain the authoritative universal interface because prompt and resource support varies between MCP clients.
Configuration
Configuration is validated at startup. The most important settings are:
NEW_RELIC_API_KEY= # xor NEW_RELIC_API_KEY_FILE
NEW_RELIC_REGION=US # US, EU, or JP NEW_RELIC_DEFAULT_ACCOUNT_ID= NEW_RELIC_ACCOUNT_ALLOWLIST= N