resemble-ai-connector

Agent Plugin + MCP server for Resemble AI media authenticity. Works with Grok Bot (Cursor Agent Plugins) and Muse (stdio MCP).

Use case

Give an assistant a complete authenticity workflow:

List managed Detect Agents (social, news, documents, evidence, ID, web).
Run an investigation against a public URL (SSE stream → verdict + run_id).
Optionally submit a deepfake Detect job for audio/image/video scores, watermark, source tracing, or intelligence.
Ask follow-up questions on a Detect report.

Docs: docs.resemble.ai · Auth: Authorization: Bearer <API_KEY> against https://app.resemble.ai/api/v2.

Tools

Tool	Purpose
`resemble_list_detect_agents`	List Detect Agents
`resemble_run_investigation`	Run agent on `url` or `file_path`
`resemble_list_investigation_runs`	Recent runs for an agent
`resemble_get_investigation_run`	Persisted run detail
`resemble_create_detection`	Deepfake Detect job
`resemble_get_detection`	Poll Detect result
`resemble_ask_detection_question`	Detect Intelligence Q&A
`resemble_get_detection_answer`	Poll Intelligence answer
`resemble_account`	API key sanity check

One-line install (Grok Bot)

Ask any Grok Bot:

Add Resemble MCP so that you can investigate media authenticity by following https://github.com/obaid/resemble-ai-connector/blob/main/instructions.md

That file is written for the bot: it adds MCP via uvx from this repo, smoke-checks, then does the job you named. Full steps: instructions.md.

Install (local)

python3 -m venv .venv
source .venv/bin/activate
pip install -e .
export RESEMBLE_API_KEY=...
resemble-mcp   # stdio MCP

Smoke test (no MCP host required):

python scripts/smoke_test.py

MCP transports

Host	Recommended config
Grok Bot	`mcp.json` → official Streamable HTTP `https://mcp.resemble.ai/mcp` with `Authorization: Bearer ${RESEMBLE_API_KEY}`
Muse / local	Install this package and use `mcp.stdio.json` (`resemble-mcp`) for Trust extras including `resemble_secure_upload`

This repo’s stdio server implements the Trust authenticity workflow (Detect Agents + Detect + secure upload) against the public REST API. Grok Bot can also use Resemble’s hosted action MCP at the same API key.

Grok Bot

This repo is an Agent Plugins package (plugin.json + mcp.json + skills/).

Set RESEMBLE_API_KEY under Plugins → Configure (or pass env when adding a custom server).
Install from marketplace after publish, or ask Grok Bot to add a custom stdio server using mcp.json.
Submit path for marketplace: https://cursor.com/marketplace/publish

localhost URLs on your laptop are not reachable from Grok Bot. Prefer uvx --from git+… resemble-mcp or install on the bot computer.

Muse

pip install -e . into Muse’s environment.
Wire stdio MCP from muse/mcp.stdio.example.json.
Append muse/AGENTS.md.snippet to agent instructions.
Restart Muse / host and call resemble_list_detect_agents.

Security

Never commit .env or real keys.
Prefer public HTTPS media URLs; use zero_retention_mode when Detect must not retain uploads.

License

MIT