Use ToRun from your coding tool
The ToRun MCP server lets a coding agent such as Claude Code, Cursor or opencode create the media a project needs (images, speech, music and video), edit images, transcribe audio, run deep research and ToRun's workflow templates, and publish an HTML page or browser game as a link. Paid calls are charged to your ToRun account at the same prices as the app.
Every ToRun account with a paid plan or a purchased balance can create a developer key.
What your agent can do
Images
Sprites, icons, backgrounds and illustrations from a prompt, saved to your ToRun library.
Speech
Voice lines and narration from text, as an audio file.
Music and video
Game loops, background tracks and short clips. A long job returns an id the agent checks later.
Publish a page
An HTML page or browser game as a link anyone with the address can open. It is not listed on Explore or indexed by search engines.
Tools
image_generate
Generates one or more images from a prompt.
image_edit
Edits an image from a written instruction.
tts_generate
Turns text into speech.
stt_transcribe
Turns the speech in an audio or video file into text.
music_generate
Composes a music track, with or without vocals.
video_generate
Generates a short video clip from a prompt.
job_status
Reports on an image, music or video job and returns the file when it is ready.
deep_research_start
Starts a deep research run that writes a report with its sources cited.
deep_research_status
Reports on a deep research run and returns the report when it is ready.
workflow_template_search
Finds workflow templates and shows the inputs each one takes.
workflow_run
Runs a workflow template with the inputs you give it.
workflow_run_status
Reports on a workflow run and returns its results when they are ready.
canvas_publish
Publishes an HTML page or browser game as an unlisted link.
account_balance
Shows the allowance and wallet left, and this key's limit and spend.
Connect it in three steps
1
Create a developer key on the Developers page of your ToRun account. It is shown once, so copy it.
2
Put the key in an environment variable named TORUN_API_KEY, never in a file you share.
3
Add ToRun to your tool with one of the configurations below, then ask your agent for what you need.
opencode opencode.json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"torun": {
"type": "remote",
"url": "https://mcp.torun.ai/mcp",
"oauth": false,
"headers": {
"Authorization": "Bearer {env:TORUN_API_KEY}"
},
"timeout": 120000
}
}
}
Claude Code
claude mcp add --transport http torun https://mcp.torun.ai/mcp --header "Authorization: Bearer $TORUN_API_KEY"
Cursor .cursor/mcp.json
{
"mcpServers": {
"torun": {
"url": "https://mcp.torun.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:TORUN_API_KEY}"
}
}
}
}
Docs
Limits of a key
Spends at most 1,000,000 Runs a month, unless you change it on the key.
Asks you first before a single call that would cost more than 100,000 Runs.
Up to 60 calls a minute.
Up to 20 published pages a day per account.
How calls are paid
Each call is charged in Runs at the same prices as in the app: first from your plan's allowance, then from your wallet if you allowed that on the key. Every charge appears on your billing page under the key that made it.
The free allowance never pays for API calls, so a key needs a paid plan, a purchase or a balance on the account.
Questions
Which tools can connect to the ToRun MCP server?
Any tool that supports remote MCP servers over HTTP with a bearer token, including Claude Code, Cursor and opencode.
What does a call cost?
The same as the same generation in the app, in Runs. A call above the key's threshold asks first: your agent shows you the price and runs it only after you agree.
Who can get a developer key?
Any ToRun account with a confirmed e-mail address and a paid plan or a purchased balance. You create the key yourself on the Developers page of your account.