New Relic MCP Server

Instructions

Implementation Reference

• src/tools/entity.ts:103-163 (handler)

  Core handler function that executes a comprehensive NerdGraph GraphQL query to retrieve detailed entity information, including GUID, name, type, tags, alert violations, APM settings, relationships, and golden metrics.
  async getEntityDetails(input: { entity_guid: string }): Promise<Record<string, unknown>> { const graphqlQuery = `{ actor { entity(guid: "${input.entity_guid}") { guid name type domain entityType reporting tags { key values } ... on AlertableEntity { alertSeverity recentAlertViolations { alertSeverity violationId openedAt closedAt violationUrl } } ... on ApmApplicationEntity { language settings { apdexTarget } } relationships { type target { entities { guid name } } } goldenMetrics { metrics { name value unit } } } } }`; const response = (await this.client.executeNerdGraphQuery(graphqlQuery)) as { data?: { actor?: { entity?: Record<string, unknown> } }; }; const entity = response.data?.actor?.entity; if (!entity) { throw new Error('Entity not found'); } return entity; }
• src/tools/entity.ts:37-52 (schema)

  Defines the MCP Tool specification for 'get_entity_details', including name, description, and inputSchema requiring a non-empty 'entity_guid' string.
  getDetailsTool(): Tool { return { name: 'get_entity_details', description: 'Get detailed information about a specific entity', inputSchema: { type: 'object', properties: { entity_guid: { type: 'string', description: 'The GUID of the entity', }, }, required: ['entity_guid'], }, }; }
• src/server.ts:57-106 (registration)

  Registers the get_entity_details tool (via entityTool.getDetailsTool()) along with other tools into the server's tools map, which is used for tool listing and discovery.
  private registerTools(): void { const nrqlTool = new NrqlTool(this.client); const apmTool = new ApmTool(this.client); const entityTool = new EntityTool(this.client); const alertTool = new AlertTool(this.client); const syntheticsTool = new SyntheticsTool(this.client); const nerdGraphTool = new NerdGraphTool(this.client); const restDeployments = new RestDeploymentsTool(); const restApm = new RestApmTool(); const restMetrics = new RestMetricsTool(); // Register all tools const tools = [ nrqlTool.getToolDefinition(), apmTool.getListApplicationsTool(), entityTool.getSearchTool(), entityTool.getDetailsTool(), alertTool.getPoliciesTool(), alertTool.getIncidentsTool(), alertTool.getAcknowledgeTool(), syntheticsTool.getListMonitorsTool(), syntheticsTool.getCreateMonitorTool(), nerdGraphTool.getQueryTool(), // REST v2 tools restDeployments.getCreateTool(), restDeployments.getListTool(), restDeployments.getDeleteTool(), restApm.getListApplicationsTool(), restMetrics.getListMetricNamesTool(), restMetrics.getMetricDataTool(), restMetrics.getListApplicationHostsTool(), { name: 'get_account_details', description: 'Get New Relic account details', inputSchema: { type: 'object' as const, properties: { target_account_id: { type: 'string' as const, description: 'Optional account ID to get details for', }, }, }, }, ]; tools.forEach((tool) => { this.tools.set(tool.name, tool); }); }
• src/server.ts:246-252 (handler)

  Server dispatch handler for the tool: validates the entity_guid input argument and delegates execution to EntityTool.getEntityDetails.
  case 'get_entity_details': { const { entity_guid } = args as Record<string, unknown>; if (typeof entity_guid !== 'string' || entity_guid.trim() === '') { throw new Error('get_entity_details: "entity_guid" (non-empty string) is required'); } return await new EntityTool(this.client).getEntityDetails({ entity_guid }); }