Tools
check_coverage
Checks up to 1,000 events at once: the event each one names and the markets Ticker reads for it.
When to use it
- Someone hands you their events, as ids or links, and asks which of them Ticker covers.
- You want to know, before you pull numbers, which markets Ticker reads for each of a list of events.
- To find one event by its name, use
search_events.
Inputs
refs(array of strings, required): The events to check, 1 to 1,000. Each one is a Ticker event id (evplus ten characters), a marketplace id with its source prefix (vs:,tm:,sh:,sg:,gt:,tp:orax:), or a marketplace event link. Up to 1000 items.
Examples
Which of these events does Ticker cover?
{ "refs": ["ev3rp4z4zhq1", "ev8k2m4q7x1a"] }Does Ticker read this event on every market?
{ "refs": ["ev3rp4z4zhq1"] }What comes back
rows, one per ref, in the order you sent them. Each row hasref, the event it names (event_id,name,date,venueandstatus),has_tm_id, andmarkets: each market Ticker reads for the event that your plan includes, withlast_read_at, when its newest read answered.- A ref that names no event has a null
event_id,miss(invalidornot_found) andmiss_reason, one line saying why. summary: how many refs you sent, how many named an event, how many of those hold a TM id, and a count per market.
Limits and quota
- Reads only: it changes nothing.
- Each call spends one MCP request.
- At most 1,000 refs in one call.
- Lists only the markets your plan includes. A marketplace id or link from a market your plan does not include is not read, and its row says so.