New Relic NerdGraph MCP Server

This repository provides a Model Context Protocol (MCP) server for interacting with the New Relic NerdGraph API. It allows MCP clients (like Claude Desktop) to use natural language or specific commands to query and interact with your New Relic account data and features.

Built using the fastmcp framework.

Features

This MCP server exposes various New Relic capabilities as tools and resources, including:

• Account Details: Fetch basic information about the configured account.
• Generic NerdGraph Queries: Execute arbitrary NerdGraph queries.
• NRQL Queries: Run specific NRQL queries against your account data.
• Entity Management: Search for entities (Applications, Hosts, Monitors, etc.) and retrieve detailed information by GUID.
• APM: List Application Performance Monitoring (APM) applications.
• Synthetics: List Synthetic monitors and create simple browser monitors.
• Alerts: List alert policies, view open incidents, and acknowledge incidents.

Prerequisites

• Python: Python 3.10+ recommended (as required by fastmcp).
• pip: Python package installer.
• New Relic Account: Access to a New Relic account.
• New Relic User API Key: A User API key is required for authentication. You can generate one here. Keep this key secure!
• New Relic Account ID: Your New Relic Account ID is needed for most operations. You can find it in the New Relic UI (often in the URL or account settings).

Setup & Installation

1. Clone the Repository:

   git clone  # Replace  with the actual URL
   cd mcp-server-newrelic
   

2. Install Dependencies:

   pip install -r requirements.txt
   

   This will install fastmcp, requests, and their dependencies.

Configuration

The server requires your New Relic API Key and Account ID to function. Configure these using environment variables before running the server:

# Replace YOUR_API_KEY and YOUR_ACCOUNT_ID with your actual credentials
export NEW_RELIC_API_KEY="YOUR_API_KEY"
export NEW_RELIC_ACCOUNT_ID="YOUR_ACCOUNT_ID"