New Relic MCP Server
Connect AI agents to New Relic observability — query telemetry, errors, alerts, and dashboards in natural language.
Updated
What is New Relic MCP?
The New Relic MCP server is a Model Context Protocol server that connects AI agents to New Relic's observability platform so they can query telemetry, run NRQL, and investigate errors, alerts, and dashboards in natural language.
It is hosted by New Relic as a remote HTTP endpoint at https://mcp.newrelic.com/mcp/ (EU accounts use https://mcp.eu.newrelic.com/mcp/), so there is nothing to self-host. The server translates your requests into New Relic Query Language (NRQL), retrieves the relevant metrics, logs, and incidents, and returns summarized answers to the agent.
Authentication uses OAuth — you connect the server to your AI tool and authorize through a browser flow against your New Relic account (an NRAK- API key is also supported as an alternative). The agent then operates with the access your New Relic user has, scoped to the accounts you can reach.
Tools the New Relic MCP server exposes
| Tool | What it does |
|---|---|
| execute_nrql_query | Run an NRQL query against your New Relic telemetry. |
| natural_language_to_nrql_query | Convert a plain-English question to NRQL, execute it, and return results. |
| get_entity | Fetch an entity by GUID or name pattern. |
| list_related_entities | Find entities one hop away from a given entity. |
| list_dashboards | List all dashboards in the account. |
| get_dashboard | Retrieve details for a specific dashboard. |
| list_alert_policies | Display the account's alert policies. |
| list_recent_issues | Show all currently open issues. |
| analyze_entity_logs | Identify error patterns in an entity's logs. |
| analyze_golden_metrics | Examine an entity's key health indicators. |
Connect the New Relic MCP server
Claude Code
- 1
Add the server
Run: claude mcp add newrelic --transport http https://mcp.newrelic.com/mcp/ (EU accounts use https://mcp.eu.newrelic.com/mcp/).
- 2
Authenticate
Run /mcp in Claude Code and complete the New Relic OAuth browser flow. An NRAK- API key via --header "Api-Key: NRAK-..." is an alternative.
- 3
Use it
Ask Claude to run NRQL, list open issues, or summarize an entity's golden metrics.
Cursor
- 1
Open MCP settings
In Cursor, go to Settings > MCP and add a new server (or edit ~/.cursor/mcp.json).
- 2
Configure the endpoint
Add an entry with url "https://mcp.newrelic.com/mcp/" (EU: https://mcp.eu.newrelic.com/mcp/) using HTTP transport.
- 3
Authenticate
Complete the New Relic OAuth flow when prompted, then enable the server and call its tools from chat.
Cursor is not listed in New Relic's official docs; use its standard remote-MCP (mcp.json) configuration with the documented server URL.
Sample use cases
An engineer asks 'what is the average response time for the checkout service this week?' in plain English
The agent uses natural_language_to_nrql_query to convert the question to NRQL, runs it, and returns the metric with a trend chart.
During an incident, an agent calls analyze_entity_logs on the affected service
It identifies the top recurring error patterns, their frequency, and the first occurrence — narrowing down the root cause.
A scheduled agent runs analyze_golden_metrics on all production services every morning
It reports any service where throughput, error rate, or latency has deviated significantly from the 7-day baseline.
An agent calls list_dashboards and get_dashboard to review performance data for a specific team
It summarizes key metrics from the team's dashboards and flags widgets showing degraded performance.
An agent uses list_alert_policies to audit all alerting rules in the account
It reports which services have no alerts, which alerts haven't fired in 90 days, and suggests gaps in coverage.
An agent calls list_related_entities to map the dependency graph of a failing service
It visualizes upstream and downstream dependencies, helping responders understand the blast radius of the failure.
An agent runs a complex NRQL query via execute_nrql_query to correlate deployment events with error spikes
It identifies which specific deployment caused a regression by matching deploy timestamps with error rate inflections.
An agent calls list_recent_issues to check all currently open issues across the account
It returns a prioritized list of open issues with severity, affected entities, and duration — ready for a morning triage review.
Security & permissions
Authentication is OAuth: you authorize the connection against your New Relic account through a browser flow (an NRAK- API key is also supported). The agent inherits the access of the authenticating New Relic user, scoped to the accounts and data that user can reach — telemetry, NRQL query results, dashboards, alerts, incidents, and logs. Grant access via a user with least-privilege scope, since the agent can read across all entities and accounts that user can see.
Using New Relic MCP with Gamut
In a Gamut workflow, the New Relic MCP server becomes a tool your agent can call on a schedule or in response to an event — for example, on an alert webhook or a nightly run an agent can run NRQL queries, pull recent incidents and error groups, and summarize golden metrics into a digest or a chat message. Gamut manages the OAuth connection to New Relic, so the agent invokes the observability tools without you handling tokens in the workflow itself. It reads and analyzes telemetry; it does not replace New Relic's own alerting or remediation.
Frequently asked questions
What is the New Relic MCP server?
It is New Relic's official Model Context Protocol server, hosted at https://mcp.newrelic.com/mcp/, that lets AI agents query your New Relic observability data — running NRQL, inspecting dashboards, alerts, incidents, and errors in natural language.
Is the New Relic MCP server free?
New Relic does not document a separate charge for the MCP server itself. You need a New Relic account with API access; New Relic offers a free tier, and usage is governed by your existing plan.
How do I connect the New Relic MCP server to Claude Code or Cursor?
For Claude Code, run claude mcp add newrelic --transport http https://mcp.newrelic.com/mcp/ then authenticate with /mcp via OAuth. For Cursor, add the same URL as an HTTP MCP server in Settings > MCP (or mcp.json) and complete the OAuth flow.
Is the New Relic MCP server hosted or self-hosted?
It is hosted by New Relic as a remote HTTP endpoint (https://mcp.newrelic.com/mcp/ for US, https://mcp.eu.newrelic.com/mcp/ for EU), so there is nothing to self-host.
Can I query New Relic in plain English through the MCP server?
Yes. The natural_language_to_nrql_query tool converts plain-English questions into NRQL queries, executes them, and returns the results — no NRQL syntax knowledge required.
Does the New Relic MCP server support log analysis?
Yes. The analyze_entity_logs tool identifies error patterns in an entity's logs, returning the most frequent error signatures and their occurrence counts.
Can it show service dependencies?
Yes. The list_related_entities tool finds entities one hop away from a given entity, mapping upstream and downstream dependencies to understand service relationships and blast radius.