Ticket Fairy agent skills
Official Agent Skills and AI coding agent rules from
Ticket Fairy, the ticketing platform for festivals, club
nights, concerts, conferences and tours.
Skills
Start here
| Skill | What it does |
|---|
find-event-tickets | Find Ticket Fairy events, choose tickets, and help a buyer pay through supported agent checkout or browser checkout. |
start-organising-events | Help an organiser start a Ticket Fairy workspace for ticketing or standalone event management, prepare their first event and compare published feature plans. |
connect-organiser-account | Get a Ticket Fairy organiser credential for an AI agent, with the person's approval, and use it on the organiser API. |
manage-events-with-the-cli | Manage Ticket Fairy events, tickets, orders, customers, invitations, promotions, check-in and webhooks with the official ticketfairy CLI or its MCP server. |
answer-ticketfairy-questions | Answer how-to questions about Ticket Fairy from the official guides, with the guides MCP server. |
By area
Each of these skills lists every published guide for its area, what an agent can do for each
guide, and the exact command-line and MCP routes. The steps stay in the guides, which an agent
reads live from the guides MCP server at https://www.ticketfairy.com/docs/mcp.
| Skill | What it does |
|---|
build-with-the-ticketfairy-api | Use Ticket Fairy access tokens, API keys and webhooks, and sell from your own app. |
connect-ticketfairy-integrations | Connect Ticket Fairy to Mailchimp, Zapier and other tools an organiser already uses. |
email-and-market-to-buyers | Send Ticket Fairy emails and SMS to buyers, design emails, and build event websites and landing pages. |
follow-event-type-playbooks | Follow the Ticket Fairy order of work for festivals, club nights, tours, conferences and other event types. |
get-paid-for-ticket-sales | Set up Ticket Fairy payment accounts, choose who pays the fees, pick currencies and follow payouts. |
grow-sales-with-referrals | Set up Ticket Fairy referral rewards and see who brought in each sale. |
manage-brand-and-team | Manage a Ticket Fairy brand kit, team roles, several brands, collectives and account security. |
|
scripts/build_guide_skills.py builds the area skills from the guide catalogue; the script
explains how to export it and run it.
Install them with the skills CLI, using Node.js 22.20 or later:
npx skills add theticketfairy/agent-skills
To install every skill without the prompts:
npx skills add theticketfairy/agent-skills --all -y
In Claude Code, you can also add them as a plugin:
/plugin marketplace add theticketfairy/agent-skills
/plugin install ticketfairy@ticketfairy
The repository is also an Agent Plugin: plugin.json describes it,
and mcp.json connects the public Ticket Fairy event search and guides MCP servers, which need no account.
All 34 skill names are also advertised in the
public skill index.
Focused collections
These five public repositories provide focused collections from the 34-skill hub.
They use the same canonical skill names; choose the collection for your task
instead of installing duplicate copies from several sources.
| Collection | Capabilities | skills.sh | Install |
|---|
| Buyer ticketing skills | Public event discovery, supported agent checkout and browser handoff | Browse | npx skills add theticketfairy/buyer-ticketing-skills |
| Event planning skills | Event setup, tickets, artists, team travel and show schedules | Browse | npx skills add theticketfairy/event-planning-skills |
| Event operations skills | Orders, refunds, doors, crew, accreditation, site and reports | Browse | npx skills add theticketfairy/event-operations-skills |
| Event marketing skills | Buyer messaging, promotions, referrals, ads and social media | Browse | npx skills add theticketfairy/event-marketing-skills |
| Developer integration skills | Account connection, CLI, MCP, API, webhooks and integrations | Browse | npx skills add theticketfairy/developer-integration-skills |
Maintain one source
The five authored entry skills stay in skills/. Guide-area skills come from the
platform's published guide catalogue and GuideAreaSkills family definitions.
From a reviewed platform checkout, export them with:
php /path/to/agent-skills/scripts/export_guides.php --with-skill-families > /tmp/ticketfairy-guides.json
Then run in this repository with a reviewed CLI checkout:
python3 scripts/build_guide_skills.py /tmp/ticketfairy-guides.json /path/to/ticketfairy-cli
python3 scripts/build_skill_repositories.py /path/to/release-packages
skill-repositories.json assigns every canonical skill to one focused collection.
The copy step produces skill files, README inventories, agent rules, the MIT licence
and SOURCE.json; it does not create, publish or install anything. Review the
canonical change first, commit it, rebuild the packages from that exact commit,
and publish the copied release files together. Update skills here rather than
editing their generated copies. skills-source.json records
the platform, CLI and public-index evidence used for this refresh.
Skill installation grants no authority to send messages or change an account.
Use the person's explicit action and recipient scope; inspect the original result
before retrying an uncertain refund, send, transfer or ticket grant.
Rules for AI coding agents
AGENTS.md tells Claude Code, Cursor, Windsurf, Codex and other coding agents how
to use the Ticket Fairy API, MCP server and CLI correctly. CLAUDE.md, .cursorrules and
.cursor/rules/ point to it.
More
Licence
MIT. See LICENSE.
