Buukkaa-bandi.fi

Checks whether an artist can be booked for the event date and event type, and returns the price estimate for the event city and crowd size. When available is false, reasons explain why (e.g. date-reserved, only-weekend-gigs, audience-not-ok).

check_artist_availability

Stores the event and the client's contact details once and returns a booking_id. Then call send_quote with the booking_id for each artist (at most 10 artists per booking). Only call this after the user has confirmed the details; use the user's own real name, email and phone. The artists reply to that email. A booking_id expires 24 hours after its last use and at the latest 7 days after it was created.

create_booking_request

Returns the public profile of an artist: description (Finnish), genres, event types they play for, setlist, reviews and the starting price. Give `city` and `crowd` to get the price for a specific event. Does not check the date, use check_artist_availability for that.

get_artist_details

Shows a booking request: the event, the artists it has been sent to and how many quotes can still be sent. Useful to check what has already been done.

get_booking_request

Lists Finnish cities where artists can be booked, alphabetically. Use `query` to find a city by the start of its Finnish name (e.g. "Tampe" or "Helsin"). Returns city slugs to use in the other tools.

list_available_cities

Searches bands and other performers that are free on the event date and play for the given event type. Results are ranked by relevance and distance, 10 per page. Prices are estimates in euros for the given crowd size, including travel costs when price_includes_travel is true.

search_artists

Sends the booking request to one artist as a quote request. The artist and the client get it by email and the artist replies with an offer. Each booking_id can be sent to at most 10 artists. Check availability first and only send to artists the user has chosen. Pass an idempotency_key to retry safely.

send_quote