Find the guide. Pick the guide below that matches the task. If none fits, search all guides: connect an MCP client to https://www.ticketfairy.com/docs/mcp (Streamable HTTP, no account or key) and call search_guides with the task in plain words.
Read it before you act. Call get_guide with the guide's slug. It returns who the guide is for, what to have ready, every step and the common questions. Follow those steps; do not guess the dashboard from memory.
Do the work, or hand it over. Each guide below says what an agent can do:
- Command line. With the organiser's permission, install the official CLI (npm install -g ticketfairy) and sign in with ticketfairy login, or use a Personal Access Token that the organiser stores in TICKET_FAIRY_API_KEY. Then check the account and pick the brand: ticketfairy auth status, ticketfairy brand list and ticketfairy brand use <BRAND_ID>. Add --output json --non-interactive to every command you run that does not already choose its own mode, such as --output csv or --interactive; the commands below leave them out to stay short.
- MCP. ticketfairy mcp --read-only starts the CLI's MCP server with read tools. Drop --read-only only when the organiser wants you to make changes.
- Fai. Fai is the assistant inside the organiser's dashboard. When a task is not on the command line, give the organiser the suggested prompt to paste into Fai.
- Dashboard. Otherwise, send the organiser the guide link and walk them through it.
Keep secrets out of the chat. Codes, passwords and tokens that the organiser receives go into the Ticket Fairy dashboard: the page that asks for them, or Fai there when the guide says so. They never go into your conversation with the organiser.
Confirm before you change anything. Show the organiser what you will create, change, send, refund or cancel, and wait for their yes. You can do only what their team role allows.
Never take payment. Buyers pay in the browser checkout. Bank, tax and payout details stay in the organiser's own browser.

Guides

Sell one pass that covers several of your events

Sell one pass that covers several of your events

Slug sell-a-pass-that-covers-several-events. Guide: https://www.ticketfairy.com/guides/sell-a-pass-that-covers-several-events

Sell a season pass or a multi-night bundle once, then let the buyer book the nights they want as you announce them.

For: Selling a season ticket or a multi-night bundle across your programme.

What an agent can do: Fai can build the pass, choose the events it covers and read what it has sold. She asks before each change, because a pass is something buyers pay for.

Command line:

Show the brand's events: ticketfairy event list

CLI MCP tools that read: select_brand.

Prompt for Fai: "Create a season pass for covering four events, priced at 96, usable until the end of March, and show me the events it would cover before saving"

Then: See how many passes you have sold and how many events holders have booked

What an agent can do: Fai can read the roll-up for a pass: how many sold, how many events were booked and how much revenue is still waiting.

Command line:

Show the brands you can act for: ticketfairy brand list

CLI MCP tools that read: select_brand.

Prompt for Fai: "For , how many season passes have sold and how many events have been booked with them"

Then: Stop selling a pass while the ones already bought still work

What an agent can do: Fai can archive a pass once you confirm it. She asks first, because it takes a product off sale.

Command line:

Show the brands you can act for: ticketfairy brand list

CLI MCP tools that read: select_brand.

Prompt for Fai: "Take the last season pass for off sale"

All guides: https://www.ticketfairy.com/guides
Guides MCP server: https://www.ticketfairy.com/docs/mcp (tools search_guides and get_guide)
CLI reference: https://www.npmjs.com/package/ticketfairy
Developer documentation: https://www.ticketfairy.com/developers
Support: support@ticketfairy.com

Guides

Sell one pass that covers several of your events

Then: See how many passes you have sold and how many events holders have booked

Then: Stop selling a pass while the ones already bought still work

More

sell-passes-and-extras

Sell passes and extras

How to work