Skip to main content
Glama

New Relic MCP Server

by cloudbring
npmGitHub
JavaScript
MIT License
18
3
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

New Relic MCP Server

smithery badge

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.

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

npx @smithery/cli install 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:

# 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":"..."}' # 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

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.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" } } } }

Add to your Cline settings in VS Code:

{ "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" } } ] }

Add to your Zed configuration file at ~/.config/zed/settings.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" } } } } } }

Add to your Windsurf Cascade configuration:

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

  1. Clone the repository:

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

  1. Install dependencies and build:

npm install npm run build

  1. Add to your MCP client configuration:

{ "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" } } } }

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)

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

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

"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

"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

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

Search Infrastructure

"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

If you're having trouble connecting:

  1. Verify your API key is valid:

    curl -X POST https://api.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

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

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:

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

  1. Install dependencies:

npm install

  1. Create a .env file:

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

  1. Build the project:

npm run build

Development Commands

# 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

# 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:

# 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

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

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

Deploy Server
A
security – no known vulnerabilities
-
license - not tested
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Run NRQL, NerdGraph, and REST v2 operations to query data, manage incidents, create synthetics, and annotate deployments — all from your MCP client.

  1. Features
    1. Installation
      1. Quick Install with Smithery
      2. Smithery CLI (recommended)
      3. Manual Installation
    2. Configuration
      1. Required Environment Variables
      2. Getting Your New Relic Credentials
    3. Usage Examples
      1. Query Your Data
      2. Monitor Applications
      3. Manage Alerts
      4. Search Infrastructure
    4. Tool Reference
      1. NerdGraph/GraphQL tools
      2. REST v2 tools (added in v2.0)
    5. Troubleshooting
      1. Development
        1. Project Structure
        2. Setup Development Environment
        3. Development Commands
        4. Testing
        5. Debugging
        6. Architecture
      2. Contributing
        1. Development Workflow
        2. Code Style
      3. Documentation
        1. Comparisons
          1. Support
            1. License
              1. Disclaimer
                1. Acknowledgments

                  Related Resources

                  Related MCP Servers

                  • mcp-graphql

                    blurrah
                    A
                    security
                    -
                    license
                    A
                    quality
                    MCP for working with GraphQL servers.
                    Last updated -
                    2
                    502
                    296
                    MIT License
                    • Apple

                  • Neo4j MCP Server

                    ujjalcal
                    -
                    security
                    -
                    license
                    -
                    quality
                    An MCP server that enables graph database interactions with Neo4j, allowing users to access and manipulate graph data through natural language commands.
                    Last updated -

                  • mcp-graphql-schema

                    hannesj
                    -
                    security
                    -
                    license
                    -
                    quality
                    A MCP server that exposes GraphQL schema information to LLMs like Claude. This server allows an LLM to explore and understand large GraphQL schemas through a set of specialized tools, without needing to load the whole schema into the context
                    Last updated -
                    17
                    42
                    MIT License
                    • Apple
                    • Linux

                  • Nx MCP Serverofficial

                    nrwl
                    -
                    security
                    -
                    license
                    -
                    quality
                    The Nx MCP server provides LLMs with comprehensive insights into your monorepo: project dependencies, file relationships, executable tasks, ownership metadata, technology stacks, custom generators, and Nx documentation. This deep context enables LLMs to produce code perfectly aligned with your archi
                    Last updated -
                    39,084
                    1,380
                    MIT License

                  View all related MCP servers

                  New MCP Servers

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

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