New Relic MCP server
New Relic's official hosted MCP server: run NRQL, search entities, analyze golden metrics, and triage incidents from your agent.
The New Relic MCP server is New Relic's official integration that turns your observability data into an action engine for AI agents. Instead of pivoting to the New Relic UI to read a chart or hand-write NRQL, an agent can ask a question in natural language, have it translated to NRQL and executed against NRDB, and get back metrics, traces, and logs with the analysis layered on top. It spans the full observability surface: discovering entities and accounts, querying data, managing alerts, responding to incidents, deep performance analytics, and log analysis.
The canonical deployment is a single hosted, remote endpoint at https://mcp.newrelic.com/mcp/ that serves every New Relic data center; the User API key you pass in the Api-Key header carries the account context that routes the request to the right region and inherits that user's role-based permissions, so you never put long-lived secrets on disk beyond your own key. It uses Streamable HTTP transport and works with GitHub Copilot, Claude, Cursor, ChatGPT, and other MCP clients. Beyond raw NRQL it offers higher-level reasoning tools: analyze_golden_metrics for throughput, latency, error rate, and saturation; analyze_transactions and analyze_threads for deep dives; and report generators for deployment impact and end-user impact.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Available tools
| Tool | Description |
|---|---|
| convert_time_period_to_epoch_ms | Converts a human time period into epoch milliseconds for use in queries. |
| get_dashboard | Fetches the details of a specific dashboard. |
| get_entity | Retrieves an entity by GUID or by name pattern search. |
| list_related_entities | Lists entities one hop away from a given entity GUID. |
| list_available_new_relic_accounts | Lists all account IDs the authenticated user can access. |
| list_dashboards | Lists all dashboards in an account. |
| list_entity_types | Lists the complete catalog of entity types. |
| search_entity_with_tag | Finds entities by a tag key and value. |
| execute_nrql_query | Runs an NRQL query against NRDB and returns results. |
| natural_language_to_nrql_query | Converts a natural-language question into NRQL and executes it. |
| list_alert_conditions | Lists alert condition details for alert policies. |
| search_incident | Lists alert events with flexible filtering. |
| list_alert_policies | Lists alert policies with optional name filtering. |
| list_recent_issues | Lists all currently open issues in an account. |
| list_synthetic_monitors | Lists automated availability and performance synthetic tests. |
| analyze_deployment_impact | Assesses the performance impact of a deployment. |
| generate_alert_insights_report | Generates an alert intelligence analysis report. |
| generate_user_impact_report | Generates an end-user impact analysis report. |
| list_entity_error_groups | Fetches error groups from Errors Inbox for an entity. |
| list_change_events | Lists change-event history for applications. |
| analyze_entity_logs | Identifies error patterns and anomalies across an entity's logs. |
| analyze_golden_metrics | Analyzes throughput, response time, error rate, and saturation for an entity. |
| analyze_kafka_metrics | Examines Kafka consumer lag and producer metrics. |
| analyze_threads | Reviews thread state, CPU, and memory data. |
| analyze_transactions | Identifies slow and error-prone transactions. |
| list_garbage_collection_metrics | Reports garbage-collection and memory metrics. |
| list_recent_logs | Lists recent logs for an entity. |
| list_entity_performance_risk_groups | Fetches performance risks for an entity from the inbox. |
Required configuration
- NEW_RELIC_API_KEYRequired
New Relic User API key (starts with NRAK-) passed in the Api-Key header. Carries account context and inherits the user's role-based permissions.
What you can do with it
Investigate an incident in natural language
Ask the agent what is wrong with a service; it uses natural_language_to_nrql_query and analyze_golden_metrics to surface the regression, then list_recent_issues and analyze_deployment_impact to tie it to a change.
Diagnose performance without writing NRQL
Have the agent run analyze_transactions, analyze_threads, and analyze_entity_logs to pinpoint slow transactions, thread contention, and error patterns, then summarize the root cause.
FAQ
- Is it free?
- The MCP server itself is free for New Relic users; access and usage are governed by your New Relic plan. It went generally available in 2026 as part of New Relic's agentic platform.
- Does it support remote/OAuth?
- The canonical deployment is a hosted remote endpoint at https://mcp.newrelic.com/mcp/ using Streamable HTTP. Authentication is a User API key (NRAK-) sent in the Api-Key header, which routes to the correct data center and inherits that user's permissions.
- Can it modify my New Relic configuration?
- The tool surface is oriented around reading and analyzing observability data, querying NRDB, inspecting entities, alerts, incidents, and logs. The server inherits the API key user's role-based permissions, so scope the key accordingly.