Skip to content
English
  • There are no suggestions because the search field is empty.

How to connect Rask to Claude, Codex, Cursor or VS Code with MCP

Let Claude Code, Codex, Cursor, VS Code or Claude Desktop dub, translate and lip-sync your videos from a chat, with the price confirmed before anything runs.

The Rask MCP server lets an AI assistant work with your Rask account. You write a request such as "Dub this webinar into Spanish and German with lip-sync", and the assistant uploads the video, estimates the price, starts the dub and returns the download links.

  • Server address: https://api.rask.ai/v3/mcp
  • Supported assistants: Claude Code, Codex CLI, Cursor, VS Code and Claude Desktop, plus any client that supports remote MCP servers over HTTP
  • Plans: Creator, Creator Pro, Business and Enterprise. Open Settings → API keys and choose Connect MCP.
  • Cost: the MCP server itself is free. Dubbing, lip-sync and other processing use minutes from your balance, at the same price as in the Rask app.

What the assistant can do

The server gives the assistant 29 tools. It sees only the tools that your access level allows.

TaskTools
Account and languagesrask_get_account (plan and balance), rask_get_usage (usage), rask_list_languages (languages)
Mediarask_create_upload (prepare an upload), rask_import_media (import from a link)
Projectsrask_create_project, rask_list_projects, rask_get_project, rask_get_download_links
Transcript and versionsrask_get_transcript, rask_edit_transcript, rask_retranslate_segments, rask_list_versions, rask_save_version, rask_restore_version
Voicesrask_get_voice_setup (speakers and voices), rask_list_voices, rask_set_speaker_voice, rask_create_voice_clone
Processingrask_estimate_cost, rask_start_dub, rask_start_lipsync, rask_start_onscreen (on-screen text), rask_start_localization (dub, lip-sync and on-screen text in one run), rask_generate_segments
Jobs and APIrask_get_job (status), rask_cancel_job, rask_api_operations (find a REST operation), rask_api_read (run an allowed GET request)

Two ways to connect

Browser sign-inAPI key
Best forYou work with the assistant yourselfAn agent or script that runs without a person
How it worksThe assistant opens a Rask page, you choose the access and approve itYou create a key in Settings → API keys and give it to the client
Where to manage itSettings → API keys → Connected appsSettings → API keys

What you choose during browser sign-in

  1. The Teamspace the assistant works in.
  2. The access level. By default, the form offers access without spending, valid for 90 days.
  3. The expiry date of the access.
  4. If you allow spending: monthly limits for minutes and projects.

Click Approve. The connection appears in Settings → API keys → Connected apps, where you can change or revoke it at any time.

Connect your assistant

You can also copy these commands from Settings → API keys → Connect MCP in the Rask app.

Claude Code

Browser sign-in:

claude mcp add --transport http rask https://api.rask.ai/v3/mcp
claude mcp login rask

API key:

claude mcp add --transport http rask https://api.rask.ai/v3/mcp \
  --header 'Authorization: Bearer ${RASK_API_KEY}'

Codex CLI

Browser sign-in. Run the second command if the sign-in page does not open automatically:

codex mcp add rask --url https://api.rask.ai/v3/mcp
codex mcp login rask

API key:

codex mcp add rask --url https://api.rask.ai/v3/mcp \
  --bearer-token-env-var RASK_API_KEY

Cursor

Edit ~/.cursor/mcp.json.

For browser sign-in, add only the address, then complete the browser sign-in from MCP settings or with agent mcp login rask:

{
  "mcpServers": {
    "rask": {
      "url": "https://api.rask.ai/v3/mcp"
    }
  }
}

For an API key:

{
  "mcpServers": {
    "rask": {
      "url": "https://api.rask.ai/v3/mcp",
      "headers": { "Authorization": "Bearer ${env:RASK_API_KEY}" }
    }
  }
}

VS Code

Browser sign-in:

code --add-mcp '{"name":"rask","type":"http","url":"https://api.rask.ai/v3/mcp"}'

Start the server in VS Code and confirm the sign-in.

For an API key, add this to .vscode/mcp.json. VS Code asks for the key once and stores it securely:

{
  "inputs": [
    { "type": "promptString", "id": "rask-api-key", "description": "Rask API key", "password": true }
  ],
  "servers": {
    "rask": {
      "type": "http",
      "url": "https://api.rask.ai/v3/mcp",
      "headers": { "Authorization": "Bearer ${input:rask-api-key}" }
    }
  }
}

Claude Desktop

Browser sign-in: open Settings → Connectors → Add custom connector and paste https://api.rask.ai/v3/mcp. No extra software is needed.

API key: this method needs Node.js and the mcp-remote bridge. Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "rask": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.16.0",
        "https://api.rask.ai/v3/mcp",
        "--header",
        "Authorization:${RASK_AUTH_HEADER}"
      ],
      "env": { "RASK_AUTH_HEADER": "Bearer <your API key>" }
    }
  }
}

In this method, the key is stored in the configuration file as plain text. Use browser sign-in when you can.

In Claude Desktop, share your video as a link (YouTube, Google Drive or Vimeo).

Check the connection

Ask the assistant: "Show my Rask plan and balance." It calls rask_get_account and returns your plan and the minutes left.

How spending is confirmed

Every tool that spends minutes works in two steps:

  1. Estimate. The assistant calls rask_estimate_cost. This is free and returns the price, your balance after the action and a confirmation token.
  2. Run. The assistant repeats the request with the token and the approved price. The token is valid for 10 minutes and works only for that exact request.

If the price has changed since the estimate, the request stops with cost_changed and nothing is charged. The assistant then asks for a new estimate.

Your monthly limits set the maximum the assistant can spend. A connection without a spending limit cannot start paid work: the server answers spend_cap_required.

In Claude Code, Rask shows you the price and asks for confirmation before each paid action. Other clients ask your permission to call the tool, depending on their settings.

Example requests

  • "Dub https://youtu.be/… into Spanish and German. Show me the price first."
  • "Translate my latest project into French with lip-sync."
  • "Create a voice clone from this sample and use it for Speaker 1 in project Q3 webinar."
  • "Replace the word 'dashboard' with 'panel' in every Spanish segment and re-dub only those segments."
  • "Translate the on-screen text in project Onboarding v2 into Portuguese (Brazil)."
  • "How many minutes did we use this month, and on which projects?"

Troubleshooting

What you seeWhat to do
Needs authentication in Claude CodeRun claude mcp login rask or open /mcp and complete the browser sign-in.
401 when you connect with a keyCheck that you copied the full key, that it is not expired or revoked, and that RASK_API_KEY is available to the client process.
Cursor shows SSE … 405Check the error before it, usually a 401, and fix the key or sign-in.
The assistant sees only a few toolsYour access level is limited. Create a key or a connection with Full access.
spend_cap_requiredSet a monthly limit for minutes in Settings → API keys or Connected apps.
confirmation_expiredThe token is older than 10 minutes. Ask the assistant for a new estimate.
feature_not_in_planYour plan does not include API access. See Plans and minutes explained.

Related articles