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.

Functions
11
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just StubHub

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/stubhub
Every site

One MCP server for StubHub and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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.

Read 10
  • 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

    NameTypeRequired
    args{ query: string } | stringYes

    Returns stubhubFindEventsToSellResult

    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;
    }
    
    interface stubhubFindEventsToSellResult {
      query: string;
      matches: stubhubSellMatch[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/stubhub/findEventsToSell

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    args{ query: string; site?: "stubhub" | "viagogo" } | stringYes

    Returns stubhubFindPerformersResult

    type 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/findPerformers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    args{ query: string; site?: "stubhub" | "viagogo" } | stringYes

    Returns stubhubFindVenuesResult

    type 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/findVenues

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    args{ eventId: string; listingId: string; site?: "stubhub" | "viagogo" }Yes

    Returns stubhubCheckoutHandoff

    type 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/getCheckoutHandoff

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.stubhub.getCheckoutHandoff({ eventId: "1", listingId: "1" });
  • getEventReturns one event's details.

    Arguments

    NameTypeRequired
    args{ eventId: string; site?: "stubhub" | "viagogo" } | { url: string } | stringYes

    Returns stubhubEventDetail

    type 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/getEvent

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    args{ eventId: string; site?: "stubhub" | "viagogo" } | { url: string } | stringYes

    Returns stubhubEventPage

    type 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/getEventListings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    args{ query?: string } | stringNo

    Returns stubhubListCategoriesResult

    interface 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/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.stubhub.listCategories();
  • listFavoritesThe signed-in caller's followed performers, teams and venues.

    Arguments

    None.

    Returns stubhubFavoritesResult

    interface 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/listFavorites

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.stubhub.listFavorites();
  • listMyOrdersThe signed-in caller's own order history.

    Arguments

    None.

    Returns stubhubOrdersResult

    interface 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/listMyOrders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.stubhub.listMyOrders();
Act 1
  • createListingPublishes a ticket listing for sale on one of the caller's own events, at a given price and quantity.

    Arguments

    NameTypeRequired
    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 stubhubListingResult

    interface 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/createListing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.stubhub.createListing({});

Use it from code