# Songkick MCP > Songkick connects your AI agent to a global live music database for concert discovery. Use our tools to search artists, venues, or locations; pull full tour histories (`get_artist_gigography`); or get detailed event information from any specific date and place. It’s everything you need to plan an outing or audit a band's career—all via natural conversation. ## Overview - **Category:** data-management - **Price:** Free - **Tags:** live-music, concert-schedules, tour-history, artist-data, event-discovery ## Description This server hooks your AI agent up to a massive global database of live music schedules. You don't gotta spend time clicking through sticky ticketing sites; your agent handles all that messy legwork for you. It gives you instant access to tour dates, venue history, and event lineups, no questions asked. When you need to plan an outing or audit a band’s career, the tools do the heavy lifting. You're in charge of the conversation; your agent pulls the data. To start anywhere, your agent can first narrow down the search area using `search_locations` to find and validate any metropolitan region or city name. If you know where you wanna go but not what kind of place it is, `search_venues` lets you pinpoint specific concert halls or clubs by name or general area. You can also zero in on a musician first; just use `search_artists` to find an artist's profile based on their name or related keywords. Once the location or artist are scoped out, you get into discovery mode. If you wanna know what's happening across an entire city that weekend, your agent runs `get_location_calendar`, checking every available show within a specified metro area. Need to check one spot specifically? You run `get_venue_calendar` and it generates the full schedule for any single concert hall or club over time. If you’re focused on one band, you can use `get_artist_calendar` to pull all upcoming dates and locations they've scheduled within a given date range. For deep dives into history, your agent pulls every past event associated with a specific musician—or whole group—by running `get_artist_gigography`. This tool gives you the complete historical record of their tour life. If you’re already pointed at one confirmed show ID, you use `get_event_details` to pull all the final metadata. That means getting detailed start times, specific lineups, and confirming every little detail about that single concert. Basically, if it involves a band playing live somewhere, your agent can find it. You check what's happening city-wide using `get_location_calendar`, then you use `search_artists` to confirm the group name. After that, you might check their full past tour history with `get_artist_gigography`. If they have a show coming up next month, you run `get_artist_calendar` for those dates. Once you pick one date, and you know the venue, your agent can even pull the whole schedule for that spot using `get_venue_calendar`, or drill down further by running `get_event_details` on a specific show ID to see who's playing with whom. It’s everything you need built into natural conversation. ## Tools ### get_artist_calendar Retrieves a list of upcoming shows for an artist within a specific date range. ### get_artist_gigography Pulls the full, historical record of past events and concerts for any named artist. ### get_event_details Fetches detailed metadata—like lineups or start times—for one specific concert event ID. ### get_location_calendar Gets all scheduled events happening across an entire metropolitan area or defined location. ### search_artists Searches the database to find artists based on name or related keywords. ### search_locations Finds and validates geographical locations or cities for event searching. ### search_venues Searches the database to find specific concert venues by name or area. ### get_venue_calendar Retrieves the full schedule of shows for a single, named concert venue over time. ## Prompt Examples **Prompt:** ``` Is 'Coldplay' on tour right now? ``` **Response:** ``` Searching for Coldplay... Yes, they are currently on tour! I see upcoming shows in London, Paris, and Berlin. Would you like the specific dates and venue information? ``` **Prompt:** ``` Show me concerts in New York City next week. ``` **Response:** ``` Retrieving the NYC concert calendar... There are several exciting events, including 'The Killers' at Madison Square Garden and various indie bands at local clubs. Shall I list them by date for you? ``` **Prompt:** ``` Get the gigography for 'Radiohead'. ``` **Response:** ``` Fetching Radiohead's history... I've identified hundreds of past events spanning from their early club dates to major festival headlining slots. I can break this down by year or country if you're interested. ``` ## Capabilities ### Find upcoming events by city or area The agent checks all available shows within a specified metropolitan region using `get_location_calendar`. ### Retrieve an artist's full concert history The system pulls every past event and tour date associated with a specific musician or group via `get_artist_gigography`. ### Check an artist’s current touring schedule The agent queries the database for all upcoming dates and locations for a given artist using `get_artist_calendar`. ### Get event details by specific ID You retrieve detailed metadata, including start times and full lineups, for one confirmed show using `get_event_details`. ### List shows at a single venue The agent generates a schedule of all events happening at one specific concert hall or club via `get_venue_calendar`. ## Use Cases ### The Local Discovery Problem A user just landed in Miami and wants to see what's happening tonight. Instead of visiting three different event websites, they ask their agent: 'Show me concerts in Miami tomorrow.' The agent runs `search_locations` (Miami), then calls `get_location_calendar`, giving the user a single list of actionable events. ### The Industry Audit A booking agent is vetting 'Artist Y' for a new tour. They need to prove the band has played in Europe and North America over 10 years. The agent runs `get_artist_gigography` on Artist Y, instantly pulling every historical date and country reference. ### The Venue Planner An event organizer needs to decide if a specific small club can handle a festival show. They run `search_venues` first, then use `get_venue_calendar` to check the venue's capacity and scheduled events for the desired date range. ### The Follow-Up Detail Check A user sees an event listing online but needs confirmation on the opening act. They provide the Event ID, and the agent runs `get_event_details`, immediately returning the full lineup and confirmed start time. ## Benefits - **Audit Artist History:** Stop guessing what a band has played. Use `get_artist_gigography` to pull hundreds of past event records in one go, perfect for competitive analysis. - **Plan Local Outings:** Don't check 12 different local listings. Run `get_location_calendar` to see all scheduled events across an entire metro area at once. - **Check Tour Status:** Need to know if 'Band X' is coming? Call `get_artist_calendar`. It gives you a clear view of their next few stops without ambiguity. - **Deep Dive on Venues:** Don't forget the physical location. Use `search_venues` and then `get_venue_calendar` to see if *that specific club* has any openings that night. - **Pinpoint Details:** Found an event ID but need the full lineup? `get_event_details` pulls all the required metadata in a single, clean call. ## How It Works The bottom line is: your agent uses a three-step filter sequence—search > calendar > detail—to find concrete concert information. 1. First, tell your AI client what you're looking for: an artist name (`search_artists`), a city (`search_locations`), or a venue name (`search_venues`). 2. Next, use the appropriate calendar tool—like `get_artist_calendar`—to filter that search down by date range or location. 3. Finally, if you need specifics (lineup, exact time), call `get_event_details` with the event ID to pull all confirmed data. ## Frequently Asked Questions **How do I find all concerts in New York using get_location_calendar?** You provide the location name (New York) and the date range. The agent returns a consolidated list of events from every venue and artist within that area for your specified time. **Can I check an artist's past shows using get_artist_gigography?** Yes, this tool pulls the complete historical record. You just need to provide the artist's name, and it gathers every verifiable gig date in the database. **What is the difference between search_venues and get_venue_calendar?** `search_venues` finds a venue by name (e.g., The Fillmore). `get_venue_calendar` then uses that specific venue ID to pull its actual, date-specific schedule. **What data does get_event_details provide?** It provides detailed metadata for one single event. This includes lineups, confirmed start times, and any other specific info attached to that concert ID. **What credentials do I need to use `search_artists` or other tools?** You must provide a valid Songkick API Key. The server requires this key during setup; it authenticates your requests and authorizes access to the live music data streams. **Are there rate limits when I use `get_artist_calendar` repeatedly?** Yes, you are subject to Songkick’s established API rate limits. If you send too many requests in a short window, the server will return an error code (usually 429). Your AI client should handle this with an exponential backoff strategy. **How can I refine my searches if I use `search_locations`?** The `search_locations` tool returns geographical coordinates and names. You must then take those specific location parameters (like city name or zip code) to feed into tools like `get_location_calendar` for relevant results. **Is there a way to filter results using `get_artist_calendar` by date range?** Yes. The tool accepts specific parameters, including start and end dates. Providing these bounds lets you narrow the search dramatically instead of retrieving all historical or future data for the artist. **How do I find upcoming concerts in a specific city?** First, use the `search_locations` tool to find the correct `metroAreaId` for your city. Then, use the `get_location_calendar` tool with that ID to retrieve all upcoming events in that area. **Can I see the full tour history of an artist?** Yes! Use the `get_artist_gigography` tool with the Artist ID. It provides a comprehensive list of past concerts and events recorded for that specific artist. **Does the integration provide details for specific concert venues?** Absolutely. You can use the `search_venues` tool to find a venue by name and then use `get_venue_calendar` to see all upcoming shows scheduled at that specific location.