Which integrations are available for this server?

Provides comprehensive access to New Relic's observability platform, enabling AI agents to query NRQL, manage APM applications, alerts, dashboards, synthetic monitors, logs, infrastructure metrics, workflows, notifications, service levels, tags, entities, and workloads through the NerdGraph API.

How do I use New Relic MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@New Relic MCP Server show me the top 5 slowest transactions" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

New Relic MCP Server

by karldane

Overview Schema Related Servers Score Discussions

Remote

New Relic MCP Server

A Go-native MCP (Model Context Protocol) server for the New Relic observability platform, providing comprehensive access to APM, infrastructure, logs, traces, alerts, dashboards, synthetics, workflows, notifications, service levels, tags, entities, and workloads — all through a single GraphQL endpoint.

Overview

55 registered MCP tools covering the full NerdGraph API surface
Safety-first design: every tool carries EnforcerProfile metadata (risk, impact, resource cost, PII flag, idempotency) for automated policy enforcement via MCP Bridge
Write protection: all mutation tools gated behind a -write-enabled flag; disabled by default
Multi-region: US and EU data center support (NEWRELIC_REGION=us|eu)
TDD-built: 80%+ test coverage across all tools

Related MCP server: NewRelic MCP Server

Registries

This server is published on the following MCP registries:

Smithery: karldane/newrelic-mcp
MCP Registry: io.github.karldane/newrelic-mcp

API Architecture

All tools communicate with a single NerdGraph endpoint:

Region	Endpoint
US (default)	`https://api.newrelic.com/graphql`
EU	`https://api.eu.newrelic.com/graphql`

Internal query helpers determine the response-scope:

Helper	Returns	Used For
`actorGraphQuery`	`data.actor.*`	Entity queries, cross-account NRQL
`nerdGraphQuery`	`data.actor.account.*`	Account-scoped queries (alerts, workflows, etc.)
`rawGraphQuery`	`data.<mutationName>`	All mutations
`executeNRQL`	Parsed NRQL results	NRQL-based tools

Tools

NRQL Querying

Tool	Description	GraphQL Operation	Risk	Impact
`nrql_query`	Execute arbitrary NRQL queries	`actor.account.nrql`	Med	Read

APM & Applications

Tool	Description	GraphQL Operation	Risk	Impact
`list_applications`	List all APM-monitored applications	`actor.entitySearch` (domain:APM, type:APPLICATION)	Low	Read
`get_apm_metrics`	Get APM performance metrics	`actor.account.nrql` (FROM APMApplication)	Low	Read
`get_application_metrics`	Get detailed metrics for a specific app	`actor.account.nrql` (FROM APMApplication)	Low	Read
`query_traces`	Query distributed traces	`actor.account.nrql` (FROM Transaction)	Low	Read
`get_transaction_traces`	Get transaction trace details	NRQL via executeNRQL	Low	Read
`get_trace_details`	Get specific trace details	NRQL via executeNRQL	Low	Read

Alert Policies & Conditions

Tool	Description	GraphQL Operation	Risk	Impact
`list_alerts`	List all alert policies	`actor.account.alerts.policiesSearch`	Low	Read
`get_alert_policy`	Get a single alert policy by ID	`actor.account.alerts.policy`	Low	Read
`get_alert_conditions`	Get conditions for a policy	`actor.account.alerts.alertConditionsSearch`	Low	Read
`get_alert_violations`	Get active alert violations	`actor.account.nrql` (NRQL alert query)	Low	Read
`list_nrql_alert_conditions`	List NRQL conditions for a policy	`actor.account.alerts.nrqlConditionsSearch`	Low	Read
`create_alert_policy`	Create a new alert policy	`alertsPolicyCreate`	Low	Write
`update_alert_policy`	Update an alert policy	`alertsPolicyUpdate`	Low	Write
`delete_alert_policy`	Delete an alert policy	`alertsPolicyDelete`	High	Write
`create_alert_condition`	Create an NRQL alert condition	`alertsNrqlConditionCreate`	Med	Write
`acknowledge_alert_violation`	Acknowledge an alert violation	`alertsViolationAcknowledge`	Med	Write

Synthetic Monitoring

Tool	Description	GraphQL Operation	Risk	Impact
`list_synthetic_monitors`	List all synthetic monitors	`actor.entitySearch` (domain:SYNTH, type:MONITOR)	Low	Read
`get_synthetic_monitor`	Get a synthetic monitor by GUID	`actor.entity` (SyntheticMonitorEntityOutline)	Low	Read
`list_private_locations`	List private locations	`actor.entitySearch` (domain:SYNTH, type:PRIVATE_LOCATION)	Low	Read
`create_ping_monitor`	Create a simple ping monitor	`syntheticsCreateSimpleMonitor`	Low	Write
`delete_synthetic_monitor`	Delete a synthetic monitor	`syntheticsDeleteMonitor`	Med	Write

Dashboards

Tool	Description	GraphQL Operation	Risk	Impact
`list_dashboards`	List all dashboards	`actor.entitySearch` (domain:DASH, type:DASHBOARD)	Low	Read
`get_dashboard`	Get full dashboard configuration by GUID	`actor.entity` (DashboardEntity)	Low	Read
`get_dashboard_data`	Get dashboard widget data	`actor.entity` (DashboardEntity)	Low	Read
`create_dashboard`	Create a new dashboard	`dashboardCreate`	Low	Write
`update_dashboard`	Update an existing dashboard	`dashboardUpdate`	Low	Write
`delete_dashboard`	Delete a dashboard	`dashboardDelete`	Med	Write
`add_dashboard_widget`	Add a widget to a dashboard	`dashboardUpdate`	Med	Write

Logs

Tool	Description	GraphQL Operation	Risk	Impact
`search_logs`	Search logs with Lucene syntax	`actor.account.nrql` (FROM Log)	Med	Read
`tail_logs`	Stream recent log entries	`actor.account.nrql` (FROM Log)	Med	Read

Infrastructure

Tool	Description	GraphQL Operation	Risk	Impact
`get_infrastructure_metrics`	Get host/container metrics	`actor.account.nrql` (FROM SystemSample)	Low	Read

Alert Workflows (aiWorkflows)

Tool	Description	GraphQL Operation	Risk	Impact
`list_workflows`	List alert notification workflows	`actor.account.aiWorkflows.workflows`	Low	Read
`get_workflow`	Get a workflow by ID	`actor.account.aiWorkflows.workflows` (filter)	Low	Read
`create_workflow`	Create a new alert workflow	`aiWorkflowsCreateWorkflow`	Low	Write
`update_workflow`	Update a workflow	`aiWorkflowsUpdateWorkflow`	Low	Write
`delete_workflow`	Delete a workflow	`aiWorkflowsDeleteWorkflow`	High	Write

Notification Channels & Destinations (aiNotifications)

Tool	Description	GraphQL Operation	Risk	Impact
`list_notification_channels`	List all notification channels	`actor.account.aiNotifications.channels`	Low	Read
`list_destinations`	List notification destinations	`actor.account.aiNotifications.destinations`	Low	Read
`create_slack_channel`	Create a Slack notification channel	`aiNotificationsCreateChannel` (type:SLACK)	Low	Write
`create_email_channel`	Create an email notification channel	`aiNotificationsCreateChannel` (type:EMAIL)	Low	Write
`delete_notification_channel`	Delete a notification channel	`aiNotificationsDeleteChannel`	High	Write

Service Levels

Tool	Description	GraphQL Operation	Risk	Impact
`list_service_levels`	List SLIs for an entity	`actor.entity` (... EntityInterfaceWithServiceLevel)	Low	Read
`create_service_level`	Create an SLI with SLO	`serviceLevelCreate`	Med	Write
`update_service_level`	Update an SLI's SLO target	`serviceLevelUpdate`	Low	Write

Tag Management (tagging)

Tool	Description	GraphQL Operation	Risk	Impact
`get_entity_tags`	Get all tags for an entity	`actor.entity.tags`	Low	Read
`add_entity_tags`	Add tags to an entity	`taggingAddTagsToEntity`	Low	Write
`remove_entity_tags`	Remove tags from an entity	`taggingDeleteTagFromEntity`	Med	Write
`replace_entity_tags`	Replace all tags on an entity	`taggingReplaceTagsOnEntity`	Med	Write

Entity Operations

Tool	Description	GraphQL Operation	Risk	Impact
`search_entities`	Advanced entity search	`actor.entitySearch` (queryBuilder)	Low	Read
`delete_entity`	Delete entities by GUID	`entityDelete`	High	Write

Cross-Account NRQL

Tool	Description	GraphQL Operation	Risk	Impact
`cross_account_nrql`	Run NRQL across multiple accounts	`actor.nrql` (multi-account)	Med	Read

Workloads

Tool	Description	GraphQL Operation	Risk	Impact
`list_workloads`	List all workloads for an account	`actor.account.workload.workloads`	Low	Read
`get_workload`	Get a workload by GUID	`actor.entity` (WorkloadEntity)	Low	Read

NerdGraph Reference

All tools access the New Relic NerdGraph API. The following NerdGraph query/mutation names are used:

GraphQL Operation	Documentation
`actor.entity`	Entity
`actor.entitySearch`	Entity Search
`actor.account.nrql`	NRQL
`alertsPolicyCreate / Update / Delete`	Alert Policies
`alertsNrqlConditionCreate`	NRQL Alert Conditions
`syntheticsCreateSimpleMonitor`	Synthetic Monitoring
`dashboardCreate / Update / Delete`	Dashboards
`aiWorkflowsCreate / Update / DeleteWorkflow`	Workflows
`aiNotificationsCreateChannel / DeleteChannel`	Notification Channels
`serviceLevelCreate / Update`	Service Levels
`taggingAddTagsToEntity / DeleteTagFromEntity / ReplaceTagsOnEntity`	Tags
`entityDelete`	Entity Deletion

Installation

Prerequisites

Go 1.22 or later
New Relic account with API access

Building from Source

git clone https://github.com/karldane/newrelic-mcp.git
cd newrelic-mcp
make

Build Options

make              # Download deps and build (default)
make deps         # Download dependencies only
make build        # Build binary only (assumes deps exist)
make build-all    # Build for Linux, macOS, and Windows
make test         # Run tests
make clean        # Remove build artifacts
make install      # Install to GOPATH/bin
make help         # Show all options

Configuration

Environment Variables

Variable	Description	Required	Default
`NEWRELIC_API_KEY`	New Relic API key (User or Admin)	Yes	-
`NEWRELIC_REGION`	Data center region (`us` or `eu`)	No	`us`

Obtaining an API Key

Log in to your New Relic account
Go to API Keys in the account settings
Create a User Key (for read-only) or Admin Key (for write operations)
Copy the key and set it as NEWRELIC_API_KEY

Usage

Basic Usage (Read-Only)

export NEWRELIC_API_KEY="your-api-key"
./newrelic-mcp

Enable Write Operations

Write operations require the -write-enabled flag:

export NEWRELIC_API_KEY="your-api-key"
./newrelic-mcp -write-enabled

Write tools are disabled by default. When -write-enabled is set, all mutations (create, update, delete, acknowledge) become available. Each write tool carries an EnforcerProfile with ImpactWrite so MCP Bridge operators can enforce policies independently.

Tools List

Query the full tool list via MCP:

{
  "tool": "tools/list"
}

Safety Features

EnforcerProfile Metadata

Every tool declares its safety profile:

Field	Description	Values
`RiskLevel`	Potential impact of misuse	low, med, high, critical
`ImpactScope`	What the tool affects	read, write
`ResourceCost`	API call weight (1-10)	integer
`PIIExposure`	Whether tool returns sensitive data	true / false
`Idempotent`	Whether retries are safe	true / false

This metadata enables automated policy enforcement by MCP Bridge without hardcoding tool lists.

Risk Classification

Low Risk: Read-only queries, log searches, metric retrieval, listing operations
Medium Risk: Creating non-destructive resources (alert conditions, service levels, dashboards, channels), acknowledging alerts
High Risk: Deleting resources (policies, entities, dashboards, workflows, channels)

Write Protection

Write tools are disabled by default and require:

Valid New Relic API key with appropriate permissions
-write-enabled command-line flag

Examples

Query Application Performance

{
  "tool": "nrql_query",
  "arguments": {
    "query": "SELECT average(duration) FROM Transaction WHERE appName = 'MyApp' TIMESERIES SINCE 1 hour ago"
  }
}

List Active Alerts

{
  "tool": "get_alert_violations",
  "arguments": {}
}

Create a Ping Monitor

{
  "tool": "create_ping_monitor",
  "arguments": {
    "name": "My Monitor",
    "uri": "https://example.com/health",
    "locations": "US_EAST_1,US_WEST_1",
    "period": "EVERY_5_MINUTES"
  }
}

Cross-Account NRQL Query

{
  "tool": "cross_account_nrql",
  "arguments": {
    "query": "SELECT count(*) FROM Transaction",
    "account_ids": "1234567,7654321"
  }
}

Architecture

The server wraps the New Relic GraphQL client and registers each tool through the MCP Framework. The tools map 1:1 to NerdGraph operations — no REST API calls are made.

Client (MCP Host)
    │
    ▼
newrelic-mcp (MCP Server)
    │
    ├── actorGraphQuery  →  actor.*  (entities, entitySearch, cross-account NRQL)
    ├── nerdGraphQuery   →  actor.account.*  (alerts, workflows, notifications, workloads)
    ├── rawGraphQuery    →  mutation results
    └── executeNRQL      →  actor.account.nrql  (NRQL query tools)
         │
         ▼
New Relic NerdGraph (api.newrelic.com/graphql)

Testing

go test ./newrelic -v

Tests cover:

Happy path (mock NerdGraph responses)
Empty/no-results responses
Missing required parameters
Write-enabled / write-disabled gating
API error responses
Unexpected response format

License

This project is licensed under the Functional Source License, Version 1.1, ALv2 Future License.

See LICENSE file for full terms.

References

MCP Framework — Base framework with EnforcerProfile support
New Relic NerdGraph API
NRQL Reference
New Relic API Explorer — Interactive GraphQL playground

Tool Inventory

The server registers 55 tools total:

6 NRQL / APM / Trace tools: nrql_query, list_applications, get_apm_metrics, get_application_metrics, query_traces, get_transaction_traces, get_trace_details
10 Alert tools: list_alerts, get_alert_policy, get_alert_conditions, get_alert_violations, list_nrql_alert_conditions, create_alert_policy, update_alert_policy, delete_alert_policy, create_alert_condition, acknowledge_alert_violation
5 Synthetic Monitoring tools: list_synthetic_monitors, get_synthetic_monitor, list_private_locations, create_ping_monitor, delete_synthetic_monitor
7 Dashboard tools: list_dashboards, get_dashboard, get_dashboard_data, create_dashboard, update_dashboard, delete_dashboard, add_dashboard_widget
2 Log tools: search_logs, tail_logs
1 Infrastructure tool: get_infrastructure_metrics
5 Workflow tools: list_workflows, get_workflow, create_workflow, update_workflow, delete_workflow
5 Notification tools: list_notification_channels, list_destinations, create_slack_channel, create_email_channel, delete_notification_channel
3 Service Level tools: list_service_levels, create_service_level, update_service_level
4 Tag tools: get_entity_tags, add_entity_tags, remove_entity_tags, replace_entity_tags
2 Entity tools: search_entities, delete_entity
1 Cross-account NRQL tool: cross_account_nrql
2 Workload tools: list_workloads, get_workload

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

0dRelease cycle

10Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Servers

New Relic MCP Server
Monitoring Observability
piekstra
A
license
B
quality
B
maintenance
Enables AI assistants to interact with New Relic monitoring and observability data through programmatic access to New Relic APIs. Supports APM management, NRQL queries, alert policies, synthetic monitoring, dashboards, infrastructure monitoring, and deployment tracking.
Last updated 2026-07-15
26
6
MIT
NewRelic MCP Server
Monitoring Observability Data Platforms
ruminaider
A
license
A
quality
D
maintenance
A comprehensive MCP server providing over 26 tools for querying, monitoring, and analyzing NewRelic data through NRQL queries and entity management. It enables interaction with NewRelic's NerdGraph API for managing alerts, logs, and incidents directly within Claude Code sessions.
Last updated 2026-03-20
24
228
2
MIT
New Relic MCP Server
Monitoring Observability
xelber
F
license
A
quality
D
maintenance
Enables AI agents to access New Relic logs and APM data through the NerdGraph API. It allows users to execute NRQL queries, retrieve application performance metrics, and analyze transaction traces using natural language.
Last updated 2025-11-05
6
1
newrelic-mcp
Monitoring Observability
kavingas
F
license
-
quality
B
maintenance
Executes NRQL queries against New Relic via the NerdGraph API, enabling monitoring and observability data retrieval through natural language.
Last updated 2026-05-27

View all related MCP servers

Related MCP Connectors

DATPAQ
34 production API tools over one hosted MCP endpoint.
Monday
Monday.com MCP — wraps the Monday.com GraphQL API (BYO API key)
pullpush-mcp
Connect any two APIs and keep them in sync — 45 MCP tools with shadow previews and diagnostics.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/karldane/newrelic-mcp'

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