Create a trip
The create_trip MCP tool: create a trip.
create_trip · writes
What the model reads
Creates a trip owned by you: blank, from a trip template (templateId, which brings the template's design and blocks), or from a design (a route: origin, stops with nights, transfers), which builds one itinerary day per trip day and derives endDate. A design needs startDate. travelers, ownerId, presentation, profile and metadata can be set in the same call.
Permissions: trips:write.
Set dryRun: true to preview the effect without writing anything.
Undo: the result names a change id; undo_change reverts it.
Input
| Field | Type | Required | Description |
|---|---|---|---|
title |
string | yes | |
startDate |
string | null | ||
endDate |
string | null | ||
templateId |
uuid | ||
design |
object | ||
design.version |
1 | yes | |
design.originCity |
string | yes | |
design.stops |
object[] | yes | max 60 items |
design.stops[].id |
string | yes | |
design.stops[].city |
string | yes | |
design.stops[].nights |
integer | yes | 0–365 |
design.stops[].transferBefore |
object | null | yes | |
design.stops[].escala |
boolean | default false | |
design.stops[].place |
object | default {"placeId":"","lat":null,"lng":null,"formattedAddress":""} | |
design.returnCity |
string | null | yes | |
design.returnTransfer |
object | null | yes | |
design.returnTransfer.id |
string | yes | |
design.returnTransfer.departDate |
string | null | yes | |
design.returnTransfer.arriveDate |
string | null | yes | |
design.returnTransfer.days |
integer | 0–30, default 0 | |
design.returnTransfer.departTime |
string | default "" | |
design.returnTransfer.arriveTime |
string | default "" | |
design.returnTransfer.flight |
object | default {"flightNo":"","airline":"","fromAirport":"","toAirport":"","source":"","fetchedAt":"","scheduleValidFor":""} | |
design.originPlace |
object | default {"placeId":"","lat":null,"lng":null,"formattedAddress":""} | |
design.originPlace.placeId |
string | default "" | |
design.originPlace.lat |
number | null | default null | |
design.originPlace.lng |
number | null | default null | |
design.originPlace.formattedAddress |
string | default "" | |
design.returnPlace |
object | default {"placeId":"","lat":null,"lng":null,"formattedAddress":""} | |
design.returnPlace.placeId |
string | default "" | |
design.returnPlace.lat |
number | null | default null | |
design.returnPlace.lng |
number | null | default null | |
design.returnPlace.formattedAddress |
string | default "" | |
travelers |
integer | 1–40 | |
ownerId |
uuid | ||
presentation |
object | ||
presentation.logoUrl |
uri | null | ||
presentation.brandColor |
string | null | ||
presentation.fontFamily |
"inter" | "montserrat" | "poppins" | "lora" | "playfair" | "source-sans" | null | ||
presentation.headerMedia |
object | null | ||
presentation.headerMedia.type |
"image" | "video" | yes | |
presentation.headerMedia.url |
uri | yes | |
profile |
object | ||
profile.pace |
"relajado" | "equilibrado" | "intenso" | null | ||
profile.profiles |
"primera_vez" | "repetidor" | "familia_ninos" | "pareja" | "grupo" | "senior" | "movilidad_reducida" | "cultural" | "gastronomico" | "naturaleza" | "fotografia" | "otaku" | "compras" | "presupuesto_ajustado" | "premium"[] | ||
profile.mobility |
"normal" | "reducida" | ||
profile.avoid |
string[] | ||
profile.notes |
string | ||
metadata |
object | ||
dryRun |
boolean | Preview only: plan the change and return its effect without writing. |
Input schema (JSON)
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1
},
"startDate": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"endDate": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"templateId": {
"type": "string",
"format": "uuid"
},
"design": {
"type": "object",
"properties": {
"version": {
"type": "number",
"const": 1
},
"originCity": {
"type": "string"
},
"stops": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"city": {
"type": "string"
},
"nights": {
"type": "integer",
"minimum": 0,
"maximum": 365
},
"transferBefore": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"departDate": {
"type": [
"string",
"null"
]
},
"arriveDate": {
"type": [
"string",
"null"
]
},
"days": {
"type": "integer",
"minimum": 0,
"maximum": 30,
"default": 0
},
"departTime": {
"type": "string",
"default": ""
},
"arriveTime": {
"type": "string",
"default": ""
},
"flight": {
"type": "object",
"properties": {
"flightNo": {
"type": "string",
"default": ""
},
"airline": {
"type": "string",
"default": ""
},
"fromAirport": {
"type": "string",
"default": ""
},
"toAirport": {
"type": "string",
"default": ""
},
"source": {
"type": "string",
"default": ""
},
"fetchedAt": {
"type": "string",
"default": ""
},
"scheduleValidFor": {
"type": "string",
"default": ""
}
},
"additionalProperties": false,
"default": {
"flightNo": "",
"airline": "",
"fromAirport": "",
"toAirport": "",
"source": "",
"fetchedAt": "",
"scheduleValidFor": ""
}
}
},
"required": [
"id",
"departDate",
"arriveDate"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"escala": {
"type": "boolean",
"default": false
},
"place": {
"type": "object",
"properties": {
"placeId": {
"type": "string",
"default": ""
},
"lat": {
"type": [
"number",
"null"
],
"default": null
},
"lng": {
"type": [
"number",
"null"
],
"default": null
},
"formattedAddress": {
"type": "string",
"default": ""
}
},
"additionalProperties": false,
"default": {
"placeId": "",
"lat": null,
"lng": null,
"formattedAddress": ""
}
}
},
"required": [
"id",
"city",
"nights",
"transferBefore"
],
"additionalProperties": false
},
"maxItems": 60
},
"returnCity": {
"type": [
"string",
"null"
]
},
"returnTransfer": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"departDate": {
"type": [
"string",
"null"
]
},
"arriveDate": {
"type": [
"string",
"null"
]
},
"days": {
"type": "integer",
"minimum": 0,
"maximum": 30,
"default": 0
},
"departTime": {
"type": "string",
"default": ""
},
"arriveTime": {
"type": "string",
"default": ""
},
"flight": {
"type": "object",
"properties": {
"flightNo": {
"type": "string",
"default": ""
},
"airline": {
"type": "string",
"default": ""
},
"fromAirport": {
"type": "string",
"default": ""
},
"toAirport": {
"type": "string",
"default": ""
},
"source": {
"type": "string",
"default": ""
},
"fetchedAt": {
"type": "string",
"default": ""
},
"scheduleValidFor": {
"type": "string",
"default": ""
}
},
"additionalProperties": false,
"default": {
"flightNo": "",
"airline": "",
"fromAirport": "",
"toAirport": "",
"source": "",
"fetchedAt": "",
"scheduleValidFor": ""
}
}
},
"required": [
"id",
"departDate",
"arriveDate"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"originPlace": {
"type": "object",
"properties": {
"placeId": {
"type": "string",
"default": ""
},
"lat": {
"type": [
"number",
"null"
],
"default": null
},
"lng": {
"type": [
"number",
"null"
],
"default": null
},
"formattedAddress": {
"type": "string",
"default": ""
}
},
"additionalProperties": false,
"default": {
"placeId": "",
"lat": null,
"lng": null,
"formattedAddress": ""
}
},
"returnPlace": {
"type": "object",
"properties": {
"placeId": {
"type": "string",
"default": ""
},
"lat": {
"type": [
"number",
"null"
],
"default": null
},
"lng": {
"type": [
"number",
"null"
],
"default": null
},
"formattedAddress": {
"type": "string",
"default": ""
}
},
"additionalProperties": false,
"default": {
"placeId": "",
"lat": null,
"lng": null,
"formattedAddress": ""
}
}
},
"required": [
"version",
"originCity",
"stops",
"returnCity",
"returnTransfer"
],
"additionalProperties": false
},
"travelers": {
"type": "integer",
"minimum": 1,
"maximum": 40
},
"ownerId": {
"type": "string",
"format": "uuid"
},
"presentation": {
"type": "object",
"properties": {
"logoUrl": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"brandColor": {
"anyOf": [
{
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
{
"type": "null"
}
]
},
"fontFamily": {
"anyOf": [
{
"type": "string",
"enum": [
"inter",
"montserrat",
"poppins",
"lora",
"playfair",
"source-sans"
]
},
{
"type": "null"
}
]
},
"headerMedia": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"image",
"video"
]
},
"url": {
"type": "string",
"format": "uri"
}
},
"required": [
"type",
"url"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"profile": {
"type": "object",
"properties": {
"pace": {
"anyOf": [
{
"type": "string",
"enum": [
"relajado",
"equilibrado",
"intenso"
]
},
{
"type": "null"
}
]
},
"profiles": {
"type": "array",
"items": {
"type": "string",
"enum": [
"primera_vez",
"repetidor",
"familia_ninos",
"pareja",
"grupo",
"senior",
"movilidad_reducida",
"cultural",
"gastronomico",
"naturaleza",
"fotografia",
"otaku",
"compras",
"presupuesto_ajustado",
"premium"
]
}
},
"mobility": {
"type": "string",
"enum": [
"normal",
"reducida"
]
},
"avoid": {
"type": "array",
"items": {
"type": "string"
}
},
"notes": {
"type": "string"
}
},
"additionalProperties": false
},
"metadata": {
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"propertyNames": {
"pattern": "^[A-Za-z0-9_.-]{1,40}$"
}
},
"dryRun": {
"type": "boolean",
"description": "Preview only: plan the change and return its effect without writing."
}
},
"required": [
"title"
],
"additionalProperties": false
}