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.
- Site
- ebay.com
- Functions
- 10
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/ebayOne MCP server for eBay 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
Open a function to see its arguments, what it returns and how to call it.
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/getDealsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ebay.getDeals();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ebay.getDeals())curl -X POST https://api.bowmark.ai/v1/sites/ebay/getDeals \ -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.ebay.getDeals();getItemReads one eBay listing by item id or URL.Arguments
Name Type Required argsstring | { itemId: string; marketplace?: "US" | "DE" }Yes Returns
ebayItemDetailinterface 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/getItemCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ebay.getItem("<args>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ebay.getItem("<args>"))curl -X POST https://api.bowmark.ai/v1/sites/ebay/getItem \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"<args>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.ebay.getItem("<args>");getMyListingsGet the caller's own active selling listings.Arguments
Name Type Required 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/getMyListingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ebay.getMyListings();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ebay.getMyListings())curl -X POST https://api.bowmark.ai/v1/sites/ebay/getMyListings \ -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.ebay.getMyListings();getSellerListingsSearches one seller's own eBay listings for a keyword by seller username and query.Arguments
Name Type Required 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/getSellerListingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ebay.getSellerListings({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ebay.getSellerListings({}))curl -X POST https://api.bowmark.ai/v1/sites/ebay/getSellerListings \ -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.ebay.getSellerListings({});getSellerProfileReads one seller's public feedback profile by username.Arguments
Name Type Required argsstring | { seller: string }Yes Returns
ebaySellerProfileinterface 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/getSellerProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ebay.getSellerProfile("musicmagpie");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ebay.getSellerProfile("musicmagpie"))curl -X POST https://api.bowmark.ai/v1/sites/ebay/getSellerProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"musicmagpie"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.ebay.getSellerProfile("musicmagpie");getWatchlistGet the caller's watch list.Arguments
Name Type Required 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/getWatchlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ebay.getWatchlist();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ebay.getWatchlist())curl -X POST https://api.bowmark.ai/v1/sites/ebay/getWatchlist \ -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.ebay.getWatchlist();searchRuns an eBay item search through eBay's documented Browse API and returns the matching listings.Arguments
Name Type Required argsstring | { query: string; limit?: number; marketplace?: "US" | "DE" }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/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ebay.search({ query: "running shoes" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ebay.search({"query": "running shoes"}))curl -X POST https://api.bowmark.ai/v1/sites/ebay/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"running shoes"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.ebay.search({ query: "running shoes" });searchAutocompleteReads eBay's own search-box autosuggest.Arguments
Name Type Required argsstring | { query: string; marketplace?: "US" | "DE" }Yes Returns
ebayAutocompleteResultinterface ebayAutocompleteResult { suggestions: string[]; categories: { categoryId: string; name: string }[]; // empty when eBay associates none }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/ebay/searchAutocompleteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ebay.searchAutocomplete({ query: "running shoes" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ebay.searchAutocomplete({"query": "running shoes"}))curl -X POST https://api.bowmark.ai/v1/sites/ebay/searchAutocomplete \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"running shoes"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/searchByCategoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ebay.searchByCategory({ categoryId: "15709" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ebay.searchByCategory({"categoryId": "15709"}))curl -X POST https://api.bowmark.ai/v1/sites/ebay/searchByCategory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"categoryId":"15709"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required argsstring | { query: string; site?: "ebay.com"; limit?: number }Yes Returns
ebaySoldSearchinterface 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/searchSoldCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ebay.searchSold({ query: "nintendo switch oled" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ebay.searchSold({"query": "nintendo switch oled"}))curl -X POST https://api.bowmark.ai/v1/sites/ebay/searchSold \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"nintendo switch oled"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.ebay.searchSold({ query: "nintendo switch oled" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/ebay/<function> - OpenAPI
/v1/sites/ebay/openapi.json