TicketSea

Get ticket links for an event

get_ticket_links

Read-onlyIdempotent

Use this when the user wants to buy or compare tickets for one specific event. Returns the exact-event seller links from a fresh, upcoming snapshot (links), each labeled primary or resale, official and affiliate, and the other sellers the event's TicketSea page offers (otherSellers), such as resale marketplaces, each with a description of what the link is; some are a search for the event rather than its own page. Does not check stock or reserve tickets. Canceled, past and stale events return no 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
`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.

Changed21 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"
```

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.1/5.0

Behavior5/5

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

Beyond the readOnly/idempotent annotations, it discloses the snapshot is fresh and upcoming-only, that dead events return empty, that it performs no stock check or reservation, and that some otherSellers entries are event searches rather than the event's own page — exactly the caveats an agent needs before presenting links.

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

Conciseness4/5

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

Front-loaded with the selection trigger, then the return shape, then the exclusions. Dense but the middle sentence is long and packs several qualifiers, slightly taxing to parse, though no sentence is expendable.

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?

With annotations covering safety and an output schema covering the return structure, the description only needs to cover selection and edge behavior — and it does, including empty-result conditions and the nature of otherSellers entries.

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?

Schema coverage is 100% and the slug property already states 'Exact event slug from a search result; not an artist or venue slug', including a pattern. The description adds no further slug format or sourcing detail, so the baseline 3 applies.

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

Purpose4/5

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

States a specific verb+resource (returns ticket seller links for one exact event) and enumerates the payload shape: links vs otherSellers, primary/resale, official/affiliate. It does not name the closest sibling (get_ticket_prices), so the agent must infer the boundary from 'Does not check stock or reserve tickets' rather than an explicit contrast.

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?

'Use this when the user wants to buy or compare tickets for one specific event' is a clear positive trigger, and 'Does not check stock or reserve tickets' plus 'canceled, past and stale events return no links' rules out the purchase-flow and dead-event cases. No alternative tool is named, so routing to get_ticket_prices or get_event is left to inference.

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?