Universe MCP by usefulapi
Read events, ticket types, orders, attendees and daily ticket sales in Universe.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"universe": {
"url": "https://universe.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://universe.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (9)
🟢universe_get_viewer
Return the signed-in Universe user and the host accounts they can manage (team memberships). Use a host id with universe_list_events. Read-only.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢universe_list_events(hostId, states, search, limit, offset)
List events (id, title, url, state, first date, venue, tickets sold). Without hostId it lists the signed-in user's own events; with hostId it lists that host account's events (ids come from universe_get_viewer). Read-only.
Eingabe-Schema
{
"type": "object",
"properties": {
"hostId": {
"description": "Host account id. Omit for your own events.",
"type": "string"
},
"states": {
"description": "Only events in these states, e.g. POSTED.",
"type": "array",
"items": {
"type": "string",
"enum": [
"DRAFT",
"PRESUBMITTED",
"POSTED",
"EXPIRED",
"ARCHIVED",
"DECLINED",
"INACTIVE"
]
}
},
"search": {
"description": "Text to match in the event title (host events only).",
"type": "string"
},
"limit": {
"description": "Page size. Default 25, max 100.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of rows to skip. Default 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢universe_get_event(eventId)
Fetch one event by id: description, address, dates, capacity, tickets sold, sales amount, category and host. For ticket types use universe_list_ticket_types. Read-only.
Eingabe-Schema
{
"type": "object",
"properties": {
"eventId": {
"type": "string",
"description": "Event id."
}
},
"required": [
"eventId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢universe_list_ticket_types(eventId, states, limit, offset)
List the ticket types (rates) of an event: name, price, capacity, sold count, state and sales window. Read-only.
Eingabe-Schema
{
"type": "object",
"properties": {
"eventId": {
"type": "string",
"description": "Event id."
},
"states": {
"description": "Only rates in these states.",
"type": "array",
"items": {
"type": "string",
"enum": [
"ACTIVE",
"LOCKED",
"INACTIVE",
"HIDDEN"
]
}
},
"limit": {
"description": "Page size. Default 25, max 100.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of rows to skip. Default 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"eventId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢universe_list_time_slots(eventId, startAfter, startBefore, limit, offset)
List the dates and time slots of an event (start, end, capacity, tickets sold, state). Optionally filter by start date range (YYYY-MM-DD). Read-only.
Eingabe-Schema
{
"type": "object",
"properties": {
"eventId": {
"type": "string",
"description": "Event id."
},
"startAfter": {
"description": "Only slots that start after this date (YYYY-MM-DD).",
"type": "string"
},
"startBefore": {
"description": "Only slots that start before this date (YYYY-MM-DD).",
"type": "string"
},
"limit": {
"description": "Page size. Default 25, max 100.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of rows to skip. Default 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"eventId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢universe_list_orders(eventId, states, match, updatedSince, limit, ...)
List the orders of an event: buyer name and email, state, price breakdown, created and updated time. Filter by order state, text match or updated-since time. Contains buyer personal data. Read-only.
Eingabe-Schema
{
"type": "object",
"properties": {
"eventId": {
"type": "string",
"description": "Event id."
},
"states": {
"description": "Only orders in these states, e.g. PAID.",
"type": "array",
"items": {
"type": "string",
"enum": [
"UNPAID",
"UNAPPROVED",
"NEEDS_PRE_AUTH",
"CHECKOUT",
"PENDING",
"PAID",
"FAILED",
"DECLINED",
"CANCELLED",
"ENDED",
"CLOSED",
"EXPIRED",
"ERROR",
"PARTIALLY_PAID",
"UNAUTHORIZED"
]
}
},
"match": {
"description": "Text to match (buyer name, email or order reference).",
"type": "string"
},
"updatedSince": {
"description": "Only orders updated since this ISO 8601 time.",
"type": "string"
},
"limit": {
"description": "Page size. Default 25, max 100.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of rows to skip. Default 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"eventId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢universe_get_order(orderId)
Fetch one order by id: buyer, state, cost breakdown, time slot, checkout answers and the ticket items with their check-in state. Read-only.
Eingabe-Schema
{
"type": "object",
"properties": {
"orderId": {
"type": "string",
"description": "Order id."
}
},
"required": [
"orderId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢universe_list_attendees(eventId, states, match, timeSlotIds, limit, ...)
List the attendees (ticket holders) of an event: name, email, ticket type, time slot, ticket state and checkout answers. Filter by ticket state, text match or time slot. Contains personal data. Read-only.
Eingabe-Schema
{
"type": "object",
"properties": {
"eventId": {
"type": "string",
"description": "Event id."
},
"states": {
"description": "Only tickets in these states, e.g. PAID.",
"type": "array",
"items": {
"type": "string",
"enum": [
"UNPAID",
"UNAPPROVED",
"CHECKOUT",
"PENDING",
"PAID",
"FAILED",
"DECLINED",
"CANCELLED",
"ENDED",
"CLOSED",
"EXPIRED",
"ERROR",
"PARTIALLY_PAID",
"UNAUTHORIZED",
"TRANSFERRED",
"UPGRADED"
]
}
},
"match": {
"description": "Text to match (name or email).",
"type": "string"
},
"timeSlotIds": {
"description": "Only these time slot ids.",
"type": "array",
"items": {
"type": "string"
}
},
"limit": {
"description": "Page size. Default 25, max 100.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of rows to skip. Default 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"eventId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢universe_event_sales_by_day(eventId, from, to)
Return ticket sales per day for an event between two dates (YYYY-MM-DD, inclusive). Read-only.
Eingabe-Schema
{
"type": "object",
"properties": {
"eventId": {
"type": "string",
"description": "Event id."
},
"from": {
"type": "string",
"description": "First day, YYYY-MM-DD."
},
"to": {
"type": "string",
"description": "Last day, YYYY-MM-DD."
}
},
"required": [
"eventId",
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis