mcp-ebay
Provides tools to search products, view item details, track and place bids, make Buy It Now purchases, view order history, and track shipments on eBay via browser automation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-ebay search for vintage rolex watches"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@striderlabs/mcp-ebay
MCP (Model Context Protocol) server connector for eBay. Enables AI agents to search products, view item details, track and place bids, make Buy It Now purchases, view order history, and track shipments — all via browser automation with Playwright.
Features
Tool | Description |
| Search eBay by keyword with filters (price, condition, sort) |
| Full item details: price, condition, specs, seller info, images |
| View bid history and auction status |
| Place a maximum bid on an auction |
| Initiate a Buy It Now purchase and proceed to checkout |
| List your past eBay purchases |
| Track a shipment by tracking number or order item |
Related MCP server: eBay MCP Server
Installation
npm install -g @striderlabs/mcp-ebayOr install Playwright browsers after installing:
npx playwright install chromiumUsage with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"ebay": {
"command": "npx",
"args": ["-y", "@striderlabs/mcp-ebay"]
}
}
}Usage with Claude Code
claude mcp add ebay -- npx -y @striderlabs/mcp-ebayTool Reference
search_products
{
"query": "vintage rolex watch",
"max_results": 10,
"min_price": 500,
"max_price": 5000,
"condition": "1000",
"sort": "15"
}Condition codes: 1000=New, 2000=Refurbished, 3000=Used
Sort codes: 12=Best Match, 15=Ending Soonest, 16=Newly Listed, 3=Price Lowest
get_item_details
{ "item_id": "123456789012" }track_bids
{ "item_id": "123456789012" }place_bid
{
"item_id": "123456789012",
"bid_amount": 75.00,
"username": "your@email.com",
"password": "yourpassword"
}buy_it_now
{
"item_id": "123456789012",
"username": "your@email.com",
"password": "yourpassword",
"quantity": 1
}Note: This proceeds to the eBay checkout page. Final payment must be completed on eBay.
view_order_history
{
"username": "your@email.com",
"password": "yourpassword",
"days": 60
}track_shipment
{ "tracking_number": "1Z999AA10123456784" }Or by item ID (requires login):
{
"item_id": "123456789012",
"username": "your@email.com",
"password": "yourpassword"
}Security Notes
Credentials are passed per-call and never stored
Browser sessions are closed after each tool call
Runs headless Chromium — no UI required
For production use, consider using environment variables for credentials
Development
git clone https://github.com/markswendsen-code/mcp-ebay
cd mcp-ebay
npm install
npm run buildLicense
MIT
Available Tools
7 toolsbuy_it_nowA
Purchase an eBay item immediately using Buy It Now. Proceeds to checkout — final payment must be completed on eBay.
Inputs: item_id (required), password (required), username (required), quantity.
get_item_detailsA
Get full details for an eBay item by its item ID, including price, condition, seller info, and specs.
Inputs: item_id (required).
place_bidB
Place a bid on an eBay auction item. Requires eBay credentials.
Inputs: item_id (required), password (required), username (required), bid_amount (required).
search_productsA
Search eBay for products by keyword, with optional filters for price, condition, and sort order.
Inputs: query (required), sort, condition, max_price, +2 more.
track_bidsA
View the current bid history and status for an eBay auction item.
Inputs: item_id (required).
track_shipmentA
Track a shipment by tracking number, or look up tracking for a specific item from your order history.
Inputs: item_id, password, username, tracking_number.
view_order_historyA
View your eBay purchase history. Requires eBay credentials.
Inputs: password (required), username (required), days.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: searching, viewing details, tracking bids, placing bids, buying, viewing orders, and tracking shipments. No overlapping responsibilities confuse an agent's selection.
All tools follow a consistent verb_noun pattern in snake_case (e.g., search_products, place_bid, track_shipment). Minor pluralization differences (track_bids vs place_bid) do not break the pattern.
With 7 tools, the set is well-scoped for an eBay buyer-centric server. Each tool covers a distinct aspect of the buying workflow—search, item details, bidding, purchasing, order history, and shipment tracking—without bloat.
The tool surface covers core buyer workflows: searching, inspecting items, bidding, buying, viewing orders, and tracking shipments. Minor gaps like canceling orders or leaving feedback are not critical for most use cases but prevent a perfect score.
Maintenance
Related MCP Connectors
Playwright browser automation — navigate, click, fill forms, extract, screenshot — 17 agent tools.
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI models to find the best online deals by browsing and interacting with multiple shopping platforms like Amazon and eBay across various regions. It uses Playwright to automate searches and retrieve product information from compatible e-commerce and deal-tracking websites.11 npm3MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search eBay listings, track item prices over time, and identify deals below market value using eBay's APIs. It provides tools for category browsing and retrieving detailed information for specific listings.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to control a web browser using Playwright, supporting navigation, interaction, and data extraction through natural language.MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to perform browser automation using Playwright, including navigation, content extraction, screenshot analysis, and custom script execution.520 npmMIT