Una errata, un resultado vacío «correcto»: ahora Hermes rechaza el nombre de argumento equivocado

Pides al agente que revise la consola del navegador en busca de errores. Llama a la herramienta de navegador de Playwright con una letra mal: levle en lugar de level. La herramienta no se queja. Devuelve un resultado normal: Total messages: 0 (Errors: 0, Warnings: 0). El agente informa de una página limpia.
La página tenía doce errores. El argumento se descartó en silencio, la herramienta se ejecutó con los valores por defecto y todo parecía correcto. Un éxito silencioso es mucho más peligroso que un fallo: los fallos los lees, los éxitos no.
El PR #115682, fusionado el 12 de noviembre, rechaza llamadas así antes de que lleguen a ejecutarse.
Por qué tenía éxito en silencio
La respuesta es un campo del schema: additionalProperties: false.
Los servidores MCP suelen describir sus parámetros con zod o pydantic, y esas librerías emiten schemas que dicen explícitamente «este objeto tiene exactamente estas claves». Suena estricto, pero el parse normalmente descarta las claves desconocidas en vez de lanzar un error. Así que levle="error" se tira como clave extra, level vuelve a su valor por defecto, la herramienta termina su trabajo y vuelve un éxito.
El modelo no ve nada raro, así que mantiene la ortografía incorrecta el resto de la sesión.
Qué pasa ahora: rechazo antes del dispatch, con los nombres válidos
La regla es corta. Si una herramienta de terceros (MCP o plugin) cierra su propio schema, una clave de primer nivel no declarada se rechaza antes de que la llamada se ejecute.
@playwright/mcp real sobre stdio, a través del cliente MCP y del dispatch de herramientas reales:
| Llamada | Antes | Después |
|---|---|---|
browser_console_messages(levle="error") |
Total messages: 0 ... — la errata descartada en silencio |
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"}) |
el error de zod del propio servidor, sobre action, sin nombrar nunca el 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 |
| Herramienta de terceros con schema abierto y una clave extra | el handler recibe la clave | idéntico (sin cambios) |
| Herramienta integrada con una clave desconocida | se ejecuta, el resultado gana _warning |
idéntico (se mantiene avisar y ejecutar) |
Fíjate en la segunda fila. El error de envolver los argumentos es de los más fáciles de cometer para un modelo: ha visto la forma arguments de tool_call y asume que toda llamada quiere ese envoltorio. Antes recibías un error de zod del servidor que solo mencionaba action, y tenías que deducir tú que el problema estaba en la capa externa. Ahora el rechazo lo dice.
Por qué las herramientas integradas se quedaron como estaban
Porque el schema de una herramienta integrada no es el mismo tipo de promesa. Hermes escribe esos schemas él mismo y mantiene un contrato más laxo: una clave extra no hace fallar la llamada, el resultado solo gana un _warning que te dice que ese nombre no era un parámetro. La única integrada que sí cierra su schema (manage_catalog) ya rechaza claves desconocidas en su propio handler.
Dicho de otro modo: cuanto más fuera del código, más estricta la puerta. La lista properties de una herramienta de terceros es una promesa a quien la llama, así que ahora se hace cumplir como tal.
Dónde vive la comprobación y hasta dónde llega
Está en _closed_schema_refusal, en tools/arg_validation.py, como lo primero que hace check_tool_args, lo que significa que cubre todos los puntos de entrada que ya ejecutan comprobaciones de argumentos: ToolRegistry.dispatch (herramientas MCP, de plugin y de registro en cualquier superficie) y el wrapper del ejecutor inline.
Otro arreglo relacionado en el mismo commit: un schema que cierra el objeto pero omite properties también rechaza los extras; «ningún argumento declarado» sigue significando «solo estos argumentos». Veinticinco herramientas MCP de Playwright cierran su schema, y seis de ellas no tienen ningún argumento obligatorio; esas seis son exactamente donde una errata solía convertirse en un éxito silencioso con los valores por defecto.
¿Se verán afectados tus servidores MCP?
La prueba es directa: busca additionalProperties: false en el schema de la herramienta.
- Los servidores MCP modernos que generan sus schemas a partir de zod o pydantic están cerrados y empezarán a rechazar argumentos mal escritos.
- El JSON Schema escrito a mano y las formas abiertas (
anyOf,oneOf,$ref,patternProperties) se comportan como antes: los extras siguen llegando al handler. - Si alguno de tus plugins dependía de «manda una clave extra y que el handler se apañe», declara esa clave en
properties. Esa siempre fue la interfaz más clara.
Si tu configuración MCP se arma con variables de entorno y archivos, vale la pena releer cómo se inyectan los argumentos en variables de contexto en la config de MCP y cómo se traza la frontera en el catálogo MCP y su modelo de seguridad. Un post anterior sobre schemas locales con $ref cubría otro fallo de la misma zona: argumentos que no se podían ver en absoluto, en lugar de argumentos vistos mal y aceptados sin hacer ruido.
Estado del release
El PR #115682 se fusionó en main el 12 de noviembre de 2026, con tests/tools/test_unknown_tool_arguments.py fijando dos invariantes: un schema cerrado rechaza antes del handler y un schema abierto sigue admitiendo extras. La v0.23.1 salió el 10 de noviembre y no lo incluye.
Actualización (17/11/2026): estos cambios salieron en la v0.23.2 (16 de noviembre):
hermes updatelos trae. Lo de «no está en la v0.23.1» es una foto del momento de la publicación.
Una nota al pie: si tu lista de herramientas es enorme y el modelo sigue confundiendo nombres de parámetros, la causa raíz puede ser el tamaño del schema; adelgazar el schema de herramientas es la otra mitad del mismo problema.