eBay MCP server for AI agents

Let Claude, ChatGPT or your own agent read eBay: 10 typed functions through one MCP server. No eBay API key needed.

Functions
10
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just eBay

An MCP server for eBay 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/ebay
Every site

One MCP server for eBay 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

Open a function to see its arguments, what it returns and how to call it.

Read 10
  • getDealsReads eBay's own /deals page.

    Arguments

    None.

    Returns ebayDeal[]

    interface ebayDeal {
      itemId: string;
      title: string;
      price: { value: string; currency: string } | null;
      originalPrice: { value: string; currency: string } | null;  // null when this tile carries no discount
      discountPercent: number | null;  // null when this tile carries no discount
      url: string;
      imageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ebay/getDeals

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ebay.getDeals();
  • getItemReads one eBay listing by item id or URL.

    Arguments

    NameTypeRequired
    argsstring | { itemId: string; marketplace?: "US" | "DE" }Yes

    Returns ebayItemDetail

    interface ebayItemDetail {
      itemId: string;
      title: string;
      shortDescription: string | null;
      price: { value: string; currency: string } | null;
      condition: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      buyingOptions: string[];
      url: string;
      imageUrl: string | null;
      seller: { username: string | null; feedbackScore: number | null; feedbackPercentage: string | null };
      itemLocation: { city: string | null; stateOrProvince: string | null; country: string | null } | null;
      shipping: { costType: string | null; cost: { value: string; currency: string } | null } | null;
      currentBidPrice: { value: string; currency: string } | null;  // auctions only
      bidCount: number | null;  // auctions only
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ebay/getItem

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ebay.getItem("<args>");
  • getMyListingsGet the caller's own active selling listings.

    Arguments

    NameTypeRequired
    args{ limit?: number }No

    Returns ebayItem[]

    interface ebayItem {
      itemId: string;
      title: string;
      price: { value: string; currency: string } | null;
      condition: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      buyingOptions: string[];
      url: string;
      imageUrl: string | null;
      seller: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ebay/getMyListings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ebay.getMyListings();
  • getSellerListingsSearches one seller's own eBay listings for a keyword by seller username and query.

    Arguments

    NameTypeRequired
    args{ seller: string; query: string; limit?: number }Yes

    Returns ebayItem[]

    interface ebayItem {
      itemId: string;
      title: string;
      price: { value: string; currency: string } | null;
      condition: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      buyingOptions: string[];
      url: string;
      imageUrl: string | null;
      seller: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ebay/getSellerListings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ebay.getSellerListings({});
  • getSellerProfileReads one seller's public feedback profile by username.

    Arguments

    NameTypeRequired
    argsstring | { seller: string }Yes

    Returns ebaySellerProfile

    interface ebaySellerProfile {
      username: string;
      feedbackScore: number | null;  // eBay's lifetime feedback score
      feedbackPercentage: string | null;  // positive feedback, last 12 months, e.g. "99.1"; null when eBay prints none
      sellerType: "business" | "individual";  // "business" only when eBay prints "Registered as a business seller"
      memberSince: string | null;
      location: string | null;  // the country eBay prints beside "Member since", e.g. "United Kingdom"
      storeUrl: string | null;  // the seller's eBay Store, when they run one
      profileUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ebay/getSellerProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ebay.getSellerProfile("musicmagpie");
  • getWatchlistGet the caller's watch list.

    Arguments

    NameTypeRequired
    args{ limit?: number }No

    Returns ebayWatchlistItem[]

    interface ebayItem {
      itemId: string;
      title: string;
      price: { value: string; currency: string } | null;
      condition: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      buyingOptions: string[];
      url: string;
      imageUrl: string | null;
      seller: string | null;
    }
    
    interface ebayWatchlistItem extends ebayItem {
      watchlistPosition: number;  // 1-indexed position in the watchlist
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ebay/getWatchlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ebay.getWatchlist();
  • searchAutocompleteReads eBay's own search-box autosuggest.

    Arguments

    NameTypeRequired
    argsstring | { query: string; marketplace?: "US" | "DE" }Yes

    Returns ebayAutocompleteResult

    interface ebayAutocompleteResult {
      suggestions: string[];
      categories: { categoryId: string; name: string }[];  // empty when eBay associates none
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ebay/searchAutocomplete

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ebay.searchAutocomplete({ query: "running shoes" });
  • searchByCategorySearches one eBay category through eBay's documented Browse API by id, with an optional keyword narrowing within it.

    Arguments

    NameTypeRequired
    argsstring | { categoryId: string; query?: string; limit?: number }Yes

    Returns ebayItem[]

    interface ebayItem {
      itemId: string;
      title: string;
      price: { value: string; currency: string } | null;
      condition: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      buyingOptions: string[];
      url: string;
      imageUrl: string | null;
      seller: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ebay/searchByCategory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ebay.searchByCategory({ categoryId: "15709" });
  • searchSoldSold prices from PriceCharting's record of completed eBay sales; covers video games, consoles, trading cards, comics and Lego only, in USD for…

    Arguments

    NameTypeRequired
    argsstring | { query: string; site?: "ebay.com"; limit?: number }Yes

    Returns ebaySoldSearch

    interface ebaySoldItem {
      title: string;
      price: number;        // what it SOLD for, never the asking price
      currency: string;     // "USD"
      soldDate: string;     // ISO date, YYYY-MM-DD
      url: string;          // the listing's own ebay.com page
      itemId: string;
      condition: string | null; // "Used" | "New" | "Complete in box" | "Graded"
      format?: "auction" | "buy_it_now" | "best_offer"; // absent: the source does not publish it
      shipping?: number;    // absent: the source does not publish it
    }
    
    interface ebaySoldSummary {
      count: number;
      median: number | null;
      low: number | null;   // 25th percentile
      high: number | null;  // 75th percentile
      currency: string;
    }
    
    interface ebaySoldSearch {
      items: ebaySoldItem[];                         // newest first
      summary: ebaySoldSummary;                      // over returned rows, part sales (box/manual/pieces only) excluded
      byCondition: Record<string, ebaySoldSummary>;  // the same, per condition bucket
      matchedProducts: { title: string; url: string }[];  // the ONE product read; [] if none matched
      nearestProducts: { title: string; url: string }[];  // only when nothing matched: closest titles, NOT matches
      source: "pricecharting.com";
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ebay/searchSold

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ebay.searchSold({ query: "nintendo switch oled" });

Use it from code