Netra MCP - What is Netra? | Technical documentation

Netra exposes a remote MCP server so you can pull observability context directly into your editor or agent workspace.

Choose the MCP endpoint that matches your Netra data region, then replace the API key placeholder with your own project API key.

Server Details

Region-specific MCP endpoints:
Auth header: x-api-key

NETRA_MCP_ENDPOINT="https://api.getnetra.ai/mcp"
NETRA_API_KEY="<your-api-key-here>"

Use the endpoint that matches the region where your Netra project is hosted.

Client Setup

Claude Code
Cursor
Windsurf
Antigravity
Codex

Add the Netra MCP server directly from the command line:

claude mcp add netra --transport http <your-netra-mcp-endpoint> --header "x-api-key: <your-netra-api-key>"

Alternatively, add it via JSON:

claude mcp add-json netra '{"type": "http", "url": "<your-netra-mcp-endpoint>", "headers": {"x-api-key": "<your-netra-api-key>"}}'

To verify the server was added correctly:

claude mcp list

Add this netra entry to your MCP server configuration in mcp.json:

"netra": {
  "url": "<your-netra-mcp-endpoint>",
  "headers": {
    "x-api-key": "<your-netra-api-key>"
  }
}

Add this netra entry to your MCP server configuration in mcp_config.json:

"netra": {
  "url": "<your-netra-mcp-endpoint>",
  "headers": {
    "x-api-key": "<your-netra-api-key>"
  }
}

Add this netra server definition to your MCP configuration in mcp.json:

"netra": {
  "serverUrl": "<your-netra-mcp-endpoint>",
  "headers": {
    "x-api-key": "<your-netra-api-key>"
  }
}

Add this block to ~/.codex/config.toml:

[mcp_servers.netra]
enabled = true
url = "<your-netra-mcp-endpoint>"

[mcp_servers.netra.http_headers]
x-api-key = "<your-netra-api-key>"

Codex also supports managing MCP servers from the CLI, but custom HTTP headers like x-api-key should be set in the config file.

Why Netra MCP

Integrate Netra’s observability context directly into your development workflow. The Netra MCP server enables your AI coding assistant to query traces, filter performance data, and gain deep system insights without leaving the IDE. By bridging the gap between telemetry and your code, it helps you identify and resolve complex LLM performance issues as they happen.

Available Tools

Tool	Description
`netra_get_trace_by_id`	Retrieve all spans for a given trace ID
`netra_query_traces`	Get traces using trace filters (like the filter field in the dashboard)

Troubleshooting

Ensure your JSON/TOML configs are properly formatted
Confirm the MCP server is reachable at your region-specific MCP endpoint
Verify your API key is correct and has not expired
Restart the client after making config changes

Next Step

After saving your config, restart the client and confirm the netra MCP server shows up in the available tools or MCP server list.

Get Started

​Server Details

​Client Setup

​Why Netra MCP

​Available Tools

​Troubleshooting

​Next Step

Server Details

Client Setup

Why Netra MCP

Available Tools

Troubleshooting

Next Step