# List routes

> The list_routes MCP tool: list routes.

`list_routes` · read-only

[REST: `GET /v1/catalog/routes`](https://api.bymundi.com/docs/reference/catalog.routes.list.md)

## 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

| Field | Type | Required | Description |
|---|---|---|---|
| `q` | string |  | max 200 chars |
| `tipo` | "dia_entero" \| "medio_dia" \| "excursion" \| "tematica" \| "con_experiencias" \| "llegada" |  |  |
| `duracion` | "medio_dia" \| "dia_entero" \| "dia_entero_largo" |  |  |
| `ritmo` | "relajado" \| "equilibrado" \| "intenso" |  |  |
| `structured` | boolean \| "true" \| "false" |  |  |
| `destinoId` | uuid |  |  |
| `throughPlaceId` | uuid |  |  |
| `updatedSince` | datetime |  |  |
| `limit` | integer |  | 1–100, default 25 |
| `cursor` | string |  | max 500 chars |

## Input schema (JSON)

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