ebay-mcp
Provides tools for interacting with eBay's Commerce Identity and Buy Browse APIs, enabling user profile verification, item search and retrieval, and automatic token refresh via OAuth 2.0.
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., "@ebay-mcp search for vintage cameras on eBay"
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.
ebay-mcp
eBay Developers Program の OAuth 2.0(User access token) で呼び出す REST API を、Cursor / Claude から使うための Model Context Protocol サーバーです。
実行には Python 3.10 以上が必要です。macOS の /usr/bin/python3 が 3.9 の場合は、/opt/homebrew/bin/python3.11 -m venv .venv のように新しいランタイムで仮想環境を作成してください。
対応していること
Commerce Identity — サインインしたアカウントのプロフィール検証(
GET /commerce/identity/v1/user/)Buy Browse —
item_summary/searchと単品item/{id}の取得トークン更新 —
EBAY_REFRESH_TOKENがあれば 401 時に自動でリフレッシュを試行(プロセス内のみ)OAuth 補助 —
ebay-mcp-authで Authorization Code を取得し、mcp.json用のenv断片を表示
Related MCP server: eBay MCP Server
環境変数(秘密情報はコードに書かない)
変数 | 例 / 説明 |
|
|
| Developer Portal の App Id(OAuth Client Id) |
| Cert Id(Client Secret)。漏洩したら Dev Console で Rotate / 再発行 してください |
| User access token( |
| 推奨(User モード時)。application のみ運用では不要 |
|
|
| application token 用 scope(既定 |
| 既定 |
| 任意。将来の Notification 等で使う場合に |
|
|
|
|
| 既定 |
ユーザーがチャットなどに貼った Cert Id は無効化(ローテーション)済みとして扱い、mcp.json の env のみへ再設定することを強く推奨します。
初回: ユーザートークンの取得(ebay-mcp-auth)
Keys → User Tokens (OAuth) で Ru Name に次と一致する Redirect URL を登録
(例)https://127.0.0.1:8765/callback端末から:
cd projects/ebay-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e .
export EBAY_ENV=sandbox
export EBAY_CLIENT_ID="<App Id>"
export EBAY_CLIENT_SECRET="<Cert Id>"
export EBAY_REDIRECT_URI="https://127.0.0.1:8765/callback"
python -m ebay_mcp.authブラウザで eBay にサインインし、許可後に自動で localhost に戻ります。表示された mcp.json フラグメント の env を Cursor の MCP 設定へマージします。
コードだけ貼った場合は、リダイレクト URL に含まれる code= を次のように渡します。
ebay-mcp-auth --code '<code の値のみ>'Browse 検索などで権限エラーになる場合は、Dev Console で 追加の OAuth scope に対応した Ru Name / アプリ権限があるか確認し、EBAY_OAUTH_SCOPE を拡張してください。
疎通
EBAY_ENV=sandbox EBAY_CLIENT_ID=... EBAY_CLIENT_SECRET=... EBAY_ACCESS_TOKEN=... EBAY_REFRESH_TOKEN=... \\
ebay-mcp-check成功時末尾に OK: end-to-end eBay access works. が表示されます。
Cursor 登録
examples/cursor_mcp_config.example.json を参考にしてください。公開前は uvx --from /abs/path/to/projects/ebay-mcp でローカルパス指定もできます。
MIT License © 2026 taka392
Available Tools
4 toolsget_item_summaryB
GET a single Browse listing by REST item id (encode-safe; pass the v1 item id).
Inputs: item_id (required). Returns: result
refresh_access_tokenA
Refresh tokens in-process only.
User mode: EBAY_REFRESH_TOKEN grant. Application mode: client_credentials refetch.
Inputs: no named parameters. Returns: result
search_item_summaryA
Search marketplace listings (Browse item_summary/search).
Typical filters: limit 1–50 for quick previews. category_ids is optional (comma-separated eBay leaf category ids).
Sort: omit for Best Match; use newlyListed for newest listings first.
Inputs: query (required), limit, offset, category_ids, +1 more. Returns: result
verifyA
Verify credentials.
User token: Commerce Identity profile. Application-only keyset: Browse ping + totals.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool serves a unique purpose: retrieving a single item, refreshing tokens, searching listings, and verifying credentials. No overlap exists.
All tool names follow a consistent snake_case pattern with descriptive verbs (get, refresh, search, verify). No mixing of conventions.
Four tools are well-scoped for an eBay browsing and authentication server, covering essential operations without unnecessary bloat.
The surface covers browsing (search and get item), token management, and credential verification. For the apparent purpose, no obvious gaps.
Maintenance
Related MCP Connectors
Search eBay sold and active listings, browse categories, and retrieve item details.
eBay MCP — Browse + Taxonomy APIs via client_credentials OAuth
Run an eBay seller account from your AI assistant: orders, listings, stock, fees and payouts.
Live eBay prices, sellers and profit for any keyword on 8 eBay sites. Pay per call with x402 USDC.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents 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 with Playwright.713 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables eBay sellers to manage inventory, view orders, handle messages, and browse listings through AI assistants using eBay seller APIs.-
- AlicenseNot gradedqualityCmaintenanceEnables eBay product search and item detail retrieval through eBay's official Browse API using app-level OAuth, returning real per-country shipping costs without browser cookies or bot checks.MIT
- AlicenseAqualityCmaintenanceEnables interaction with the Etsy Open API v3, covering all 105 operations with authentication, scope management, and secure token refresh.724 npmMIT