# Search or browse trip templates

> The list_trip_templates MCP tool: search or browse trip templates.

`list_trip_templates` · read-only

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

## What the model reads

Searches or browses the agency's trip templates (Catalog → Trips). Each is a design (a route) plus the blocks a trip made from it starts with; create_trip with `templateId` makes one. Filter by `tag`. With `q`, returns one ranked page; without it, the most recently changed first, paged by `cursor`.

Permissions: catalog:read.

## Input

| Field | Type | Required | Description |
|---|---|---|---|
| `q` | string |  | max 200 chars |
| `tag` | string |  | max 60 chars |
| `limit` | integer |  | 1–100, default 25 |
| `cursor` | string |  | max 500 chars |
| `updatedSince` | datetime |  |  |

## Input schema (JSON)

```json
{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "tag": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "updatedSince": {
      "type": "string",
      "format": "date-time"
    }
  },
  "additionalProperties": false
}
```