`events`

Pack: bandsintown · Endpoint: https://gateway.pipeworx.io/bandsintown/mcp

Search Bandsintown live events globally by date range, location (city or lat/lon), and radius; returns events with artist, venue, datetime, ticket URL, and lineup.

Parameters

Name	Type	Required
`date`	string	no
`location`	string	no
`radius`	number	no
`page`	number	no

Example call

Arguments

{
  "location": "New York, NY"
}

curl

curl -X POST https://gateway.pipeworx.io/bandsintown/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"events","arguments":{"location":"New York, NY"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('events', {
  "location": "New York, NY"
});

More examples

{
  "date": "2024-07-20",
  "location": "Los Angeles, CA",
  "radius": 25,
  "page": 1
}

Response shape

Always returns: items, count

Field	Type	Description
`items`	array	List of global events matching filters
`count`	integer	Number of items returned.

Full JSON Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Event ID"
          },
          "artist_id": {
            "type": "integer",
            "description": "Artist ID"
          },
          "url": {
            "type": "string",
            "description": "Event URL on Bandsintown"
          },
          "datetime": {
            "type": "string",
            "description": "Event date and time in ISO format"
          },
          "title": {
            "type": "string",
            "description": "Event title"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Event description if available"
          },
          "lineup": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "List of performing artists"
          },
          "offers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "description": "Offer type"
                },
                "url": {
                  "type": "string",
                  "description": "Offer URL"
                },
                "status": {
                  "type": "string",
                  "description": "Offer status"
                }
              }
            },
            "description": "Ticket offers"
          },
          "venue": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Venue name"
              },
              "url": {
                "type": "string",
                "description": "Venue URL"
              },
              "city": {
                "type": "string",
                "description": "Venue city"
              },
              "region": {
                "type": "string",
                "description": "Venue region/state"
              },
              "country": {
                "type": "string",
                "description": "Venue country"
              },
              "latitude": {
                "type": "number",
                "description": "Venue latitude"
              },
              "longitude": {
                "type": "number",
                "description": "Venue longitude"
              }
            },
            "description": "Venue information"
          }
        }
      },
      "description": "List of global events matching filters"
    },
    "count": {
      "type": "integer",
      "description": "Number of items returned."
    }
  },
  "required": [
    "items",
    "count"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "bandsintown": {
      "url": "https://gateway.pipeworx.io/bandsintown/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

events