GigXchange

Gigs HAPPENING across the UK — the public listings directory of shows to go and see (mostly imported, already booked). Use for "what's on in Leeds this weekend?". These are concerts to attend, not work to apply for; gigs open for applications are in search_open_gigs. Filter by city and/or a date range ("this weekend"). Paginated.

Member-posted gigs that are OPEN FOR APPLICATIONS — real venues/promoters looking to book an act, future dates only. Use for "what can I apply for?", "any gigs for me?", "what work is going in Leeds?". Excludes the imported concert directory (search_gigs) and past dates. Each row carries the gig `id` that apply_to_gig needs, and `unpaid: true` where the gig pays nothing (charity/exposure). An empty result means no gigs are open for applications right now; concerts in search_gigs are not opportunities.

GigXchange artists and bands open to a booking on a specific date. FREE-BY-DEFAULT: a member is bookable on every date EXCEPT ones they have marked (unavailable / on hold / already booked), so a large result means "nobody has blocked that day", not "everyone confirmed they are free"; it is not a confirmed yes. Each result carries the member `id` needed by make_offer and check_member_availability. Filter by city. act_type must be one of: solo, duo, trio, band. Paginated.

Recurring UK open mic nights in a city, with day/frequency, signup method, backline and fee. Use `day` for "open mic tonight / on Thursday" (UK time). Filter by performer type (music, comedy, poetry...) and by kit the night lists (has_pa, has_backline, has_engineer - as the listing states it; a night that does not say is counted in a note, not treated as "none"). Paginated.

The public directory of UK grassroots live-music venues in a city (listings, no booking): capacity, backline, PA, engineer and genres booked. Filter by genre, capacity, PA/backline/engineer and live-music day. GigXchange MEMBER venues open to a gig request on a date are in search_available_venues. Paginated.

GigXchange MEMBER venues open to receiving a gig request on a specific date (free-by-default: open unless the venue marked that date). Use for "which venues could I pitch for Friday?". This is availability to RECEIVE A REQUEST TO PLAY, not room hire: GigXchange does not currently support hiring a venue/room and has no hire rates. Filter by city. Paginated.

Overview of the GigXchange Index (GX Index), the UK live-music pay index: headline counts, the cities it covers, every published monthly issue (slug, title, url), the latest issue's open datasets (HuggingFace, Kaggle, Zenodo DOI) and the city average-fee league behind the Pint Index. Use for any GX Index question; fees are in get_rates and single issues in get_index_issue.

Takes no parameters.

What UK acts typically get paid, from the GigXchange Index: median and range (25th-90th percentile) by city, gig type and act size, with sample size and an honest label when a figure is regional, UK-wide or modelled. Use for "what should my band charge", "what does a wedding band cost in Leeds", "cheapest city for pub gigs" (pass several cities to compare). Typical published artist take-home fees, not a quote. No genre dimension. Regions are not accepted - pass a city.

One published GigXchange Index monthly issue by slug (e.g. "september-2026" - get_index_summary lists them): headline description, key figures, context, FAQ, PDF and open-dataset links (HuggingFace, Kaggle, Zenodo DOI).

Live counts across GigXchange: members by type, venues, open mics, cities, and upcoming gigs listed in the directory (concerts to see, not work to apply for; gigs open for applications are in search_open_gigs).

Takes no parameters.

Public profile for a GigXchange member by URL slug (display name, bio, genres, location, ratings).

Public electronic press kit for an artist by URL slug (summary, genres, rating, media counts).

Full detail for a single directory gig — line-up, address, times, tickets. Use the city_slug + slug from a search_gigs result.

Full detail for a single open mic night — schedule, signup, slot length, backline, address. Use the slug from a search_open_mics result.

Full detail for a single grassroots venue — capacity, PA, backline, genres booked, curfew, address. Use the slug from a search_venues result.

Public detail for an event hosted on GigXchange by URL slug — date, venue, ticketing, organiser.

UK cities where GigXchange has members, with a member count each. Use for "do you cover <city>?".

Takes no parameters.

Index of published Member Spotlight features — long-form profiles of real GigXchange members. Newest first.

Takes no parameters.

Full editorial text of one Member Spotlight issue by slug, plus a link to the member profile it features.

The signed-in member's own profile: name, type, bio, location, verification, rating. Requires a connected account.

Takes no parameters.

Count of the member's unread messages. Returns a COUNT only — message contents are never exposed.

Takes no parameters.

The member's own bookings from 30 days ago onwards — status, date, venue/event, agreed fee, and which side they are on. Max 25.

Status and amounts of the member's invoices, both directions — each row carries direction: "sent" (issued by the member) or "received" (billed to them). Payment-processor identifiers are never exposed.

Takes no parameters.

The full map of GigXchange's official help centre — every category and the questions it answers. Use for "what can you help me with?" or to see what the help centre covers. Topics not listed here are not covered by the help centre.

Searches GigXchange's help articles — its own documentation of how the platform works (payments, fees, deposits, cancellations, bookings, profiles, messages, account, what to do when something goes wrong). Returns matching articles with their url, or no results when the help centre does not cover a topic.

The full text of one official GigXchange help article, by slug from a search_help result.

The member's OWN availability for a date window. GigXchange is free-by-default: they are bookable on every date EXCEPT the marked ones this returns (unavailable / soft_hold / confirmed_booking). Default window 90 days, max 365.

Whether ONE named member (artist or venue, by profile id from search/get_profile) is free on a specific date. Free-by-default: "available" means nothing is marked against that date. Use for "is X free on the 14th?"; finding WHO is free is search_available_performers.

Set a date on the member's own GigXchange calendar: unavailable, soft_hold (pencilled), or available (clears the manual entry). Same statuses the app's calendar offers; a booked night comes from a real booking, never by hand; only touches manual entries — never booking-derived ones. Requires the member's "Allow my assistant to act" switch (Settings > Integrations > AI).

Toggle a GigXchange profile (by slug) in the member's favourites list. Requires the member's "Allow my assistant to act" switch.

Mark all of the member's GigXchange notifications as read. Requires the member's "Allow my assistant to act" switch.

Takes no parameters.

Update the member's own public fee range (GBP, min and max) shown on their profile — the same field as the app's profile editor. Requires the member's "Allow my assistant to act" switch.

Accept or decline a booking offer the member RECEIVED (never one they sent). expected_fee must equal the current fee on the booking (refused otherwise). Declining requires a short reason (relayed to the other party) and is limited to 3 per day. Accepting can start the payment flow. Requires the member's "Allow my assistant to act" switch.

Propose a different fee on a pending booking offer (posts an amended offer card in chat, retiring the old one). expected_current_fee must match the booking; the new fee must stay within 50-200% of it, and only one counter per booking per day. Requires the member's "Allow my assistant to act" switch.

Send a booking offer to another GigXchange member — the recipient gets a pending booking, a notification and an offer card in Messages, exactly as if the member had sent it in the app. Supported pairs: venue/promoter/organiser to artist, artist to venue/promoter, promoter to venue. Offers involving an agent are app-only. Max 5 offers a day, one per recipient a day, and no duplicate live offer for the same date. Requires the member's "Allow my assistant to act" switch.

Apply the member to an open gig from search_open_gigs (GigXchange member-posted gigs only). The offered fee comes from the gig's listed budget — there is no fee parameter. One live application per gig, 5 per day. Requires the member's "Allow my assistant to act" switch.

Replace the member's own public profile bio (plain text, max 1500 chars). The previous bio is returned and included in the member's notification for easy recovery. Requires the member's "Allow my assistant to act" switch.

Send a text message into one of the member's EXISTING GigXchange conversations (no new conversations). Max 2000 characters, 10 per conversation per day. The exact text sent is returned. Requires the member's "Allow my assistant to act" switch.

Send one of the member's own DRAFT settle-privately invoices to its GigXchange recipient (notifies them + posts the invoice card in chat). Platform-generated booking invoices are refused — GigXchange sends those automatically. Requires the member's "Allow my assistant to act" switch.