Custos e limites de gasto nas ferramentas MCP pagas
Por SkyNet · 10 de novembro de 2026
Há servidores MCP que custam dinheiro. Gerar uma imagem, animar uma cena, mandar trabalho para uma API que cobra ao pedido: cada chamada sai do bolso. A v0.23.0, “The Hearth Release” (5 de novembro de 2026), dá ao Hermes uma forma de lidar com isso. Uma entrada mcp_servers no config.yaml pode declarar quanto custa cada ferramenta, um orçamento por chat e a etiqueta da unidade. O agente passa a mostrar o preço e a perguntar antes de estourar o orçamento, mesmo em YOLO.
Isto interessa a quem liga ferramentas pagas: geração de imagem, vídeo e 3D, ou APIs que cobram por chamada. Sem esta informação, o custo é invisível até chegar a fatura. Com ela, o Hermes trata o dinheiro como o que é: um recurso limitado.
Como usar
Nas notas da release, descreve-se assim: “Paid MCP tools, such as 3D or media generation, can declare what a call costs. The approval prompt shows each call’s price and the chat’s running total, and Hermes asks before a chat goes over its limit, even in YOLO mode.”
A configuração cabe numa entrada:
mcp_servers:
renders:
command: "render-mcp"
trust: untrusted
tool_costs:
create_image: 20 # about 20 credits per call
animate: {credits: [5, 20], note: "per animation"} # a range, with a short note
get_status: 0 # free; same as leaving it out
spend_limit: 100 # per chat; 0 or absent = no limit
cost_unit: credits # label in prompts (default: credits)
Em tool_costs, a chave é o nome da ferramenta do próprio servidor. O valor pode ser um número não negativo, um intervalo [min, max] ou um objecto {credits: <número ou intervalo>, note: "..."}. Ferramentas não declaradas — ou declaradas a zero — não são afectadas. spend_limit é o orçamento por conversa; 0 ou ausente significa sem limite. cost_unit é só a etiqueta que aparece nos prompts, com “credits” por omissão.
Pormenores que interessam
O prompt de aprovação mostra o custo da chamada e o total corrido da conversa. Pode ler-se “Costs about 20 credits.”, “Costs 5-20 credits (per animation).” e ainda “This chat has used about 40 credits on ‘renders’ (limit 100).” quando já gastou algo.
A contabilidade é simples de explicar: total corrido por chat e por servidor, contando o valor declarado — o topo do intervalo — por cada chamada com custo que seja aprovada e iniciada. Chamadas recusadas ou bloqueadas não somam. Uma chamada cujo servidor morre antes de a receber conta na mesma: erra para o lado de perguntar mais cedo. E convém não esquecer que o total vive em memória; é um orçamento da conversa, não a fatura do fornecedor.
O total segue a conversa quando a compressão de contexto ou /branch a continuam com um novo session id. Um chat novo (/new na CLI, novo chat no Desktop) começa total novo; nas plataformas de mensagens o total pertence ao chat e sobrevive a /new. Cada execução de cron tem o seu. Reiniciar o Hermes repõe todos os totais.
Abaixo do limite, um servidor trust: full corre ferramentas com custo sem perguntar; em trust: untrusted toda a chamada com capacidade de escrita já pergunta, e o prompt passa a levar o custo. Ferramentas anotadas com readOnlyHint: true ficam sem prompt, salvo se o orçamento o exigir.
Ao passar o limite, o Hermes pergunta — mesmo num servidor trust: full, que normalmente nunca pergunta. E todas as chamadas com custo seguintes nessa conversa voltam a perguntar. Esse prompt só oferece Allow Once e Deny; respostas anteriores do tipo Session ou Always para a mesma ferramenta não o silenciam. Onde ninguém pode responder — cron jobs, hermes chat -q, gateway sem aprovador — a chamada é recusada sem correr, e o modelo é instruído a não repetir.
YOLO (/yolo para o chat, --yolo para o processo) e approvals.mode: off saltam o prompt do trust: untrusted, mas não o spend limit. Abaixo do limite corre sem perguntar; a chamada que o ultrapassaria pergunta, ou é recusada onde ninguém responde (por exemplo, cron com approvals.mode: off).
Armadilhas
tool_costs, spend_limit ou cost_unit mal formados fazem o servidor ser saltado com um erro que nomeia a chave. Um orçamento declarado nunca é ignorado em silêncio, o que é bom — mas obriga a ler o erro até ao fim. A outra armadilha é a gralha no nome: uma chave de tool_costs que o servidor não oferece, ou copiar o prefixo de apresentação mcp_<server>_ do Hermes, não dá erro, só um aviso na ligação, e essa ferramenta fica sem custo declarado. Usa os nomes próprios das ferramentas do servidor e lê os avisos quando ligas.
Plugins
Um pacote portable plugin pode declarar a mesma tabela para o seu servidor. Se acrescentares uma entrada mcp_servers com o mesmo nome — por exemplo, para pôr trust: full — os tool_costs, spend_limit e cost_unit do pacote continuam a aplicar-se, salvo se a tua entrada definir essas chaves. spend_limit: 0 desliga o limite do pacote; tool_costs: {} remove os custos.
A mudança aparece na v0.23.0 (5 de novembro de 2026), nos PRs #142470, #143780, #143795 e #143787. Para detalhes, vale a pena ler a secção “Tool costs and spend limits” e a referência de configuração MCP. As notas da release estão no GitHub.
Tags: #hermes #mcp #custos #aprovacoes