Make short videos from Claude or Cursor with a remote MCP server

2026-11-17来源 dev.to AIEnglish

I run WowReveal, a web app that turns a video link into a vertical short with a narrated story, captions and music.

I wanted people to be able to use it without opening the site at all. Many of us already work through Claude, Codex and other AI agents all day, so doing everything from there is more convenient and it saves time. That is why WowReveal has a remote MCP server. This post shows how to connect it and what a real session looks like.

What you need

  • A WowReveal account on a paid plan (API and MCP access starts at $12 a month).
  • An API key from the Developers page inside the app. The key is shown once and can be revoked at any time.
  • An MCP client: Claude Code, Claude Desktop, Cursor or anything else that speaks Streamable HTTP.

Connect

The server lives at one URL:

https://wowreveal.com/mcp 

Claude Code, one command:

claude mcp add --transport http wowreveal https://wowreveal.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" 

Cursor, in .cursor/mcp.json:

{ "mcpServers": { "wowreveal": { "url": "https://wowreveal.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } 

The server also accepts the key in an X-API-Key header, which some directories and gateways need.

A real session

Ask in plain words:

Find 3 trending talent show auditions from this week and make Spanish story shorts.

The agent then calls the tools in this order:

  1. get_account to check the balance and current prices.
  2. search_trends with the niche and a 7-day window.
  3. estimate_credits to confirm the balance covers three shorts.
  4. create_short three times. Each call returns a job id at once.
  5. wait_for_project until the jobs finish. It waits up to 50 seconds per call, so the agent does not hammer the API.
  6. get_project to fetch the script and a signed video link.

A story short costs 8 credits. Reading tools such as get_account, list_templates and get_project are free.

What I learned building it

Return a job id, never block. Rendering takes minutes. Every write tool returns an id immediately, and a separate tool waits. Agents handle that well, and nothing times out.

Give the agent a price tool. estimate_credits costs nothing and stops the agent from starting work the balance cannot pay for. Failed jobs refund their credits automatically, so a bad run does not cost the user.

Tool descriptions are the interface. Glama grades tool descriptions. Each of mine says what the tool does, what it costs and when to call it, and the server holds an A grade there.

Mind the 401 response. One registry scanned my server, saw a Bearer challenge on the 401 and went looking for OAuth. Changing the challenge header and publishing a server card at /.well-known/mcp/server-card.json fixed discovery.

Tools at a glance

The server has 35 tools in six groups:

  • Account and catalogs: balance, templates, the 27 languages, caption styles, voices.
  • Shorts and projects: create, wait, retry, delete, build a compilation.
  • AI Clipper: analyse a long video and render the clips you pick.
  • Instant tools: scripts, hooks, post kits, translations, covers, voiceovers.
  • Planning: trend search and a rough earnings estimate.
  • AI Studio: image and video generation with the available models.

Full docs: https://wowreveal.com/developers

If you build something with it, or the server behaves badly with your client, tell me in the comments. I read all of them.

原文:https://www.a8q9.cn/en/article/make-short-videos-from-claude-or-cursor-with-a-remote-mcp-server-399653.html

相关文章