New Relic MCP Server

Instructions

Implementation Reference

• src/tools/nerdgraph.ts:33-43 (handler)

  The primary handler for the 'run_nerdgraph_query' tool. Validates the GraphQL query and variables input using Zod, then delegates execution to the NewRelicClient.

  async execute(input: unknown): Promise<unknown> {
    // Validate input with Zod for consistency
    const schema = z.object({
      query: z.string().min(1, 'Invalid or empty GraphQL query provided'),
      variables: z.record(z.any()).optional(),
    });
  
    const { query, variables } = schema.parse(input);
  
    return await this.client.executeNerdGraphQuery(query, variables);
  }

• src/tools/nerdgraph.ts:12-30 (schema)

  Defines the tool's metadata, including name, description, and input schema specifying a required 'query' string and optional 'variables' object.

  getQueryTool(): Tool {
    return {
      name: 'run_nerdgraph_query',
      description: 'Execute a custom NerdGraph GraphQL query',
      inputSchema: {
        type: 'object',
        properties: {
          query: {
            type: 'string',
            description: 'The GraphQL query to execute',
          },
          variables: {
            type: 'object',
            description: 'Optional GraphQL variables to supply to the query',
          },
        },
        required: ['query'],
      },
    };

• src/server.ts:79-80 (registration)

  Registers the 'run_nerdgraph_query' tool by including NerdGraphTool.getQueryTool() in the server's list of available tools.

  nerdGraphTool.getQueryTool(),
  // REST v2 tools

• src/server.ts:283-284 (handler)

  Server-side dispatch handler that instantiates NerdGraphTool and calls its execute method for 'run_nerdgraph_query' tool invocations.

  case 'run_nerdgraph_query':
    return await new NerdGraphTool(this.client).execute(args);