Skip to main content

MCP para agentes

Conecta YourMapSeat con tu agente.

Usa el endpoint MCP para consultar el mapa, seguir la actividad y preparar pujas con la misma confirmación explícita del chat.

Streamable HTTP

Usa placeholders locales en la configuración y mantén el token fuera del repositorio.

Endpoint MCP

https://yourmapseat.com/api/mcp

Crea credenciales seguras para conectar Codex, ChatGPT y otros agentes con el mapa de YourMapSeat.

Gestionar tokens MCP

Acceso autenticado

Content-Type: application/json
Accept: application/json, text/event-stream
Authorization: Bearer <YOUR_ACCESS_TOKEN>

Usa placeholders locales en la configuración y mantén el token fuera del repositorio.

01

Codex

Añade un servidor MCP remoto en la configuración de Codex e introduce el endpoint y el Bearer token localmente.

Ejemplo de configuración

[mcp_servers.yourmapseat]
url = "https://yourmapseat.com/api/mcp"
bearer_token_env_var = "YOURMAPSEAT_ACCESS_TOKEN"

Usa placeholders locales en la configuración y mantén el token fuera del repositorio.

02

ChatGPT

Si tu cuenta ofrece conexiones MCP remotas, crea un conector en configuración y usa el mismo endpoint autenticado.

Datos del servidor

  • 1Endpoint MCP: https://yourmapseat.com/api/mcp
  • 2Usa el token como Bearer token. En Codex, mantén el secreto en una variable de entorno local.
  • 3Usa tools/list para descubrir las tools y lee siempre el resultado antes de actuar. Las tools en vivo deben aportar precio, ocupación y actividad.

03

Qué está disponible

Descubrimiento del mapa, estadísticas del usuario, tus propias conversaciones y el flujo protegido de compra de Regiones.

Usa tools/list para descubrir las tools y lee siempre el resultado antes de actuar. Las tools en vivo deben aportar precio, ocupación y actividad.

get_presidential_resultsget_governor_resultsget_world_statisticslist_countriesget_country_statisticslist_country_regionsget_region_detailsget_map_rankingsget_recent_map_activityget_my_ai_usagelist_my_conversationscreate_my_conversationupdate_my_conversationprepare_delete_my_conversationdelete_my_conversationget_purchase_statusprepare_map_purchasestart_map_purchase_checkout

Puja con seguridad

Un agente puede preparar una puja, pero no puede comprar en silencio.

El endpoint no acepta claves administrativas, no expone datos de otros usuarios y no confirma la ocupación cuando solo se abre el checkout.

  1. 1Llama a prepare_map_purchase y muestra Región, patrocinador, precio y vencimiento.
  2. 2Pide una confirmación explícita en un mensaje nuevo y usa el código devuelto.
  3. 3Solo entonces llama a start_map_purchase_checkout. El pago ocurre en Stripe Checkout.