New Relic MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with New Relic's observability platform. Query metrics, manage alerts, monitor applications, and interact with your entire observability stack through a simple, unified interface.

Disclaimer: This is an unofficial community project and is not affiliated with, endorsed by, or supported by New Relic, Inc. All trademarks are the property of their respective owners.

Features

📊 NRQL Queries - Execute powerful queries to analyze your data
🚀 APM Integration - Monitor application performance and health
🔔 Alert Management - View and acknowledge alerts and incidents
🔍 Entity Search - Discover and inspect entities across your infrastructure
📈 Synthetics Monitoring - Manage synthetic monitors and checks
🔧 NerdGraph API - Direct access to New Relic's GraphQL API
🌐 REST v2 Tools (2.0+) - High‑value REST endpoints for deployments, APM apps, metrics, and alerts

Installation

Quick Install with Smithery

To install or deploy via Smithery, see the official docs: Deployments, Project Configuration, and [smithery.yaml Reference](https://smithery.ai/docs/build/project-config/smithery-yaml).

To install New Relic MCP for Claude Desktop automatically via Smithery:

bash

npx @smithery/cli install @cloudbring/newrelic-mcp --client claude

Smithery CLI (recommended)

We recommend the Smithery CLI for local development, inspection, and deployment flows. Benefits:

Unified dev/build/deploy workflow, client‑agnostic
Dev server with hot‑reload and playground (optional tunnel)
Build bundles for stdio or shttp transports
Inspect a server interactively; run with supplied config
Simple install per client

Examples:

bash

# Hot‑reload dev server
npx @smithery/cli dev src/server.ts --port 8181 --no-open

# Build production bundle (shttp transport)
npx @smithery/cli build src/server.ts --out .smithery/index.cjs --transport shttp

# Inspect a published server
npx @smithery/cli inspect @cloudbring/newrelic-mcp

# Run with config (env via JSON)
npx @smithery/cli run @cloudbring/newrelic-mcp --config '{"NEW_RELIC_API_KEY":"...","NEW_RELIC_ACCOUNT_ID":"...","NEW_RELIC_REGION":"US"}'

# Install into a specific client
npx @smithery/cli install newrelic-mcp --client claude

# Open playground
npx @smithery/cli playground --port 3001

Notes:

This repo includes a minimal smithery.yaml with runtime: "typescript" to align with TypeScript‑first deployments.
See the CLI reference for all commands and flags: smithery-ai/cli.

Manual Installation

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

json

{
  "mcpServers": {
    "newrelic": {
      "command": "npx",
      "args": [
        "-y",
        "newrelic-mcp"
      ],
      "env": {
        "NEW_RELIC_API_KEY": "your-api-key-here",
        "NEW_RELIC_ACCOUNT_ID": "your-account-id",
        "NEW_RELIC_REGION": "US"
      }
    }
  }
}

Cline (VS Code)

Add to your Cline settings in VS Code:

json

{
  "cline.mcpServers": [
    {
      "name": "newrelic",
      "command": "npx",
      "args": ["-y", "newrelic-mcp"],
      "env": {
        "NEW_RELIC_API_KEY": "your-api-key-here",
        "NEW_RELIC_ACCOUNT_ID": "your-account-id",
        "NEW_RELIC_REGION": "US"
      }
    }
  ]
}

Zed Editor

Add to your Zed configuration file at ~/.config/zed/settings.json:

json

{
  "language_models": {
    "mcp": {
      "servers": {
        "newrelic": {
          "command": "npx",
          "args": ["-y", "newrelic-mcp"],
          "env": {
            "NEW_RELIC_API_KEY": "your-api-key-here",
            "NEW_RELIC_ACCOUNT_ID": "your-account-id"
          }
        }
      }
    }
  }
}

Windsurf Editor

Add to your Windsurf Cascade configuration:

json

{
  "mcpServers": {
    "newrelic": {
      "command": "npx",
      "args": ["-y", "newrelic-mcp"],
      "env": {
        "NEW_RELIC_API_KEY": "your-api-key-here",
        "NEW_RELIC_ACCOUNT_ID": "your-account-id",
        "NEW_RELIC_REGION": "US"
      }
    }
  }
}

Local Development

1. Clone the repository:

bash

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

2. Install dependencies and build:

bash

npm install
npm run build

3. Add to your MCP client configuration:

json

{
  "mcpServers": {
    "newrelic": {
      "command": "node",
      "args": ["/path/to/newrelic-mcp/dist/server.js"],
      "env": {
        "NEW_RELIC_API_KEY": "your-api-key-here",
        "NEW_RELIC_ACCOUNT_ID": "your-account-id",
        "NEW_RELIC_REGION": "US"
      }
    }
  }
}

Configuration

Required Environment Variables

NEW_RELIC_API_KEY - Your New Relic User API Key (required)
NEW_RELIC_ACCOUNT_ID - Your New Relic Account ID (optional, can be provided per tool call)
NEW_RELIC_REGION - New Relic data center region: US (default) or EU (optional)

Getting Your New Relic Credentials

1. API Key:

Log in to New Relic
Navigate to API Keys in the left sidebar
Create a new User API Key with appropriate permissions

2. Account ID:

Find your Account ID in the URL when logged into New Relic
Or navigate to Administration → Access management → Accounts

3. Region:

Set NEW_RELIC_REGION=US for US data center (default)
Set NEW_RELIC_REGION=EU for EU data center
If not specified, defaults to US

For detailed setup instructions, see docs/new-relic-setup.md.

Usage Examples

Once configured, you can interact with New Relic through your MCP client:

Query Your Data

text

"Show me the average response time for my web application over the last hour"
"What are the top 10 slowest database queries today?"
"Display error rate trends for the production environment"

Monitor Applications

text

"List all my APM applications and their current status"
"Show me the health of my Node.js services"
"Which applications have active alerts?"

Manage Alerts

text

"Show me all open incidents"
"What critical alerts fired in the last 24 hours?"
"Acknowledge incident #12345"

Search Infrastructure

text

"Find all Redis databases in production"
"Show me entities with high CPU usage"
"List all synthetic monitors and their success rates"

Tool Reference

Below is a concise catalog of all MCP tools exposed by this server. See the docs folder for detailed stories/specs.

NerdGraph/GraphQL tools

Tool	Summary
`run_nrql_query`	Execute NRQL queries (requires `target_account_id`)
`run_nerdgraph_query`	Execute raw NerdGraph GraphQL queries
`list_apm_applications`	List APM applications via NerdGraph
`search_entities`	Search entities (name, type, tags)
`get_entity_details`	Fetch details for a GUID
`list_alert_policies`	List alert policies via NerdGraph
`list_open_incidents`	List open incidents via NerdGraph
`acknowledge_incident`	Acknowledge an incident (NerdGraph only)
`list_synthetics_monitors`	List Synthetics monitors
`create_browser_monitor`	Create a browser monitor
`get_account_details`	Fetch account metadata

REST v2 tools (added in v2.0)

Tool	Summary	Notes
`create_deployment`	Create deployment marker for an APM application	Inputs: `application_id`, `revision`; optional `changelog`, `description`, `user`; supports `region`
`list_deployments_rest`	List deployments for an app	Supports `page`, `auto_paginate`, `region`
`delete_deployment`	Delete deployment marker	Requires `confirm: true`; User API key must have admin role permissions
`list_apm_applications_rest`	List APM apps via REST	Filters: `filter[name]`, `filter[host]`, `filter[ids]`, `filter[language]`; auto‑paginate
`list_metric_names_for_host`	List metric names/values for host	Inputs: `application_id`, `host_id`, optional `name`; auto‑paginate
`get_metric_data_for_host`	Get timeslice metric data for host	Inputs: `application_id`, `host_id`, `names[]`; optional `values[]`, `from`, `to`, `period`, `summarize`; auto‑paginate
`list_application_hosts`	List hosts for an APM app	Filters: `filter[hostname]`, `filter[ids]`; auto‑paginate
`list_alert_policies_rest`	List alert policies via REST	Optional `filter_name`; supports pagination
`list_open_incidents_rest`	List incidents via REST	Server has no `only_open`/`priority` filters; these are applied client‑side; auto‑paginate

References:

Detailed specs and schemas: docs/REST_ENDPOINT_TOOL.md and docs/rest-tools-stories/*

Troubleshooting

Connection Issues

If you're having trouble connecting:

1. Verify your API key is valid:

For US region:

bash

curl -X POST https://api.newrelic.com/graphql \
     -H 'Content-Type: application/json' \
     -H 'API-Key: YOUR_API_KEY' \
     -d '{"query":"{ actor { user { email } } }"}'

For EU region:

bash

curl -X POST https://api.eu.newrelic.com/graphql \
     -H 'Content-Type: application/json' \
     -H 'API-Key: YOUR_API_KEY' \
     -d '{"query":"{ actor { user { email } } }"}'

2. Check that your Account ID is correct

3. Ensure your API key has the necessary permissions

4. Check the MCP client logs for detailed error messages

Permission Errors

If you receive permission errors:

1. Verify your API key has the required permissions:

For NRQL queries: NRQL query permission
For APM data: APM read permissions
For alerts: Alerts read/write permissions

2. Create a new API key with broader permissions if needed

Development

Project Structure

text

src/
├── server.ts           # Main MCP server implementation
├── client/
│   └── newrelic-client.ts  # New Relic API client
└── tools/
    ├── nrql.ts         # NRQL query tool
    ├── apm.ts          # APM applications tool
    ├── entity.ts       # Entity management tools
    ├── alert.ts        # Alert and incident tools
    ├── synthetics.ts   # Synthetics monitoring tools
    └── nerdgraph.ts    # NerdGraph query tool

Setup Development Environment

1. Clone the repository:

bash

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

2. Install dependencies:

bash

npm install

3. Create a .env file:

bash

NEW_RELIC_API_KEY=your-api-key-here
NEW_RELIC_ACCOUNT_ID=your-account-id
NEW_RELIC_REGION=US

4. Build the project:

bash

npm run build

Development Commands

bash

# Start development server with hot reload
npm run dev

# Build for production
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Run linting
npm run lint

# Format code
npm run format

# Test server startup
npm run test:server

Testing

The project uses Test-Driven Development (TDD) with:

Vitest for unit testing
Gherkin for BDD testing
Evalite for LLM response validation

bash

# Run all tests
npm test

# Run with coverage
npm run test:coverage

# Run BDD tests only
npm run test:bdd

# Run integration tests with real API
USE_REAL_ENV=true npm test

Debugging

Use the MCP Inspector to test and debug the server:

bash

# Run with MCP Inspector
npm run inspect

# Run with development server
npm run inspect:dev

# Run with environment variables
npm run inspect:env

See docs/mcp-inspector-setup.md for detailed instructions.

Architecture

The server follows a modular architecture with:

Client Layer: Handles New Relic API communication
Tools Layer: Implements MCP tool specifications
Server Layer: Manages MCP protocol and tool routing

Each tool:

Has a single, focused purpose
Validates inputs using Zod schemas
Returns structured, typed responses
Includes comprehensive error handling

Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Workflow

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Write tests first (TDD approach)

4. Implement your feature

5. Ensure all tests pass (npm test)

6. Maintain >90% code coverage

7. Run linting (npm run lint)

8. Commit your changes (commits will be auto-formatted)

9. Push to your branch

10. Open a Pull Request

Code Style

This project uses:

Biome for linting and formatting
TypeScript with strict mode
2 spaces for indentation
Single quotes for strings
Semicolons always

Documentation

New Relic Setup Guide - Detailed credential setup
MCP Inspector Setup - Testing and debugging
Logging & Telemetry - Test monitoring
Implementation Details - Architecture deep dive
REST tools overview - High‑level design for REST v2 tools
REST tool stories - Per‑tool specs, schemas, and test plans

Comparisons

We researched other public New Relic MCP servers and did not find any actively maintained, feature‑complete alternatives at the time of writing. If you know of one, please open an issue to add it here.

Project	Status	Transport(s)	Deployments	APM Apps	Metrics	Alerts	Synthetics	Notes
This project (newrelic-mcp)	Active	NerdGraph + REST v2	Create/List/Delete	List (NerdGraph + REST)	Host names + timeslices (REST)	Policies + Incidents (NG + REST)	List/Create (browser)	Comprehensive tests and docs

Planned enhancements (based on REST v2 catalog and user demand):

Alerts: violations and conditions management via REST where available
Metrics: broader app‑level metrics endpoints (names/data) beyond per‑host
Additional REST coverage: labels, key transactions, mobile apps (prioritized by feedback)

Support

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

This project is not affiliated with, endorsed by, or supported by New Relic, Inc. It is an independent open-source project that uses New Relic's public APIs.

Acknowledgments

Built on the Model Context Protocol specification
Integrates with New Relic's observability platform APIs
Inspired by the broader MCP ecosystem

---

Made with ❤️ by @cloudbring using Cursor and Claude Code

Newrelic Mcp

Documentation

New Relic MCP Server

Features

Installation

Quick Install with Smithery

Smithery CLI (recommended)

Manual Installation

Configuration

Required Environment Variables

Getting Your New Relic Credentials

Usage Examples

Query Your Data

Monitor Applications

Manage Alerts

Search Infrastructure

Tool Reference

NerdGraph/GraphQL tools

REST v2 tools (added in v2.0)

Troubleshooting

Development

Project Structure

Setup Development Environment

Development Commands

Testing

Debugging

Architecture

Contributing

Development Workflow

Code Style

Documentation

Comparisons

Support

License

Disclaimer

Acknowledgments

Similar MCP

Waha Mcp

Wizzy Mcp Tmdb

Rijksmuseum Mcp

Mcp Server Playwright

Trending MCP

Playwright Mcp

Serena

Mcp Playwright

Mcp Server Cloudflare

Waha Mcp

Wizzy Mcp Tmdb

Rijksmuseum Mcp

Mcp Server Playwright

Playwright Mcp

Serena

Mcp Playwright

Mcp Server Cloudflare