TicketSea

Plan a visit to an event

prepare_event_visit

Read-onlyIdempotent

Use this when the user is planning a trip to one specific event and wants tickets together with a place to stay, parking or directions. One call returns the latest event details, every seller link for the event, the venue address, suggested stay dates and search links for hotels, parking, directions and things to do. Planning only; nothing is booked or saved. Stale or inactive events have no planning links.

Input Schema

Name	Required	Description	Default
`slug`	Yes	Exact event slug from a search result; not an artist or venue slug.

Output Schema

Name	Required	Description	Default
`url`	Yes
`city`	Yes
`date`	Yes
`name`	Yes
`slug`	Yes
`links`	Yes
`stale`	Yes
`venue`	Yes
`visit`	Yes
`notice`	Yes
`onSale`	Yes
`region`	Yes
`status`	Yes
`country`	Yes
`pricing`	No
`tickets`	No
`dateTime`	Yes
`timezone`	Yes
`localTime`	Yes
`otherSellers`	No
`publicSaleState`	Yes
`handoffAvailable`	Yes
`listingUpdatedAt`	Yes
`inventoryVerified`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed29 schema fields changedOct 22, 2026

removedOutput schema / properties / date / description

Removed value: -"Venue-local date; may be blank if unknown."

removedOutput schema / properties / dateTime / description

Removed value: -"Provider absolute start timestamp when supplied."

removedOutput schema / properties / handoffAvailable / description

Removed value: -"At least one exact-event seller link exists; this does not mean tickets remain."

removedOutput schema / properties / links / items / properties

Removed value: -{
-  "affiliate": {
-    "type": "boolean"
-  },
-  "destination": {
-    "description": "REST only: the seller page the link leads to, for display; may be blank. Link people to url.",
-    "type": "string"
-  },
-  "inventoryVerified": {
-    "const": false,
-    "type": "boolean"
-  },
-  "official": {
-    "type": "boolean"
-  },
-  "purpose": {
-    "const": "external_event_checkout",
-    "type": "string"
-  },
-  "seller": {
-    "type": "string"
-  },
-  "type": {
-    "type": "string"
-  },
-  "url": {
-    "description": "Link to show the person: opens the seller's page for this event through ticketsea.com/go/.",
-    "format": "uri",
-    "type": "string"
-  }
-}

removedOutput schema / properties / links / items / required

Removed value: -[
-  "url",
-  "seller",
-  "type",
-  "official",
-  "affiliate",
-  "purpose",
-  "inventoryVerified"
-]

removedOutput schema / properties / listingUpdatedAt / description

Removed value: -"Original listing retrieval timestamp; not a stock check."

removedOutput schema / properties / localTime / description

Removed value: -"Venue-local time; may be blank if unknown."

removedOutput schema / properties / otherSellers / description

Removed value: -"Other sellers the event's TicketSea page offers, such as resale marketplaces and box offices, in page order. detail is the page's own description of the link; some are a search for the event rather than a page for this exact performance. Empty for stale, canceled and past events."

removedOutput schema / properties / otherSellers / items / properties

Removed value: -{
-  "affiliate": {
-    "type": "boolean"
-  },
-  "detail": {
-    "type": "string"
-  },
-  "inventoryVerified": {
-    "const": false,
-    "type": "boolean"
-  },
-  "seller": {
-    "type": "string"
-  },
-  "url": {
-    "format": "uri",
-    "type": "string"
-  }
-}

removedOutput schema / properties / otherSellers / items / required

Removed value: -[
-  "url",
-  "seller",
-  "detail",
-  "affiliate",
-  "inventoryVerified"
-]

removedOutput schema / properties / pricing / description

Removed value: -"Informational published ranges, not current available offers. Prices may change moment to moment and are not guaranteed. Fees and taxes may be additional. When ranges is empty, omit the price line. Never combine primary/resale sellers or currencies."

removedOutput schema / properties / pricing / properties / inventoryVerified / const
```
Removed value: -false
```

removedOutput schema / properties / pricing / properties / ranges / items / properties

Removed value: -{
-  "checkedAt": {
-    "type": "string"
-  },
-  "currency": {
-    "type": "string"
-  },
-  "feeInclusion": {
-    "const": "unknown",
-    "type": "string"
-  },
-  "label": {
-    "type": "string"
-  },
-  "maxMinor": {
-    "minimum": 1,
-    "type": "integer"
-  },
-  "minMinor": {
-    "minimum": 1,
-    "type": "integer"
-  },
-  "minorUnit": {
-    "maximum": 3,
-    "minimum": 0,
-    "type": "integer"
-  },
-  "provider": {
-    "type": "string"
-  },
-  "sourceType": {
-    "type": "string"
-  },
-  "validUntil": {
-    "description": "Expiry in Unix milliseconds. Discard at this time even if cached.",
-    "type": "integer"
-  }
-}

removedOutput schema / properties / pricing / properties / ranges / items / required

Removed value: -[
-  "provider",
-  "sourceType",
-  "currency",
-  "minMinor",
-  "maxMinor",
-  "minorUnit",
-  "checkedAt",
-  "validUntil",
-  "label",
-  "feeInclusion"
-]

removedOutput schema / properties / publicSaleState / description

Removed value: -"Schedule state, not inventory. registration means restricted registration access, not an open general sale."

removedOutput schema / properties / tickets / description

Removed value: -"The first exact-event seller link for this performance, present only for a fresh, upcoming listing with a known seller page. The link opens the seller's page for this event through ticketsea.com/go/. It is not an availability check, and the event can have other sellers."

removedOutput schema / properties / tickets / properties / affiliate / description
```
Removed value: -"TicketSea may earn a commission from this seller."
```
removedOutput schema / properties / tickets / properties / type / description
```
Removed value: -"primary or resale."
```
removedOutput schema / properties / tickets / properties / url / format
```
Removed value: -"uri"
```

removedOutput schema / properties / timezone / description

Removed value: -"Provider timezone; may be blank if unknown. Do not invent one."

removedOutput schema / properties / url / format
```
Removed value: -"uri"
```
removedOutput schema / properties / visit / properties / bookingCreated / const
```
Removed value: -false
```

removedOutput schema / properties / visit / properties / planningAvailable / description

Removed value: -"The event snapshot is fresh and upcoming; this does not confirm availability."

removedOutput schema / properties / visit / properties / suggestedStay / properties

Removed value: -{
-  "checkIn": {
-    "format": "date",
-    "type": "string"
-  },
-  "checkOut": {
-    "format": "date",
-    "type": "string"
-  }
-}

removedOutput schema / properties / visit / properties / suggestedStay / required
```
Removed value: -[
-  "checkIn",
-  "checkOut"
-]
```

removedOutput schema / properties / visit / properties / travelLinks / items / properties

Removed value: -{
-  "affiliate": {
-    "type": "boolean"
-  },
-  "detail": {
-    "type": "string"
-  },
-  "title": {
-    "type": "string"
-  },
-  "url": {
-    "format": "uri",
-    "type": "string"
-  }
-}

removedOutput schema / properties / visit / properties / travelLinks / items / required
```
Removed value: -[
-  "title",
-  "detail",
-  "url",
-  "affiliate"
-]
```

removedOutput schema / properties / visit / properties / venueAddress / properties

Removed value: -{
-  "city": {
-    "type": "string"
-  },
-  "country": {
-    "type": "string"
-  },
-  "name": {
-    "type": "string"
-  },
-  "postalCode": {
-    "type": "string"
-  },
-  "region": {
-    "type": "string"
-  },
-  "street": {
-    "type": "string"
-  }
-}

removedOutput schema / properties / visit / properties / venueAddress / required

Removed value: -[
-  "name",
-  "street",
-  "city",
-  "region",
-  "postalCode",
-  "country"
-]

Changed2 schema fields changedOct 12, 2026

changedInput schema / properties / slug / description

Previous value: -"Exact event slug returned by search_events; not an artist or venue slug."New value: +"Exact event slug from a search result; not an artist or venue slug."

changedOutput schema / properties / tickets / description

Previous value: -"The first exact-event seller link for this performance, present only for a fresh, upcoming listing with a known seller page. The link opens the seller's page for this event through ticketsea.com/go/. It is not an availability check; get_ticket_links lists every seller."New value: +"The first exact-event seller link for this performance, present only for a fresh, upcoming listing with a known seller page. The link opens the seller's page for this event through ticketsea.com/go/. It is not an availability check, and the event can have other sellers."

First observedOct 12, 2026

TDQS

A4.3/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, non-destructive and closed-world, so the safety burden is light. The description still adds real context beyond them: what one call aggregates, 'nothing is booked or saved', and the edge case that 'stale or inactive events have no planning links' — the last is genuinely useful pre-call knowledge.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences: trigger first, then return contents, then constraints. Every sentence carries information an agent needs and nothing is redundant.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so the description is free to summarize rather than explain returns, and it does. Combined with annotation coverage and the stale-event caveat, an agent has everything needed to decide and invoke correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There is a single required parameter and schema description coverage is 100%: the schema itself says 'Exact event slug from a search result; not an artist or venue slug.' The description adds nothing about the slug, so baseline 3 applies since the schema carries the full load.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('planning a trip to one specific event') and enumerates the bundled artifacts returned (tickets, stay, parking, directions). This clearly separates it from single-purpose siblings like get_event, get_ticket_links and get_ticket_prices.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Opens with an explicit trigger condition ('Use this when the user is planning a trip to one specific event...'), which gives an agent a clear selection rule. It stops short of naming alternatives or when-not-to-use cases (e.g., browsing multiple events, which would push toward search_events), so it is strong but not fully routing-complete.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All TicketSea tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?