honeycomb-mcp-server

Instructions

Implementation Reference

• index.ts:725-738 (handler)

  MCP CallToolRequest handler case for 'honeycomb_query_result_get'. Extracts arguments (datasetSlug, queryResultId), calls HoneycombClient.getQueryResult, and returns JSON response.

  case "honeycomb_query_result_get": {
    const args = request.params
      .arguments as unknown as QueryResultGetArgs;
    if (!args.datasetSlug || !args.queryResultId) {
      throw new Error("datasetSlugとqueryResultIdが必要です");
    }
    const response = await client.getQueryResult(
      args.datasetSlug,
      args.queryResultId
    );
    return {
      content: [{ type: "text", text: JSON.stringify(response) }],
    };
  }

• index.ts:325-342 (schema)

  Tool definition object for 'honeycomb_query_result_get' including name, description, and inputSchema for validation (datasetSlug and queryResultId required).

  const queryResultGetTool: Tool = {
    name: "honeycomb_query_result_get",
    description: "Get query results for a previously executed query. The response body will be a JSON object with 'complete': true and the results populated once the query is complete.",
    inputSchema: {
      type: "object",
      properties: {
        datasetSlug: {
          type: "string",
          description: "The dataset slug or use `__all__` for endpoints that support environment-wide operations.",
        },
        queryResultId: {
          type: "string",
          description: "The unique identifier (ID) of the query result.",
        },
      },
      required: ["datasetSlug", "queryResultId"],
    },
  };

• index.ts:791-792 (registration)

  Registration of the tool in the list returned by ListToolsRequest handler.

  queryResultCreateTool,
  queryResultGetTool,

• index.ts:562-578 (helper)

  HoneycombClient.getQueryResult method: Performs HTTP GET request to Honeycomb API endpoint /query_results/{datasetSlug}/{queryResultId} to fetch the query results, handles errors, returns JSON.

  async getQueryResult(datasetSlug: string, queryResultId: string): Promise<any> {
    const response = await fetch(
      `${this.baseUrl}/query_results/${datasetSlug}/${queryResultId}`,
      {
        method: "GET",
        headers: this.headers,
      }
    );
  
    if (!response.ok) {
      const errorBody = await response.text();
      console.error(`Query result error: Status=${response.status}, Body=${errorBody}`);
      throw new Error(`Failed to get query result: ${response.statusText}`);
    }
  
    return await response.json();
  }

• index.ts:75-78 (schema)

  TypeScript interface defining the input arguments for the honeycomb_query_result_get tool.

  interface QueryResultGetArgs {
    datasetSlug: string;
    queryResultId: string;
  }