BandMate AI
BandMateAI
Sign in

For AI agents

Read, search, book, or act for a member

AI assistants are welcome here. Three doors, depending on whether you are acting for someone with a BandMate account.

1. Read the site

Start with /llms.txt (summary) or /llms-full.txt (everything). These pages have a Markdown twin: add .md to the path, or send Accept: text/markdown to the HTML URL.

2. Search bands, shows and venues

Public, no account, JSON enveloped as { "data": ..., "meta": ... }.

  • GET https://bandmateai.com/api/v1/public/bands?q=&state=MD&genre=&sort_by=name&limit=20
  • GET https://bandmateai.com/api/v1/public/bands/{slug} · /gigs · /members · /songs · /last-setlist
  • GET https://bandmateai.com/api/v1/public/gigs?state=&city=&from_date=YYYY-MM-DD&to_date=&limit=50
  • GET https://bandmateai.com/api/v1/public/venues?limit=100 · /{slug} · /{slug}/gigs

3. Ask a band to play, for a client

POST https://bandmateai.com/api/v1/public/bands/{slug}/booking-inquiry with a JSON body. No account needed. Required: name, email, venue_or_event_name, details (10–5000 characters). Optional: proposed_date (YYYY-MM-DD), budget_range, is_booker. Say which agent is submitting in details. The band reads it in their inbox and replies to the email given.

{
  "name": "Jordan Lee",
  "email": "jordan@example.com",
  "venue_or_event_name": "Riverside Summer Series",
  "proposed_date": "2027-06-19",
  "details": "Outdoor stage, 7–9pm, PA provided. Submitted by an AI assistant on behalf of Jordan Lee.",
  "budget_range": "$600–800",
  "is_booker": true
}

201 on success. 403 if the band has inquiries turned off. 429 after three inquiries a day from one email.

4. Act for a BandMate member (MCP)

BandMate is an MCP server. A Band or Band Pro member connects you from their side: they add the URL below in their client and approve it once on bandmateai.com. You then act as them, see only their bands, and do what their role allows: gigs, pay, venues, expenses, mileage.

https://bandmateai.com/api/v1/mcp

OAuth 2.1 with PKCE and dynamic client registration. An unauthenticated request returns 401 with a WWW-Authenticate challenge naming the resource metadata; follow it. Discovery: /.well-known/oauth-protected-resource/api/v1/mcp.

  • list_bands — bands, your role, plan, booking contact and whether the connector is enabled
  • list_gigs — upcoming or past gigs with your pay and miles; owners and managers see the band total
  • get_gig — one gig in full, including tech notes
  • check_availability — what you already have on a date or range, across every band
  • create_gig — add a gig to a band you own or manage; a city/state-only address gives an estimated distance
  • update_gig — edit a gig: date, times, venue, pay, status, notes; only the fields passed change
  • cancel_gig — cancel a gig and keep it in history
  • delete_gig — delete a gig permanently; owner only, and only after you confirm
  • list_members — a band's members with role, position and how each is paid
  • invite_member — invite someone by email with a role, position and pay type; they get a join link
  • resend_invite — send a pending invite again and extend it a week
  • cancel_invite — revoke a pending invite
  • set_member_pay — set one member's pay on a gig, apart from the band total
  • set_member_rate — put a member (sound engineer, sub) on a flat fee with a dated rate schedule
  • mark_paid — record a payment: amount, date, method (cash, Venmo, Zelle, check)
  • log_mileage — log your own round-trip miles for a gig
  • create_expense — log an expense with category, vendor, receipt note and gig
  • list_venues — a band's venues, with ids for create_gig
  • create_venue — add a venue with address, load-in notes and contact; reuses an existing match
  • update_venue — edit a venue's details or your band's notes and contact for it
  • merge_venues — merge a duplicate venue into the one to keep, moving its gigs; after you confirm
  • set_band_contact — store the band's leader or booker name, email and phone
  • calendar_feed — your personal ICS calendar URL plus per-band feeds, with subscribe steps
  • mileage_summary — a year of deductible miles, effective rate and each trip
  • tax_summary — income marked paid, expenses by category, the mileage deduction
  • list_expenses — your logged expenses
  • list_equipment — your gear with purchase details and rig notes
  • list_setlists — a band's setlists
  • get_setlist — every song on a setlist with key, BPM and duration

The setup guide for people