`cities`

Pack: setlist-fm · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/cities for the schema, then POST the same URL with its arguments for the data.

Search setlist.fm for cities by name or country. Returns city name, state, country, and geolocation coordinates. Useful for resolving city identifiers before searching setlists or venues.

Parameters

Name	Type	Required	Description
`name`	string	no	City name, e.g. “Berlin”. At least one of name/country is required.
`country`	string	no	ISO 3166-1 alpha-2 country code — “DE”, not “Germany”. Call `countries` for the full list.
`p`	number	no

Example call

Arguments

{
  "name": "Berlin",
  "country": "DE"
}

curl

curl -X POST https://gateway.pipeworx.io/setlist-fm/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cities","arguments":{"name":"Berlin","country":"DE"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('cities', {
  "name": "Berlin",
  "country": "DE"
});

Response shape

Field	Type	Description
`itemsPerPage`	number	Items per page
`page`	number	Current page
`total`	number	Total cities
`city`	array	Search result cities

Full JSON Schema

{
  "type": "object",
  "properties": {
    "itemsPerPage": {
      "type": "number",
      "description": "Items per page"
    },
    "page": {
      "type": "number",
      "description": "Current page"
    },
    "total": {
      "type": "number",
      "description": "Total cities"
    },
    "city": {
      "type": "array",
      "description": "Search result cities",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "City ID"
          },
          "name": {
            "type": "string",
            "description": "City name"
          },
          "state": {
            "type": "string",
            "description": "State/Province"
          },
          "stateCode": {
            "type": "string",
            "description": "State code"
          },
          "coords": {
            "type": "object",
            "description": "Coordinates"
          },
          "country": {
            "type": "object",
            "description": "Country"
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the setlist-fm pack

{
  "mcpServers": {
    "setlist-fm": {
      "url": "https://gateway.pipeworx.io/setlist-fm/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

cities