recommendations
Pack: seatgeek · 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/recommendations for the schema, then POST the same URL with its arguments for the data.
Get ranked SeatGeek event recommendations SIMILAR TO a seed you supply — a performer id, an event id, or the performers of an event. Requires at least one seed; it is not a personalized feed for an anonymous user. Optional filters (geoip, lat/lon, postal_code, datetime_utc, per_page) narrow the result.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
postal_code | string | no | Restrict recommendations to a US postal code, e.g. “94002”. |
lat | number | no | Latitude to rank recommendations around; pair with lon. |
lon | number | no | Longitude to rank recommendations around; pair with lat. |
per_page | number | no | Results per page (default 10). |
Example call
Arguments
{
"performers.id": 35,
"per_page": 10
}curl
curl -X POST https://gateway.pipeworx.io/seatgeek/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"recommendations","arguments":{"performers.id":35,"per_page":10}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('recommendations', {
"performers.id": 35,
"per_page": 10
});Response shape
| Field | Type | Description |
|---|---|---|
recommendations | array | |
list_data | object | |
meta | object |
Full JSON Schema
{
"type": "object",
"properties": {
"recommendations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"event": {
"type": "object",
"properties": {
"access_method": {
"type": "null"
},
"announce_date": {
"type": "string"
},
"announcements": {
"type": "object",
"properties": {}
},
"conditional": {
"type": "boolean"
},
"contingent": {
"type": "boolean"
},
"created_at": {
"type": "string"
},
"date_tbd": {
"type": "boolean"
},
"datetime_local": {
"type": "string"
},
"datetime_tbd": {
"type": "boolean"
},
"datetime_utc": {
"type": "string"
},
"tbd_datetime_range_start_utc": {
"type": "null"
},
"tbd_datetime_range_end_utc": {
"type": "null"
},
"description": {
"type": "string"
},
"onsale": {
"type": "null"
},
"display_config": {
"type": "object",
"properties": {
"checkout_seat_numbers_required": {
"type": "boolean"
},
"event_page_all_in_pricing_default": {
"type": "boolean"
},
"global_all_in_pricing_default": {
"type": "boolean"
},
"itemization_required": {
"type": "boolean"
},
"listing_detail_all_in_pricing_default": {
"type": "boolean"
},
"order_fee_required_in_aip": {
"type": "boolean"
},
"primary_sale_taxes_required_in_aip": {
"type": "boolean"
},
"secondary_sale_taxes_required_in_aip": {
"type": "boolean"
},
"secondary_marketplace_banner_required": {
"type": "boolean"
},
"above_face_value_banner_required": {
"type": "boolean"
},
"secondary_marketplace_banner_emphasis_required": {
"type": "boolean"
}
}
},
"enddatetime_utc": {
"type": "string"
},
"sales_end_datetime_utc": {
"type": [
"null",
"string"
]
},
"expected_experience_end": {
"type": [
"null",
"string"
]
},
"event_promotion": {
"type": "null"
},
"game_number": {
"type": "number"
},
"home_game_number": {
"type": "number"
},
"id": {
"type": "number"
},
"integrated": {
"type": [
"null",
"object"
],
"properties": {
"provider_name": {
"type": "string"
},
"provider_id": {
"type": "string"
}
}
},
"is_open": {
"type": "boolean"
},
"is_visible": {
"type": "boolean"
},
"is_visible_override": {
"type": "string"
},
"links": {
"type": "array",
"items": {}
},
"main_event_id": {
"type": "null"
},
"performers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"name": {
"type": "string"
},
"image": {
"type": "string"
},
"id": {
"type": "number"
},
"images": {
"type": "object",
"properties": {
"huge": {
"type": "string"
}
}
},
"divisions": {
"type": "null"
},
"has_upcoming_events": {
"type": "boolean"
},
"primary": {
"type": "boolean"
},
"stats": {
"type": "object",
"properties": {
"event_count": {
"type": "number"
}
}
},
"taxonomies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"parent_id": {
"type": "null"
},
"seo_event_type": {
"type": "string"
},
"rank": {
"type": "number"
}
}
}
},
"image_attribution": {
"type": "string"
},
"url": {
"type": "string"
},
"score": {
"type": "number"
},
"slug": {
"type": "string"
},
"home_venue_id": {
"type": "null"
},
"short_name": {
"type": "string"
},
"num_upcoming_events": {
"type": "number"
},
"colors": {
"type": "null"
},
"image_license": {
"type": "string"
},
"genres": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"primary": {
"type": "boolean"
}
}
}
},
"popularity": {
"type": "number"
},
"home_team": {
"type": "boolean"
},
"away_team": {
"type": "boolean"
},
"hidden": {
"type": "boolean"
},
"location": {
"type": "null"
},
"image_rights_message": {
"type": "string"
},
"is_event": {
"type": "boolean"
},
"ada_dominant_image_color": {
"type": "string"
}
}
}
},
"performer_order": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"ordinal": {
"type": "number"
}
}
}
},
"playoffs": {
"type": "null"
},
"popularity": {
"type": "number"
},
"regulation": {
"type": "null"
},
"score": {
"type": "number"
},
"season_stage": {
"type": "null"
},
"short_title": {
"type": "string"
},
"stats": {
"type": "object",
"properties": {
"listing_count": {
"type": "number"
},
"ticket_count": {
"type": "number"
},
"average_price": {
"type": "number"
},
"lowest_price_good_deals": {
"type": "number"
},
"lowest_price": {
"type": "number"
},
"highest_price": {
"type": "number"
},
"visible_listing_count": {
"type": "number"
},
"dq_bucket_counts": {
"type": "array",
"items": {}
},
"median_price": {
"type": "number"
},
"lowest_sg_base_price": {
"type": "number"
},
"lowest_sg_base_price_good_deals": {
"type": "number"
}
}
},
"status": {
"type": "string"
},
"taxonomies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"parent_id": {
"type": "null"
},
"seo_event_type": {
"type": "string"
},
"rank": {
"type": "number"
}
}
}
},
"ticketmaster": {
"type": [
"null",
"string"
]
},
"tdc_pv_id": {
"type": "number"
},
"tdc_pvo_id": {
"type": "number"
},
"time_tbd": {
"type": "boolean"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"venue": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"name_v2": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"timezone": {
"type": "string"
},
"score": {
"type": "number"
},
"popularity": {
"type": "number"
},
"address": {
"type": "string"
},
"country": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"slug": {
"type": "string"
},
"metro_code": {
"type": "number"
},
"capacity": {
"type": "number"
},
"hidden": {
"type": "boolean"
},
"links": {
"type": "array",
"items": {}
},
"extended_address": {
"type": "string"
},
"access_method": {
"type": "null"
},
"location": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lon": {
"type": "number"
}
}
},
"has_upcoming_events": {
"type": "boolean"
},
"num_upcoming_events": {
"type": "number"
},
"url": {
"type": "string"
},
"marquee_city": {
"type": "null"
},
"sg_market_area": {
"type": "number"
},
"display_location": {
"type": "string"
}
}
},
"visible_at": {
"type": "string"
},
"visible_until_utc": {
"type": "string"
},
"open_domain_id": {
"type": "string"
},
"open_id": {
"type": "string"
},
"event_group_ids": {
"type": "array",
"items": {
"type": "number"
}
},
"type": {
"type": "string"
},
"taxonomy_id": {
"type": "number"
},
"home_team": {
"type": "null"
},
"away_team": {
"type": "null"
},
"approved": {
"type": "boolean"
},
"general_admission": {
"type": "boolean"
},
"inventory_config": {
"type": "array",
"items": {
"type": "object",
"properties": {
"market": {
"type": "string"
},
"enabled_datetime": {
"type": "string"
},
"disabled_datetime": {
"type": "null"
},
"is_disabled": {
"type": "boolean"
}
}
}
}
}
},
"score": {
"type": "number"
}
}
}
},
"list_data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"list_key": {
"type": "string"
},
"style_type": {
"type": "string"
}
}
},
"meta": {
"type": "object",
"properties": {
"total": {
"type": "number"
},
"per_page": {
"type": "number"
},
"page": {
"type": "number"
},
"status": {
"type": "number"
},
"geolocation": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lon": {
"type": "number"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"display_name": {
"type": "string"
},
"metro_code": {
"type": "string"
},
"sg_market_area_id": {
"type": "string"
},
"range": {
"type": "string"
}
}
}
}
}
}
}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 seatgeek pack
{
"mcpServers": {
"seatgeek": {
"url": "https://gateway.pipeworx.io/seatgeek/mcp"
}
}
}See Getting Started for client-specific install steps.