Tool catalog
Every FreeTicket MCP tool grouped by domain, with the API operation it calls.
Each tool calls one API operation and returns what the API returns. Roles, validation and errors are the same as in the B2B API reference. Tools marked destructive ask for confirmation in clients that support it.
Public (no credential)
Available on both /mcp and /mcp/public.
| Tool | Does |
|---|---|
public_events_list |
Search the catalog of published events |
public_events_get |
Event detail by slug |
public_events_availability |
Live stock and buyer prices per date and ticket type. Check it before creating an order. |
public_orders_create |
Create an order and return the payment link for the buyer |
public_orders_get |
Order status (pending, paid, expired, cancelled), plus tickets once paid |
public_tickets_resend |
Resend the ticket email to the buyer’s original address |
Public ordering covers general admission tickets that are not members-only.
Session
| Tool | Does |
|---|---|
whoami |
Your user, your workspaces and your role in each |
Events and dates
| Tool | Does |
|---|---|
events_list · events_get |
List events (filters: q, status) or get one |
events_create |
Create an event with its dates |
events_update · events_publish |
Edit an event, or publish a draft |
events_delete |
Delete an event. Destructive. |
event_dates_list · event_dates_create · event_dates_update |
Dates of an event |
event_dates_delete |
Delete a date. Destructive. |
Ticket types and tickets
| Tool | Does |
|---|---|
ticket_types_list · ticket_types_get |
Ticket types with price breakdown and stock |
ticket_types_create · ticket_types_update |
Create one, or change price, stock or visibility |
ticket_types_delete |
Delete a ticket type. Destructive. |
tickets_access |
Check a ticket by its code, without admitting it |
tickets_checkin |
Admit a ticket at the door |
tickets_resend |
Resend a ticket email |
Sales
| Tool | Does |
|---|---|
sales_list · sales_get |
List sales with filters, or get one with its items |
sales_tickets |
Individual tickets and attendees of a sale |
sales_create |
Record a comp or direct sale |
sales_cancel · sales_refund |
Cancel or refund a sale. Destructive. |
Memberships
| Tool | Does |
|---|---|
plans_list · plans_get · plans_subscribers |
Plans and their members |
plans_create · plans_update |
Manage plans |
plans_delete · subscriptions_cancel |
Delete a plan, or cancel a subscription. Destructive. |
Venues, staff, discounts and webhooks
| Tool | Does |
|---|---|
venues_list · venues_get · venues_create · venues_update |
Venues |
venues_delete |
Delete a venue. Destructive. |
staff_list · staff_create · staff_update_role |
Staff with access to the workspace |
discounts_list · discounts_create · discounts_update |
Discount codes |
discounts_delete |
Delete a discount code. Destructive. |
webhooks_list · webhooks_create |
Webhook endpoints. See Webhooks. |
webhooks_delete |
Delete a webhook. Destructive. |
Reports and exports
| Tool | Does |
|---|---|
reports_summary |
KPIs for the active workspace |
reports_by_event |
Revenue, tickets sold and availability per event |
reports_timeseries |
Revenue and tickets over time |
reports_inventory |
Capacity, sold, reserved and available per event, date or ticket type |
reports_financials |
Per-date financial statement and net to settle |
reconciliation |
Payment ↔ sale ↔ invoice reconciliation, flagging mismatches |
reports_export_buyers · reports_export_attendees · reports_export_subscribers · reports_export_reconciliation |
Exports |
Settlements
| Tool | Does |
|---|---|
settlements_list |
Payouts from FreeTicket to the organizer |
settlements_document · settlements_proof |
A signed download link for the settlement PDF or a payment proof, valid for 5 minutes |
Content
| Tool | Does |
|---|---|
content_videos · content_posts · content_lives · content_live_get |
Published videos, community posts and live streams |
content_playback_token |
Signed playback token: 1 hour for video, 30 minutes for live. Members-only content also needs a buyer session. |
Credentials
| Tool | Does |
|---|---|
api_keys_list |
Audit which API keys exist and when they were last used. Never returns secrets. |
Creating and revoking keys is not available as a tool. Use the CLI or the API.
Members area (enterprise)
customer_me, customer_tickets, customer_ticket_get, customer_membership, customer_profile, customer_profile_update, customer_subscribe, customer_subscription_cancel, customer_ticket_cancel and customer_logout act on behalf of a signed-in buyer. They require an enterprise service API key plus the buyer’s session token. See Credentials.
Rendered results
In clients that support the MCP Apps extension, list and report tools render as a table or KPI tiles instead of raw JSON. The view is self-contained and makes no network requests. Other clients receive the same data as text.
Global mode
Most list and report tools accept workspace:
"all": aggregate every workspace you can access.["id1", "id2"]: aggregate only those workspaces.
Rows are tagged with workspaceId and workspaceName. reports_summary returns KPIs for one workspace only, because KPIs can’t be added up across workspaces.