MCP tools reference

GetYourGuide MCP tools

11 tools for GetYourGuide on the Cotlet MCP server. Your agent picks them from tools/list.

MCP server
https://cotlet.dev/mcp/v1
Connects with
Your own GetYourGuide Supplier Portal account
Integration page
GetYourGuide
GetYourGuide Endpoints
Endpoint Access Description
getyourguide_list_bookings read Bookings for your products, by activity date, with travelers, option and status.
getyourguide_get_booking read One booking: reference, option, date and time, participants by category, price and lead traveler.
getyourguide_list_products read Your products with their options, status and price categories.
getyourguide_get_availability read Start times and free spots of an option for the dates you ask for.
getyourguide_list_messages read Traveler conversations from Messages, each with its booking reference.
getyourguide_list_reviews read Reviews of your products with rating, text, date and your reply, if any.
getyourguide_get_performance read The figures shown in the Supplier Portal performance view, for a date range.
getyourguide_update_availability write Set free spots for start times of an option on one date, or close them with 0.
getyourguide_update_pricing write Change the retail price per category of an option, from a date on.
getyourguide_reply_to_message write Send a reply to a traveler in a Messages conversation.
getyourguide_reply_to_review write Post your public reply under a review of your product.

List bookings

read

MCP tool getyourguide_list_bookings

Returns bookings whose activity date falls in the range, ordered by date and start time. Cancelled bookings are left out unless status is cancelled or all. Results come in pages; pass next_cursor as cursor for the next one.

Parameters

Parameters: list_bookings
NameTypeDescription
from date First activity date. Default: today.
to date Last activity date. Default: 7 days from today.
product_id string Only bookings for this product.
status enum confirmed, cancelled or all. Default: confirmed.
cursor string Next page cursor from the previous call.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "getyourguide_list_bookings",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "bookings": [
      {
        "booking_reference": "GYGZ4K2M9T1X",
        "product_id": "88213",
        "option_id": "412087",
        "date": "2026-10-18",
        "time": "17:30",
        "status": "confirmed",
        "travelers": {
          "adult": 2,
          "child": 1
        }
      },
      {
        "booking_reference": "GYGB7Q5N3R8D",
        "product_id": "88213",
        "option_id": "412087",
        "date": "2026-10-18",
        "time": "18:30",
        "status": "confirmed",
        "travelers": {
          "adult": 4,
          "child": 0
        }
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

Get booking

read

MCP tool getyourguide_get_booking

Returns one booking with the option, date, start time, travelers per category, the price and the lead traveler's name and language. The reference is on the booking in list_bookings.

Parameters

Parameters: get_booking
NameTypeDescription
booking_reference required string GetYourGuide booking reference from list_bookings, e.g. GYGZ4K2M9T1X.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "getyourguide_get_booking",
    "arguments": {
      "booking_reference": "booking reference"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "booking_reference": "GYGZ4K2M9T1X",
    "product": "Sunset Harbor Walking Tour",
    "option_id": "412087",
    "date": "2026-10-18",
    "time": "17:30",
    "status": "confirmed",
    "travelers": {
      "adult": 2,
      "child": 1
    },
    "price": {
      "amount": 110,
      "currency": "EUR"
    },
    "lead_traveler": {
      "name": "Sam Rivera",
      "language": "en"
    }
  },
  "isError": false
}

List products

read

MCP tool getyourguide_list_products

Returns your products and, under each, its options with the option ID that the availability and pricing tools need. Each option lists its price categories and current retail prices. Inactive products are left out unless you ask.

Parameters

Parameters: list_products
NameTypeDescription
status enum active, inactive or all. Default: active.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "getyourguide_list_products",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "products": [
      {
        "product_id": "88213",
        "title": "Sunset Harbor Walking Tour",
        "status": "active",
        "options": [
          {
            "option_id": "412087",
            "name": "English, small group",
            "price_categories": {
              "adult": 40,
              "child": 20
            },
            "currency": "EUR"
          }
        ]
      }
    ]
  },
  "isError": false
}

Get availability

read

MCP tool getyourguide_get_availability

Returns each date in the range with its start times, free spots and how many are booked. Use it before closing a slot to see who is already booked.

Parameters

Parameters: get_availability
NameTypeDescription
option_id required string Option ID from list_products.
from required date First date.
to required date Last date.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "getyourguide_get_availability",
    "arguments": {
      "option_id": "option_8c41d2",
      "from": "2026-10-01",
      "to": "2026-10-01"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "option_id": "412087",
    "days": [
      {
        "date": "2026-10-18",
        "slots": [
          {
            "time": "17:30",
            "vacancies": 8,
            "booked": 3
          },
          {
            "time": "18:30",
            "vacancies": 12,
            "booked": 0
          }
        ]
      }
    ]
  },
  "isError": false
}

List messages

read

MCP tool getyourguide_list_messages

Returns your Messages conversations, most recent first, with the traveler, the booking reference, the unread count and the last message. Set unread_only to see only what needs an answer.

Parameters

Parameters: list_messages
NameTypeDescription
unread_only boolean Only conversations with unread messages. Default: false.
limit integer 1 to 50. Default: 20.
cursor string Next page cursor from the previous call.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "getyourguide_list_messages",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversations": [
      {
        "conversation_id": "cv_7a21",
        "booking_reference": "GYGZ4K2M9T1X",
        "traveler": "Sam Rivera",
        "unread": 1,
        "last_message": "Where exactly do we meet?",
        "updated_at": "2026-10-16T08:12:00Z"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

List reviews

read

MCP tool getyourguide_list_reviews

Returns reviews of your products, newest first, with rating, text, date and your reply when there is one. Filter to unanswered reviews to build a reply queue.

Parameters

Parameters: list_reviews
NameTypeDescription
product_id string Only reviews of this product.
since date Only reviews on or after this date.
unanswered_only boolean Skip reviews you already replied to.
cursor string Next page cursor from the previous call.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "getyourguide_list_reviews",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "reviews": [
      {
        "review_id": "rv_30482",
        "product_id": "88213",
        "rating": 5,
        "text": "Great guide, loved the harbor stories.",
        "date": "2026-10-12",
        "reply": null
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

Get performance

read

MCP tool getyourguide_get_performance

Returns the figures shown in the Supplier Portal performance view for the range. Without product_id every product is included.

Parameters

Parameters: get_performance
NameTypeDescription
from required date Start of the period.
to required date End of the period.
product_id string Only this product. Default: all products.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "getyourguide_get_performance",
    "arguments": {
      "from": "2026-10-01",
      "to": "2026-10-01"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "from": "2026-10-05",
    "to": "2026-10-11",
    "products": [
      {
        "product_id": "88213",
        "title": "Sunset Harbor Walking Tour",
        "figures": {
          "bookings": 37
        }
      }
    ]
  },
  "isError": false
}

Update availability

write

MCP tool getyourguide_update_availability

Sets free spots per start time for one option and one date; 0 closes the slot. Existing bookings are not touched. It reaches no one and one call reopens the slot, so it runs without asking for your OK. Returns the slots as the app now shows them.

Parameters

Parameters: update_availability
NameTypeDescription
option_id required string Option ID from list_products.
date required date Activity date.
slots required object Map of start time (HH:MM) to free spots, e.g. {"17:30": 0}.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "getyourguide_update_availability",
    "arguments": {
      "option_id": "412087",
      "date": "2026-10-18",
      "slots": {
        "17:30": 0,
        "18:30": 0
      }
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "option_id": "412087",
    "date": "2026-10-18",
    "slots": [
      {
        "time": "17:30",
        "vacancies": 0,
        "status": "closed"
      },
      {
        "time": "18:30",
        "vacancies": 0,
        "status": "closed"
      }
    ],
    "bookings_on_date": 3
  },
  "isError": false
}

Update pricing

write Confirm

MCP tool getyourguide_update_pricing

Sets the retail price per price category of one option from a date on. Travelers see the new price on the activity page, so a wrong price costs money. A booking system that pushes rates can overwrite it. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: update_pricing
NameTypeDescription
option_id required string Option ID from list_products.
prices required object Map of price category (adult, child) to price in your currency.
valid_from date First date with the new price. Default: today.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "getyourguide_update_pricing",
    "arguments": {
      "option_id": "412087",
      "prices": {
        "adult": 43,
        "child": 22
      },
      "valid_from": "2027-04-01"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "option_id": "412087",
    "valid_from": "2026-11-01",
    "currency": "EUR",
    "prices": {
      "adult": 44,
      "child": 22
    },
    "previous": {
      "adult": 40,
      "child": 20
    }
  },
  "isError": false
}

Reply to message

write Confirm

MCP tool getyourguide_reply_to_message

Sends your reply to the traveler in the conversation; it appears in their GetYourGuide app. Messages cannot be recalled. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: reply_to_message
NameTypeDescription
conversation_id required string Conversation ID from list_messages.
body required string Reply text.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "getyourguide_reply_to_message",
    "arguments": {
      "conversation_id": "cv_7a21",
      "body": "Hi Sam, we meet at the fountain on Harbor Square 10 minutes before 17:30. Kids are welcome on the whole route."
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversation_id": "cv_7a21",
    "status": "sent",
    "sent_at": "2026-10-16T08:40:00Z"
  },
  "isError": false
}

Reply to review

write Confirm

MCP tool getyourguide_reply_to_review

Posts your reply under one review. It is public on the activity page and attached to your provider name. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: reply_to_review
NameTypeDescription
review_id required string Review ID from list_reviews.
body required string Reply text, shown publicly on the activity page.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "getyourguide_reply_to_review",
    "arguments": {
      "review_id": "rv_30482",
      "body": "Thank you, Maria! We are so glad the harbor stories and the sunset from the old pier made your evening. Hope to see you again."
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "review_id": "rv_30482",
    "status": "published",
    "replied_at": "2026-10-16T09:05:00Z"
  },
  "isError": false
}