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

Instructions

Implementation Reference

• src/index.ts:62-67 (handler)

  The handler function for the 'get-meeting-metadata' tool. It takes a meeting ID, fetches the meeting data using TldvApi, and returns it as a JSON string in the required MCP response format.

  async ({ id }) => {
    const meeting = await tldvApi.getMeeting(id);
    return {
      content: [{ type: "text", text: JSON.stringify(meeting) }]
    };
  }

• src/index.ts:58-68 (registration)

  Registers the 'get-meeting-metadata' tool with the MCP server using server.tool(), specifying name, description, input schema, and the handler function.

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

• src/index.ts:20-24 (schema)

  Tool declaration including name, description, and input schema (zod schema: object with 'id' as string). Used for capabilities and registration.

  "get-meeting-metadata": {
    name: "get-meeting-metadata",
    description: "Get a meeting by its ID. The meeting ID is a unique identifier for a meeting. It will return the meeting metadata, including the name, the date, the organizer, participants and more.",
    inputSchema: z.object({ id: z.string() }),
  },

• src/api/tldv-api.ts:149-151 (helper)

  TldvApi.getMeeting helper method called by the tool handler. Makes an authenticated API request to TLDV's /meetings/{id} endpoint to retrieve meeting metadata.

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