eBay MCP
A local MCP server gives an assistant 379 tools for the eBay Sell APIs: listings, orders, payouts, ads and seller analytics.
- 199 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Write tools create, revise and end listings, refund orders and buy postage.
- The server holds your store tokens with access to orders and payouts.
Install
- Works in
Manual install
npm install -g ebay-mcpThe README recommends this route. Then `npm run setup` walks through keys, OAuth and client configuration.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Write tools create, revise and end listings, refund orders and buy postage.
- The server holds your store tokens with access to orders and payouts.
This is third-party code. Review the repository files before installing.
What it does
The server connects Claude Desktop, Claude Code, Cursor and other MCP clients to the eBay Sell, Commerce and Developer APIs. Tool families split into `account`, `finances`, `inventory`, `fulfillment`, `feed`, `stores`, `logistics` and more, and you can enable only the ones you need through `EBAY_MCP_TOOLS` or the `dynamic` mode. It runs locally over stdio or local HTTP with no cloud relay. OAuth 2.0 with automatic token refresh is built in, and on a `429` response the server retries with growing backoff. The `npm run setup` wizard takes your keys, completes OAuth and configures the client. The project is unofficial and not affiliated with eBay Inc.
Who it is for. Sellers and store developers on eBay who want to run listings, orders and reports through a conversation with an assistant.
Good fit when
- A seller asks for unfulfilled orders from the last 7 days and their statuses.
- A payout summary for 30 days and a transactions list with fees are needed.
- The product catalog is edited in bulk: quantities, prices and offers by SKU.
- Shipping, payment and return policies are reviewed before launching a new listing.
Not a fit when
- You only want to browse items as a buyer: the tools target sellers.
- No eBay account and developer keys exist yet.
- Order data must never be sent to an external API.
Example request
Check my eBay API rate limits in the sandbox, then show unfulfilled orders for 7 days. Change nothing yet.MCP
- Transport
- stdio, http
- Authentication
- OAuth
Environment variables
EBAY_CLIENT_IDrequired- Application Client ID from the eBay Developer Portal.
EBAY_CLIENT_SECRETrequired, secret- Application Client Secret.
EBAY_ENVIRONMENTrequired- Environment: `sandbox` or `production`.
EBAY_REDIRECT_URI- RuName for user OAuth.
EBAY_USER_REFRESH_TOKENsecret- User refresh token for higher rate limits.
Limitations
An eBay Developer account, Client ID, Client Secret and RuName are required. A user token gives limits from 10 thousand requests a day, while an application key gives 1000. Write tools change seller data, and `ebay_create_shipment_from_shipping_quote` buys postage. Start with `EBAY_ENVIRONMENT=sandbox`. Local file access for media stays off until `EBAY_MCP_MEDIA_DIRS` or `EBAY_MCP_MEDIA_ROOT` is set.
How to disable. Remove the server from the MCP client configuration and run `npm uninstall -g ebay-mcp`. Revoke tokens in the eBay Developer Portal and delete the `.env` with your keys.
FAQ
Which clients does the wizard configure?
Nine: Claude Desktop, Cursor, Zed, Cline, Continue.dev, Windsurf, Roo Code, Claude Code CLI and Amazon Q Developer. Any MCP client can connect.
How do I verify the connection without changes?
Ask to check API limits: `ebay_get_rate_limits` or `ebay_get_user_rate_limits` runs and no seller data is touched.
How do I shrink the tool set?
Set `EBAY_MCP_TOOLS=dynamic` or a list of families such as `inventory,fulfillment`. The client then sees only the selection.
Is this an official eBay server?
No. It is a community project, not affiliated with or endorsed by eBay Inc. The user follows the eBay API licence terms.
Is a separate server or cloud needed?
No. The server runs on your machine over stdio or local HTTP and your eBay keys stay on the computer.
Discussion
No questions or reviews yet.
Related
MCP serversHosted MCP server for Amazon Ads and Seller Central: the agent reviews ACoS, search terms and stock, edits on confirmation
MCP servers for Wildberries, Ozon, Yandex Market and Avito seller accounts via official APIs with write confirmation
Needle MCP puts outbound sales into agent tools: lead lists, LinkedIn, Instagram and email outreach, and drafts for review.
Read-only MCP servers for order, refund and ad data from Chinese platforms: Douyin Shop, Taobao, JD, Kuaishou and others
A read-only MCP for a Yandex Market seller dashboard: products, orders, prices, stock and reviews, with no write tool at all even if the key has write rights
An MCP server and CLI for the Yandex Market Partner API: 131 actions across orders, prices, stock, shipments and reviews via a search-and-execute pattern
README in short
Covers the Sell, Commerce and Developer APIs, typed in TypeScript with Zod input validation. Interactive MCP Apps views are in beta and only read data.