# List trips

> The list_trips MCP tool: list trips.

`list_trips` · read-only

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

## What the model reads

Lists the agency's live trips, most recently changed first (archived ones: list_archived_trips). Filter by `q` (text in the title), `publication`, `commercialState`, `ownerId`, `updatedSince` and up to 5 `metadata` key/value pairs, which must all match. Pass `nextCursor` back as `cursor` for the next page.

Permissions: trips:read.

## Input

| Field | Type | Required | Description |
|---|---|---|---|
| `limit` | integer |  | 1–100, default 25 |
| `cursor` | string |  | max 500 chars |
| `sort` | "updatedAt" \| "-updatedAt" \| "createdAt" \| "-createdAt" |  | default "-updatedAt" |
| `updatedSince` | datetime |  |  |
| `q` | string |  | max 200 chars |
| `publication` | "draft" \| "published" |  |  |
| `commercialState` | "nueva" \| "propuesta_enviada" \| "aceptada" \| "reserva_provisional" \| "reservada" \| "rechazada" \| "cancelada" |  |  |
| `ownerId` | uuid |  |  |
| `metadata` | object |  |  |

## Input schema (JSON)

```json
{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "sort": {
      "type": "string",
      "enum": [
        "updatedAt",
        "-updatedAt",
        "createdAt",
        "-createdAt"
      ],
      "default": "-updatedAt"
    },
    "updatedSince": {
      "type": "string",
      "format": "date-time"
    },
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "publication": {
      "type": "string",
      "enum": [
        "draft",
        "published"
      ]
    },
    "commercialState": {
      "type": "string",
      "enum": [
        "nueva",
        "propuesta_enviada",
        "aceptada",
        "reserva_provisional",
        "reservada",
        "rechazada",
        "cancelada"
      ]
    },
    "ownerId": {
      "type": "string",
      "format": "uuid"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {
        "type": "string",
        "maxLength": 500
      },
      "propertyNames": {
        "pattern": "^[A-Za-z0-9_.-]{1,40}$"
      }
    }
  },
  "additionalProperties": false
}
```