# Social → Context — how to use (mcp.ai)

Cole um link de rede social (TikTok, Instagram reel/post/carrossel, YouTube ou um .mp4 qualquer) e receba o conteúdo como texto: metadados, transcrição do áudio/vídeo e descrição (OCR + resumo) das imagens. Serve pra dar contexto ao Claude sobre o que está dentro do vídeo ou post. Toda a lógica roda num Cloudflare Worker próprio (download + transcrição + visão). Grátis: 3 chamadas.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/socialdl/download` — Resolve a TikTok / Instagram / YouTube link (or direct .mp4/image URL) to its DIRECT download URLs from the source CDN — every video quality, audio track and image, with quality labels. Use when the u
  - body: { url: string }
- `POST https://api.mcp.ai/api/socialdl/extract` — Download a social-media link (TikTok, Instagram reel/post/carousel, YouTube, or any direct .mp4) and return it as usable text context: metadata (author, caption, duration), the audio/video transcript,
  - body: { url: string, transcribe?: boolean, describe_images?: boolean, language?: string }
- `POST https://api.mcp.ai/api/socialdl/metadata` — Lightweight lookup: resolve a social-media link to its metadata (author, caption, duration, counts) and media URLs WITHOUT transcribing or running vision. Cheaper than socialdl_extract — use when the 
  - body: { url: string }

## Example prompts
- "Transcreva este reel: https://www.instagram.com/reel/..."
- "Resuma o que esse vídeo do TikTok fala: <link>"
- "Pegue a legenda deste vídeo do YouTube: <link>"

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