List trips

The list_trips MCP tool: list trips.

list_trips · read-only

REST: GET /v1/trips

#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

#Input schema (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
}