Saltar al contenido
Restoman Guía

MCP y agentes públicos

Los MCP y los agentes A2A que leen la Guía y las cartas de Restoman sin cuenta, y cómo llamarlos.

La Guía y las cartas tienen cada una un servidor MCP y un agente A2A. Son de solo lectura, no necesitan cuenta y responden lo mismo que muestran las páginas.

Cómo se llaman

Los cuatro reciben un mensaje JSON-RPC 2.0 por cada POST, con Content-Type: application/json, de hasta 16 KB. Los agentes no mandan Origin; un Origin de otro sitio recibe 403.

El MCP de la Guía

https://docs.restoman.com.ar/mcp, con dos herramientas:

  • search_docs (query, locale): hasta diez guías que coinciden, en JSON, la mejor primero, cada una con su página y su markdown.
  • get_doc (slug, locale): una guía entera en markdown.

locale es es-AR, el de siempre, o en-US. Su tarjeta: https://docs.restoman.com.ar/.well-known/mcp/server-card.json.

El MCP de las cartas

https://menu.restoman.com.ar/mcp, con cuatro herramientas:

  • list_restaurants (query, locale): los restaurantes publicados, por el nombre que ven los comensales, con su carta y su markdown.
  • get_menu (slug, locale): la carta de un restaurante en markdown: sus datos, sus horarios y cierres, y cada plato con su precio y sus opciones.
  • search_dishes (slug, query, locale): los platos de una carta que coinciden, en JSON, con el precio en centavos.
  • get_dish (slug, dish, locale): un plato en markdown, con sus opciones.

Lo agotado no está: cambia minuto a minuto y lo muestra la página de la carta. Su tarjeta: https://menu.restoman.com.ar/.well-known/mcp/server-card.json.

Los agentes A2A

Dos agentes A2A (Agent2Agent) responden en lenguaje natural, en español o en inglés:

  • Restoman Guía, en https://docs.restoman.com.ar/a2a: responde con la guía que mejor coincide, entera, y las demás como enlaces.
  • Restoman menus, en https://menu.restoman.com.ar/a2a: con el nombre de un restaurante, responde su carta; si además nombrás un plato, los platos de su carta que coinciden.

Son de búsqueda, sin un modelo de lenguaje: buscan en las guías y las cartas, no razonan. Hablan A2A 1.0 (con el encabezado A2A-Version: 1.0, el método SendMessage) y 0.3 (sin el encabezado, message/send), y responden cada mensaje con un mensaje, en markdown y en JSON. No crean tareas, no transmiten y no mandan avisos. Sus tarjetas están en /.well-known/agent-card.json de cada sitio.

Un ejemplo:

curl https://menu.restoman.com.ar/a2a \
  -H 'content-type: application/json' -H 'a2a-version: 1.0' \
  -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"messageId":"1","role":"ROLE_USER","parts":[{"text":"¿Qué sirve Bibis Palermo?"}]}}}'

Una parte de datos con slug (o query) y locale dice exactamente qué preguntás cuando el texto no alcanza.

Todas las guías