New Relic
New Relic MCP Server - Model Context Protocol integration for New Relic monitoring, dashboards, and NRQL queries
What is New Relic?
New Relic is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to new relic mcp server - model context protocol integration for new relic monitoring, dashboards, and nrql queries
New Relic MCP Server - Model Context Protocol integration for New Relic monitoring, dashboards, and NRQL queries
This server falls under the Monitoring & Observability category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- New Relic MCP Server - Model Context Protocol integration fo
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-newrelicConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use New Relic
New Relic MCP Server is a Python-based server that integrates New Relic's monitoring platform with Claude via the Model Context Protocol. It exposes tools for running NRQL queries, managing dashboards and widgets, searching entities, configuring alerts and notification workflows, and listing synthetic monitors — giving you a natural-language interface to your observability data.
Prerequisites
- Python 3.11 or higher installed
- uv package manager (recommended) or pip
- A New Relic account with a user API key (format: NRAK-* or NRAA-*)
- New Relic account ID (visible in the New Relic URL after logging in)
- Claude Desktop or Claude Code installed
Clone the repository
Clone the mcp-newrelic repository from GitHub. The server is not currently published to PyPI so cloning is required.
git clone https://github.com/thrashy/mcp-newrelic.git
cd mcp-newrelicInstall dependencies with uv
Use uv sync to create a virtual environment and install all dependencies in one step. Alternatively use pip install -e . if you prefer pip.
uv sync
# Or with pip:
pip install -e .Set required environment variables
Export your New Relic credentials as environment variables. NEW_RELIC_API_KEY must be a user key (not an ingest/license key). NEW_RELIC_REGION defaults to US if not set.
export NEW_RELIC_API_KEY="NRAK-xxxxxxxxxxxxxxxxxxxx"
export NEW_RELIC_ACCOUNT_ID="1234567"
export NEW_RELIC_REGION="US" # or EUAdd the server to Claude Desktop configuration
Edit your Claude Desktop config to add the New Relic server. Use uv run to launch it inside the project's virtual environment so all dependencies are available.
{
"mcpServers": {
"newrelic": {
"command": "uv",
"args": ["--directory", "/path/to/mcp-newrelic", "run", "mcp-newrelic"],
"env": {
"NEW_RELIC_API_KEY": "NRAK-xxxxxxxxxxxxxxxxxxxx",
"NEW_RELIC_ACCOUNT_ID": "1234567",
"NEW_RELIC_REGION": "US"
}
}
}
}Verify by running a test NRQL query
Once Claude Desktop is restarted, ask Claude to run a simple NRQL query to confirm the server is connected and credentials are valid.
New Relic Examples
Client configuration
claude_desktop_config.json entry for the New Relic MCP server using uv to manage the Python environment.
{
"mcpServers": {
"newrelic": {
"command": "uv",
"args": ["--directory", "/Users/yourname/mcp-newrelic", "run", "mcp-newrelic"],
"env": {
"NEW_RELIC_API_KEY": "NRAK-YOURKEYHEREXXXXXXXXXXXXXXXX",
"NEW_RELIC_ACCOUNT_ID": "1234567",
"NEW_RELIC_REGION": "US"
}
}
}
}Prompts to try
Example natural-language prompts for querying and managing New Relic through Claude.
- "Run a NRQL query: SELECT average(duration) FROM Transaction SINCE 1 hour ago"
- "Show me the current open incidents in New Relic"
- "List all alert policies in my account"
- "Search for entities named 'checkout-service'"
- "Create a dashboard called 'API Performance' with an error rate widget"
- "List all synthetic monitors and their statuses"Troubleshooting New Relic
Authentication error: 'Invalid API key'
Ensure you are using a New Relic User API key (starts with NRAK- or NRAA-), not an ingest/license key. Generate one at https://one.newrelic.com/api-keys under User Keys.
NRQL queries return no data or account not found
Verify NEW_RELIC_ACCOUNT_ID is the numeric ID visible in the URL when you log into New Relic (e.g. https://one.newrelic.com/accounts/1234567). Check that NEW_RELIC_REGION matches your account (US vs EU).
uv run fails with 'no such command'
Install uv with curl -LsSf https://astral.sh/uv/install.sh | sh and ensure ~/.cargo/bin or ~/.local/bin is in your PATH. Alternatively fall back to pip install -e . and use python -m mcp_newrelic as the command.
Frequently Asked Questions about New Relic
What is New Relic?
New Relic is a Model Context Protocol (MCP) server that new relic mcp server - model context protocol integration for new relic monitoring, dashboards, and nrql queries It connects AI assistants to external tools and data sources through a standardized interface.
How do I install New Relic?
Follow the installation instructions on the New Relic GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with New Relic?
New Relic works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is New Relic free to use?
Yes, New Relic is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
New Relic Alternatives — Similar Monitoring & Observability Servers
Looking for alternatives to New Relic? Here are other popular monitoring & observability servers you can use with Claude, Cursor, and VS Code.
Netdata
★ 78.9kReal-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Kubeshark
★ 11.9keBPF-powered network observability for Kubernetes. Indexes L4/L7 traffic with full K8s context, decrypts TLS without keys. Queryable by AI agents via MCP and humans via dashboard.
Mission Control
★ 4.9kSelf-hosted AI agent orchestration platform: dispatch tasks, run multi-agent workflows, monitor spend, and govern operations from one mission control dashboard.
Grafana
★ 3.0kThis MCP server enables natural-language querying of Grafana logs by automatically detecting log sources and service labels. It provides read-only access to log data with intelligent caching for efficient repeat queries.
Sentrux
★ 2.4kReal-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improvement of code quality. Pure Rust.
OpenInference
★ 986OpenTelemetry Instrumentation for AI Observability
Browse More Monitoring & Observability MCP Servers
Explore all monitoring & observability servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up New Relic in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use New Relic?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.