Connect Revelio to your AI assistant

MCP (Model Context Protocol) lets an AI assistant use tools from other services. Revelio's connector is read-only and gives your assistant two tools:

• list_recent_completed_videos: lists your most recent finished videos (up to 20) so the assistant can pick one. A video you finished in the Revelio editor (with music, text or an outro) is listed separately and marked as the edited version, so you can ask for that one to be posted.
• get_publish_package: returns a posting-ready package for one video: title, caption, hashtags, disclosure notes, and download links for the video (and its cover image when there is one).

The connector does not create videos, spend credits, edit captions, or post anything. Posting is done by the posting tool you connect alongside it (see step 3).

1. Sign in to Revelio and open Connect AI apps.
2. Click Create connection key. You can rename it after the app you will use (for example "Claude Desktop").
3. The in-app page fills the key into the settings for you. It starts with rvl_ and is shown only once. If you lose it, delete it and create a new one.

You can have up to 5 active keys. Use one per app or device so you can delete them separately. In the examples below, replace YOUR_REVELIO_MCP_TOKEN with your key.

Pick the app you use. After adding Revelio, restart the app or reload its MCP servers.

{
  "mcpServers": {
    "revelio": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://revelio.hypercape.com/api/mcp",
        "--header",
        "Authorization:${REVELIO_AUTH_HEADER}"
      ],
      "env": {
        "REVELIO_AUTH_HEADER": "Bearer YOUR_REVELIO_MCP_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "revelio": {
      "url": "https://revelio.hypercape.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_REVELIO_MCP_TOKEN"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "revelio-mcp-token",
      "description": "Revelio MCP token",
      "password": true
    }
  ],
  "servers": {
    "revelio": {
      "type": "http",
      "url": "https://revelio.hypercape.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:revelio-mcp-token}"
      }
    }
  }
}

claude mcp add --transport http --scope user revelio https://revelio.hypercape.com/api/mcp \
  --header "Authorization: Bearer YOUR_REVELIO_MCP_TOKEN"

const response = await openai.responses.create({
  model: process.env.OPENAI_MODEL,
  input: 'Get my most recent completed Revelio video and return its publish package.',
  tools: [
    {
      type: 'mcp',
      server_label: 'revelio',
      server_url: 'https://revelio.hypercape.com/api/mcp',
      authorization: process.env.REVELIO_MCP_TOKEN,
      allowed_tools: ['list_recent_completed_videos', 'get_publish_package'],
      require_approval: 'never',
    },
  ],
});

curl -sS -X POST "https://revelio.hypercape.com/api/mcp" \
  -H "Authorization: Bearer YOUR_REVELIO_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Revelio prepares the post and Metricool publishes it. Add both connectors to the same app, and the assistant can hand the video and caption from one to the other in a single conversation.

1. Connect Revelio as shown in step 2 (Claude Desktop, Cursor, or Claude Code).
2. Connect Metricool in the same app by following Metricool's MCP guide. Metricool signs you in with its own account login.
3. Try a prompt like one of these:

List my 5 most recent Revelio videos.

Get the publish package for my latest Revelio video and show me the caption and hashtags.

Take my latest Revelio video and post it to Instagram and TikTok via Metricool with its caption and hashtags. Ask me before publishing.

Video and cover links expire after 60 minutes. Ask for the publish package in the same conversation where you create the post. If a link has expired, ask for the publish package again to get fresh links.

Always review the caption, hashtags, and disclosure notes before publishing. You are responsible for content you publish; see the Legal Notice.

OAuth sign-in, which would let ChatGPT and claude.ai connect directly, is on our roadmap.

• 401 / "Authentication required": the key is missing, mistyped, or deleted. Check that the header reads Bearer rvl_… with one space after "Bearer".
• 403 / "This token cannot read Revelio videos": you used a general API token. Create a key on the Connect AI apps page instead.
• 429 / too many requests: each key allows 60 requests and 20 publish packages per minute. Wait a minute and try again.
• No videos listed: only finished, non-deleted videos appear. Card news and videos still generating are not included.
• Video link no longer works: links expire after 60 minutes. Ask for the publish package again.
• Claude Desktop does not show Revelio: check that Node.js is installed and the config file is valid JSON (no trailing commas), then fully quit and reopen the app.

• A key can only read your own finished videos. It cannot create, change, or delete anything.
• Keep keys in your app's MCP settings only. Never paste a key into a chat message, a URL, or a shared document.
• If a key may have leaked, delete it on the Connect AI apps page. It stops working immediately.