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

Add your ticket concierge to your website
Ask Fai about your event
Give ticket buyers an AI concierge
Teach your concierge from your event FAQ pages and Google Docs

Add your ticket concierge to your website

Slug add-your-ticket-concierge-to-your-website. Guide: https://www.ticketfairy.com/guides/add-your-ticket-concierge-to-your-website

Add your concierge to the website where buyers find your event, so it answers ticket questions and sells tickets in a chat on your own pages, and choose who takes the questions it passes on.

For: Getting your concierge onto the website your ticket buyers use.

What an agent can do: Fai can open your concierge widgets so you can copy the snippet. Choose the sites the chat loads on and where hand-offs go in the dashboard, then add the snippet to your own site.

Prompt for Fai: "Open the concierge widgets for so I can copy the snippet for our website"

Then: Change the snippet after a key leak

What an agent can do: Fai can open your concierge widgets for you. Rotating the key and replacing the snippet are done in the dashboard and on your own site.

Prompt for Fai: "Open the concierge widgets for "

Ask Fai about your event

Slug ask-fai-about-your-event. Guide: https://www.ticketfairy.com/guides/ask-fai-about-your-event

Ask Fai, the assistant in your dashboard, about your event by typing or out loud, have her chart the answer or make the change for you, and check her work before you rely on it.

For: Getting answers about your own events, orders and buyers.

What an agent can do: Fai is the agent path. She works on the brand and event you have open, reads what your role reaches, and asks before she changes anything.

Command line:

Show an event and its current sales: ticketfairy event stats <EVENT_ID>

CLI MCP tools that read: select_event, get_event.

Prompt for Fai: "How many tickets has sold so far, and how does that compare with the same point before my last event"

Then: Ask her to do the work, not only describe it

What an agent can do: Fai proposes the changes and waits for your approval on each one.

Command line:

Create a ticket release: ticketfairy ticket create <EVENT_ID> --name "Early Bird" --price 18

CLI MCP tools that read: select_event, get_event.

Prompt for Fai: "Set up an early bird tier for at twenty per cent below the standard price, ask me for the allocation and the dates, and show me the change before you save it"

Then: Things worth asking her for

What an agent can do: Reading, drawing and drafting are hers to do freely. Anything that issues a ticket or changes your event is put to you first, and a guest ticket sent to the wrong person is taken back by cancelling its order.

CLI MCP tools that read: select_event, get_event.

Prompt for Fai: "Issue two guest tickets on the comp tier for to ada@example.com and noor@example.com, then show me the list before you send"

Then: Talk to her instead of typing

What an agent can do: Talking reaches the same Fai, with the same permissions, the same tools and the same approvals as typing. Only the exact words Fai reads out approve a change by voice.

CLI MCP tools that read: select_event, get_event.

Prompt for Fai: "How did sell last weekend, and how does that compare with the weekend before"

Give ticket buyers an AI concierge

Slug give-buyers-an-ai-concierge. Guide: https://www.ticketfairy.com/guides/give-buyers-an-ai-concierge

Put an assistant on your own site that answers what buyers ask before they buy, from the answers you gave it.

For: Answering buyer questions on your own website.

What an agent can do: Fai can open the concierge builder for you. What the concierge knows is yours to enter and yours to keep current.

Command line:

Show the brands you can act for: ticketfairy brand list

CLI MCP tools that read: select_brand.

Prompt for Fai: "Open the concierge widgets for "

Then: Keep it current as the event changes

What an agent can do: Fai can open the widget so you can update what it knows.

Command line:

Show the brands you can act for: ticketfairy brand list

CLI MCP tools that read: select_brand.

Prompt for Fai: "Open the concierge widget for so I can update its answers"

Teach your concierge from your event FAQ pages and Google Docs

Slug teach-your-concierge-from-your-event-faq-pages. Guide: https://www.ticketfairy.com/guides/teach-your-concierge-from-your-event-faq-pages

Point your ticket concierge at the event FAQ, policy and venue pages you already keep, a Google Doc or your whole website, and it answers buyers from them and picks up your changes on a schedule you choose.

For: Giving your concierge the answers you already keep on your website and in documents.

What an agent can do: Fai can open your concierge's reference pages for you. Add a page, a Google Doc or a website, and choose which widgets answer from it, in the dashboard.

Prompt for Fai: "Open the concierge reference pages for "

Then: Read a whole website instead of one page

What an agent can do: Fai can open the reference pages for you. Adding the website and reviewing the pages she kept are done in the dashboard.

Prompt for Fai: "Open the concierge reference pages for so I can add our website"

Then: Give one widget a page of its own

What an agent can do: Fai can open your concierge widgets for you. A widget's own reference pages are added in the dashboard.

Prompt for Fai: "Open the concierge widgets for "

Then: Let the concierge mention events you sell elsewhere

What an agent can do: Fai can open the concierge's events on other platforms for you. Adding a page to watch is done in the dashboard.

Prompt for Fai: "Open the concierge external event sources for "

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

Add your ticket concierge to your website

Then: Change the snippet after a key leak

Ask Fai about your event

Then: Ask her to do the work, not only describe it

Then: Things worth asking her for

Then: Talk to her instead of typing

Give ticket buyers an AI concierge

Then: Keep it current as the event changes

Teach your concierge from your event FAQ pages and Google Docs

Then: Read a whole website instead of one page

Then: Give one widget a page of its own

Then: Let the concierge mention events you sell elsewhere

More

work-with-fai

Work with Fai

How to work