# eBay Browse MCP server

> Allows an AI agent to search eBay listings and retrieve aggregated price intelligence, including minimum, median, and maximum prices by item condition.

- Repository: https://github.com/cunicopia-dev/ebay-mcp
- Page: https://hostedmcp.org/servers/cunicopia-dev/ebay-mcp
- Transport: stdio
- Stars: 1
- License: MIT
- Latest version: 0.1.0

## Install

### Claude Code

```sh
claude mcp add --env 'EBAY_PRD_APP_ID=<YOUR_EBAY_PRD_APP_ID>' --env 'EBAY_PRD_CERT_ID=<YOUR_EBAY_PRD_CERT_ID>' --env 'EBAY_SBX_APP_ID=<YOUR_EBAY_SBX_APP_ID>' --env 'EBAY_SBX_CERT_ID=<YOUR_EBAY_SBX_CERT_ID>' ebay-mcp -- uvx ebay-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "ebay-mcp": {
      "command": "uvx",
      "args": [
        "ebay-mcp"
      ],
      "env": {
        "EBAY_PRD_APP_ID": "<YOUR_EBAY_PRD_APP_ID>",
        "EBAY_PRD_CERT_ID": "<YOUR_EBAY_PRD_CERT_ID>",
        "EBAY_SBX_APP_ID": "<YOUR_EBAY_SBX_APP_ID>",
        "EBAY_SBX_CERT_ID": "<YOUR_EBAY_SBX_CERT_ID>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "ebay-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ebay-mcp"
      ],
      "env": {
        "EBAY_PRD_APP_ID": "<YOUR_EBAY_PRD_APP_ID>",
        "EBAY_PRD_CERT_ID": "<YOUR_EBAY_PRD_CERT_ID>",
        "EBAY_SBX_APP_ID": "<YOUR_EBAY_SBX_APP_ID>",
        "EBAY_SBX_CERT_ID": "<YOUR_EBAY_SBX_CERT_ID>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"ebay-mcp","type":"stdio","command":"uvx","args":["ebay-mcp"],"env":{"EBAY_PRD_APP_ID":"<YOUR_EBAY_PRD_APP_ID>","EBAY_PRD_CERT_ID":"<YOUR_EBAY_PRD_CERT_ID>","EBAY_SBX_APP_ID":"<YOUR_EBAY_SBX_APP_ID>","EBAY_SBX_CERT_ID":"<YOUR_EBAY_SBX_CERT_ID>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "ebay-mcp": {
      "command": "uvx",
      "args": [
        "ebay-mcp"
      ],
      "env": {
        "EBAY_PRD_APP_ID": "<YOUR_EBAY_PRD_APP_ID>",
        "EBAY_PRD_CERT_ID": "<YOUR_EBAY_PRD_CERT_ID>",
        "EBAY_SBX_APP_ID": "<YOUR_EBAY_SBX_APP_ID>",
        "EBAY_SBX_CERT_ID": "<YOUR_EBAY_SBX_CERT_ID>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add ebay-mcp --env 'EBAY_PRD_APP_ID=<YOUR_EBAY_PRD_APP_ID>' --env 'EBAY_PRD_CERT_ID=<YOUR_EBAY_PRD_CERT_ID>' --env 'EBAY_SBX_APP_ID=<YOUR_EBAY_SBX_APP_ID>' --env 'EBAY_SBX_CERT_ID=<YOUR_EBAY_SBX_CERT_ID>' -- uvx ebay-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.ebay-mcp]
command = "uvx"
args = ["ebay-mcp"]

[mcp_servers.ebay-mcp.env]
EBAY_PRD_APP_ID = "<YOUR_EBAY_PRD_APP_ID>"
EBAY_PRD_CERT_ID = "<YOUR_EBAY_PRD_CERT_ID>"
EBAY_SBX_APP_ID = "<YOUR_EBAY_SBX_APP_ID>"
EBAY_SBX_CERT_ID = "<YOUR_EBAY_SBX_CERT_ID>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'EBAY_PRD_APP_ID=<YOUR_EBAY_PRD_APP_ID>' -e 'EBAY_PRD_CERT_ID=<YOUR_EBAY_PRD_CERT_ID>' -e 'EBAY_SBX_APP_ID=<YOUR_EBAY_SBX_APP_ID>' -e 'EBAY_SBX_CERT_ID=<YOUR_EBAY_SBX_CERT_ID>' ebay-mcp uvx -- ebay-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "ebay-mcp": {
      "command": "uvx",
      "args": [
        "ebay-mcp"
      ],
      "env": {
        "EBAY_PRD_APP_ID": "<YOUR_EBAY_PRD_APP_ID>",
        "EBAY_PRD_CERT_ID": "<YOUR_EBAY_PRD_CERT_ID>",
        "EBAY_SBX_APP_ID": "<YOUR_EBAY_SBX_APP_ID>",
        "EBAY_SBX_CERT_ID": "<YOUR_EBAY_SBX_CERT_ID>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `EBAY_PRD_APP_ID` | no | yes | eBay production App ID (Client ID) from your eBay developer account. Required for EBAY_ENV=production. |
| `EBAY_PRD_CERT_ID` | no | yes | eBay production Cert ID (Client Secret). Required for EBAY_ENV=production. |
| `EBAY_SBX_APP_ID` | no | yes | eBay sandbox App ID (Client ID). Required for EBAY_ENV=sandbox. |
| `EBAY_SBX_CERT_ID` | no | yes | eBay sandbox Cert ID (Client Secret). Required for EBAY_ENV=sandbox. |
| `EBAY_ENV` | no | no | Which eBay environment to use: "production" or "sandbox". Defaults to production. |

## FAQ

### Does this require a user login or OAuth consent?

No, it uses eBay's application token (client-credentials grant), so no user login or OAuth consent screen is required.

### Can I filter out specific items from my price analysis?

Yes, you can use an exclude parameter to strip unwanted items like laptops or notebooks from your search results to get more accurate price medians.