Creador de esquemas de herramienta MCP

Define una herramienta y llévate el JSON Schema, con los requisitos del modo estricto aplicados.

Las definiciones de herramienta describen tus sistemas internos. Todo se construye en el navegador y nada se sube.

Revisa una definición que ya tengas

Acerca de Esquema de herramienta MCP

Una definición de herramienta tiene dos tareas y solo una es JSON. El esquema dice qué forma tienen los argumentos; las descripciones dicen para qué sirve la herramienta y qué significa cada argumento. Un esquema puede ser perfectamente válido y aun así producir una herramienta que se llama en el momento equivocado con disparates verosímiles dentro, porque nada en el JSON explica qué es nada. Este creador escribe el esquema y comprueba ambas mitades: la estructura y si algo está realmente descrito. El modo estricto también se trata como corresponde: exige que todas las propiedades figuren como obligatorias y prohíbe las extra, lo que despista porque el esquema por lo demás no cambia.

Características

• Parámetros con tipos, descripciones y conjuntos cerrados de valores opcionales
• La regla de «todo obligatorio» del modo estricto aplicada, no descubierta después
• additionalProperties fijado correctamente con el modo estricto activo
• Los arrays reciben un esquema de items automáticamente
• Avisa de un parámetro sin descripción
• Detecta nombres de parámetro duplicados
• Señala un enum con un solo valor, que es una constante
• Emite la definición completa, no solo el esquema

Cómo usar Esquema de herramienta MCP

1. Nombra la herramienta y describe cuándo debe usarse
2. Añade cada parámetro con su tipo y una descripción
3. Marca cuáles son obligatorios, o activa el modo estricto
4. Copia la definición en tu array de herramientas

Ejemplo

Entrada

"strict": true

Salida

Error: strict mode requires every property to be listed as required

El modo estricto no admite propiedades opcionales: permite null en su lugar.

Errores comunes y solución de problemas

• El modo estricto se rechaza. — Exige que todas las propiedades sean obligatorias y additionalProperties false. Marca las opcionales como obligatorias permitiendo null, o desactiva el modo estricto.
• La herramienta se llama con argumentos equivocados. — Normalmente parámetros sin descripción. Un nombre solo deja el significado a la deducción, y «id» podría ser cualquier cosa.
• La herramienta se llama en el momento equivocado. — Eso es la descripción de la herramienta, no el esquema. Di cuándo usarla y qué devuelve, no solo qué hace.
• Un parámetro de tipo array se rechaza. — Los arrays necesitan un esquema de items que diga qué contienen. Aquí se añade automáticamente.

Preguntas frecuentes

¿Qué cambia realmente el modo estricto?

Garantiza que los argumentos validan contra el esquema exactamente. El precio es que todas las propiedades deben figurar como obligatorias y no se admiten extras, así que un argumento realmente opcional hay que modelarlo como obligatorio pero anulable.

¿Cuánto detalle debe tener la descripción de un parámetro?

El suficiente para que alguien que solo lea el esquema sepa qué poner ahí: el formato, las unidades, de dónde sale el valor. «La dirección de correo con la que se hizo el pedido» vale muchísimo más que «correo».

¿Cuándo debería usar un enum?

Cuando el conjunto de valores válidos sea realmente cerrado y corto. Elimina toda una clase de respuestas erróneas. Un enum de un solo valor se señala porque es una constante, no un parámetro.

¿Sirve para herramientas MCP y de API?

El esquema es el mismo subconjunto de JSON Schema en ambos casos. La envoltura cambia un poco según el contexto, pero el esquema de entrada —la parte fácil de equivocar— es idéntico.

¿Qué hace buena a la descripción de una herramienta?

Tres cosas en un par de frases: qué hace, cuándo recurrir a ella y qué devuelve. La última es la más omitida y la más útil, porque le dice a quien llama si una sola llamada bastará.

Herramientas relacionadas

• Verificador de esquemas — Pega una definición y averigua por qué se rechaza o se llama mal.
• Configuración de servidor MCP — Genera una entrada de servidor MCP para stdio, HTTP o SSE.
• Ejemplos few-shot — Convierte pares de entrada y salida en ejemplos etiquetados, JSON o de chat.
• Linter de prompts — Encuentra contradicciones, instrucciones muertas y marcadores sin rellenar.
• Constructor de subagentes — Crea el archivo de definición de un subagente con sus herramientas y modelo.
• Visor de streams SSE — Pega una respuesta en streaming y recupera el texto, las llamadas y el uso.

Más herramientas de IA y agentes

• Constructor de skills — Escribe un SKILL.md con el frontmatter revisado mientras escribes.
• Linter de skills — Pega un SKILL.md y descubre qué impide que se asocie a una tarea.
• Constructor de subagentes — Crea el archivo de definición de un subagente con sus herramientas y modelo.
• Constructor de comandos — Crea un comando propio, con argumentos y una lista de herramientas.
• Instrucciones del proyecto — Redacta un CLAUDE.md que se gane su sitio en cada sesión.
• Manifiesto de plugin — Genera un plugin.json y mira la estructura de carpetas que espera.
• Constructor de hooks — Crea hooks de settings.json y detecta los matchers que nunca se activan.
• Probador de reglas de permiso — Prueba reglas de permitir, preguntar y denegar con comandos reales.
• Configuración de servidor MCP — Genera una entrada de servidor MCP para stdio, HTTP o SSE.
• Verificador de esquemas — Pega una definición y averigua por qué se rechaza o se llama mal.
• Relleno de plantillas — Expande un prompt sobre una tabla de filas y mira qué falta.
• Linter de prompts — Encuentra contradicciones, instrucciones muertas y marcadores sin rellenar.
• Comparador de prompts — Compara dos versiones palabra por palabra, con la diferencia en tokens.
• Ejemplos few-shot — Convierte pares de entrada y salida en ejemplos etiquetados, JSON o de chat.
• Secciones XML del prompt — Envuelve secciones en etiquetas de las que el contenido no puede salir.
• Visor y validador JSONL — Lee, filtra y comprueba un archivo JSONL línea por línea.
• Conversor de transcripciones — Convierte un array de mensajes en una transcripción legible, y al revés.
• Validador de datasets — Revisa un dataset JSONL de chat buscando los errores que tumban un entrenamiento.
• Visor de streams SSE — Pega una respuesta en streaming y recupera el texto, las llamadas y el uso.
• Planificador de contexto — Reparte la ventana entre prompt, herramientas, historial y respuesta.
• Planificador de caché — Ordena los bloques para que el prefijo cacheable sea lo más largo posible.
• Divisor de texto — Divide un documento en fragmentos solapados que cortan en límites reales.
• Coste de un bucle de agente — Calcula el coste turno a turno, con el historial reenviado y la caché aplicada.
• Constructor de lotes — Convierte una tabla de filas en un trabajo por lotes, con ids únicos.

Ver todas las herramientas de IA y agentes · Todas las herramientas