The ToRun MCP server
Last updated 11 Nov 2026
What it is
The ToRun MCP server lets a coding agent use ToRun while it works on your project. An agent that supports remote MCP servers, such as Claude Code, Cursor or opencode, can create 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, without you leaving your editor. What the agent makes is paid from your ToRun account at the same prices as in the app, and it is saved to your ToRun account like anything you make in the app.
Address and sign-in
| Server address | https://mcp.torun.ai/mcp |
| Transport | HTTP (remote MCP server) |
| Sign-in | Authorization: Bearer <your developer key> |
A developer key starts with trn_live_. You create it on the Developers page of your ToRun account: see Developer keys. Setup for each tool:
Tools
| Tool | What it does | Paid |
|---|---|---|
image_generate |
Creates images from a prompt: sprites, icons, backgrounds, illustrations. Returns the images, or a job id when they take longer than the agent chose to wait. | Yes |
image_edit |
Changes an image from a written instruction: a new background, another color, an object added or removed, another style. The image is one the agent made with ToRun or a link to a PNG, JPEG or WebP file up to 20 MB; an image given by link is saved to your ToRun library first. Returns the images or a job id, like image_generate. |
Yes |
tts_generate |
Turns text into speech and returns the audio file and how long it plays, measured from the file. | Yes |
stt_transcribe |
Turns the speech in an audio or video file into text, with timed segments for subtitles when the agent asks for them. Takes mp3, m4a, wav, webm, ogg, opus, flac, aac and mp4 files up to 25 MB. | Yes |
music_generate |
Composes a track, with or without vocals, and returns a job id. | Yes |
video_generate |
Creates a short clip from a prompt and returns a job id. | Yes |
job_status |
Reports on an image, music or video job and returns the file when it is ready. | Free |
deep_research_start |
Starts a deep research run on a question: it searches the web across many sources and writes a report with its sources cited. Returns a job id. | Yes |
deep_research_status |
Reports on a deep research run and returns the report when it is ready. | Free |
workflow_template_search |
Finds ToRun's workflow templates, ready-made multi-step pipelines, and shows what each one outputs, what it typically costs and the inputs it takes. | Free |
workflow_run |
Runs a workflow template with the inputs the agent gives it and returns a job id. | Yes |
workflow_run_status |
Reports on a workflow run and the Runs it has cost so far, and returns its results when they are ready. | Free |
canvas_publish |
Publishes a single-file HTML page or browser game as a link. | Free |
account_balance |
Shows the plan allowance and wallet left, and this key's monthly limit and spend. | Free |
A file link a tool returns downloads without signing in, so the agent can save the file into your project. Keep the whole link, including the part after the question mark.
A published page is unlisted: anyone who has the link can open it, but it is not shown on ToRun Explore and search engines do not index it.
Long jobs
Music, video, deep research and workflow runs take longer than one call. The tool returns a job id, and the agent asks again until the result is ready: job_status for images, music and video, deep_research_status for a research report and workflow_run_status for a workflow run. An image that is not ready within the wait time the agent chose comes back as a job id too.
A research run takes 1 to 10 minutes and keeps going if the conversation with your agent ends; the report also appears as its own conversation in your ToRun chat list. A workflow run takes from a minute to tens of minutes, and the run and its files appear in your ToRun account. A long report or a long set of results comes in parts, and the agent asks for the rest.
How calls are paid
- Each paid call is charged in Runs at the same prices as in the app.
- It is paid first from your plan's allowance, then from your wallet if you allowed that on the key.
- The free allowance never pays for API calls.
- A workflow run is charged step by step while it runs.
- Every charge appears on your billing page under the key that made it.
A call above the key's threshold asks first
Each key has a threshold. When a single call would cost more than that, the tool does not run it yet. For a workflow run, the run's estimate is what is compared.
- If your tool can show a form when an MCP server asks a question (MCP elicitation), ToRun asks you there: the form shows the price and asks whether to continue. The call runs if you say yes; if you decline, nothing is run.
- Otherwise the tool answers with the price, your agent shows it to you, and the call runs only when the agent repeats it after you agree.
Nothing is charged for asking.
Limits
Each key has a monthly spending limit and a daily one, and a limit on calls per minute. Each account also has a daily limit on published pages. You set a key's monthly limit and threshold when you create it; the defaults are listed on torun.ai/developers. To change them, create a new key with the settings you want and revoke the old one.
When a call is refused
| The agent is told | What to do |
|---|---|
| The call needs a developer key | Check that TORUN_API_KEY holds the whole key, and that the key has not been revoked. |
| The plan allowance is used up and the key may not spend from the wallet | Wait for the allowance to renew, or create a key that may spend from the wallet. |
| Developer keys spend only a paid plan's allowance or the wallet | Top up or subscribe. |
| The key has reached its monthly or daily spending limit | Wait for the next day or month, or create a key with a higher limit. |
| The key made too many calls in a minute | Wait a moment and try again. |
| The key does not have the scope a tool needs | A key's scopes cannot be changed. Create a new key: a new key carries every scope. |
| The file must be given as a ToRun library id or as an https link, not both | Give exactly one of the two. |
| There is no such file in the account's ToRun library | Use a file of this account. A ToRun link to another account's file is refused the same way. |
| The file is too large, is not in a format the tool takes, or could not be downloaded | Images for image_edit: PNG, JPEG or WebP, up to 20 MB. Files for stt_transcribe: mp3, m4a, wav, webm, ogg, opus, flac, aac or mp4, up to 25 MB. A link must download without signing in. |