Gong MCP Server

Instructions

Implementation Reference

• src/gong.ts:351-358 (handler)

  Core handler function implementing the get_transcripts tool logic by calling the Gong API endpoint /v2/calls/transcript.

  async getTranscripts(callIds: string[]): Promise<TranscriptsResponse> {
  	const body = {
  		filter: {
  			callIds,
  		},
  	};
  	return this.request<TranscriptsResponse>('POST', '/calls/transcript', body);
  }

• src/index.ts:89-99 (schema)

  Input schema defining the parameters for the get_transcripts tool.

  inputSchema: {
    type: "object",
    properties: {
      callIds: {
        type: "array",
        items: { type: "string" },
        description: "Array of call IDs to retrieve transcripts for",
      },
    },
    required: ["callIds"],
  },

• src/index.ts:85-100 (registration)

  Tool registration in the listTools handler, providing name, description, and schema.

  {
    name: "get_transcripts",
    description:
      "Retrieve full transcripts for specified calls. Returns speaker-attributed, timestamped transcript text.",
    inputSchema: {
      type: "object",
      properties: {
        callIds: {
          type: "array",
          items: { type: "string" },
          description: "Array of call IDs to retrieve transcripts for",
        },
      },
      required: ["callIds"],
    },
  },

• src/index.ts:189-203 (handler)

  MCP server tool execution handler (dispatcher) for get_transcripts, which calls the core GongClient implementation.

  case "get_transcripts": {
    const callIds = args?.callIds as string[];
    if (!callIds?.length) {
      throw new Error("callIds is required and must be a non-empty array");
    }
    const result = await gong.getTranscripts(callIds);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(result, null, 2),
        },
      ],
    };
  }

• src/gong.ts:54-63 (schema)

  TypeScript interface for the output response structure of getTranscripts.

  export interface TranscriptsResponse {
  	requestId: string;
  	records: {
  		cursor?: string;
  		totalRecords: number;
  		currentPageSize: number;
  		currentPageNumber: number;
  	};
  	callTranscripts: CallTranscript[];
  }