StubHub MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on StubHub: 11 typed functions through one MCP server. No StubHub API key needed.
- Site
- stubhub.com
- Functions
- 11
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for StubHub alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/stubhubOne MCP server for StubHub and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
findEventsToSellThe seller side of the marketplace: searches StubHub's own event-finder (sell.stubhub.com) for a performer, team or event name and returns the…Arguments
Name Type Required args{ query: string } | stringYes Returns
stubhubFindEventsToSellResultinterface stubhubSellMatch { id: string; // pass to the seller flow's own /SellTickets/FindEvent/<id> title: string; group: string | null; // the search's own label: "Top Result", "Performers", … url: string; } interface stubhubFindEventsToSellResult { query: string; matches: stubhubSellMatch[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/stubhub/findEventsToSellCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.stubhub.findEventsToSell({ query: "metallica" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.stubhub.findEventsToSell({"query": "metallica"}))curl -X POST https://api.bowmark.ai/v1/sites/stubhub/findEventsToSell \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"metallica"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.stubhub.findEventsToSell({ query: "metallica" });findPerformersFinds a performer, artist or sports team by name and returns its id, display name and category ("Concert", "Sports", "Theater", …), for a caller who…Arguments
Name Type Required args{ query: string; site?: "stubhub" | "viagogo" } | stringYes Returns
stubhubFindPerformersResulttype stubhubSite = "stubhub" | "viagogo"; interface stubhubPerformerMatch { id: string; // StubHub's own performer id, from its /performer/<id> url name: string; kind: string | null; // "Concert", "Sports", "Theater", … url: string; } interface stubhubFindPerformersResult { site: stubhubSite; query: string; performers: stubhubPerformerMatch[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/stubhub/findPerformersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.stubhub.findPerformers({ query: "metallica" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.stubhub.findPerformers({"query": "metallica"}))curl -X POST https://api.bowmark.ai/v1/sites/stubhub/findPerformers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"metallica"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.stubhub.findPerformers({ query: "metallica" });findVenuesFinds a venue by name and returns its id, display name and StubHub's own page url for it, for a caller who knows WHERE before they know WHAT.Arguments
Name Type Required args{ query: string; site?: "stubhub" | "viagogo" } | stringYes Returns
stubhubFindVenuesResulttype stubhubSite = "stubhub" | "viagogo"; interface stubhubVenueMatch { id: string; name: string; url: string; } interface stubhubFindVenuesResult { site: stubhubSite; query: string; venues: stubhubVenueMatch[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/stubhub/findVenuesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.stubhub.findVenues({ query: "madison square garden" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.stubhub.findVenues({"query": "madison square garden"}))curl -X POST https://api.bowmark.ai/v1/sites/stubhub/findVenues \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"madison square garden"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.stubhub.findVenues({ query: "madison square garden" });getCheckoutHandoffGiven a listing id from getEventListings, resolves StubHub's own checkout URL for that listing (/secure/buy/...), without submitting or paying…Arguments
Name Type Required args{ eventId: string; listingId: string; site?: "stubhub" | "viagogo" }Yes Returns
stubhubCheckoutHandofftype stubhubSite = "stubhub" | "viagogo"; interface stubhubCheckoutHandoff { eventId: string; site: stubhubSite; listingId: string; checkoutUrl: string; // StubHub's own /secure/buy/... url, nothing submitted or paid }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/stubhub/getCheckoutHandoffCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.stubhub.getCheckoutHandoff({ eventId: "1", listingId: "1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.stubhub.getCheckoutHandoff({"eventId": "1", "listingId": "1"}))curl -X POST https://api.bowmark.ai/v1/sites/stubhub/getCheckoutHandoff \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"eventId":"1","listingId":"1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.stubhub.getCheckoutHandoff({ eventId: "1", listingId: "1" });getEventReturns one event's details.Arguments
Name Type Required args{ eventId: string; site?: "stubhub" | "viagogo" } | { url: string } | stringYes Returns
stubhubEventDetailtype stubhubSite = "stubhub" | "viagogo"; interface stubhubTier { // a general-admission tier, festivals and passes sell these, not seats name: string; // e.g. "General Admission", "Super VIP" fromPrice: number | null; // the tier's "From" all-in price per ticket; null when sold out priceText: string | null; // e.g. "$216" soldOut: boolean; } interface stubhubEventVenue { name: string | null; address: string | null; city: string | null; region: string | null; country: string | null; } interface stubhubEventDetail { id: string; site: stubhubSite; name: string; url: string; startDate: string | null; venue: stubhubEventVenue; currency: string | null; lowestPrice: number | null; highestPrice: number | null; tiers: stubhubTier[]; listingsShown: number; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/stubhub/getEventCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.stubhub.getEvent({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.stubhub.getEvent({}))curl -X POST https://api.bowmark.ai/v1/sites/stubhub/getEvent \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.stubhub.getEvent({});getEventListingsReturns the resale ticket listings one event page shows first (about ten): section, row, seats, all-in price per ticket and how many tickets each…Arguments
Name Type Required args{ eventId: string; site?: "stubhub" | "viagogo" } | { url: string } | stringYes Returns
stubhubEventPagetype stubhubSite = "stubhub" | "viagogo"; interface stubhubListing { id: string; section: string | null; row: string | null; seats: string | null; price: number; // all-in per ticket, fees included, in the event's currency priceText: string; // e.g. "$160" quantity: number | null; // tickets the listing sells together quantityText: string | null; } interface stubhubTier { // a general-admission tier, festivals and passes sell these, not seats name: string; // e.g. "General Admission", "Super VIP" fromPrice: number | null; // the tier's "From" all-in price per ticket; null when sold out priceText: string | null; // e.g. "$216" soldOut: boolean; } interface stubhubEventVenue { name: string | null; address: string | null; city: string | null; region: string | null; country: string | null; } interface stubhubEventPage { id: string; site: stubhubSite; name: string; url: string; startDate: string | null; // venue-local, no zone venue: stubhubEventVenue; currency: string | null; // e.g. "USD" listings: stubhubListing[]; // the ~10 the page shows first, page order, not the full inventory tiers: stubhubTier[]; // set instead of listings on a general-admission page (festival, pass) lowestPrice: number | null; // of those listings, or of the tiers' "From" prices highestPrice: number | null; warnings: string[]; // non-empty = the page says tickets are on sale but nothing readable came back }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/stubhub/getEventListingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.stubhub.getEventListings({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.stubhub.getEventListings({}))curl -X POST https://api.bowmark.ai/v1/sites/stubhub/getEventListings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.stubhub.getEventListings({});listCategoriesReturns the genre/category taxonomy StubHub organizes events under (concerts by genre, sports by league, theater, family, etc.), each with its own id…Arguments
Name Type Required args{ query?: string } | stringNo Returns
stubhubListCategoriesResultinterface stubhubCategory { id: string; name: string; url: string; } interface stubhubListCategoriesResult { categories: stubhubCategory[]; query: string | null; // echoes the caller's filter, or null for the curated default sample warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/stubhub/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.stubhub.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.stubhub.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/stubhub/listCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.stubhub.listCategories();listFavoritesThe signed-in caller's followed performers, teams and venues.Arguments
None.
Returns
stubhubFavoritesResultinterface stubhubFavorite { id: string; name: string | null; kind: string | null; url: string | null; } interface stubhubFavoritesResult { favorites: stubhubFavorite[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/stubhub/listFavoritesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.stubhub.listFavorites();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.stubhub.listFavorites())curl -X POST https://api.bowmark.ai/v1/sites/stubhub/listFavorites \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.stubhub.listFavorites();listMyOrdersThe signed-in caller's own order history.Arguments
None.
Returns
stubhubOrdersResultinterface stubhubOrder { id: string; eventName: string | null; eventUrl: string | null; status: string | null; // the site's own labels, read the values off a result, never guess one from prose price: number | null; quantity: number | null; } interface stubhubOrdersResult { orders: stubhubOrder[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/stubhub/listMyOrdersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.stubhub.listMyOrders();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.stubhub.listMyOrders())curl -X POST https://api.bowmark.ai/v1/sites/stubhub/listMyOrders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.stubhub.listMyOrders();searchRuns the site's own search for a performer, team, event or venue name and returns the matching events.Arguments
Name Type Required args{ query: string; site?: "stubhub" | "viagogo" } | stringYes Returns
stubhubSearchResulttype stubhubSite = "stubhub" | "viagogo"; interface stubhubEvent { id: string; // pass to getEvent / getEventListings name: string; url: string; startsAt: string | null; // ISO, UTC localDateText: string | null; // as the site prints it, venue-local venue: string | null; city: string | null; region: string | null; country: string | null; hasActiveListings: boolean; // false = nothing for sale right now } interface stubhubPerformerHit { id: string; name: string; kind: string | null; // "Concert", "Sports", "Theater", … url: string; } interface stubhubSearchResult { site: stubhubSite; query: string; totalCount: number; // matches the site reports; events is its first page of 20 events: stubhubEvent[]; performers: stubhubPerformerHit[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/stubhub/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.stubhub.search({ query: "metallica" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.stubhub.search({"query": "metallica"}))curl -X POST https://api.bowmark.ai/v1/sites/stubhub/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"metallica"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.stubhub.search({ query: "metallica" });
createListingPublishes a ticket listing for sale on one of the caller's own events, at a given price and quantity.Arguments
Name Type Required args{ match: stubhubSellMatch | string; price: number; quantity: number }Yes interface stubhubSellMatch { id: string; // pass to the seller flow's own /SellTickets/FindEvent/<id> title: string; group: string | null; // the search's own label: "Top Result", "Performers", … url: string; }Returns
stubhubListingResultinterface stubhubListingResult { match: string; // the sell-flow match url this was submitted against price: number; quantity: number; listed: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/stubhub/createListingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.stubhub.createListing({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.stubhub.createListing({}))curl -X POST https://api.bowmark.ai/v1/sites/stubhub/createListing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.stubhub.createListing({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/stubhub/<function> - OpenAPI
/v1/sites/stubhub/openapi.json