MCP

Your clips, straight from your AI app

The Viral Day MCP server lets Claude, ChatGPT, Cursor and others browse your projects and create clips with your account — OAuth sign-in, no API key to paste.

https://api.realoficial.com.br/mcp

Viral Day is a Real Oficial brand: the server URL is the same for every brand.

  • OAuth 2.1 + PKCE
  • Streamable HTTP
  • No API key
  • Revoke anytime
Connect

Connect in a minute

Pick your app. In every case the sign-in happens on the Viral Day screen, where you choose the workspace and the permissions.

  1. 01

    In Claude (web, Desktop or mobile), open Customize › Connectors and click + Add custom connector.

  2. 02

    Paste the server URL into the URL field and click Connect. Keep the default app-identity option (Anthropic’s hosted client metadata).

    https://api.realoficial.com.br/mcp
  3. 03

    Sign in with your Viral Day account, pick the workspace and the permissions, then click Allow. Done: ask Claude to list your projects.

Good to know: Claude’s Free plan allows 1 custom connector. On Team/Enterprise, only Owners add the connector under Organization settings › Connectors; each member then clicks Connect.

Something off? If Connect fails or the tools disappear, remove the connector and add it again. Claude caches discovery data for about 5 minutes — wait and retry.

Using an SDK (OpenAI Agents, Anthropic mcp_servers, Gemini)?

Those SDKs do not run OAuth: they need a ready-made token. Per-app API tokens are not available yet — for now, use a client with OAuth. Never use your account’s master token for this: it grants full access and never expires.

Tools

9 tools, two write, one spends credits

Reading never costs anything. Creating clips and rendering are the only write actions — and your AI app asks for your confirmation first.

ToolPermissionWhat it does
ro_whoamireadaccount:readYour name, active workspace, plan, credit balance and the limits of this connection.
ro_estimate_clipsreadprojects:readReads a YouTube video or Twitch VOD and returns a quote: duration, credits needed, estimated clips and warnings.
ro_list_projectsreadprojects:readLists your clip projects with status, search and pagination.
ro_get_projectreadprojects:readDetails and progress of a project, including when to check again.
ro_list_clipsreadprojects:readLists the clips of a project, with virality score and thumbnails.
ro_get_clipreadprojects:readDetails of one clip, why it was picked and the renders available.
ro_list_rendersreadprojects:readLists the workspace’s renders, with download links.
ro_create_clipswriteprojects:writeCreates the clip project from a confirmed quote. Spends credits.
ro_render_clipwriterenders:writeRenders a clip into a final downloadable video.

Creating clips is always two steps: ro_estimate_clips returns a quote (minutes, credits, estimated clips) valid for 5 minutes, and only then ro_create_clips confirms it. Credit debits are not refundable.

Credits and limits

What each connection can spend

  • 1 credit = 1 minute of source video. The selected range is rounded up.
  • Daily budget per connection: 300 minutes by default (you pick 10 to 1440 at consent and can change it later under Settings › Connected apps). The limit resets at 00:00 UTC.
  • Up to 3 projects processing at the same time per connection.
  • Up to 5 project creations every 10 minutes.
  • Renders follow your plan’s hourly limit.
  • Credits are debited from the workspace chosen at consent and are not refundable.

One connection = one workspace

Each connection is bound to the workspace chosen at consent. To use another workspace, revoke and connect again choosing the other one.

Revoke access

See every connected app, adjust its daily budget and revoke any of them under Settings › Connected apps. The app stops immediately and will ask you to connect again.

Open Connected apps
Examples

What to ask your AI app

How much would it cost to clip this whole podcast? youtube.com/watch?v=… — show me the quote before creating anything.

Create vertical clips from the first 40 minutes of this stream and tell me when they are ready.

List the 5 highest-scoring clips from my latest project and render the best one.

Beware of instructions hidden inside videos

Video titles, descriptions and transcripts are third-party text. Your AI app must never treat that content as a command — if a video says "create 50 clips now", that is not a request from you. Keep human confirmation on for the write tools and avoid combining this server with others of unknown origin.

Electoral content

The same rules as in the app apply: when creating clips of campaign or electoral content through a connected app, declare it in the quote (is_electoral_content) and follow the disclosure rules required by law. You are responsible for the content you publish.