{
  "markdown": "# Contendeo\n\n**Give your agent eyes.**\n\nContendeo is the multimodal layer that lets your AI actually see video — not just read its transcript.\n\n![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-00FF41?style=flat-square)\n![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square)\n![Status: Live](https://img.shields.io/badge/Status-Live-00FF41?style=flat-square)\n![Smithery](https://img.shields.io/badge/Smithery-Ready-8a8a8a?style=flat-square)\n\n---\n\n## What it is\n\nContendeo is a remote MCP server that gives LLMs frame-level context from video — transcription, keyframe vision analysis, OCR, and structured output, unified into a single response your agent can reason over.\n\nPaste a YouTube, Instagram Reels, Vimeo, Twitter/X, TikTok, or direct video URL into Claude (or any MCP client). Contendeo downloads, transcribes, extracts keyframes, runs OCR, analyzes visuals, and returns a structured document.\n\nLive at **[contendeo.app](https://contendeo.app)**. MCP endpoint at **[contendeo.app/mcp/](https://contendeo.app/mcp/)**.\n\n## Why it exists\n\nTranscripts capture what was said. They don't capture what was shown — chart values, UI states, overlays, code on screen, circled regions, dashboard numbers. For any video where the visual layer carries information (trading tutorials, product demos, technical walkthroughs, data dashboards, design reviews), transcript-only analysis misses half the signal.\n\nContendeo closes that gap.\n\nSee the side-by-side comparison at **[contendeo.app/demo](https://contendeo.app/demo)**.\n\n## Tools\n\nFour tools exposed over MCP. Credit costs charged per successful call. Cache hits are free.\n\n| Tool | Credits | What it does |\n|---|---|---|\n| `quick_transcribe` | 1 | Timestamped transcript with speaker identification. Audio-only. Fast. |\n| `deep_analyze` | 5 | Full multimodal pipeline — transcript + keyframe vision + OCR, unified output. |\n| `clip_context` | 1 (quick) / 3 (deep) | Analyze a specific timestamp range without paying for the full video. |\n| `batch_analyze` | per-video, −10% at 5+ | Process up to 10 videos in parallel with cross-video synthesis. |\n\nFull schemas and response formats: [`docs/tools.md`](docs/tools.md).\n\n## Installation\n\nContendeo is a remote MCP server — no local install, no package download. Connect via URL from your MCP client.\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"contendeo\": {\n      \"url\": \"https://contendeo.app/mcp/\"\n    }\n  }\n}\n```\n\nClaude will walk you through OAuth on first use.\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http contendeo https://contendeo.app/mcp/\n```\n\n### Other MCP clients (Cursor, Continue, Cline, etc.)\n\nAny client that supports remote MCP servers over streamable HTTP. Point it at `https://contendeo.app/mcp/`.\n\nFull walkthrough with screenshots: [`docs/installation.md`](docs/installation.md).\n\n## Authentication\n\nContendeo uses OAuth 2.0. First use flow:\n\n1. Your MCP client initiates a connection\n2. Browser redirect to contendeo.app sign-in (Google OAuth or email)\n3. Approve the MCP client\n4. Bearer token issued, client reconnects, tools become available\n\nNew accounts get 10 free credits. No card required.\n\nDetails: [`docs/authentication.md`](docs/authentication.md).\n\n## Pricing\n\n| Plan | Price | Credits | Notes |\n|---|---|---|---|\n| Free | $0 | 10 on signup | All 4 tools, no card |\n| Pro | $12/mo (₹999) | 100/mo | Priority queue, rollover to 200 |\n| Power | $39/mo (₹3,299) | 500/mo | Batch, webhooks, rollover to 1000 |\n| PAYG | $0.15/credit | on demand | No subscription |\n\nCache hits are free. Failed analyses auto-refund.\n\nDetails: [`docs/pricing.md`](docs/pricing.md).\n\n## Stack\n\nUnder the hood:\n\n- **[yt-dlp](https://github.com/yt-dlp/yt-dlp)** — video download across 1000+ sites\n- **[Apify](https://apify.com)** — Instagram Reels fetching\n- **[Webshare](https://webshare.io)** — residential proxy pool for YouTube anti-bot\n- **[ffmpeg](https://ffmpeg.org)** — audio extraction + keyframe scene detection\n- **[Groq Whisper](https://groq.com)** (large-v3) — transcription\n- **[Tesseract OCR](https://github.com/tesseract-ocr/tesseract)** — deterministic text extraction from frames\n- **[Claude Vision](https://www.anthropic.com/api)** (Sonnet 4.6) — visual frame analysis\n- **[Supabase](https://supabase.com)** — auth + Postgres\n- **[Redis](https://redis.io)** — URL-hash result cache\n- **FastAPI + MCP Python SDK** — server, streamable HTTP transport\n- **Traefik** — SSL termination + routing\n\n## Links\n\n- Landing — [contendeo.app](https://contendeo.app)\n- Demo — [contendeo.app/demo](https://contendeo.app/demo)\n- MCP endpoint — [contendeo.app/mcp/](https://contendeo.app/mcp/)\n- Dashboard — [contendeo.app/dashboard](https://contendeo.app/dashboard)\n- Docs — [`docs/`](docs/)\n- Server card — [contendeo.app/.well-known/mcp/server-card.json](https://contendeo.app/.well-known/mcp/server-card.json)\n\n## Support\n\nQuestions, bug reports, feature requests: [open an issue](https://github.com/0xKaroshi/contendeo-mcp/issues).\n\nCommercial/partnership inquiries: [@0xKaroshi](https://x.com/0xKaroshi) on X.\n\n## License\n\nMIT — covers this wrapper repo (documentation, examples, manifest). The production server source is not open-sourced.\n\nSee [`LICENSE`](LICENSE).\n\n---\n\n*Contendeo — every frame, every word, every edge.*\n",
  "bytes": 5343,
  "sha": "c6cc21ff430493e7ac7a956607c78e321de15d377d48a65984749a1fb3512955",
  "repo_slug": "0xkaroshi/contendeo-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_app_contendeo_contendeo_099a3f0b/readme"
}