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.
| Task | Tools |
|---|---|
| Account and languages | rask_get_account (plan and balance), rask_get_usage (usage), rask_list_languages (languages) |
| Media | rask_create_upload (prepare an upload), rask_import_media (import from a link) |
| Projects | rask_create_project, rask_list_projects, rask_get_project, rask_get_download_links |
| Transcript and versions | rask_get_transcript, rask_edit_transcript, rask_retranslate_segments, rask_list_versions, rask_save_version, rask_restore_version |
| Voices | rask_get_voice_setup (speakers and voices), rask_list_voices, rask_set_speaker_voice, rask_create_voice_clone |
| Processing | rask_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 API | rask_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-in | API key | |
|---|---|---|
| Best for | You work with the assistant yourself | An agent or script that runs without a person |
| How it works | The assistant opens a Rask page, you choose the access and approve it | You create a key in Settings → API keys and give it to the client |
| Where to manage it | Settings → API keys → Connected apps | Settings → API keys |
What you choose during browser sign-in
- The Teamspace the assistant works in.
- The access level. By default, the form offers access without spending, valid for 90 days.
- The expiry date of the access.
- 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:
- Estimate. The assistant calls
rask_estimate_cost. This is free and returns the price, your balance after the action and a confirmation token. - 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 see | What to do |
|---|---|
| Needs authentication in Claude Code | Run claude mcp login rask or open /mcp and complete the browser sign-in. |
401 when you connect with a key | Check 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 … 405 | Check the error before it, usually a 401, and fix the key or sign-in. |
| The assistant sees only a few tools | Your access level is limited. Create a key or a connection with Full access. |
spend_cap_required | Set a monthly limit for minutes in Settings → API keys or Connected apps. |
confirmation_expired | The token is older than 10 minutes. Ask the assistant for a new estimate. |
feature_not_in_plan | Your plan does not include API access. See Plans and minutes explained. |