AgentOps MCP

Instructions

Implementation Reference

• src/index.ts:328-360 (handler)

  The handler for the 'get_complete_trace' tool. It fetches the trace information and metrics, then recursively fetches complete span information and metrics for all child spans, and returns the full trace as JSON.

  case "get_complete_trace": {
    const { trace_id } = args as { trace_id: string };
    const [traceInfo, traceMetrics] = await Promise.all([
      makeAuthenticatedRequest(`/public/v1/traces/${trace_id}`),
      makeAuthenticatedRequest(`/public/v1/traces/${trace_id}/metrics`),
    ]);
    const parentTrace = { ...traceInfo, metrics: traceMetrics };
  
    if (parentTrace.spans && Array.isArray(parentTrace.spans)) {
      for (let i = 0; i < parentTrace.spans.length; i++) {
        if (parentTrace.spans[i].span_id) {
          const span_id = parentTrace.spans[i].span_id;
          const [childSpanInfo, childSpanMetrics] = await Promise.all([
            makeAuthenticatedRequest(`/public/v1/spans/${span_id}`),
            makeAuthenticatedRequest(`/public/v1/spans/${span_id}/metrics`),
          ]);
          parentTrace.spans[i] = {
            ...childSpanInfo,
            metrics: childSpanMetrics,
          };
        }
      }
    }
  
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(parentTrace, null, 2),
        },
      ],
    };
  }

• src/index.ts:209-223 (registration)

  Registers the 'get_complete_trace' tool in the list of available tools, including its name, description, and input schema.

  {
    name: "get_complete_trace",
    description:
      "Reserved for explicit requests for COMPLETE or ALL data. Get complete trace information and metrics by trace_id.",
    inputSchema: {
      type: "object",
      properties: {
        trace_id: {
          type: "string",
          description: "Trace ID",
        },
      },
      required: ["trace_id"],
    },
  },

• src/index.ts:213-222 (schema)

  Defines the input schema for the 'get_complete_trace' tool, requiring a 'trace_id' string.

  inputSchema: {
    type: "object",
    properties: {
      trace_id: {
        type: "string",
        description: "Trace ID",
      },
    },
    required: ["trace_id"],
  },