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
MCP server

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.
All reasons and checks

yosefhayim/ebay-mcp

Install

Manual install

npm install -g ebay-mcp

The README recommends this route. Then `npm run setup` walks through keys, OAuth and client configuration.

Access and checks

How we review

Broad 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_ID required
Application Client ID from the eBay Developer Portal.
EBAY_CLIENT_SECRET required, secret
Application Client Secret.
EBAY_ENVIRONMENT required
Environment: `sandbox` or `production`.
EBAY_REDIRECT_URI
RuName for user OAuth.
EBAY_USER_REFRESH_TOKEN secret
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.

Official

Hosted MCP server for Amazon Ads and Seller Central: the agent reviews ACoS, search terms and stock, edits on confirmation

MCP serverBroad access29Repository stars
Russian stack

MCP servers for Wildberries, Ozon, Yandex Market and Avito seller accounts via official APIs with write confirmation

MCP serverBroad access62Repository stars
Official

Needle MCP puts outbound sales into agent tools: lead lists, LinkedIn, Instagram and email outreach, and drafts for review.

MCP serverBroad access104Repository stars

Read-only MCP servers for order, refund and ad data from Chinese platforms: Douyin Shop, Taobao, JD, Kuaishou and others

MCP serverExtended access99Repository stars
Russian stack

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

MCP serverExtended access
Russian stack

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

MCP serverBroad access1Repository stars

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.

README badge

Report a problem