How to add New Relic MCP Server to Windsurf

Query New Relic via NerdGraph: entity search, NRQL, deployments and infrastructure. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 60★ · stdio · apikey

Windsurf config for New Relic MCP Server

uvx newrelic-mcp-server

{
  "mcpServers": {
    "new-relic-mcp-server": {
      "command": "uvx",
      "args": [
        "newrelic-mcp-server"
      ],
      "env": {
        "NEWRELIC_REGION": "US",
        "NEWRELIC_API_KEY": "<your-user-api-key>",
        "NEWRELIC_ACCOUNT_ID": "<your-account-id>"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the New Relic MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5New Relic MCP Server's tools become available to Cascade.

Before you start

Python 3.10 or newer
A New Relic User API key (starts with NRAK), created from New Relic's API Keys page after logging in
Your New Relic account ID and region (US/EU), set via NEWRELIC_API_KEY, NEWRELIC_ACCOUNT_ID, and NEWRELIC_REGION (or stored in the macOS keychain)
An MCP-compatible client (Claude Desktop, Cursor, etc.); the server runs locally over stdio

What New Relic MCP Server can do in Windsurf

query_nrql

Run a NRQL query and return the results

nerdgraph_query

Execute an arbitrary NerdGraph (GraphQL) query for full API access

search_entities

Search across New Relic entities (apps, hosts, services, etc.)

list_applications

List APM applications; get_application and get_application_metrics fetch details and metrics

list_deployments

List deployments; create_deployment records a new deployment marker

list_dashboards

List dashboards; get_dashboard returns a dashboard definition

list_alert_policies

List alert policies; get_alert_policy returns policy details

list_synthetic_monitors

List Synthetics monitors; get_synthetic_monitor returns monitor details

Security

A New Relic User API key grants broad NerdGraph access including account data and user management, so scope the key carefully and avoid admin keys. Prefer the macOS keychain setup wizard over plaintext env vars, and set NEWRELIC_REGION to EU if your account is EU-hosted.

New Relic MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the New Relic MCP Server config there under the "mcpServers" key and restart the client.

Is New Relic MCP Server safe to use with Windsurf?

Is this an official New Relic server?

No. It is a third-party, community-maintained project by piekstra. It uses New Relic's public NerdGraph API but is not built or supported by New Relic.

What kind of API key do I need?

A New Relic User API key, which starts with NRAK. You create it from the API Keys page in the New Relic UI. License/ingest keys won't work for NerdGraph queries.

Does it support the EU data center?

Yes. Set NEWRELIC_REGION (US or EU) so requests hit the correct NerdGraph endpoint for your account.

View repo Full New Relic MCP Server page