`cities`

Pack: setlist-fm · Endpoint: https://gateway.pipeworx.io/setlist-fm/mcp

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
`name`	string	no
`country`	string	no
`p`	number	no

Example call

Arguments

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

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":"Germany"}}}'

TypeScript (@pipeworx/sdk)

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

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

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, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

cities