Bandsintown API and MCP server

• POST

  list_events

  Events on your artist page with date, venue, ticket links and status.

  read

  Returns events of one artist page, soonest first, with date, venue, ticket links and whether each is published or a draft. Filter by status or by date range. Use the event_id from each item in the other tools.

  POST /api/v1/bandsintown/list_events

  Input

  Input: list_events

  Parameter	Type	Description
  artist_id	string	Artist page you manage. Default: your first artist.
  status	enum	upcoming, past, draft or all. Default: upcoming.
  from	date	Only events on or after this date.
  to	date	Only events on or before this date.

  Example response

  {
    "events": [
      {
        "event_id": "1037728455",
        "status": "published",
        "starts_at": "2026-11-14T20:00:00+00:00",
        "venue": {
          "name": "Brudenell Social Club",
          "city": "Leeds",
          "country": "United Kingdom"
        },
        "ticket_links": [
          {
            "url": "https://tickets.example.com/yourband-leeds",
            "type": "tickets"
          }
        ],
        "url": "https://www.bandsintown.com/e/1037728455"
      },
      {
        "event_id": "1037728501",
        "status": "draft",
        "starts_at": "2026-12-03T19:30:00+01:00",
        "venue": {
          "name": "Columbiahalle",
          "city": "Berlin",
          "country": "Germany"
        },
        "ticket_links": [],
        "url": null
      }
    ]
  }

• POST

  get_event

  One event in full: venue, lineup, description, ticket links, on-sale time and URL.

  read

  Returns one event with every field you can set in the event form: location, lineup, description and ticket links with their on-sale time. Bandsintown rewrites ticket links, so the links shown are the ones you entered.

  POST /api/v1/bandsintown/get_event

  Input

  Input: get_event

  Parameter	Type	Description
  event_id required	string	Event ID from list_events.

  Example response

  {
    "event_id": "1037728455",
    "status": "published",
    "starts_at": "2026-11-14T20:00:00+00:00",
    "venue": {
      "name": "Brudenell Social Club",
      "city": "Leeds",
      "country": "United Kingdom"
    },
    "lineup": [
      "Your Band"
    ],
    "description": "Album launch show.",
    "ticket_links": [
      {
        "url": "https://tickets.example.com/yourband-leeds",
        "type": "tickets",
        "on_sale_at": "2026-10-16T10:00:00+01:00"
      }
    ],
    "url": "https://www.bandsintown.com/e/1037728455"
  }

• POST

  search_venues

  Find a Bandsintown venue by name and city, to attach it to an event.

  read

  Searches the Bandsintown venue list and returns matches with a venue_id. If the venue is not listed, pass custom_location to create_event instead. Attach a venue with a full location: events without one are not considered by Bandsintown's recommendations.

  POST /api/v1/bandsintown/search_venues

  Input

  Input: search_venues

  Parameter	Type	Description
  query required	string	Venue name.
  city	string	City, to narrow the results.

  Example response

  {
    "venues": [
      {
        "venue_id": "v_118302",
        "name": "Brudenell Social Club",
        "city": "Leeds",
        "country": "United Kingdom"
      }
    ]
  }

• POST

  get_event_stats

  RSVPs for each of your shows, as in the Events Performance view of Insights.

  read

  Returns RSVPs per show from Insights, the same figures as Events Performance. Pass event_id for one show, or leave it out for all upcoming shows.

  POST /api/v1/bandsintown/get_event_stats

  Input

  Input: get_event_stats

  Parameter	Type	Description
  artist_id	string	Artist page you manage. Default: your first artist.
  event_id	string	Only this event. Default: all upcoming events.

  Example response

  {
    "events": [
      {
        "event_id": "1037728455",
        "venue": "Brudenell Social Club",
        "starts_at": "2026-11-14T20:00:00+00:00",
        "rsvps": 212
      }
    ]
  }

• POST

  get_follower_stats

  Total followers, RSVPs and ticket clicks with the change over a period, from Insights.

  read

  Returns the Insights summary: total followers, RSVPs and ticket clicks, with how much each changed in the period. Periods match the Insights filters. Read only.

  POST /api/v1/bandsintown/get_follower_stats

  Input

  Input: get_follower_stats

  Parameter	Type	Description
  artist_id	string	Artist page you manage. Default: your first artist.
  period	enum	7d, 4w or 12m. Default: 4w.

  Example response

  {
    "period": "7d",
    "followers": {
      "total": 18420,
      "change": 163
    },
    "rsvps": {
      "total": 2310,
      "change": 54
    },
    "ticket_clicks": {
      "total": 1190,
      "change": 37
    }
  }

• POST

  get_top_markets

  Locations where your fans are, ranked by trackers or fan requests.

  read

  Returns your top locations from Insights, the same list as Top Markets. Sort by trackers (followers) or by fan requests (fans asking you to play there). Read only.

  POST /api/v1/bandsintown/get_top_markets

  Input

  Input: get_top_markets

  Parameter	Type	Description
  artist_id	string	Artist page you manage. Default: your first artist.
  rank_by	enum	trackers or fan_requests. Default: trackers.
  limit	integer	1 to 50. Default: 10.

  Example response

  {
    "markets": [
      {
        "rank": 1,
        "location": "London, United Kingdom",
        "trackers": 2104,
        "fan_requests": 311
      },
      {
        "rank": 2,
        "location": "Leeds, United Kingdom",
        "trackers": 1388,
        "fan_requests": 96
      }
    ]
  }

• POST

  create_event

  New event saved as a draft. Nothing is public until you publish it.

  write

  Saves a new event as a draft; Bandsintown lists drafts under Drafts. Attach a venue from search_venues or pass custom_location. One ticket link must carry the Tickets label. create_event reaches no one and one delete_event call undoes it, so it runs without asking first.

  POST /api/v1/bandsintown/create_event

  Input

  Input: create_event

  Parameter	Type	Description
  artist_id	string	Artist page you manage. Default: your first artist.
  starts_at required	datetime	Local venue time, ISO 8601.
  venue_id	string	Venue from search_venues. Or use custom_location.
  custom_location	object	name, city, country, for a place not in the venue list.
  title	string	Event name, if different from the artist name.
  description	string	Event description.
  lineup	string[]	Other artists with a Bandsintown page on the bill.
  ticket_links	object[]	List of { url, type, on_sale_at }; type is tickets, free or sold_out. One link must be tickets.

  Example response

  {
    "event_id": "1037728455",
    "status": "draft",
    "starts_at": "2026-11-14T20:00:00+00:00",
    "venue": {
      "name": "Brudenell Social Club",
      "city": "Leeds",
      "country": "United Kingdom"
    },
    "ticket_links": [
      {
        "url": "https://tickets.example.com/yourband-leeds",
        "type": "tickets"
      }
    ],
    "url": null
  }

• POST

  update_event

  Change the date, venue, lineup, description or ticket links of a draft or published event.

  asks first write

  Changes only the fields you pass, on a published event or a draft. Bandsintown notifies followers of changes unless Notify my Followers is off; notify_followers defaults to false here, so set it to true only for changes fans must hear about, such as a new venue. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/bandsintown/update_event

  Input

  Input: update_event

  Parameter	Type	Description
  event_id required	string	Event ID from list_events.
  fields required	object	Any of starts_at, venue_id, custom_location, title, description, lineup, ticket_links.
  notify_followers	boolean	Alert followers about the change. Default: false.

  Example response

  {
    "event_id": "1037728455",
    "status": "published",
    "starts_at": "2026-11-21T20:00:00+00:00",
    "ticket_links": [
      {
        "url": "https://tickets.example.com/yourband-leeds",
        "type": "tickets"
      }
    ],
    "followers_notified": false
  }

• POST

  publish_event

  Publish a draft now or at a set time, optionally notifying followers.

  asks first write

  Publishes a draft now, or schedules it, as the dashboard's Publish and Schedule to Publish do. With notify_followers on, Bandsintown alerts followers. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/bandsintown/publish_event

  Input

  Input: publish_event

  Parameter	Type	Description
  event_id required	string	Event ID from list_events.
  publish_at	datetime	Schedule for later. Default: now.
  notify_followers	boolean	Alert followers. Default: true.

  Example response

  {
    "event_id": "1037728501",
    "status": "scheduled",
    "publish_at": "2026-10-16T10:00:00+01:00",
    "followers_notified": true
  }

• POST

  delete_event

  Remove an event from your artist page.

  asks first write

  Deletes one event from your artist page, as the red X on the Events page does. It cannot be undone with a tool, so you re-create the event if needed. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/bandsintown/delete_event

  Input

  Input: delete_event

  Parameter	Type	Description
  event_id required	string	Event ID from list_events.

  Example response

  {
    "event_id": "1037728501",
    "status": "deleted"
  }

• POST

  send_fan_message

  Post to your followers by push notification and email, now or at a set time.

  asks first write

  Sends a Bandsintown post to your followers: push notification to fans who have enabled it, and email. Send now or schedule with send_at. Add your Smart Link so fans can find your shows. Your latest non-targeted post shows at the top of your artist page. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/bandsintown/send_fan_message

  Input

  Input: send_fan_message

  Parameter	Type	Description
  artist_id	string	Artist page you manage. Default: your first artist.
  body required	string	Post text. Include your Smart Link.
  send_at	datetime	Schedule for later. Default: now.

  Example response

  {
    "message_id": "msg_20418",
    "status": "scheduled",
    "send_at": "2026-10-16T10:00:00+01:00"
  }

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.