TicketSea

Find live events worldwide and link each seller's tickets. Some ticket links are affiliate links.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
100%
Integridad del esquema
81%
Calidad de los nombres
97%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~5,786Tokens (definiciones de herramientas)
~11.2 KBTamaño de respuesta típico
Impacto significativo en la atención (4.52% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

{
  "mcpServers": {
    "ticketsea": {
      "url": "https://ticketsea.com/mcp"
    }
  }
}

Puntos de conexión remotos

https://ticketsea.com/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (6)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢search_catalog(city, from, limit, mode, offset, ...)

Use this when the user names an artist, team, venue or event and you need the matching TicketSea records. Ranked search with prefixes, aliases and labeled one-edit corrections. Artist and venue matches are worldwide; an event radius needs a city ID or a full City, Region, Country label. Results are cached listings, not live inventory, and this is a search by name, not a dated list of events.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "city": {
      "description": "City the user asked about: a TicketSea city ID or an exact City, Region, Country label. Required for a distance radius.",
      "maxLength": 160,
      "type": "string"
    },
    "from": {
      "format": "date",
      "type": "string"
    },
    "limit": {
      "default": 5,
      "maximum": 24,
      "minimum": 1,
      "type": "integer"
    },
    "mode": {
      "default": "results",
      "description": "suggest is a bounded autocomplete preview without pagination; short prefixes match names and aliases. Use results for full context matching and pagination.",
      "enum": [
        "results",
        "suggest"
      ],
      "type": "string"
    },
    "offset": {
      "default": 0,
      "maximum": 1000,
      "minimum": 0,
      "type": "integer"
    },
    "query": {
      "description": "Artist, team, venue or event name, or the start of one.",
      "maxLength": 120,
      "type": "string"
    },
    "radius": {
      "default": "anywhere",
      "description": "Miles around city for event results.",
      "enum": [
        "75",
        "200",
        "anywhere"
      ],
      "type": "string"
    },
    "sale": {
      "description": "soon selects events whose public on-sale has not started yet. Give a specific query (an artist or a city name) with it; use radius 200 for local on-sales.",
      "enum": [
        "all",
        "soon"
      ],
      "type": "string"
    },
    "to": {
      "format": "date",
      "type": "string"
    },
    "type": {
      "description": "Limit results to one record type.",
      "enum": [
        "all",
        "artist",
        "venue",
        "event"
      ],
      "type": "string"
    }
  },
  "required": [],
  "additionalProperties": false
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "correctedQuery": {
      "type": [
        "string",
        "null"
      ]
    },
    "groups": {
      "items": {
        "properties": {
          "hasMore": {
            "type": "boolean"
          },
          "items": {
            "items": {
              "properties": {
                "checked": {
                  "description": "Original event retrieval Unix timestamp, not an inventory check",
                  "type": "integer"
                },
                "date": {
                  "type": "string"
                },
                "detail": {
                  "type": "string"
                },
                "image": {
                  "type": "string"
                },
                "kind": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "pricing": {
                  "description": "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.",
                  "properties": {
                    "inventoryVerified": {
                      "const": false,
                      "type": "boolean"
                    },
                    "label": {
                      "type": "string"
                    },
                    "notice": {
                      "type": "string"
                    },
                    "ranges": {
                      "items": {
                        "properties": {
                          "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"
                          }
                        },
                        "required": [
                          "provider",
                          "sourceType",
                          "currency",
                          "minMinor",
                          "maxMinor",
                          "minorUnit",
                          "checkedAt",
                          "validUntil",
                          "label",
                          "feeInclusion"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "required": [
                    "label",
                    "ranges",
                    "notice",
                    "inventoryVerified"
                  ],
                  "type": "object"
                },
                "slug": {
                  "type": "string"
                },
                "url": {
                  "description": "Relative canonical TicketSea URL",
                  "type": "string"
                }
              },
              "required": [
                "kind",
                "slug",
                "name",
                "url",
                "detail"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "label": {
            "type": "string"
          },
          "nextOffset": {
            "type": [
              "integer",
              "null"
            ]
          },
          "scanLimited": {
            "type": "boolean"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "type",
          "label",
          "items",
          "hasMore",
          "scanLimited"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "indexStale": {
      "type": "boolean"
    },
    "indexUpdatedAt": {
      "type": "string"
    },
    "location": {
      "type": [
        "string",
        "null"
      ]
    },
    "notice": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "radius": {
      "type": [
        "number",
        "null"
      ]
    }
  },
  "required": [
    "query",
    "groups",
    "indexUpdatedAt",
    "indexStale",
    "notice"
  ]
}
🟢search_events(city, country, from, kind, limit, ...)

Use this when the user wants upcoming concerts, sports, theatre or other live events by performer or event name, city, country, category or dates. Returns cached provider listings in date order. Each event has its TicketSea page (url) and, when a fresh exact-event seller link exists, a tickets link to that seller's page. Not live inventory, and nothing is purchased. Use nextOffset to page, and narrow the filters when scanLimited is true.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "city": {
      "description": "City the user asked about, as an exact city name (case-insensitive), such as Seattle. Location is never inferred.",
      "maxLength": 120,
      "type": "string"
    },
    "country": {
      "pattern": "^[A-Z]{2}$",
      "type": "string"
    },
    "from": {
      "format": "date",
      "type": "string"
    },
    "kind": {
      "enum": [
        "music",
        "sports",
        "theatre",
        "other"
      ],
      "type": "string"
    },
    "limit": {
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "maximum": 1000,
      "minimum": 0,
      "type": "integer"
    },
    "query": {
      "description": "Artist, team, event or venue text.",
      "maxLength": 120,
      "type": "string"
    },
    "to": {
      "format": "date",
      "type": "string"
    }
  },
  "required": [],
  "additionalProperties": false
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "coverage": {
      "type": "string"
    },
    "events": {
      "items": {
        "properties": {
          "city": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "date": {
            "description": "Venue-local date; may be blank if unknown.",
            "type": "string"
          },
          "dateTime": {
            "description": "Provider absolute start timestamp when supplied.",
            "type": [
              "string",
              "null"
            ]
          },
          "inventoryVerified": {
            "const": false,
            "type": "boolean"
          },
          "listingUpdatedAt": {
            "description": "Original listing retrieval timestamp; not a stock check.",
            "type": "string"
          },
          "localTime": {
            "description": "Venue-local time; may be blank if unknown.",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "onSale": {
            "properties": {
              "endAt": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "startAt": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "tbd": {
                "type": "boolean"
              }
            },
            "required": [
              "startAt",
              "endAt",
              "tbd"
            ],
            "type": "object"
          },
          "pricing": {
            "description": "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.",
            "properties": {
              "inventoryVerified": {
                "const": false,
                "type": "boolean"
              },
              "label": {
                "type": "string"
              },
              "notice": {
                "type": "string"
              },
              "ranges": {
                "items": {
                  "properties": {
                    "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"
                    }
                  },
                  "required": [
                    "provider",
                    "sourceType",
                    "currency",
                    "minMinor",
                    "maxMinor",
                    "minorUnit",
                    "checkedAt",
                    "validUntil",
                    "label",
                    "feeInclusion"
                  ],
                  "type": "object"
                },
                "type": "array"
              }
            },
            "required": [
              "label",
              "ranges",
              "notice",
              "inventoryVerified"
            ],
            "type": "object"
          },
          "publicSaleState": {
            "description": "Schedule state, not inventory. registration means restricted registration access, not an open general sale.",
            "type": "string"
          },
          "region": {
            "type": "string"
          },
          "slug": {
            "pattern": "^[a-z0-9-]{1,240}$",
            "type": "string"
          },
          "stale": {
            "type": "boolean"
          },
          "status": {
            "type": "string"
          },
          "tickets": {
            "description": "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.",
            "properties": {
              "affiliate": {
                "description": "TicketSea may earn a commission from this seller.",
                "type": "boolean"
              },
              "official": {
                "type": "boolean"
              },
              "seller": {
                "type": "string"
              },
              "type": {
                "description": "primary or resale.",
                "type": "string"
              },
              "url": {
                "format": "uri",
                "type": "string"
              }
            },
            "required": [
              "url",
              "seller",
              "type",
              "official",
              "affiliate"
            ],
            "type": "object"
          },
          "timezone": {
            "description": "Provider timezone; may be blank if unknown. Do not invent one.",
            "type": "string"
          },
          "url": {
            "format": "uri",
            "type": "string"
          },
          "venue": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "url",
          "name",
          "date",
          "dateTime",
          "localTime",
          "timezone",
          "venue",
          "city",
          "region",
          "country",
          "status",
          "publicSaleState",
          "onSale",
          "listingUpdatedAt",
          "stale",
          "inventoryVerified"
        ],
        "type": "object"
      },
      "maxItems": 50,
      "type": "array"
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextOffset": {
      "maximum": 1000,
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "notice": {
      "type": "string"
    },
    "scanLimited": {
      "type": "boolean"
    },
    "sources": {
      "items": {
        "properties": {
          "available": {
            "type": "boolean"
          },
          "countrySnapshots": {
            "items": {
              "properties": {
                "country": {
                  "type": "string"
                },
                "listingUpdatedAt": {
                  "type": "string"
                },
                "stale": {
                  "type": "boolean"
                }
              },
              "required": [
                "country",
                "listingUpdatedAt",
                "stale"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "error": {
            "type": "string"
          },
          "source": {
            "type": "string"
          }
        },
        "required": [
          "source",
          "available"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "events",
    "nextOffset",
    "hasMore",
    "scanLimited",
    "sources",
    "coverage",
    "notice"
  ]
}
🟢get_event(slug)

Use this when you have an event's slug from a search result and need that event's current details: date, local time, venue, sale state, cancellation and any published price range. Returns the newest available snapshot; older details are returned explicitly marked stale.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Exact event slug from a search result; not an artist or venue slug.",
      "pattern": "^[a-z0-9-]{1,240}$",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "date": {
      "description": "Venue-local date; may be blank if unknown.",
      "type": "string"
    },
    "dateTime": {
      "description": "Provider absolute start timestamp when supplied.",
      "type": [
        "string",
        "null"
      ]
    },
    "inventoryVerified": {
      "const": false,
      "type": "boolean"
    },
    "listingUpdatedAt": {
      "description": "Original listing retrieval timestamp; not a stock check.",
      "type": "string"
    },
    "localTime": {
      "description": "Venue-local time; may be blank if unknown.",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "notice": {
      "type": "string"
    },
    "onSale": {
      "properties": {
        "endAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "startAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "tbd": {
          "type": "boolean"
        }
      },
      "required": [
        "startAt",
        "endAt",
        "tbd"
      ],
      "type": "object"
    },
    "pricing": {
      "description": "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.",
      "properties": {
        "inventoryVerified": {
          "const": false,
          "type": "boolean"
        },
        "label": {
          "type": "string"
        },
        "notice": {
          "type": "string"
        },
        "ranges": {
          "items": {
            "properties": {
              "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"
              }
            },
            "required": [
              "provider",
              "sourceType",
              "currency",
              "minMinor",
              "maxMinor",
              "minorUnit",
              "checkedAt",
              "validUntil",
              "label",
              "feeInclusion"
            ],
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": [
        "label",
        "ranges",
        "notice",
        "inventoryVerified"
      ],
      "type": "object"
    },
    "publicSaleState": {
      "description": "Schedule state, not inventory. registration means restricted registration access, not an open general sale.",
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "slug": {
      "pattern": "^[a-z0-9-]{1,240}$",
      "type": "string"
    },
    "stale": {
      "type": "boolean"
    },
    "status": {
      "type": "string"
    },
    "tickets": {
      "description": "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.",
      "properties": {
        "affiliate": {
          "description": "TicketSea may earn a commission from this seller.",
          "type": "boolean"
        },
        "official": {
          "type": "boolean"
        },
        "seller": {
          "type": "string"
        },
        "type": {
          "description": "primary or resale.",
          "type": "string"
        },
        "url": {
          "format": "uri",
          "type": "string"
        }
      },
      "required": [
        "url",
        "seller",
        "type",
        "official",
        "affiliate"
      ],
      "type": "object"
    },
    "timezone": {
      "description": "Provider timezone; may be blank if unknown. Do not invent one.",
      "type": "string"
    },
    "url": {
      "format": "uri",
      "type": "string"
    },
    "venue": {
      "type": "string"
    }
  },
  "required": [
    "slug",
    "url",
    "name",
    "date",
    "dateTime",
    "localTime",
    "timezone",
    "venue",
    "city",
    "region",
    "country",
    "status",
    "publicSaleState",
    "onSale",
    "listingUpdatedAt",
    "stale",
    "inventoryVerified",
    "notice"
  ]
}
🟢get_ticket_links(slug)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Exact event slug from a search result; not an artist or venue slug.",
      "pattern": "^[a-z0-9-]{1,240}$",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "date": {
      "description": "Venue-local date; may be blank if unknown.",
      "type": "string"
    },
    "dateTime": {
      "description": "Provider absolute start timestamp when supplied.",
      "type": [
        "string",
        "null"
      ]
    },
    "handoffAvailable": {
      "description": "At least one exact-event seller link exists; this does not mean tickets remain.",
      "type": "boolean"
    },
    "inventoryVerified": {
      "const": false,
      "type": "boolean"
    },
    "links": {
      "items": {
        "properties": {
          "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"
          }
        },
        "required": [
          "url",
          "seller",
          "type",
          "official",
          "affiliate",
          "purpose",
          "inventoryVerified"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "listingUpdatedAt": {
      "description": "Original listing retrieval timestamp; not a stock check.",
      "type": "string"
    },
    "localTime": {
      "description": "Venue-local time; may be blank if unknown.",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "notice": {
      "type": "string"
    },
    "onSale": {
      "properties": {
        "endAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "startAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "tbd": {
          "type": "boolean"
        }
      },
      "required": [
        "startAt",
        "endAt",
        "tbd"
      ],
      "type": "object"
    },
    "otherSellers": {
      "description": "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.",
      "items": {
        "properties": {
          "affiliate": {
            "type": "boolean"
          },
          "detail": {
            "type": "string"
          },
          "inventoryVerified": {
            "const": false,
            "type": "boolean"
          },
          "seller": {
            "type": "string"
          },
          "url": {
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "url",
          "seller",
          "detail",
          "affiliate",
          "inventoryVerified"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "pricing": {
      "description": "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.",
      "properties": {
        "inventoryVerified": {
          "const": false,
          "type": "boolean"
        },
        "label": {
          "type": "string"
        },
        "notice": {
          "type": "string"
        },
        "ranges": {
          "items": {
            "properties": {
              "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"
              }
            },
            "required": [
              "provider",
              "sourceType",
              "currency",
              "minMinor",
              "maxMinor",
              "minorUnit",
              "checkedAt",
              "validUntil",
              "label",
              "feeInclusion"
            ],
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": [
        "label",
        "ranges",
        "notice",
        "inventoryVerified"
      ],
      "type": "object"
    },
    "publicSaleState": {
      "description": "Schedule state, not inventory. registration means restricted registration access, not an open general sale.",
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "slug": {
      "pattern": "^[a-z0-9-]{1,240}$",
      "type": "string"
    },
    "stale": {
      "type": "boolean"
    },
    "status": {
      "type": "string"
    },
    "tickets": {
      "description": "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.",
      "properties": {
        "affiliate": {
          "description": "TicketSea may earn a commission from this seller.",
          "type": "boolean"
        },
        "official": {
          "type": "boolean"
        },
        "seller": {
          "type": "string"
        },
        "type": {
          "description": "primary or resale.",
          "type": "string"
        },
        "url": {
          "format": "uri",
          "type": "string"
        }
      },
      "required": [
        "url",
        "seller",
        "type",
        "official",
        "affiliate"
      ],
      "type": "object"
    },
    "timezone": {
      "description": "Provider timezone; may be blank if unknown. Do not invent one.",
      "type": "string"
    },
    "url": {
      "format": "uri",
      "type": "string"
    },
    "venue": {
      "type": "string"
    }
  },
  "required": [
    "slug",
    "url",
    "name",
    "date",
    "dateTime",
    "localTime",
    "timezone",
    "venue",
    "city",
    "region",
    "country",
    "status",
    "publicSaleState",
    "onSale",
    "listingUpdatedAt",
    "stale",
    "inventoryVerified",
    "notice",
    "links",
    "handoffAvailable"
  ]
}
🟢prepare_event_visit(slug)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Exact event slug from a search result; not an artist or venue slug.",
      "pattern": "^[a-z0-9-]{1,240}$",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "date": {
      "description": "Venue-local date; may be blank if unknown.",
      "type": "string"
    },
    "dateTime": {
      "description": "Provider absolute start timestamp when supplied.",
      "type": [
        "string",
        "null"
      ]
    },
    "handoffAvailable": {
      "description": "At least one exact-event seller link exists; this does not mean tickets remain.",
      "type": "boolean"
    },
    "inventoryVerified": {
      "const": false,
      "type": "boolean"
    },
    "links": {
      "items": {
        "properties": {
          "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"
          }
        },
        "required": [
          "url",
          "seller",
          "type",
          "official",
          "affiliate",
          "purpose",
          "inventoryVerified"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "listingUpdatedAt": {
      "description": "Original listing retrieval timestamp; not a stock check.",
      "type": "string"
    },
    "localTime": {
      "description": "Venue-local time; may be blank if unknown.",
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "notice": {
      "type": "string"
    },
    "onSale": {
      "properties": {
        "endAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "startAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "tbd": {
          "type": "boolean"
        }
      },
      "required": [
        "startAt",
        "endAt",
        "tbd"
      ],
      "type": "object"
    },
    "otherSellers": {
      "description": "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.",
      "items": {
        "properties": {
          "affiliate": {
            "type": "boolean"
          },
          "detail": {
            "type": "string"
          },
          "inventoryVerified": {
            "const": false,
            "type": "boolean"
          },
          "seller": {
            "type": "string"
          },
          "url": {
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "url",
          "seller",
          "detail",
          "affiliate",
          "inventoryVerified"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "pricing": {
      "description": "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.",
      "properties": {
        "inventoryVerified": {
          "const": false,
          "type": "boolean"
        },
        "label": {
          "type": "string"
        },
        "notice": {
          "type": "string"
        },
        "ranges": {
          "items": {
            "properties": {
              "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"
              }
            },
            "required": [
              "provider",
              "sourceType",
              "currency",
              "minMinor",
              "maxMinor",
              "minorUnit",
              "checkedAt",
              "validUntil",
              "label",
              "feeInclusion"
            ],
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": [
        "label",
        "ranges",
        "notice",
        "inventoryVerified"
      ],
      "type": "object"
    },
    "publicSaleState": {
      "description": "Schedule state, not inventory. registration means restricted registration access, not an open general sale.",
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "slug": {
      "pattern": "^[a-z0-9-]{1,240}$",
      "type": "string"
    },
    "stale": {
      "type": "boolean"
    },
    "status": {
      "type": "string"
    },
    "tickets": {
      "description": "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.",
      "properties": {
        "affiliate": {
          "description": "TicketSea may earn a commission from this seller.",
          "type": "boolean"
        },
        "official": {
          "type": "boolean"
        },
        "seller": {
          "type": "string"
        },
        "type": {
          "description": "primary or resale.",
          "type": "string"
        },
        "url": {
          "format": "uri",
          "type": "string"
        }
      },
      "required": [
        "url",
        "seller",
        "type",
        "official",
        "affiliate"
      ],
      "type": "object"
    },
    "timezone": {
      "description": "Provider timezone; may be blank if unknown. Do not invent one.",
      "type": "string"
    },
    "url": {
      "format": "uri",
      "type": "string"
    },
    "venue": {
      "type": "string"
    },
    "visit": {
      "properties": {
        "bookingCreated": {
          "const": false,
          "type": "boolean"
        },
        "instructions": {
          "type": "string"
        },
        "planningAvailable": {
          "description": "The event snapshot is fresh and upcoming; this does not confirm availability.",
          "type": "boolean"
        },
        "suggestedStay": {
          "properties": {
            "checkIn": {
              "format": "date",
              "type": "string"
            },
            "checkOut": {
              "format": "date",
              "type": "string"
            }
          },
          "required": [
            "checkIn",
            "checkOut"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "travelLinks": {
          "items": {
            "properties": {
              "affiliate": {
                "type": "boolean"
              },
              "detail": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "url": {
                "format": "uri",
                "type": "string"
              }
            },
            "required": [
              "title",
              "detail",
              "url",
              "affiliate"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "venueAddress": {
          "properties": {
            "city": {
              "type": "string"
            },
            "country": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "postalCode": {
              "type": "string"
            },
            "region": {
              "type": "string"
            },
            "street": {
              "type": "string"
            }
          },
          "required": [
            "name",
            "street",
            "city",
            "region",
            "postalCode",
            "country"
          ],
          "type": "object"
        }
      },
      "required": [
        "planningAvailable",
        "venueAddress",
        "suggestedStay",
        "travelLinks",
        "bookingCreated",
        "instructions"
      ],
      "type": "object"
    }
  },
  "required": [
    "slug",
    "url",
    "name",
    "date",
    "dateTime",
    "localTime",
    "timezone",
    "venue",
    "city",
    "region",
    "country",
    "status",
    "publicSaleState",
    "onSale",
    "listingUpdatedAt",
    "stale",
    "inventoryVerified",
    "notice",
    "links",
    "handoffAvailable",
    "visit"
  ]
}
🟢get_service_status

Use this when a search fails or returns nothing unexpectedly and you need to know whether TicketSea's listings are current. Returns the latest snapshot time for each country. This is not a seller uptime or booking success measurement.

Esquema de entrada

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "bookingSupported": {
      "const": false,
      "type": "boolean"
    },
    "countrySnapshots": {
      "items": {
        "properties": {
          "country": {
            "type": "string"
          },
          "listingUpdatedAt": {
            "type": "string"
          },
          "stale": {
            "type": "boolean"
          }
        },
        "required": [
          "country",
          "listingUpdatedAt",
          "stale"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "hasRecentSnapshot": {
      "type": "boolean"
    },
    "latestListingUpdatedAt": {
      "type": [
        "string",
        "null"
      ]
    },
    "mode": {
      "type": "string"
    },
    "notice": {
      "type": "string"
    },
    "paymentSupported": {
      "const": false,
      "type": "boolean"
    },
    "service": {
      "type": "string"
    }
  },
  "required": [
    "service",
    "mode",
    "latestListingUpdatedAt",
    "hasRecentSnapshot",
    "countrySnapshots",
    "bookingSupported",
    "paymentSupported",
    "notice"
  ]
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada6 herramientas