Herramientas

Una tool es una operación con nombre que publica un servidor MCP, descrita con un JSON Schema de entrada, que puede leer o cambiar datos de un sistema. El host obtiene las definiciones con tools/list y se las pasa al modelo, que solo propone usarla indicando qué tool y con qué argumentos; es el host quien la envía al servidor con tools/call y quien puede pedir antes la aprobación de una persona. Como el modelo no sabe de la tool más que su nombre, su descripción y su esquema, la description tiene que explicar en qué casos conviene usarla y qué no hace.

Son anotaciones con las que el servidor describe el comportamiento de una tool y que el host usa para decidir, por ejemplo, si pide confirmación antes de llamarla: readOnlyHint indica que no modifica su entorno y destructiveHint que puede hacer cambios destructivos. Si no se declaran, se asumen los valores más prudentes: que la tool escribe, que destruye, que no es idempotente y que trabaja con entidades externas. Son pistas y no garantías, así que el cliente debe tratarlas como no fiables salvo que el servidor sea de confianza.

Depende de tres diferencias: una tool puede modificar un sistema, sus argumentos se validan con un JSON Schema y, si falla, devuelve un error que el modelo lee y le sirve para corregirse; un resource solo se lee, se identifica por su URI y admite caché y avisos cuando cambia. Así, una búsqueda en la que el modelo teclea el identificador, y se equivoca a menudo, conviene como tool aunque no escriba nada, y un documento estable que se lee completo, como una política interna, conviene como resource.