Ticketsauce MCP by usefulapi
Read Ticketsauce events, orders and ticket check-in IDs (read-only).
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"ticketsauce": {
"url": "https://ticketsauce.usefulapi.io/mcp"
}
}
}遠端端點
https://ticketsauce.usefulapi.io/mcpstreamable-http它能做什麼
工具清單
工具（5）
🟢ticketsauce_list_events(organization_id, partner_id, start_after, start_before, start_phrase, ...)
List the events you own on Ticketsauce with id, name, slug, start/end (local and UTC), venue address, timezone, organization, privacy type, whether tickets are on sale, and the event and ticket-shop URLs. Filter by start/end/created dates (yyyy-mm-dd, UTC), a phrase such as this_weekend, organization or partner. The API has no paging for events. Use the event id for orders and check-ins. GET /v2/events.
輸入結構描述
{
"type": "object",
"properties": {
"organization_id": {
"description": "Only events of this organization.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"partner_id": {
"description": "Only events of this partner.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"start_after": {
"description": "Events starting on/after this date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"start_before": {
"description": "Events starting on/before this date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"start_phrase": {
"description": "Events starting in a named period (today, this_weekend, next_month...).",
"type": "string",
"enum": [
"today",
"yesterday",
"tomorrow",
"this_week",
"this_weekend",
"next_week",
"next_weekend",
"this_month",
"next_month"
]
},
"end_after": {
"description": "Events ending on/after this date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"end_before": {
"description": "Events ending on/before this date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"created_after": {
"description": "Events created on/after this date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"created_before": {
"description": "Events created on/before this date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"active_only": {
"description": "Only active events (the API default is true).",
"type": "boolean"
},
"inactive_only": {
"description": "Only inactive events (the API default is false).",
"type": "boolean"
},
"privacy_type": {
"description": "public (API default), unlisted or all.",
"type": "string",
"enum": [
"public",
"unlisted",
"all"
]
},
"sort_by": {
"description": "Sort field (default date).",
"type": "string",
"enum": [
"date",
"name",
"city"
]
},
"sort_dir": {
"description": "Sort direction (default asc).",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"include_performers": {
"description": "Include the performers of each event.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ticketsauce_get_event(event, photos, include_performers)
One event by id or slug: everything in the list plus summary and description (text and HTML), order_count and ticket_count (tickets sold, not refunded or voided). Replies are cached for an hour. GET /v2/event/{id_or_slug}.
輸入結構描述
{
"type": "object",
"properties": {
"event": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Event id (UUID) or event slug, as returned by ticketsauce_list_events."
},
"photos": {
"description": "Include the photo gallery records.",
"type": "boolean"
},
"include_performers": {
"description": "Include the performers.",
"type": "boolean"
}
},
"required": [
"event"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ticketsauce_list_orders(event_id, q, ordered_after, ordered_before, ordered_phrase, ...)
Orders of one event, oldest first by default (pass sort_dir desc for newest first): order id, status, buyer name, email, phone and address, totals (total_paid, refund_amount, taxes, fees), promo code, ticket_count, paid date. Contains your customers' personal data. Filter by order or modified dates, a phrase, buyer email or last name (exact match), totals, or promo use; optionally embed tickets, questionnaire answers and line-item fees. Paged: per_page up to 500, then pass next_page. Replies are cached for an hour. GET /v2/orders/{event_id}.
輸入結構描述
{
"type": "object",
"properties": {
"event_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "Event id (UUID) from ticketsauce_list_events."
},
"q": {
"description": "Exact buyer email address or last name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"ordered_after": {
"description": "Ordered on/after (UTC).",
"type": "string"
},
"ordered_before": {
"description": "Ordered on/before (UTC).",
"type": "string"
},
"ordered_phrase": {
"description": "Ordered in a named period.",
"type": "string",
"enum": [
"today",
"yesterday",
"tomorrow",
"this_week",
"this_weekend",
"next_week",
"next_weekend",
"this_month",
"next_month"
]
},
"modified_after": {
"description": "Modified on/after (UTC).",
"type": "string"
},
"modified_before": {
"description": "Modified on/before (UTC).",
"type": "string"
},
"total_above": {
"description": "Only orders with a total greater than this.",
"type": "number",
"minimum": 0
},
"total_below": {
"description": "Only orders with a total less than this.",
"type": "number",
"minimum": 0
},
"promo_used_only": {
"description": "Only orders that used a promo code.",
"type": "boolean"
},
"return_tickets": {
"description": "Include each order's tickets.",
"type": "boolean"
},
"return_questionnaires": {
"description": "Include questionnaire answers.",
"type": "boolean"
},
"return_line_item_fees": {
"description": "Include line-item fees.",
"type": "boolean"
},
"sort_by": {
"description": "Sort field (default date).",
"type": "string",
"enum": [
"date",
"name"
]
},
"sort_dir": {
"description": "Sort direction (default asc).",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Orders per page, 1-500 (default 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 500
}
},
"required": [
"event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ticketsauce_get_order(order_id)
One order by id, with its buyer details, totals and its tickets (ticket type, name, price, redeemed state, promo code). Contains personal data. Replies are cached for an hour. GET /v2/order/{order_id}.
輸入結構描述
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "Order id (UUID) from ticketsauce_list_orders."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ticketsauce_list_checkin_ids(event_id, page, per_page)
The ticket check-in ids of one event, for door/scanning reconciliation (the API documents no response fields; the reply is returned as is). Paged: per_page up to 5000, then pass next_page. Replies are cached for 5 minutes. GET /v2/tickets/checkin_ids/{event_id}.
輸入結構描述
{
"type": "object",
"properties": {
"event_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "Event id (UUID) from ticketsauce_list_events."
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Ids per page, 1-5000 (default 1000).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 5000
}
},
"required": [
"event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社群
證據