TicketLens Experiences MCP

Official remote MCP server and REST API for discovering tours, tickets, attractions, and activities with TicketLens.

TicketLens provides a public hosted remote MCP server at https://mcp.ticketlens.com/ and a versioned REST API at https://api.ticketlens.com/v1 for AI travel planners, destination discovery flows, and custom integrations. The same hosted inventory covers guided tours, attraction tickets, hop-on hop-off buses, sports tickets, and other event tickets.

Main website: www.ticketlens.com/en

What TicketLens is

• The official TicketLens remote MCP + REST surface for destination experiences.
• A developer-facing search surface for destination experiences.
• Available as both MCP and REST on the same hosted inventory.
• Designed for AI assistants, travel planning tools, destination discovery flows, and custom integrations.

Why it fits AI agents

• Hosted remote MCP server with a public URL for quick connector setup and evaluation.
• Public REST fallback on the same inventory for clients that are not using MCP yet.
• Broad destination-experiences coverage across tours, attraction tickets, hop-on hop-off buses, sports tickets, and events.

What the current API/MCP returns

The public tour-named tools and endpoints return a broader destination-experiences catalog, not just guided tours.

search_tours and POST /v1/search/tours can return:

• guided tours
• attraction and museum tickets
• hop-on hop-off bus products
• sports tickets
• event and admission products

Current public MCP tools:

• search_tours
• search_pois
• get_tour
• health_check
• submit_feedback

Current public REST endpoints:

• 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

Hosted MCP quickstart

Hosted MCP URLs:

• Base URL: https://mcp.ticketlens.com/
• Canonical server card: https://mcp.ticketlens.com/.well-known/mcp/server-card.json
• Compatibility alias: https://mcp.ticketlens.com/.well-known/mcp.json

Codex

Add the hosted server from the CLI:

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

If you manage Codex MCP servers through config files, start from examples/mcp/codex-config.toml.

Cursor

Add the hosted MCP URL to your Cursor MCP config. A ready-to-copy example is in examples/mcp/cursor-mcp.json.

Claude

Claude remote MCP connectors are added from the UI, not through claude_desktop_config.json. Use the hosted URL https://mcp.ticketlens.com/ in Settings > Connectors, or follow the short guide in examples/mcp/claude-connector.md.

OpenClaw

OpenClaw users can integrate TicketLens quickly by adding a workspace skill that calls the public TicketLens REST API. Start from examples/openclaw/skills/ticketlens-api/SKILL.md.

See examples/openclaw/README.md for the recommended API path and notes about the more advanced MCP route.

Hosted API quickstart

Hosted API URLs:

• Base URL: https://api.ticketlens.com/v1
• OpenAPI JSON: https://api.ticketlens.com/v1/openapi.json
• Swagger UI: https://api.ticketlens.com/v1/docs
• ReDoc: https://api.ticketlens.com/v1/redoc
• Committed artifact: openapi/ticketlens-tour-search-api.v1.json

The hosted examples below use the public HTTPS endpoints directly and do not require extra headers in the current public setup.

Step 1: resolve the Eiffel Tower to a canonical TicketLens POI:

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

Step 2: search for Eiffel Tower tickets using the POI from step 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
  }'

For destination-specific ticketing flows like the Eiffel Tower, this is useful for agents because TicketLens can surface inventory from the official Eiffel Tower site, including hard-to-find high-season availability when it exists, alongside second-market ticket options in the same search flow.

To filter for travel dates, add a dates object with ISO YYYY-MM-DD values:

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
  }'

Date filtering notes:

• Use dates.from_date for a single-day search.
• Use both dates.from_date and dates.to_date for a date range.
• Dates must use ISO YYYY-MM-DD.
• dates.flexible_days exists in the schema but is not implemented in the current public version.

MCP tool reference

Tool	What it does
search_tours	Search destination experiences across tours, attraction tickets, hop-on hop-off buses, sports tickets, event tickets, and other activities.
search_pois	Resolve POIs and aliases before calling search_tours.
get_tour	Fetch detail for an experience returned by search_tours.
health_check	Return a passive service health snapshot.
submit_feedback	Share structured MCP feedback when behavior is broken, unclear, missing capabilities, or worth improving.

MCP feedback

submit_feedback is available on the hosted MCP server only. It is not part of the public REST API or the OpenAPI document.

Use submit_feedback when an agent encounters:

• broken behavior
• confusing or incomplete results
• missing capabilities
• documentation gaps
• clear product or tool improvements

Supported fields:

• required: category, message
• optional: suggestion, related_tool_name, related_request_id, expected_behavior, actual_behavior, reproduction_summary

Supported categories:

• bug_report
• improvement
• missing_capability
• documentation_gap
• other

Example improvement suggestion:

{
  "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."
}

Example documentation-gap report:

{
  "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."
}

Example bug report payload:

{
  "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."
}

API endpoint reference

Method	Path	Purpose
POST	/v1/search/tours	Search destination experiences, including tours, attraction tickets, hop-on hop-off buses, sports tickets, event tickets, and other activities.
GET	/v1/tours/{tour_id}	Fetch detail for an experience returned by /v1/search/tours.
POST	/v1/search/pois	Resolve points of interest before filtering search.
GET	/v1/pois/{poi_id}	Fetch a canonical POI record by ID.
GET	/v1/livez	Process liveness check.
GET	/v1/readyz	Local readiness check for required configuration and service initialization.
GET	/v1/health	Richer human-facing diagnostic health using recent search backend activity.

Examples by experience type

Ready-to-run curl examples:

• Eiffel Tower ticket discovery

• hop-on hop-off bus discovery

• football ticket discovery

• classic guided tour discovery

• 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

General API client examples:

• examples/api/javascript/search_experiences.mjs
• examples/api/python/search_experiences.py

FAQ

Why is the endpoint called tours if it returns tickets too?

The public tour-named tools and endpoints cover destination experiences more broadly, so search_tours and POST /v1/search/tours can return guided tours, attraction tickets, hop-on hop-off buses, sports tickets, event tickets, and other bookable activities.

Access, limits, and support

• The hosted MCP and API are public and intended for developer evaluation and integration.
• Fair-use and abuse-protection limits may apply.
• MCP clients can use submit_feedback for runtime issues, confusing behavior, missing capabilities, and improvement suggestions.
• Open a GitHub issue for broken examples, stale docs, or integration gaps.

Maintenance

This repository is a curated public mirror of documentation, examples, and exported API artifacts. Runtime source remains internal and public-facing artifacts are refreshed from the private source of truth.