tl;dv MCP for Zoom, Google Meet and MS Teams

Instructions

Implementation Reference

• src/index.ts:74-79 (handler)

  The MCP tool handler function that fetches the meeting transcript via TldvApi and returns it as a JSON-stringified text content block.

  async ({ meetingId }) => {
    const transcript = await tldvApi.getTranscript(meetingId);
    return {
      content: [{ type: "text", text: JSON.stringify(transcript) }]
    };
  }

• src/index.ts:70-80 (registration)

  Registration of the 'get-transcript' tool handler with the MCP server using server.tool().

  server.tool(
    tools["get-transcript"].name,
    tools["get-transcript"].description,
    tools["get-transcript"].inputSchema.shape,
    async ({ meetingId }) => {
      const transcript = await tldvApi.getTranscript(meetingId);
      return {
        content: [{ type: "text", text: JSON.stringify(transcript) }]
      };
    }
  );

• src/index.ts:25-29 (schema)

  Tool metadata including name, description, and input schema (Zod object with meetingId: string) for 'get-transcript'.

  "get-transcript": {
    name: "get-transcript",
    description: "Get transcript by meeting ID. The transcript is a list of messages exchanged between the participants in the meeting. It's time-stamped and contains the speaker and the message",
    inputSchema: z.object({ meetingId: z.string() }),
  },

• src/api/tldv-api.ts:198-200 (helper)

  TldvApi class method that performs the HTTP request to retrieve the transcript from the TLDV API endpoint.

  async getTranscript(meetingId: string): Promise<TldvResponse<GetTranscriptResponse>> {
    return this.request<GetTranscriptResponse>(`/meetings/${meetingId}/transcript`);
  }

• src/api/schemas.ts:91-97 (schema)

  Zod schema definition for the GetTranscriptResponse type used in the API response validation.

  export const GetTranscriptResponseSchema = z.object({
    id: z.string(),
    meetingId: z.string(),
    data: z.array(SentenceSchema),
  });
  
  export type GetTranscriptResponse = z.infer<typeof GetTranscriptResponseSchema>;