eBay Browse

Name: eBay Browse
Author: cunicopia-dev

by cunicopia-devversion 0.1.0i★ –iRuns on your computer

Registry nameio.github.cunicopia-dev/ebay-mcp

Install

Overview

Description from the maker (original English)

eBay Browse API MCP server — buy-side listing search and price intelligence.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Search & AI memory
You need to fill in: EBAY_PRD_APP_ID, EBAY_PRD_CERT_ID, EBAY_SBX_APP_ID, EBAY_SBX_CERT_ID

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: EBAY_ENV, EBAY_PRD_APP_ID, EBAY_PRD_CERT_ID, EBAY_SBX_APP_ID, EBAY_SBX_CERT_ID

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "ebay": {
      "command": "uvx",
      "args": [
        "ebay-mcp"
      ],
      "env": {
        "EBAY_ENV": "your-value",
        "EBAY_PRD_APP_ID": "your-value",
        "EBAY_PRD_CERT_ID": "your-value",
        "EBAY_SBX_APP_ID": "your-value",
        "EBAY_SBX_CERT_ID": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add ebay --env EBAY_ENV=your-value --env EBAY_PRD_APP_ID=your-value --env EBAY_PRD_CERT_ID=your-value --env EBAY_SBX_APP_ID=your-value --env EBAY_SBX_CERT_ID=your-value -- uvx ebay-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "ebay": {
      "command": "uvx",
      "args": [
        "ebay-mcp"
      ],
      "env": {
        "EBAY_ENV": "your-value",
        "EBAY_PRD_APP_ID": "your-value",
        "EBAY_PRD_CERT_ID": "your-value",
        "EBAY_SBX_APP_ID": "your-value",
        "EBAY_SBX_CERT_ID": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "ebay": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ebay-mcp"
      ],
      "env": {
        "EBAY_ENV": "your-value",
        "EBAY_PRD_APP_ID": "your-value",
        "EBAY_PRD_CERT_ID": "your-value",
        "EBAY_SBX_APP_ID": "your-value",
        "EBAY_SBX_CERT_ID": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

EBAY_ENV env
Which eBay environment to use: "production" or "sandbox". Defaults to production.
EBAY_PRD_APP_ID secret env
eBay production App ID (Client ID) from your eBay developer account. Required for EBAY_ENV=production.
EBAY_PRD_CERT_ID secret env
eBay production Cert ID (Client Secret). Required for EBAY_ENV=production.
EBAY_SBX_APP_ID secret env
eBay sandbox App ID (Client ID). Required for EBAY_ENV=sandbox.
EBAY_SBX_CERT_ID secret env
eBay sandbox Cert ID (Client Secret). Required for EBAY_ENV=sandbox.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account cunicopia-dev, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Search & AI memoryi

More stars than 0% of the other 7230 servers in this category
Published to the registry more recently than 18% of the other 7230 servers in this category
Basic checks equal to or better than 100% of the other 7230 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is eBay Browse safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: EBAY_PRD_APP_ID, EBAY_PRD_CERT_ID, EBAY_SBX_APP_ID, EBAY_SBX_CERT_ID

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.0) reached the registry 4 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Context7, Codebase Memory, Exa

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Context7

by upstash

Feeds AI the latest docs for libraries and frameworks before it answers, so code it writes does not use outdated, removed functions.

Computer or cloud★ 64,224MITUpdated 3 days ago

Install

Codebase Memory

by DeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

Runs on your computer★ 48,148MITUpdated 20 days ago

Install

Exa

by exa-labs

Connect AI agents to Exa for web search, content fetching, and multi-step research.

Runs in the cloud★ 5,213MITUpdated 44 days ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

ebay-mcp

Give an AI agent real, live market prices — straight from the largest secondhand marketplace on the internet.

eBay is a continuously-updating ledger of what physical things actually cost right now. This wraps its Browse API as an MCP server with three tools, so an agent can search listings, pull a single item, and — the useful one — get an aggregated price landscape for anything: min, median, max, broken down by condition.

Python 3.12+ · MIT · MCP server · app-token auth, no user login

Setup is one free eBay app keyset — no user login, no OAuth consent screen to click through. Point an agent at it and ask "what does an RTX 5080 actually go for?" — one call back comes a grounded answer, split by condition, with the cheapest listings attached.

The three tools
Architecture: one client, three tools
Authentication: client-credentials, cached
ebay_price_check: how the landscape is built
Install
Configuration
Sandbox vs. production
Project layout
License

The three tools

Tool	What it does
`ebay_price_check`	Aggregated price landscape for a query — count, min/median/max, a breakdown by condition, and the cheapest listings. The headline tool.
`ebay_search`	Listing search with sorting and filtering — returns clean `{itemId, title, price, condition, seller, itemWebUrl}` rows.
`ebay_get_item`	Full detail for one item by ID.

// ebay_price_check  ·  query: "RTX 5080", exclude: ["laptop", "notebook"]

{ "count": 47, "currency": "USD", "min": 899, "median": 1099, "max": 2200, "by_condition": { "New": { "count": 18, "min": 1099, "median": 1199, "max": 1634 }, "Used": { "count": 21, "min": 899, "median": 1050, "max": 1499 } }, "cheapest": [ { "price": 899, "condition": "Used", "title": "…", "itemWebUrl": "…" } ] }

Architecture: one client, three tools

Every tool flows through a single EbayBrowseClient, which owns the token and talks to eBay. There's one place credentials are read, one place a token is cached, one place HTTP happens — nothing to drift.

flowchart LR

Agent(["AI agent / Claude"]) subgraph server["ebay-mcp · stdio server"] Tools["ebay_search ebay_get_item ebay_price_check"] Client["EbayBrowseClient"] Cache[("OAuth token in-memory, auto-refresh")] end Cfg["~/.ebay-mcp.toml or env vars"] eBay["eBay Browse API"]

The server is async; the client is plain synchronous requests, run in a thread (asyncio.to_thread) so a slow eBay call never blocks the event loop. ebay_price_check is the one tool that does more than pass through — it runs a search and then aggregates the result (see below).

Authentication: client-credentials, cached

eBay's Browse API uses an application token (the OAuth client-credentials grant) — no user is involved. The client mints one on first use, caches it in memory, and silently refreshes when it's about to expire. You never think about it.

sequenceDiagram

participant T as Tool call participant C as EbayBrowseClient participant O as eBay OAuth participant B as Browse API

T->>C: search("RTX 5080") alt token missing or expired C->>O: POST /identity/v1/oauth2/token Basic(app_id:cert_id), grant=client_credentials O-->>C: access_token + expires_in Note over C: cache until (expires_in − 60s) end C->>B: GET /item_summary/search Authorization: Bearer … B-->>C: listings JSON C-->>T: parsed results

The 60-second buffer means a token is treated as expired slightly early, so a call never races a token that dies mid-flight. Tokens live ~2 hours; in practice one fetch covers a long session.

`ebay_price_check`: how the landscape is built

The other two tools are thin wrappers. This one is the reason the project exists: it turns a pile of raw listings into a number you can reason about.

flowchart LR

Q["query

exclude[]"] --> S["search

(up to 50 listings)"] S --> F["drop excluded titles

unpriced listings"] F --> G["group by condition"] G --> A["aggregate

min · median · max"] G --> H["cheapest N (the tail)"] A --> R(["{ count, min, median, max, by_condition, cheapest }"]) H --> R

exclude is what makes the number honest — a search for "RTX 5080" is full of laptops and prebuilt PCs, and exclude: ["laptop", "notebook", "prebuilt"] strips them so the median reflects the actual card. The by_condition split matters just as much: a "median" that blends new-in-box with used-and-abused is noise; split by condition and each tier tells the truth.

One honest limitation worth knowing: the Browse API returns **active asking

prices**, not completed sales. Treat the floor as "best currently advertised,"

not "what it sold for."

Install

git clone https://github.com/cunicopia-dev/ebay-mcp

cd ebay-mcp python3.12 -m venv .venv && source .venv/bin/activate pip install -e .

You need a (free) eBay developer application keyset — see docs/SETUP.md for the five-minute walkthrough. Then wire it into your MCP client:

"mcpServers": { "ebay": { "command": "/path/to/ebay-mcp/.venv/bin/ebay-mcp" } } }

Configuration

Credentials come from environment variables (highest priority) or a `~/.ebay-mcp.toml` file. The active env selects the keyset *and* the API base URL together — so production creds can never accidentally point at the sandbox, or vice versa.

flowchart TD

Start(["load_config()"]) --> Env{"EBAY_ENV / EBAY_*_APP_ID in environment?"} Env -->|"set"| UseEnv["take keyset from env vars"] Env -->|"unset"| Toml{"~/.ebay-mcp.toml present?"} Toml -->|"yes"| UseToml["take keyset from TOML"] Toml -->|"no"| Default["default env = production (error if creds missing)"] UseEnv --> Pick["env → keyset + base URL (locked together)"] UseToml --> Pick Default --> Pick

# ~/.ebay-mcp.toml   (chmod 600)

env = "production"

[production] app_id = "YourApp-PRD-..." cert_id = "PRD-..."

[sandbox] app_id = "YourApp-SBX-..." cert_id = "SBX-..."

Check what's active any time — credentials are masked in the output:

ebay-mcp-config

env: production

app_id: Keit****87dd

cert_id: PRD-****0914

api_base: https://api.ebay.com

OK — configuration is valid.

Sandbox vs. production

Flip env between sandbox and production to switch environments — same code, different endpoints and keyset. The sandbox is good for proving the auth flow wires up; its inventory is sparse and seeded, so for real prices you want a production keyset.

Project layout

src/ebay_mcp/

config.py # env + TOML loader; ebay-mcp-config CLI browse.py # EbayBrowseClient — OAuth cache + search / get_item server.py # MCP server: list_tools / call_tool / main tests/ # config precedence, aggregation, tool listing (no network) docs/SETUP.md # getting an eBay keyset

License

MIT

eBay Browse

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Search & AI memoryi

Common questions

Alternatives

Context7

Codebase Memory

Exa

README from the maker

ebay-mcp

Contents

The three tools

Architecture: one client, three tools

Authentication: client-credentials, cached

ebay_price_check: how the landscape is built

Install

Configuration

env: production

app_id: Keit****87dd

cert_id: PRD-****0914

api_base: https://api.ebay.com

OK — configuration is valid.

Sandbox vs. production

Project layout

License

`ebay_price_check`: how the landscape is built