TicketLens Experiences MCP

Servidor MCP remoto alojado para experiencias de destino con endpoint público y resolución de POI.

Documentación

TicketLens Experiences MCP

Servidor MCP remoto oficial y API REST para descubrir tours, entradas, atracciones y actividades con TicketLens.

TicketLens ofrece un servidor MCP remoto público alojado en https://mcp.ticketlens.com/ y una API REST versionada en https://api.ticketlens.com/v1 para planificadores de viajes con IA, flujos de descubrimiento de destinos e integraciones personalizadas. El mismo inventario alojado cubre tours guiados, entradas a atracciones, autobuses hop-on hop-off, entradas deportivas y otras entradas para eventos.

Sitio web principal: www.ticketlens.com/en

Qué es TicketLens

La superficie oficial remota MCP + REST de TicketLens para experiencias de destino.
Una superficie de búsqueda orientada a desarrolladores para experiencias de destino.
Disponible tanto como MCP como REST sobre el mismo inventario alojado.
Diseñado para asistentes de IA, herramientas de planificación de viajes, flujos de descubrimiento de destinos e integraciones personalizadas.

Por qué encaja con agentes de IA

Servidor MCP remoto alojado con una URL pública para configuración y evaluación rápidas del conector.
Respaldo REST público sobre el mismo inventario para clientes que aún no usan MCP.
Amplia cobertura de experiencias de destino en tours, entradas a atracciones, autobuses hop-on hop-off, entradas deportivas y eventos.

Qué devuelve la API/MCP actual

Las herramientas y endpoints públicos con nombre tour devuelven un catálogo más amplio de experiencias de destino, no solo tours guiados.

search_tours y POST /v1/search/tours pueden devolver:

tours guiados
entradas a atracciones y museos
productos de autobús hop-on hop-off
entradas deportivas
productos de eventos y admisión

Herramientas MCP públicas actuales:

search_tours
search_pois
get_tour
health_check
submit_feedback

Endpoints REST públicos actuales:

POST /v1/search/tours
GET /v1/tours/{tour_id}
POST /v1/search/pois
GET /v1/pois/{poi_id}
GET /v1/livez
GET /v1/readyz
GET /v1/health
GET /v1/openapi.json
GET /v1/docs
GET /v1/redoc

Inicio rápido con MCP alojado

URLs de MCP alojado:

URL base: https://mcp.ticketlens.com/
Tarjeta de servidor canónica: https://mcp.ticketlens.com/.well-known/mcp/server-card.json
Alias de compatibilidad: https://mcp.ticketlens.com/.well-known/mcp.json

Codex

Añade el servidor alojado desde la CLI:

codex mcp add ticketlens-experiences --url https://mcp.ticketlens.com/

Si gestionas servidores MCP de Codex mediante archivos de configuración, empieza desde examples/mcp/codex-config.toml.

Cursor

Añade la URL MCP alojada a tu configuración MCP de Cursor. Hay un ejemplo listo para copiar en examples/mcp/cursor-mcp.json.

Claude

Los conectores MCP remotos de Claude se añaden desde la interfaz de usuario, no mediante claude_desktop_config.json. Usa la URL alojada https://mcp.ticketlens.com/ en Settings > Connectors, o sigue la guía breve en examples/mcp/claude-connector.md.

OpenClaw

Los usuarios de OpenClaw pueden integrar TicketLens rápidamente añadiendo una skill de workspace que llame a la API REST pública de TicketLens. Empieza desde examples/openclaw/skills/ticketlens-api/SKILL.md.

Consulta examples/openclaw/README.md para la ruta de API recomendada y notas sobre la ruta MCP más avanzada.

Inicio rápido con API alojada

URLs de API alojada:

URL base: https://api.ticketlens.com/v1
JSON de OpenAPI: https://api.ticketlens.com/v1/openapi.json
Interfaz Swagger: https://api.ticketlens.com/v1/docs
ReDoc: https://api.ticketlens.com/v1/redoc
Artefacto confirmado: openapi/ticketlens-tour-search-api.v1.json

Los ejemplos alojados a continuación usan directamente los endpoints HTTPS públicos y no requieren cabeceras adicionales en la configuración pública actual.

Paso 1: resuelve la Torre Eiffel a un POI canónico de TicketLens:

curl -sS https://api.ticketlens.com/v1/search/pois \
  -H 'content-type: application/json' \
  -d '{
    "query": "Eiffel Tower",
    "city": "Paris",
    "language": "en",
    "limit": 5
  }'

Paso 2: busca entradas para la Torre Eiffel usando el POI del paso 1:

curl -sS https://api.ticketlens.com/v1/search/tours \
  -H 'content-type: application/json' \
  -d '{
    "query": "ticket",
    "poi": {
      "id": "660851",
      "match_mode": "exact"
    },
    "city": "Paris",
    "languages": ["en"],
    "per_page": 5
  }'

Para flujos de emisión de entradas específicos de destinos como la Torre Eiffel, esto es útil para agentes porque TicketLens puede mostrar inventario del sitio oficial de la Torre Eiffel, incluida disponibilidad difícil de encontrar en temporada alta cuando existe, junto con opciones de entradas de segundo mercado en el mismo flujo de búsqueda.

Para filtrar por fechas de viaje, añade un objeto dates con valores ISO YYYY-MM-DD:

curl -sS https://api.ticketlens.com/v1/search/tours \
  -H 'content-type: application/json' \
  -d '{
    "query": "ticket",
    "poi": {
      "id": "660851",
      "match_mode": "exact"
    },
    "city": "Paris",
    "dates": {
      "from_date": "2026-05-15",
      "to_date": "2026-05-17"
    },
    "languages": ["en"],
    "per_page": 5
  }'

Notas sobre el filtrado por fechas:

Usa dates.from_date para una búsqueda de un solo día.
Usa tanto dates.from_date como dates.to_date para un rango de fechas.
Las fechas deben usar ISO YYYY-MM-DD.
dates.flexible_days existe en el esquema pero no está implementado en la versión pública actual.

Referencia de herramientas MCP

Herramienta	Qué hace
`search_tours`	Busca experiencias de destino en tours, entradas a atracciones, autobuses hop-on hop-off, entradas deportivas, entradas para eventos y otras actividades.
`search_pois`	Resuelve POIs y alias antes de llamar a `search_tours`.
`get_tour`	Obtiene el detalle de una experiencia devuelta por `search_tours`.
`health_check`	Devuelve una instantánea pasiva del estado de salud del servicio.
`submit_feedback`	Comparte comentarios MCP estructurados cuando el comportamiento es defectuoso, poco claro, faltan capacidades o merece mejoras.

Comentarios MCP

submit_feedback está disponible solo en el servidor MCP alojado. No forma parte de la API REST pública ni del documento OpenAPI.

Usa submit_feedback cuando un agente encuentre:

comportamiento defectuoso
resultados confusos o incompletos
capacidades faltantes
lagunas en la documentación
mejoras claras de producto o herramienta

Campos admitidos:

obligatorios: category, message
opcionales: suggestion, related_tool_name, related_request_id, expected_behavior, actual_behavior, reproduction_summary

Categorías admitidas:

bug_report
improvement
missing_capability
documentation_gap
other

Ejemplo de sugerencia de mejora:

{
  "category": "improvement",
  "message": "Add clearer filter explanations when date constraints remove all results.",
  "related_tool_name": "search_tours",
  "suggestion": "Return a short hint explaining which filter removed the result set."
}

Ejemplo de informe de laguna en la documentación:

{
  "category": "documentation_gap",
  "message": "The MCP docs should explain when search_pois is recommended before search_tours.",
  "related_tool_name": "search_pois",
  "suggestion": "Add a short POI-first workflow example to the MCP quickstart."
}

Ejemplo de carga útil de informe de error:

{
  "category": "bug_report",
  "message": "The tool rejected a valid POI filter after resolving the POI successfully.",
  "related_tool_name": "search_tours",
  "related_request_id": "req-123",
  "expected_behavior": "The search should accept the resolved POI and return matching experiences.",
  "actual_behavior": "The tool returned an invalid argument error.",
  "reproduction_summary": "Resolve a POI with search_pois, then pass the returned POI id into search_tours."
}

Referencia de endpoints de API

Método	Ruta	Propósito
`POST`	`/v1/search/tours`	Busca experiencias de destino, incluidos tours, entradas a atracciones, autobuses hop-on hop-off, entradas deportivas, entradas para eventos y otras actividades.
`GET`	`/v1/tours/{tour_id}`	Obtiene el detalle de una experiencia devuelta por `/v1/search/tours`.
`POST`	`/v1/search/pois`	Resuelve puntos de interés antes de filtrar la búsqueda.
`GET`	`/v1/pois/{poi_id}`	Obtiene un registro POI canónico por ID.
`GET`	`/v1/livez`	Procesa la comprobación de actividad.
`GET`	`/v1/readyz`	Comprobación local de preparación para la configuración requerida y la inicialización del servicio.
`GET`	`/v1/health`	Estado de salud diagnóstico más rico orientado a humanos usando actividad reciente del backend de búsqueda.

Ejemplos por tipo de experiencia

Ejemplos curl listos para ejecutar:

Descubrimiento de entradas para la Torre Eiffel
Descubrimiento de autobuses hop-on hop-off
Descubrimiento de entradas de fútbol
Descubrimiento de tours guiados clásicos
examples/api/curl/eiffel-tower-ticket-search.sh
examples/api/curl/hop-on-hop-off-search.sh
examples/api/curl/football-ticket-search.sh
examples/api/curl/guided-tour-search.sh
examples/api/curl/poi-search.sh

Ejemplos generales de clientes de API:

Preguntas frecuentes

¿Por qué el endpoint se llama tours si también devuelve entradas?

Las herramientas y endpoints públicos con nombre tour cubren experiencias de destino de forma más amplia, por lo que search_tours y POST /v1/search/tours pueden devolver tours guiados, entradas a atracciones, autobuses hop-on hop-off, entradas deportivas, entradas para eventos y otras actividades reservables.

Acceso, límites y soporte

El MCP y la API alojados son públicos y están destinados a la evaluación e integración por parte de desarrolladores.
Pueden aplicarse límites de uso justo y protección contra abuso.
Los clientes MCP pueden usar submit_feedback para problemas en tiempo de ejecución, comportamiento confuso, capacidades faltantes y sugerencias de mejora.
Abre un issue de GitHub para ejemplos rotos, documentación desactualizada o brechas de integración.

Mantenimiento

Este repositorio es un espejo público curado de documentación, ejemplos y artefactos de API exportados. El código fuente en tiempo de ejecución permanece interno y los artefactos públicos se actualizan desde la fuente privada de verdad.