Um erro de digitação, um resultado vazio 'bem-sucedido': o Hermes agora recusa o nome de argumento errado

Você pede ao agente para checar o console do browser em busca de erros. Ele chama a ferramenta de browser do Playwright com uma letra errada — levle em vez de level. A ferramenta não reclama. Retorna um resultado normal: Total messages: 0 (Errors: 0, Warnings: 0). O agente reporta uma página limpa.
A página tinha doze erros. O argumento foi descartado em silêncio, a ferramenta rodou com defaults e tudo parecia bem. Um sucesso silencioso é muito mais perigoso que uma falha — você lê falhas, você não lê sucessos.
O PR #115682, mergeado em 12 de novembro, recusa chamadas assim antes que elas rodem.
Por que dava sucesso silencioso
A resposta é um campo do schema: additionalProperties: false.
Servidores MCP em geral descrevem seus parâmetros com zod ou pydantic, e essas bibliotecas emitem schemas que dizem explicitamente “este objeto tem exatamente estas chaves”. Parece rígido, mas o parse normalmente descarta chaves desconhecidas em vez de lançar erro. Então levle="error" é jogado fora como chave extra, level volta ao default, a ferramenta roda até o fim e um sucesso volta.
O modelo não vê nada errado, então mantém a grafia errada pelo resto da sessão.
O que acontece agora: recusa antes do dispatch, com os nomes válidos
A regra é curta. Se uma ferramenta de terceiros (MCP ou plugin) fecha o próprio schema, uma chave de topo não declarada é recusada antes de a chamada rodar.
@playwright/mcp real sobre stdio, pelo cliente MCP e pelo dispatch de ferramentas reais:
| Chamada | Antes | Depois |
|---|---|---|
browser_console_messages(levle="error") |
Total messages: 0 ... — o typo descartado em silêncio |
levle: not a parameter of mcp__pw__browser_console_messages. The tool was NOT invoked. Valid parameters: level, all, filename. |
browser_tabs(arguments={"action": "list"}) |
o erro zod do próprio servidor, sobre action, nunca nomeando o wrapper |
arguments: not a parameter of mcp__pw__browser_tabs. ... Do not wrap the arguments in an "arguments" field (that shape is only for tool_call); pass each one at the top level. |
browser_tabs(action="list") |
resultado normal | idêntico |
| Ferramenta de terceiros com schema aberto e uma chave extra | o handler recebe a chave | idêntico (sem mudança) |
| Ferramenta nativa com uma chave desconhecida | roda, resultado ganha _warning |
idêntico (warn-and-run mantido) |
Olhe a segunda linha. O erro de envolver os argumentos é um dos mais fáceis de um modelo cometer: ele já viu o formato arguments do tool_call e assume que toda chamada quer esse wrapper. Antes, você recebia um erro zod do servidor que mencionava só action e tinha que descobrir sozinho que o problema era a camada de fora. Agora a recusa diz isso.
Por que as ferramentas nativas ficaram de fora
Porque o schema de uma ferramenta nativa não é o mesmo tipo de promessa. O Hermes escreve esses schemas ele mesmo e mantém um contrato mais frouxo: uma chave extra não faz a chamada falhar, o resultado só ganha um _warning avisando que o nome não era um parâmetro. A única ferramenta nativa que fecha o próprio schema (manage_catalog) já recusa chaves desconhecidas no seu handler.
Dito de outro jeito: quanto mais fora do código, mais rígida a porta. A lista properties de uma ferramenta de terceiros é uma promessa aos seus chamadores, então agora ela é cobrada como tal.
Onde a checagem mora, e até onde ela alcança
Ela fica em _closed_schema_refusal, em tools/arg_validation.py, como a primeira coisa que check_tool_args faz — o que significa que cobre todo ponto de entrada que já roda checagem de argumentos: ToolRegistry.dispatch (ferramentas MCP, de plugin e de registry em todas as superfícies) e o wrapper do executor inline.
Uma correção relacionada no mesmo commit: um schema que fecha o objeto mas omite properties também recusa extras — “nenhum argumento declarado” continua sendo “só estes argumentos”. Vinte e cinco ferramentas do Playwright MCP fecham o schema, e seis delas não têm nenhum argumento obrigatório; essas seis são exatamente onde um typo antes virava um sucesso silencioso por default.
Seus servidores MCP serão afetados
O teste é direto: procure additionalProperties: false no schema da ferramenta.
- Servidores MCP modernos que geram schemas a partir de zod ou pydantic são fechados, e vão começar a recusar argumentos com erro de digitação.
- JSON Schema escrito à mão, e formatos abertos (
anyOf,oneOf,$ref,patternProperties), se comportam como antes — extras ainda chegam ao handler. - Se um dos seus plugins dependia de “manda uma chave extra e deixa o handler resolver”, declare essa chave em
properties. Essa sempre foi a interface mais clara.
Se o seu setup de MCP é montado a partir de variáveis de ambiente e arquivos, vale reler como argumentos são injetados em variáveis de contexto na config de MCP e como a fronteira é desenhada em o catálogo MCP e seu modelo de segurança. Um post anterior sobre schemas $ref locais cobriu uma falha diferente na mesma área: argumentos que não podiam ser vistos de jeito nenhum, em vez de argumentos vistos errado e aceitos em silêncio.
Status de release
O PR #115682 entrou em main em 12 de novembro de 2026, com tests/tools/test_unknown_tool_arguments.py fixando dois invariantes: um schema fechado recusa antes do handler, e um schema aberto ainda admite extras. A v0.23.1 saiu em 10 de novembro e não o inclui.
Atualização (17/11/2026): essas mudanças saíram na v0.23.2 (16 de novembro): um
hermes updateas traz. O « não está na v0.23.1 » acima é um retrato da data de publicação.
Um adendo: se a sua lista de ferramentas é enorme e o modelo continua trocando nomes de parâmetro, a causa raiz pode ser o tamanho do schema — enxugar o schema de ferramentas é a outra metade do mesmo problema.