NewAgent Observability is live.
Back to directory
New Relic logo

New Relic MCP server: 27 tools, in preview

A hosted observability connector still in preview, its three regional endpoints, and the compliance line its own documentation draws.

Connector
Official, hosted, US, EU and Japan
Coverage
Entities, alerts, NRQL, logs, dashboards, deployments
Tools
27 documented
Biggest risk for an agent
Prohibited for FedRAMP-regulated accounts

Last verified 1 September 2026 · from New Relic's own MCP documentation and tool reference

This page is one of 90 in a directory of monitoring and developer tools. Each page checks what an AI coding agent can get out of the tool through its MCP server, the connector that lets the agent query the tool directly.

Summary

New Relic runs a hosted MCP server with regional endpoints for the US, EU and Japan. Its tool reference lists 27 tools. They cover entities, alerts, incidents, logs, dashboards, deployments and NRQL, which is New Relic's query language.

It is explicitly a preview. The documentation describes it as provided under a preview program, and access is requested from the Previews and Trials page.

FedRAMP is the Federal Risk and Authorization Management Program. New Relic states you must not use the server if your accounts or data fall under FedRAMP compliance mandates, and calls that use strictly prohibited.

What is the New Relic MCP server?

It is New Relic's server for the Model Context Protocol. New Relic is an observability platform, so a connected agent reaches telemetry, alerts and the entities that produce them.

Two tools carry the querying. execute_nrql_query runs NRQL directly, and natural_language_to_nrql_query turns a question into NRQL. The pairing is rare. The agent can write the query itself, or it can ask New Relic to write it.

The rest is analysis rather than retrieval. analyze_deployment_impact, analyze_golden_metrics, analyze_threads and generate_user_impact_report return New Relic's own assessment rather than raw rows.

It is strongest in production observability, touches release through change events, and reaches nothing in code review or cost.

Part of the workWhat New Relic has hereCan an agent reach it
Code, tests & reviewNoneNothing for code or review
CI & releaseChange tracking, deployment impactPartial. list_change_events and analyze_deployment_impact connect a release to behavior; nothing runs a pipeline
Production observabilityEntities, alerts, incidents, NRQL, logs, dashboards, syntheticsYes. Core strength, across the full telemetry surface
Agent observability & evalsNone for your own agentsNo traces or evaluations of your agents. The tools observe your services, not your models
AI cost managementNoneNo spend data exposed over this connector

For an agent, New Relic answers what production is doing and what changed just before it started. Deployment impact analysis is the tool that links the two. It has no view of the code, so a fix still needs a repository connector.

What can an AI agent do with New Relic?

TaskToolsWorksWatch out for
Ask a question in Englishnatural_language_to_nrql_query execute_nrql_queryYesHave the agent call list_available_new_relic_accounts first, then compose the query. The first tool produces NRQL and the second runs it, so read the NRQL before trusting the answer
Find the right serviceget_entity search_entity_with_tag list_related_entitiesYeslist_available_new_relic_accounts establishes which account is in scope
See what is alertinglist_recent_issues list_alert_policies list_alert_conditions search_incidentYesIssues, policies and conditions are separate concepts with separate tools
Connect a deploy to a regressionlist_change_events analyze_deployment_impactYesImpact analysis is New Relic's assessment, not raw telemetry
Investigate performanceanalyze_golden_metrics analyze_transactions analyze_threads list_garbage_collection_metricsYesThese tools work where the New Relic language agent reports thread and garbage-collection data
Read errors and logslist_entity_error_groups analyze_entity_logs list_recent_logsYesError groups aggregate; recent logs do not
Report user impactgenerate_user_impact_report generate_alert_insights_reportYesBoth generate a report rather than returning a dataset

list_available_new_relic_accounts belongs first. Most tools take an account, and an answer from the wrong one looks exactly like an answer from the right one.

27 tools documented across the preview program

Querying3
execute_nrql_querynatural_language_to_nrql_queryconvert_time_period_to_epoch_ms
Entities4
get_entitysearch_entity_with_taglist_related_entitieslist_available_new_relic_accounts
Alerting4
list_recent_issueslist_alert_policieslist_alert_conditionssearch_incident
Change2
list_change_eventsanalyze_deployment_impact
Performance5
analyze_golden_metricsanalyze_transactionsanalyze_threadsanalyze_kafka_metricslist_garbage_collection_metrics
Errors and logs3
list_entity_error_groupsanalyze_entity_logslist_recent_logs
Dashboards and synthetics3
get_dashboardlist_dashboardslist_synthetic_monitors
Reports3
generate_user_impact_reportgenerate_alert_insights_reportlist_entity_performance_risk_groups

Counts come from New Relic's own MCP tool reference, read 24 August 2026. The hosted endpoints are a preview program. An unauthenticated tools/list gets no answer from them.

What connecting costs before the first question

A context window is the amount of text a model can hold at once. Twenty-seven tools cost 1,897 to 2,193 tokens on Claude. A group is a heading on this page, not a filter New Relic offers, so the group sizes do not divide the token cost.

The endpoints are a preview program running in three regions, so the surface that registers can change and is not one to budget against.

Tool setToolsTokens (GPT-5.6, GPT-5.5)Tokens (GPT-4, GPT-3.5)Tokens (Claude Haiku 4.5 to Opus 5)Share of a 200,000-token window
Every tool documented27668 to 913668 to 9131,897 to 2,1930.3% to 1.1%

Encodings: GPT-5.6, GPT-5.5 o200k_base; GPT-4, GPT-3.5 cl100k_base; Claude Haiku 4.5 to Opus 5 count_tokens. Counted from the 27 tool entries in the vendor's own documentation. That is the only public inventory.

The server could not be run for a live tools/list. So no input schemas are available. These figures cover each tool's name and description only. They are a floor, not the figure.

The Claude columns are measured through the API's count_tokens endpoint, with an empty schema per tool. So they cover the same content as the GPT columns. The range there is two tokenizer generations. Haiku 4.5 and Opus 4.6 sit at the low end. Opus 5 and Sonnet 5 sit at the high end. The gap between them is about a fifth.

New Relic MCP server limits: where answers come back incomplete

New Relic's preview product, regional deployments and generated queries set the constraints below.

The agent says: Error rate is up 12%. A generated query produced that.

natural_language_to_nrql_query converts a question into NRQL, and execute_nrql_query runs it. A query that means something slightly different returns a real number for the wrong measurement.

Guard: Require the agent to print the NRQL alongside any figure it reports.

The agent says: There is no data for that service. It may be querying another region.

New Relic runs separate US, EU and Japan deployments with distinct hostnames and token URLs. A key for one does not reach another.

Guard: Have the agent call list_available_new_relic_accounts and state the account and region behind an answer.

New Relic prohibits this server for FedRAMP-regulated accounts.

The documentation gives the reason as security and compliance requirements. It states you must not use the MCP server if your accounts or data fall under FedRAMP compliance mandates. It calls that use strictly prohibited.

Guard: Settle the compliance question before any technical evaluation, because it decides the outcome.

How to configure New Relic MCP for agents

  1. 1

    Check the compliance restriction first

    New Relic states the server must not be used where accounts or data fall under FedRAMP mandates.

  2. 2

    Request preview access

    The feature is provided under a preview program, enabled from the Previews and Trials page.

  3. 3

    Pick the region

    Token URLs differ: mcp.newrelic.com for the US, mcp.eu.newrelic.com for the EU and mcp.jp.newrelic.com for Japan.

  4. 4

    Decide between a user key and OAuth

    A user key is in the NRAK- format; OAuth uses New Relic's pre-configured client and endpoints.

Paste this into your agent’s instructions

Several tools generate an assessment rather than returning data, and one writes the query the answer rests on. Both need naming.

Terminal
When you answer using New Relic MCP tools, state:
- The account and entity the answer covers.
- The NRQL that ran. If natural_language_to_nrql_query wrote
  it, show the query it produced.
- Whether a claim came from an analyze_ or generate_ tool,
  which return New Relic's assessment rather than raw telemetry.
Never state that data does not exist. State that the query
above returned no results.
Write your answer in ASD-STE100 Simplified Technical
English. Use short sentences with one idea in each.

Do you need the MCP server at all?

Often not. NerdGraph and the NRQL API answer the same questions and are generally available rather than preview.

The connector earns its place on the analysis tools. Deployment impact and golden-metric analysis are New Relic's own assessments, which a raw query does not reproduce.

For an observability connector that is not in preview, Grafana and Datadog both publish generally available servers.

Connect it for investigation while the preview lasts. Use NerdGraph where you need a supported interface.

New Relic MCP server setup

The server is hosted, so nothing is installed. Preview access is requested from the Previews and Trials page in your account.

Authentication is a user key or OAuth. Keys are in the NRAK- format and are created under API keys in the account menu.

Claude Code

The user key is in the NRAK- format and travels as a header.

Terminal
claude mcp add --transport http newrelic \
  https://mcp.newrelic.com/mcp \
  --header "Api-Key: NRAK-XXXXXXXXXXXXXXXXXXXXX"

Cursor

In ~/.cursor/mcp.json. Use the endpoint for your data region.

Terminal
{"mcpServers":{"newrelic":{
  "url":"https://mcp.newrelic.com/mcp",
  "headers":{"Api-Key":"NRAK-XXXXXXXXXXXXXXXXXXXXX"}}}}

Codex CLI

Codex reads TOML, so the JSON blocks above will not transfer. The key still applies.

Terminal
[mcp_servers.newrelic]
url = "https://mcp.newrelic.com/mcp"
headers = { "Api-Key" = "NRAK-XXXXXXXXXXXXXXXXXXXXX" }

Every other client

Each block below is the configuration for one client, with the file path and the key that client expects.

Claude Desktop

macOS ~/Library/Application Support/Claude/claude_desktop_config.json. Windows %APPDATA%\Claude\claude_desktop_config.json. There is no CLI. Edit through Settings, Developer, Edit Config.

Quit and restart fully for changes to load. Paths in args must be absolute. Logs at ~/Library/Logs/Claude/mcp.log.

Terminal
{"mcpServers":{"newrelic":{"url":"https://mcp.newrelic.com/mcp",
  "headers":{"Api-Key":"NRAK-XXXXXXXXXXXXXXXXXXXXX"}}}}
Gemini CLI

~/.gemini/settings.json globally, or .gemini/settings.json per project. Key mcpServers. CLI: gemini mcp add.

Terminal
{"mcpServers":{"newrelic":{"url":"https://mcp.newrelic.com/mcp",
  "headers":{"Api-Key":"NRAK-XXXXXXXXXXXXXXXXXXXXX"}}}}
VS Code Copilot

.vscode/mcp.json per workspace, or your user profile. CLI: code --add-mcp.

Terminal
{"servers":{"newrelic":{"url":"https://mcp.newrelic.com/mcp",
  "headers":{"Api-Key":"NRAK-XXXXXXXXXXXXXXXXXXXXX"}}}}

The key is `servers`, not `mcpServers`. VS Code is the only client that uses that name, and copying a config from anywhere else fails silently.

Windsurf

~/.codeium/windsurf/mcp_config.json, which is the path Windsurf documents. Key mcpServers, the same JSON shape as Cursor, carrying the same credential.

Zed

~/.config/zed/settings.json, carrying the same credential as the blocks above.

The key is `context_servers`. Zed does not call them MCP servers in config, so searching its settings for mcp finds nothing.

Google Antigravity

~/.gemini/config/mcp_config.json globally, or .agents/mcp_config.json per project. Key mcpServers. There is no CLI. Use the /mcp overlay in the editor. Supports stdio, streamable HTTP, SSE and websocket.

Terminal
{"mcpServers":{"newrelic":{"url":"https://mcp.newrelic.com/mcp",
  "headers":{"Api-Key":"NRAK-XXXXXXXXXXXXXXXXXXXXX"}}}}
Amp (Sourcegraph)

~/.config/amp/settings.json or .amp/settings.json, carrying the same credential. The amp mcp CLI covers approve, doctor and oauth.

The key is `amp.mcpServers`, namespaced. A bare mcpServers block is ignored.

Cline

~/.cline/mcp.json per the docs. The source also reads ~/.cline/data/settings/cline_mcp_settings.json. Key mcpServers, standard JSON shape, carrying the same credential. Supports stdio, streamable HTTP and SSE.

Goose (Block)

~/.config/goose/config.yaml, carrying the same credential.

YAML, and servers are called `extensions`. Goose does not use the MCP vocabulary in config at all. Add one interactively with goose configure, or per session with goose session --with-extension.

Kiro (AWS)

.kiro/settings/mcp.json per workspace, or ~/.kiro/settings/mcp.json globally. Key mcpServers, standard JSON shape, carrying the same credential.

Warp

~/.warp/.mcp.json or .warp/.mcp.json. Key mcpServers, standard shape, carrying the same credential. Also addable through the /agent-add-mcp skill.

JetBrains Junie

.junie/mcp/mcp.json per project, or ~/.junie/mcp/mcp.json. Key mcpServers, carrying the same credential. Use /mcp in the CLI to manage.

Roo Code

.roo/mcp.json per project. The global file is mcp_settings.json, opened from the Roo Code MCP settings view with Edit Global MCP. Key mcpServers, carrying the same credential.

Continue

.continue/mcpServers/*.yaml, one file per server, carrying the same credential.

YAML, and `mcpServers` is a list, not an object. Every JSON client keys servers by name. Continue takes an array, so a converted config will not parse.

Trae

.trae/mcp.json per project, or paste into the UI under Raw Config (JSON). Key mcpServers, standard shape, carrying the same credential.

Devin

Devin has no config file to edit. Servers are added through a web form in the settings UI, and Devin's documentation states you do not need to write or paste JSON. The block below is the shape those fields describe, shown for reference. Either route uses the same credential.

EU and Japan regions

Separate deployments with their own token URLs. The same key format and OAuth flow authorize them.

Terminal
# EU
https://mcp.eu.newrelic.com/mcp
# Japan
https://mcp.jp.newrelic.com/mcp
OAuth

New Relic publishes pre-configured OAuth endpoints, so the client authorizes in a browser rather than storing a key.

Terminal
# Authorization URL: https://login.newrelic.com/login
# Token URL (US):    https://mcp.newrelic.com/oauth2/token
# Scopes:            ["openid"]

Read-only access, permissions and security

  • FedRAMP accounts are excluded

    New Relic states that use of this preview with FedRAMP-regulated accounts is strictly prohibited.

  • It is preview software

    The documentation places it under a preview program governed by New Relic's pre-release policies.

  • Telemetry can carry sensitive content

    Log and transaction tools return production data, which reaches the model like any other tool result.

  • Every documented tool reads

    Nothing in the 27 creates or deletes a New Relic resource.

Troubleshooting

The endpoint refuses the connection
Preview access has to be enabled. Request it from the Previews and Trials page before configuring a client.
Data appears to be missing
Check the region and the account. There are separate US, EU and Japan deployments, and list_available_new_relic_accounts shows what the key can reach.
A natural-language answer looks wrong
natural_language_to_nrql_query writes the query, and execute_nrql_query runs it. Have the agent print the generated NRQL and read it.
Compliance review blocks the rollout
If any account or data falls under FedRAMP mandates, New Relic's own documentation prohibits using this server.

New Relic MCP server: Reference

ItemValue
Endpointsmcp.newrelic.com · mcp.eu.newrelic.com · mcp.jp.newrelic.com
StatusPreview program, under New Relic's pre-release policies
ComplianceProhibited for FedRAMP-regulated accounts
AuthUser key in the NRAK- format, or OAuth with published endpoints
OAuth scopes["openid"]
Tools27 documented, all read-only
Repositorynewrelic/mcp-server · 7 stars · 0 forks · 0 releases · created 16 October 2025 · last pushed 24 October 2025
Inventory sourceNew Relic's own tool reference, read 24 August 2026

What engineers report

New Relic documents 27 tools and runs three regional endpoints, and the figures below come from those docs. Public discussion is small: newrelic/mcp-server has 7 stars, and the two issues below are what engineers have filed against it.

What was checkedWhat it shows
Documented tools27
Regional endpoints3: US, EU and Japan
StatusPreview program
Compliance exclusionFedRAMP-regulated accounts
Repository stars7
Repository last push24 October 2025

“The MCP tool is great but Agents will run the same query across all accounts for every investigation unless specifically prompted not to do so.”

drod3763, GitHub issue, 24 April 2026 · Query scope across accounts, and a request for a default account.

“Even when I am already logged in, when clicking on the MCP oauth link, I am redirected out to my corporate SSO. After login, the mcp oath flow was lost, and nothing ever goes back to the MCP.”

Jason-Coyne, GitHub issue, 8 April 2026 · The OAuth flow against corporate SSO, on an issue still open at the time of writing.

Tool inventory, regions, authentication and the compliance restriction read from New Relic's own MCP documentation and tool reference on 24 August 2026. Repository facts from the GitHub API on the same date.

Should you connect an agent to New Relic?

Yes. Best for a read-scoped user key in the right region, with generated NRQL printed in every answer.

Strongest fit
New Relic customers outside FedRAMP scope who want an agent to investigate production from the editor.
Main advantage
Both routes to a query: the agent can write NRQL, or ask the platform to write it.
Main weakness
It is a preview, so it sits outside the support and stability guarantees of the rest of the platform.
Operational risk
Low from the tools, which all read. The real risk is the compliance restriction on FedRAMP accounts.

From Oodle

One platform for agent traces and infrastructure

Agent traces usually sit in a different product from the rest of your telemetry, so when a slow database makes an agent slow the symptom is in one tool and the cause is in another. Oodle keeps both in one query surface, from $10 per million spans.

See agent observability

Frequently asked questions

How many tools does the New Relic MCP server have?

27 documented, read from New Relic's own tool reference on 24 August 2026. The hosted endpoints are a preview and answer no unauthenticated tools/list.

Can I use it under FedRAMP?

No. New Relic states you must not use the MCP server if your accounts or data fall under FedRAMP compliance mandates, and calls that use strictly prohibited.

Which regions are available?

US at mcp.newrelic.com, EU at mcp.eu.newrelic.com and Japan at mcp.jp.newrelic.com, each with its own OAuth token URL.

How does authentication work?

A user key in the NRAK- format, or OAuth using New Relic's pre-configured client, authorization URL and regional token URLs with the openid scope.

Can an agent change anything?

No. All 27 documented tools read: they query, list, analyze or generate a report.

Changelog

  • 24 October 2025. Last push. The repository has never tagged a GitHub release.
  • 16 October 2025. newrelic/mcp-server created on GitHub.

Sources

Every number on this page traces to one of these

  1. New Relic MCP overview and tool reference, read 24 August 2026
  2. Regional endpoints, OAuth configuration and the FedRAMP restriction from the same documentation
  3. Repository facts from the GitHub API · newrelic/mcp-server, retrieved 24 August 2026

New Relic’s own MCP documentation

Also production observability:

For the release behind a regression: