Omnicensus MCP Server

Score and analyze videos through any MCP-compatible AI agent — Claude Desktop, Cursor, Windsurf, Continue, Cline, and others.

What it does

Exposes 27 tools to the agent. The core ones:

| Tool | Use | |---|---| | quick_score | Score a video's hook in ~10s. No signup needed. Returns viral score + hook diagnostic. | | analyze_video | Submit for full analysis (drop-off moments, edit suggestions, best 30s/60s clips, audience reactions). | | get_job_status | Poll a submitted job. | | get_capabilities | List analysis modes, platforms, current API version. | | get_agent_balance | Check credit balance. | | submit_retention_feedback | Send real view/retention numbers to improve accuracy. | | extract_clips | Pull the best short clips from a video. |

Plus ~20 more for thumbnails, FCPXML/CSV exports, hook variants, report chat, channel insights, competitor teardown, audience exploration, social scheduling/posting, brain-map sharing, credit purchase, and team/org billing. Call get_capabilities for the live catalog.

Install (Claude Desktop)

claude mcp add omnicensus npx -- -y @omnicensus/mcp-server

Then in ~/Library/Application Support/Claude/claude_desktop_config.json add your API key:

{
  "mcpServers": {
    "omnicensus": {
      "command": "npx",
      "args": ["-y", "@omnicensus/mcp-server"],
      "env": { "OMNICENSUS_API_KEY": "sk_live_..." }
    }
  }
}

Install (Cursor / Windsurf / Continue)

Add to your ~/.cursor/mcp.json (Cursor) or equivalent:

{
  "mcpServers": {
    "omnicensus": {
      "command": "npx",
      "args": ["-y", "@omnicensus/mcp-server"],
      "env": { "OMNICENSUS_API_KEY": "sk_live_..." }
    }
  }
}

Get an API key

1. Sign in at https://omnicensus.video
2. Settings → Developers → Generate API key
3. Copy the sk_live_... value into the env above

Example prompts (once installed)

"Score this video for me: https://example.com/myvideo.mp4"

"Analyze https://example.com/long-form.mp4 for TikTok — find me the best 30-second clip."

"What's my Omnicensus balance?"

Local development

From the Omnicensus repo:

cd mcp-server
npm install
npm run dev   # runs from src/ via tsx

To point at a local backend, set OMNICENSUS_API_BASE to your emulator's functions URL.

License

MIT