Universe MCP by usefulapi
Read events, ticket types, orders, attendees and daily ticket sales in Universe.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"universe": {
"url": "https://universe.usefulapi.io/mcp"
}
}
}遠端端點
https://universe.usefulapi.io/mcpstreamable-http它能做什麼
工具清單
工具(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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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"
}社群
證據