Prompts

Especificación MCP 2026-07-28 · revisada el 2 de octubre de 2026

Plantillas de mensajes que el servidor MCP publica y el usuario invoca: prompts/list, prompts/get, argumentos, resources embebidos y gobierno en una empresa.

Qué aprenderás

Explicar qué es un prompt en MCP, quién lo invoca y en qué se diferencia de una tool y de un resource
Leer y escribir los mensajes prompts/list y prompts/get completos, con sus errores
Diseñar un prompt de varios mensajes con un resource embebido y argumentos validados
Decidir cuándo conviene servir una plantilla desde el servidor en lugar de copiarla en cada cliente

Contenido de la lección

01 El problema
02 Qué es un prompt y quién lo invoca
03 Descubrir y obtener: `prompts/list` y `prompts/get`
04 Varios mensajes y resources embebidos
05 Autocompletado de argumentos
06 Registrar el prompt en el servidor
07 En producción

Además: quiz de comprobación y desafío práctico.

Extracto

El equipo de soporte de Nortia responde cada día a decenas de incidencias de entrega. Para que el modelo redacte esas respuestas con el tono de la casa y sin prometer compensaciones indebidas, alguien escribió hace meses unas instrucciones que funcionan bien. Hoy esas instrucciones viven copiadas en tres sitios: la configuración de la consola de soporte de España, la de México y un documento compartido del que cada agente pega lo que recuerda.

En septiembre cambia la política de compensación: el abono de gastos de envío pasa a aplicarse a partir de 48 horas de retraso, no de 24. Dos de las tres copias se actualizan. Durante una semana, parte de los agentes sigue ofreciendo abonos que la política ya no contempla, y nadie puede decir qué versión del texto se usó en cada ticket.

Fin del extracto · la lección sigue con 6 secciones más

Preguntas frecuentes

¿Qué es un prompt en MCP y en qué se diferencia de una tool?

Es una plantilla de mensajes con nombre y argumentos que ofrece el servidor y que este devuelve ya rellena cuando el host la pide con prompts/get; no lanza acciones ni cambia datos. La diferencia está en quién la invoca: una tool la elige el modelo cuando cree que la necesita, mientras que un prompt lo escoge una persona desde la aplicación, por ejemplo en un menú o con un comando. Si el modelo tiene que consultar algo por iniciativa propia, lo adecuado son las tools o los resources; cuando alguien inicia a menudo la misma tarea y quiere plantearla siempre igual, encaja un prompt.

¿Cómo funcionan `prompts/list` y `prompts/get` en MCP?

prompts/list devuelve el catálogo del servidor, con el name, el title, la description y los arguments de cada prompt (nombre, descripción y si es obligatorio), y es cacheable con ttlMs y cacheScope. prompts/get recibe el nombre del prompt y sus argumentos como pares clave-valor, siempre de tipo cadena, y devuelve una lista de mensajes con rol user o assistant, que puede incluir un resource embebido con un documento completo. Un nombre desconocido o la ausencia de un argumento obligatorio se responden con el error de protocolo -32602, porque los prompts no tienen isError.

¿Por qué servir los prompts desde un servidor MCP en lugar de copiarlos en cada aplicación?

Porque así hay una única fuente: basta desplegar un cambio de la plantilla una vez para que llegue a todos los clientes MCP, y como lo que devuelve prompts/get no se guarda en caché, cada petición obtiene la versión vigente. Además el servidor puede registrar cada uso con el usuario y la versión de la plantilla, y decidir el contenido según la credencial, por ejemplo una política distinta para cada inquilino. El precio es que todo lo que devuelve el prompt ocupa contexto del modelo en cada uso.