# tl;dv MCP

> tl;dv connects your AI client directly to meeting recordings, transcripts, and structured insights from Google Meet and Zoom calls. It lets you list all past meetings, pull full transcriptions for deep searching, or instantly read summarized notes and key moments without ever opening a browser tab.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** meeting-transcription, call-recording, summarization, meeting-insights, video-conferencing, natural-language-processing

## Description

Your AI client connects right up to your meeting recordings—whether they came from Google Meet or Zoom. This server makes it easy for you to manage transcripts, notes, and all the juicy details from past calls without ever opening a browser tab. You're getting direct access to everything that happened.

First off, before you start running anything else, you can check things out. Use `test_tldv_auth` to make sure your API key is good to go, and run `get_api_status` anytime you wanna verify the current connection between your agent and the service.

To scope out what's available, you gotta start by listing everything. The tool `list_recorded_meetings` gives you a rundown of all your past calls, providing essential metadata like titles and dates so you can get an overview of your content. You can also pull up a list of the latest transcripts with `list_recent_transcripts`, letting you quickly see what's ready to read.

When you zero in on a specific recording, you have tools for every angle. You can use `get_meeting_details` to grab core info about any recorded meeting, like its title and general duration. If you need the exact length of the call—down to the minute and second—you run `get_meeting_duration`. For who was there, `get_meeting_participants` lists every single attendee, pulling their names and roles if tl;dv caught 'em. You can also pull key moments or highlights identified by tl;dv using `get_meeting_highlights`, skipping the fluff and getting straight to what mattered.

If you wanna know what was decided, this is where it gets good. Run `get_meeting_notes` to get AI-generated summaries that capture the main outcomes and key decisions from any specified call. For a deeper dive into the actual conversation, use `get_meeting_transcript`. This fetches the complete, raw text record of the entire meeting session so your agent can search it for any topic or name you need. You're also able to pull synthesized notes using `get_meeting_notes` and grab full transcripts via `get_meeting_transcript`, giving you two different angles on the same discussion.

When you’ve finished reviewing, you got options too. `get_recording_download` provides a direct URL so you can download the original video file for that meeting. If you're working with content from outside sources, `import_external_meeting` processes and adds recorded meetings to your knowledge base using just an external URL. You also have access to **`list_recorded_meetings`** which lists all past recordings; **`get_meeting_notes`** pulls the AI-generated summaries of main outcomes; **`get_meeting_transcript`** fetches the complete, searchable text record; and **`get_recording_download`** generates direct URLs for the original video file.

## Tools

### get_api_status
Checks the current connection status between your AI client and the tl;dv service.

### get_recording_download
Provides a direct URL to download the original video file for a specific meeting recording.

### get_meeting_duration
Checks the exact length of a given call recording in minutes and seconds.

### get_meeting_highlights
Pulls specific key moments or highlights identified by tl;dv from the meeting content.

### get_meeting_details
Retrieves core information about a specific recorded meeting, including its title and duration.

### get_meeting_notes
Reads and returns AI-generated summaries, capturing the main outcomes of a meeting.

### get_meeting_participants
Lists all attendees for a given recording, including their names and roles within the call.

### get_meeting_transcript
Fetches the full, raw text transcription of an entire meeting session.

### import_external_meeting
Processes and adds a recorded meeting to your knowledge base using an external URL.

### list_recorded_meetings
Lists all your past recorded meetings, giving you an overview of what content is available.

### list_recent_transcripts
Retrieves a list of the latest available transcripts for quick access.

### test_tldv_auth
Verifies that your provided API key is active and correctly formatted for use with the service.

## Prompt Examples

**Prompt:** 
```
List all my recorded meetings from this month.
```

**Response:** 
```
I've retrieved your meetings. You have 4 recent recordings including 'Q4 Roadmap Sync', 'User Interview - Alex', and 'Daily Standup'. Which one would you like the AI notes for?
```

**Prompt:** 
```
Summarize the key decisions made in the 'Q4 Roadmap Sync' meeting.
```

**Response:** 
```
Fetching AI notes... In the 'Q4 Roadmap Sync' (ID: mtg_10293), the team decided to prioritize the Mobile SDK, push the API redesign to Q1, and schedule a security audit for next week. Would you like the full highlight list?
```

**Prompt:** 
```
Show me who attended the meeting with 'Alex' (ID: mtg_88231).
```

**Response:** 
```
I've retrieved the attendee list for mtg_88231. Participants included: Alex Rivera (External), Sarah Smith (Product), and Mike Ross (Engineering). The recording duration was 45 minutes.
```

## Capabilities

### List recorded meetings
Retrieves a list of all past recordings, including essential metadata like title and date.

### Get AI-generated summaries
Pulls synthesized notes and key decisions from any specified meeting recording.

### Retrieve full transcriptions
Fetches the complete, searchable text record for a specific call or meeting.

### Check participants list
Lists every person who attended a given recording and includes their roles where available.

### Download video recordings
Generates direct, usable URLs for the original video file of a meeting.

## Use Cases

### The Sales Follow-Up Check
A sales rep needs confirmation on a pricing detail discussed last week. Instead of digging through 45 minutes of video, they ask their agent to run `get_meeting_transcript` and focus the search query. The agent immediately pulls the exact quote, confirming the $10k figure was agreed upon.

### The Product Spec Dump
A Product Manager needs a quick list of requirements from a brainstorming session. They run `get_meeting_highlights` on the recording and use the resulting notes to structure their next sprint board, saving hours of manual note-taking.

### The Operations Audit
An Ops manager needs to know who was involved in a specific client discussion last month. They run `list_recorded_meetings` to find the ID, then use `get_meeting_participants` to generate an accurate roster for internal records.

### External Content Sync
A team member recorded a critical session using a non-integrated tool. They simply provide the external URL and run `import_external_meeting`. The server processes it, adding the data to the knowledge base as if it were native.

## Benefits

- Stop searching through video feeds. Use `get_meeting_notes` to pull concise summaries and key decisions from any call in seconds, letting you get straight to the outcome.
- Never forget who was on the line. The `get_meeting_participants` tool gives you a clean list of all attendees and their roles for audit trails or follow-up tasks.
- Need to prove what was said? Use `get_meeting_transcript` to retrieve the full text. You can then ask your agent specific questions about the conversation, making it searchable.
- Import content easily. If a meeting is recorded elsewhere, run `import_external_meeting` and add its insights directly into your central knowledge base.
- Audit everything with `list_recorded_meetings`. This tool lets you see every capture—from 'Q4 Sync' to 'Daily Standup'—in one clean list.

## How It Works

The bottom line is, your AI client treats your meeting recordings like a searchable database, not just video files.

1. First, subscribe to the tl;dv server and input your API Key into your AI client.
2. Next, prompt your agent with an action that requires meeting data (e.g., 'Give me notes for mtg_10293').
3. The agent runs the appropriate tool (`get_meeting_notes`), which returns the summarized text directly to you.

## Frequently Asked Questions

**How do I start using the tl;dv MCP Server?**
You must first subscribe to the server and input your API Key into your AI client. After that, run `test_tldv_auth` to confirm everything is working before pulling any data.

**Which tool do I use if I only need a list of names?**
`get_meeting_participants` handles this. It gives you a clean roster for a specific meeting ID, which is much better than trying to eyeball the attendee list.

**Can I get notes for a meeting that wasn't recorded on Meet or Zoom?**
Yes. Use `import_external_meeting`. Just provide an external URL, and the server will process it, adding the knowledge to your system.

**I need to know what happened last month; should I use list_recorded_meetings or list_recent_transcripts?**
Use `list_recorded_meetings` first. This gives you an overview of all captured content and their metadata. If you only care about the text, then check with `list_recent_transcripts`.

**I'm not sure if my API key is still active; how do I check it using `test_tldv_auth`?**
Running `test_tldv_auth` verifies your credentials immediately. It confirms that the connection to tl;dv is working and that your account has sufficient permissions for basic operations.

**If I have a video link from YouTube or Vimeo, can I process it with `import_external_meeting`?**
Yes, you can upload recording URLs to `import_external_meeting`. The tool processes recordings from various external sources, not just those generated by Meet and Zoom.

**Do I use `get_meeting_transcript` or `get_recording_download` if I need the raw video file?**
You must use `get_recording_download`. This tool provides a direct download link for the original video file, while `get_meeting_transcript` only delivers the text transcription.

**What happens if I run `get_meeting_details` using an incorrect meeting ID?**
The agent will return a specific error indicating that the requested meeting ID was not found. You need to verify the ID against your list of recorded meetings before attempting retrieval.

**Can I see the AI-generated notes for a specific meeting?**
Yes! Use the `get_meeting_notes` tool and provide the Meeting ID. Your agent will retrieve the complete AI summary and key points recorded for that session.

**How do I search for a specific discussion point in the transcript?**
Run the `get_meeting_transcript` query with the Meeting ID. The agent will retrieve the full text, allowing you to ask the AI to find or summarize specific parts of the conversation.

**Is it possible to list the participants of a meeting via AI?**
Absolutely. Use the `get_meeting_participants` tool and provide the Meeting ID. The agent will return the directory of everyone who attended the recorded session.