New Relic

You set up an MCP server that connects to New Relic APIs through a unified interface, enabling you to query metrics, manage alerts, monitor applications, and inspect observability entities across your stack. This server is designed to be used with MCP clients to simplify automation and command execution against New Relic services.

How to use

Use an MCP client to interact with the New Relic MCP Server. You can run NRQL queries, fetch APM data, search for entities, manage alerts and incidents, and work with synthetics monitors. Leverage REST v2 endpoints for deployments, metrics, and alert policies, and use NerdGraph for direct GraphQL queries against New Relic APIs.

How to install

Choose one of the installation paths to run the MCP server locally or deploy it in your development environment.

Option 1: Quick install with Smithery (recommended for streamlined development and testing)

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

Option 2: Manual installation for local development (useful when you want full control over the environment and runtime)

# Clone the repository
git clone https://github.com/cloudbring/newrelic-mcp.git
cd newrelic-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Add to your MCP client configuration

Manual MCP server configuration for local development

If you are configuring a local MCP client to run the New Relic MCP Server, use the following explicit command to start the server in your environment.

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

You configure credentials and region information to connect to New Relic from your MCP client. The required environment variable is the API key, while the account ID and region can be supplied to target specific accounts or data centers.

Required environment variables

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

Usage examples

Interact with New Relic using your MCP client by issuing natural language-like commands to perform queries, explore entities, and manage alerts. You can ask for NRQL results, list APM applications, search for infrastructure entities, and review incidents and synthetic monitors.

Tool Reference

The MCP server exposes a collection of tools to perform specific actions against New Relic APIs. Each tool is designed to be called with well-defined inputs and returns structured outputs.

Troubleshooting

If you encounter connection or permission issues, verify your API key and region, ensure the account ID is correct, and check client logs for detailed error messages.

Development

For contributors, the project follows a modular structure with a client layer, tools layer, and server layer. You can run tests, develop new features, and verify changes with the provided commands.

License and disclaimer

This MCP server is an independent community project and is not affiliated with or endorsed by New Relic. It uses public New Relic APIs to integrate observability data.

Available tools

run_nrql_query

Execute NRQL queries against your New Relic data, returning insights from metric data.

run_nerdgraph_query

Execute raw NerdGraph GraphQL queries to access New Relic’s GraphQL API.

list_apm_applications

List APM applications and their basic status via NerdGraph.

search_entities

Search entities by name, type, or tags across your infrastructure.

get_entity_details

Fetch detailed information for a specific entity GUID.

list_alert_policies

List alert policies available in your account via NerdGraph.

list_open_incidents

List currently open incidents in your environment.

acknowledge_incident

Acknowledge an incident to indicate awareness and ongoing remediation.

list_synthetics_monitors

List Synthetics monitors and their current status.

create_browser_monitor

Create or manage browser monitors for synthetic checks.

get_account_details

Fetch metadata for your New Relic account.

create_deployment

Create a deployment marker for an APM application (REST v2 tool).

list_deployments_rest

List deployments for an APM application via REST v2.

delete_deployment

Delete a deployment marker via REST v2 (requires admin permissions).

list_apm_applications_rest

List APM applications via REST with filter options.

list_metric_names_for_host

List metric names available for a host within an app.

get_metric_data_for_host

Retrieve time-sliced metric data for a host.

list_application_hosts

List hosts associated with an APM application.

list_alert_policies_rest

List alert policies via REST with optional filters.

list_open_incidents_rest

List incidents via REST (client-side filtering may apply).