# Plaud — how to use (mcp.ai)

Your Plaud recordings in natural language: list recordings, read speaker-attributed transcripts and AI-generated summaries/action items. Connect your Plaud account in one click.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_plaud?ms=1787533020000`
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. `plaud_get_notes`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/plaud`
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/plaud/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/plaud/get/notes` — Notas geradas por IA de uma gravação: resumo compacto, action items e tópicos-chave.
  - body: { file_id: string, account?: string }
- `POST https://api.mcp.ai/api/plaud/get/recording` — Detalhes de uma gravação Plaud por ID.
  - body: { file_id: string, account?: string }
- `POST https://api.mcp.ai/api/plaud/get/transcript` — Transcrição completa com timestamps e atribuição de falantes de uma gravação.
  - body: { file_id: string, account?: string }
- `POST https://api.mcp.ai/api/plaud/get/user` — Dados do usuário Plaud autenticado.
- `POST https://api.mcp.ai/api/plaud/list/recordings` — Lista gravações Plaud. Filtros opcionais: `query` (substring do nome, case-insensitive), `date_from`/`date_to` (YYYY-MM-DD, inclusivo). Com filtro, pagina até 5×100 e retorna todas.
  - body: { page?: number, page_size?: number, query?: string, date_from?: string, date_to?: string, account?: string }

## Example prompts
- "List my Plaud recordings from last week"
- "Summarize the transcript of my latest Plaud-recorded meeting"
- "What were the action items from recording X?"

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