List routes

The list_routes MCP tool: list routes.

list_routes · read-only

REST: GET /v1/catalog/routes

#What the model reads

Lists the agency's routes (Catalog → Routes): ready-made days through catalog places. Filter by words in the title (q), tipo, duracion, ritmo, structured, a destination or zone (destinoId) or a place it stops at (throughPlaceId). Most recently changed first; pass nextCursor back as cursor for more. get_route returns one with its stops. To plan a day FROM routes, suggest_routes ranks them for that day.

Permissions: catalog:read.

#Input

#Input schema (JSON)

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "tipo": {
      "type": "string",
      "enum": [
        "dia_entero",
        "medio_dia",
        "excursion",
        "tematica",
        "con_experiencias",
        "llegada"
      ]
    },
    "duracion": {
      "type": "string",
      "enum": [
        "medio_dia",
        "dia_entero",
        "dia_entero_largo"
      ]
    },
    "ritmo": {
      "type": "string",
      "enum": [
        "relajado",
        "equilibrado",
        "intenso"
      ]
    },
    "structured": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "string",
          "enum": [
            "true",
            "false"
          ]
        }
      ]
    },
    "destinoId": {
      "type": "string",
      "format": "uuid"
    },
    "throughPlaceId": {
      "type": "string",
      "format": "uuid"
    },
    "updatedSince": {
      "type": "string",
      "format": "date-time"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "additionalProperties": false
}