Pular para o conteúdo principal
API para Desenvolvedores
Beta

Chame 1000+ ferramentas
do seu próprio código.

Um endpoint REST por ferramenta, ou um servidor MCP para todos eles. JSON dentro, JSON fora — e toda resposta diz quanto custou e quanto restou.

1000+
endpoints chamáveis
REST + MCP
duas superfícies, uma chave
1,000
créditos grátis / mês
one call, start to finish
# request
curl -X POST https://api.iotools.cloud/v1/tool/case-converter \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "inputString": "hello world",
        "caseStyle": "uppercase" }'
# response
{
  "outputs": { "outputString": "HELLO WORLD" },
  "credits_used": 1,
  "credits_remaining": 999
}
Três passos

Comece

Não há um plano pago a comprar primeiro — o plano Builder aumenta seus limites, não desbloqueia endpoints.

1

Crie uma conta gratuita

Sem cartão, sem ligação de vendas. O nível gratuito acessa cada endpoint que o pago faz.

2

Minta uma chave de API

A partir da sua página de conta. Ela é mostrada uma vez — guarde-a em um lugar seguro.

3

Chame qualquer ferramenta

A resposta traz o resultado, custo e saldo, então você nunca precisa de uma segunda requisição.

Uma chave, duas superfícies

Duas maneiras de chamar

REST

Um endpoint por ferramenta

Um POST por ferramenta, campos planos no corpo — sem invólucro. Todo esquema é publicado, então você pode gerar um cliente em vez de escrever um manualmente. Falhas são documentos RFC 9457 com um code estável para ramificar.

curl -X POST https://api.iotools.cloud/v1/tool/case-converter \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "inputString": "hello world" }'
Comece →
MCP

Um servidor para todos eles

As mesmas ferramentas, chamáveis por agentes de IA — aponte Claude, Cursor ou Windsurf para nosso endpoint MCP. Ele anuncia cinco ferramentas, não 1000+: um agente pesquisa, lê o esquema de que precisa e o executa, por cerca de mil tokens em vez de duzentos mil.

{
  "mcpServers": {
    "iotools": {
      "type": "http",
      "url": "https://mcp.iotools.cloud/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
Guia de configuração MCP →
Envelopes previsíveis

Toda resposta, um formato

Sucesso

200

O que você pediu, quanto custou e quanto restou — na mesma resposta, toda vez.

{
  "request_id": "req_8f2c1a",
  "tool": "case-converter",
  "tool_version": "1.0.1",
  "outputs": { "outputString": "HELLO WORLD" },
  "credits_used": 1,
  "credits_remaining": 999
}

Falha

4xx / 5xx

Um code estável para ramificar, não uma mensagem para analisar. Chamadas falhadas são reembolsadas — veja a referência de erros.

{
  "type": "https://docs.iotools.cloud/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "code": "insufficient_credits",
  "request_id": "req_8f2c1b"
}
Pronto para agentes

Para agentes de IA

Um agente que não memorizou um slug precisa de uma maneira de encontrar a ferramenta certa sem adivinhar uma. Ambas as superfícies classificam com a mesma busca, então um agente obtém a mesma resposta de qualquer forma — o que muda é quanto do trabalho você precisa explicitar.

Sobre a API REST

três chamadas, explicitadas no prompt

Um agente com nada além de uma ferramenta HTTP não pode descobrir o catálogo por conta própria, então o prompt carrega a sequência: busque por intenção, leia o esquema do slug que escolheu e depois o chame.

Use the IO Tools REST API to convert the attached CSV to JSON.
My key is in $IOTOOLS_KEY. Send it as
"Authorization: Bearer $IOTOOLS_KEY" on every request.

1. Find the tool — do not guess a slug:
   GET https://api.iotools.cloud/v1/tools/search?q=convert+csv+to+json&limit=5

2. Read the schema of the slug you picked:
   GET https://api.iotools.cloud/v1/tool/{slug}

3. Run it with the fields that schema declared:
   POST https://api.iotools.cloud/v1/tool/{slug}
   The fields go at the top level of the body, with no wrapper:
   { "fieldName": "…" }

Every response carries credits_used and credits_remaining,
so report what the job cost when you are done.

Sobre o servidor MCP

uma linha, depois de conectado

Conecte o servidor uma vez com a configuração acima e search_tools torna-se uma ferramenta como qualquer outra. As três chamadas REST se colapsam no loop de chamada de ferramenta do cliente, então o prompt é apenas a tarefa.

Convert the attached CSV to JSON
using the iotools MCP server.
Grátis, e medido por nada além do limite de taxa:search_toolsdescribe_toolget_creditsget_usage

Agentes de codificação também podem começar a partir de /llms.txt, um índice em texto simples do site construído para modelos de linguagem.

Pede antes de gastar

Solicitação MCP, em toda chamada paga

Um agente escolhe suas próprias ferramentas e as chama quantas vezes quiser — nada sobre um loop de chamada de ferramenta naturalmente para no seu orçamento. Portanto, toda chamada paga é posta para aprovação antes de qualquer coisa ser cobrada, citando o preço. Clientes que suportam solicitação MCP a mostram para você:

String Case Converter costs 3 credits. Run it?

Toda chamada, não apenas a primeira — não há «lembre-se disso». O prompt chega depois que suas entradas são validadas e antes de um único crédito se mover, a única janela onde «não» é grátis. Como seu cliente a mostra cabe ao cliente.

Accept
Executa e cobra no máximo o preço citado — nunca mais.
Decline
Nada executa, nada é cobrado e o agente é instruído a pedir a você primeiro.
Ignore
Um prompt dispensado ou descartado conta como uma recusa. Falha fechada.

Clientes que não conseguem mostrar um prompt continuam funcionando — mas uma única chamada acima de 50 créditos é recusada em vez de gasta silenciosamente.

Seis categorias

Navegue pelo catálogo

Toda ferramenta ativada por API fica em uma das seis categorias.

Catálogo completo
Créditos, não assentos

Quanto custa

Usar a maioria das ferramentas em seu navegador é grátis e ilimitado. Chamá-las a partir do código custa créditos — toda chamada, incluindo ferramentas que são gratuitas no site. Ler o catálogo não custa nada.

Conta gratuita

1,000 créditos / mês
60 requisições por minuto
Todos os 1000+ endpoints
Mínimo 3 créditos por chamada
Nenhum cartão necessário

Plano Builder

50,000 créditos / mês
300 requisições por minuto
Mínimo 1 crédito por chamada, não 3
Mesmos endpoints — apenas mais espaço

Como uma chamada é precificada

Uma chamada custa o que for maior: o peso da própria ferramenta ou o mínimo por chamada do seu plano.

A maioria do catálogo não tem peso nenhum, então custa o mínimo — 3 em uma conta gratuita, 1 no Builder.

As ferramentas de IA custam mais, porque há uma conta de fornecedor real por trás delas.

Chamadas falhadas são gratuitas — créditos são reembolsados em qualquer 4xx ou 5xx.

Como os créditos funcionam →

Próximos passos