retrieve_transcripts
Extracts detailed call transcripts from the Gong MCP Server, including speaker IDs, topics, and timestamped sentences, using specific call IDs for precise retrieval.
Instructions
Retrieve transcripts for specified call IDs. Returns detailed transcripts including speaker IDs, topics, and timestamped sentences.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| callIds | Yes | Array of Gong call IDs to retrieve transcripts for |
Implementation Reference
- src/index.ts:247-260 (handler)Executes the retrieve_transcripts tool: validates input arguments and invokes gongClient.retrieveTranscripts to fetch and return transcripts as JSON.case "retrieve_transcripts": { if (!isGongRetrieveTranscriptsArgs(args)) { throw new Error("Invalid arguments for retrieve_transcripts"); } const { callIds } = args; const response = await gongClient.retrieveTranscripts(callIds); return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }], isError: false, }; }
- src/index.ts:169-183 (registration)Registers the retrieve_transcripts tool with name, description, and input schema for the MCP server.const RETRIEVE_TRANSCRIPTS_TOOL: Tool = { name: "retrieve_transcripts", description: "Retrieve transcripts for specified call IDs. Returns detailed transcripts including speaker IDs, topics, and timestamped sentences.", inputSchema: { type: "object", properties: { callIds: { type: "array", items: { type: "string" }, description: "Array of Gong call IDs to retrieve transcripts for" } }, required: ["callIds"] } };
- src/index.ts:208-216 (schema)Type guard/schema validation for retrieve_transcripts arguments, ensuring callIds is a non-empty array of strings.function isGongRetrieveTranscriptsArgs(args: unknown): args is GongRetrieveTranscriptsArgs { return ( typeof args === "object" && args !== null && "callIds" in args && Array.isArray((args as GongRetrieveTranscriptsArgs).callIds) && (args as GongRetrieveTranscriptsArgs).callIds.every(id => typeof id === "string") ); }
- src/index.ts:60-72 (schema)TypeScript interfaces defining input arguments and response structure for retrieve_transcripts.interface GongRetrieveTranscriptsResponse { transcripts: GongTranscript[]; } interface GongListCallsArgs { [key: string]: string | undefined; fromDateTime?: string; toDateTime?: string; } interface GongRetrieveTranscriptsArgs { callIds: string[]; }
- src/index.ts:136-145 (helper)GongClient helper method that performs the actual API request to Gong for transcripts.async retrieveTranscripts(callIds: string[]): Promise<GongRetrieveTranscriptsResponse> { return this.request<GongRetrieveTranscriptsResponse>('POST', '/calls/transcript', undefined, { filter: { callIds, includeEntities: true, includeInteractionsSummary: true, includeTrackers: true } }); }