# Tldv — how to use (mcp.ai)

Connect your Tldv account and use 7 tools for productivity straight from your AI agent. Connect with your own API key. Meeting recorder and transcription tool for video conferences.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_tldv?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `tldv_check_health`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/tldv`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/tldv/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/tldv/check/health` — Tool to verify API availability and health status. Use when you need to check if the tl;dv API is operational before making other API calls.
- `POST https://api.mcp.ai/api/tldv/download/meeting/recording` — Tool to download a meeting recording file. Returns the recording file by following the API's redirect to a signed download URL (valid for 6 hours). Use when you need to retrieve the actual recording c
  - body: { meeting_id: string }
- `POST https://api.mcp.ai/api/tldv/get/meeting` — Tool to retrieve a meeting by its unique identifier. Returns detailed meeting metadata including id, name, date, URL, duration, organizer, invitees, template, and extra properties. Use when you need t
  - body: { meetingId: string }
- `POST https://api.mcp.ai/api/tldv/get/meeting/highlights` — Tool to retrieve meeting notes (highlights) by meeting ID in human-readable format. Use when you need to fetch notes from a completed meeting. Highlights are only returned if the transcript is complet
  - body: { meetingId: string }
- `POST https://api.mcp.ai/api/tldv/get/meeting/transcript` — Tool to retrieve the complete transcript of a meeting by its ID. Returns transcript segments with speaker names, text, and timestamps. The transcript is only returned if it is complete.
  - body: { meetingId: string }
- `POST https://api.mcp.ai/api/tldv/import/meeting` — Tool to import a meeting, recording, or other media from a publicly accessible URL. The URL must point to media in a supported format (mp3, mp4, wav, m4a, mkv, mov, avi, wma, flac). Returns a job ID t
  - body: { url: string, name?: string }
- `POST https://api.mcp.ai/api/tldv/list/meetings` — Tool to retrieve a paginated list of meetings from tldv. Returns meeting metadata including id, name, occurrence date, URL, duration, organizer details, invitees, and template information. Use when yo
  - body: { meetingType?: string }

## Example prompts
- "What can I do in Tldv?"
- "Show me a summary of my Tldv account"

## More
- Page: https://mcp.ai/tldv
- Agent spec (llms.txt): https://mcp.ai/tldv/llms.txt
- Postman collection: https://mcp.ai/tldv/postman.json