O servidor MCP do ToRun
Última atualização: 11 nov. 2026
O que é
O servidor MCP do ToRun permite que um agente de programação use o ToRun enquanto trabalha no seu projeto. Um agente compatível com servidores MCP remotos, como o Claude Code, o Cursor ou o opencode, pode criar imagens, voz, música e vídeo, editar imagens, transcrever áudio, executar pesquisas profundas e os modelos de workflow do ToRun, e publicar uma página HTML ou um jogo de navegador como link, sem você sair do editor. O que o agente cria é pago pela sua conta ToRun pelos mesmos preços do app e fica salvo na sua conta ToRun como tudo o que você cria no app.
Endereço e login
| Endereço do servidor | https://mcp.torun.ai/mcp |
| Transporte | HTTP (servidor MCP remoto) |
| Login | Authorization: Bearer <your developer key> |
Uma chave de desenvolvedor começa com trn_live_. Você a cria na página Desenvolvedores da sua conta ToRun: veja Chaves de desenvolvedor. Configuração para cada ferramenta:
Ferramentas
| Ferramenta | O que faz | Paga |
|---|---|---|
image_generate |
Cria imagens a partir de um prompt: sprites, ícones, fundos, ilustrações. Retorna as imagens, ou um id de tarefa quando elas demoram mais do que o agente escolheu esperar. | Sim |
image_edit |
Altera uma imagem a partir de uma instrução escrita: um fundo novo, outra cor, um objeto adicionado ou removido, outro estilo. A imagem é uma que o agente criou com o ToRun ou um link para um arquivo PNG, JPEG ou WebP de até 20 MB; uma imagem informada por link é salva primeiro na sua biblioteca do ToRun. Retorna as imagens ou um id de tarefa, como image_generate. |
Sim |
tts_generate |
Transforma texto em fala e retorna o arquivo de áudio e quanto tempo ele dura, medido a partir do arquivo. | Sim |
stt_transcribe |
Transforma em texto a fala de um arquivo de áudio ou vídeo, com segmentos com marcação de tempo para legendas quando o agente pede. Aceita arquivos mp3, m4a, wav, webm, ogg, opus, flac, aac e mp4 de até 25 MB. | Sim |
music_generate |
Compõe uma faixa, com ou sem vocais, e retorna um id de tarefa. | Sim |
video_generate |
Cria um clipe curto a partir de um prompt e retorna um id de tarefa. | Sim |
job_status |
Informa o andamento de uma tarefa de imagem, música ou vídeo e retorna o arquivo quando ele fica pronto. | Grátis |
deep_research_start |
Inicia uma pesquisa profunda sobre uma pergunta: ela busca na web em muitas fontes e escreve um relatório com as fontes citadas. Retorna um id de tarefa. | Sim |
deep_research_status |
Informa o andamento de uma pesquisa profunda e retorna o relatório quando ele fica pronto. | Grátis |
workflow_template_search |
Encontra os modelos de workflow do ToRun, pipelines prontos de várias etapas, e mostra o que cada um gera, quanto costuma custar e quais entradas recebe. | Grátis |
workflow_run |
Executa um modelo de workflow com as entradas que o agente fornece e retorna um id de tarefa. | Sim |
workflow_run_status |
Informa o andamento de uma execução de workflow e os Runs que ela custou até agora, e retorna os resultados quando ficam prontos. | Grátis |
canvas_publish |
Publica como link uma página HTML de um único arquivo ou um jogo de navegador. | Grátis |
account_balance |
Mostra a cota do plano e a carteira restantes, além do limite mensal e dos gastos desta chave. | Grátis |
Um link de arquivo que uma ferramenta retorna pode ser baixado sem login, então o agente pode salvar o arquivo no seu projeto. Mantenha o link inteiro, incluindo a parte depois do ponto de interrogação.
Uma página publicada não fica listada: qualquer pessoa com o link pode abri-la, mas ela não aparece no Explorar do ToRun e os buscadores não a indexam.
Tarefas longas
Música, vídeo, pesquisas profundas e execuções de workflow levam mais tempo do que uma chamada. A ferramenta retorna um id de tarefa, e o agente pergunta de novo até o resultado ficar pronto: job_status para imagens, música e vídeo, deep_research_status para um relatório de pesquisa e workflow_run_status para uma execução de workflow. Uma imagem que não fica pronta dentro do tempo de espera escolhido pelo agente também volta como um id de tarefa.
Uma pesquisa leva de 1 a 10 minutos e continua mesmo se a conversa com seu agente terminar; o relatório também aparece como uma conversa própria na sua lista de chats do ToRun. Uma execução de workflow leva de um minuto a dezenas de minutos, e a execução e seus arquivos aparecem na sua conta ToRun. Um relatório longo ou um conjunto longo de resultados chega em partes, e o agente pede o restante.
Como as chamadas são pagas
- Cada chamada paga é cobrada em Runs pelos mesmos preços do app.
- Ela é paga primeiro pela cota do seu plano e depois pela sua carteira, se você permitiu isso na chave.
- A cota gratuita nunca paga chamadas de API.
- Uma execução de workflow é cobrada etapa por etapa enquanto roda.
- Cada cobrança aparece na sua página de faturamento, sob a chave que a fez.
Uma chamada acima do limite de confirmação da chave pergunta primeiro
Cada chave tem um limite de confirmação. Quando uma única chamada custaria mais do que isso, a ferramenta ainda não a executa. Em uma execução de workflow, o que se compara é a estimativa da execução.
- Se sua ferramenta consegue mostrar um formulário quando um servidor MCP faz uma pergunta (MCP elicitation), o ToRun pergunta a você ali: o formulário mostra o preço e pergunta se deve continuar. A chamada é executada se você disser sim; se recusar, nada é executado.
- Caso contrário, a ferramenta responde com o preço, seu agente mostra o valor a você e a chamada só é executada quando o agente a repete depois que você concorda.
Perguntar não custa nada.
Limites
Cada chave tem um limite de gastos mensal e um diário, além de um limite de chamadas por minuto. Cada conta também tem um limite diário de páginas publicadas. Você define o limite mensal e o limite de confirmação de uma chave ao criá-la; os valores padrão estão em torun.ai/developers. Para mudá-los, crie uma nova chave com as configurações que quiser e revogue a antiga.
Quando uma chamada é recusada
| O que o agente recebe | O que fazer |
|---|---|
| A chamada precisa de uma chave de desenvolvedor | Confira se TORUN_API_KEY tem a chave inteira e se a chave não foi revogada. |
| A cota do plano acabou e a chave não pode gastar da carteira | Espere a cota renovar, ou crie uma chave que possa gastar da carteira. |
| Chaves de desenvolvedor só gastam a cota de um plano pago ou a carteira | Recarregue ou assine. |
| A chave atingiu seu limite de gastos mensal ou diário | Espere o próximo dia ou mês, ou crie uma chave com um limite maior. |
| A chave fez chamadas demais em um minuto | Espere um momento e tente de novo. |
| A chave não tem o escopo de que uma ferramenta precisa | Os escopos de uma chave não podem ser alterados. Crie uma nova chave: uma chave nova tem todos os escopos. |
| O arquivo deve ser informado como um id da biblioteca do ToRun ou como um link https, não os dois | Informe exatamente um dos dois. |
| Não existe esse arquivo na biblioteca do ToRun da conta | Use um arquivo desta conta. Um link do ToRun para o arquivo de outra conta é recusado da mesma forma. |
| O arquivo é grande demais, não está em um formato que a ferramenta aceita ou não pôde ser baixado | Imagens para image_edit: PNG, JPEG ou WebP, até 20 MB. Arquivos para stt_transcribe: mp3, m4a, wav, webm, ogg, opus, flac, aac ou mp4, até 25 MB. O link precisa poder ser baixado sem login. |