eBay

You can run and interact with the eBay MCP Server to search listings, track prices, and detect deals using MCP clients. This server exposes practical tools for querying eBay data and managing price information, making it easier to build AI-assisted workflows around homelab equipment and other items.

How to use

To use the eBay MCP Server, run the server locally in stdio mode for direct tool access or start it as an HTTP server for remote access through MCP clients. You will call tools by name (for example, search_ebay) from your MCP client and supply the needed parameters such as keywords, price limits, and other filters. The server handles input validation, executes the requested tool, and returns structured results that you can display or analyze in your workflow.

How to install

Prerequisites you need before installation:

1. Clone the repository and install the package in editable mode.

git clone https://github.com/hanku4u/ebay-mcp-server.git
cd ebay-mcp-server
pip install -e .

2. Configure credentials by creating a local environment file or exporting variables with your eBay API credentials.

cp .env.example .env
# Edit .env and add your EBAY_APP_ID, EBAY_CERT_ID, EBAY_DEV_ID

Configuration

Set your eBay API credentials as environment variables or in a .env file. The server uses these keys to access the eBay APIs for search and trading actions.

export EBAY_APP_ID="your-app-id"
export EBAY_CERT_ID="your-cert-id"
export EBAY_DEV_ID="your-dev-id"

Usage notes and examples

The server supports both local stdio operation and HTTP-based remote access. You can run it directly on your machine and call tools by name, or expose an HTTP endpoint that MCP clients can connect to.

# Start as a stdio MCP server (local usage)
python -m ebay_mcp

# Start as an HTTP MCP server for remote access
fastmcp run src/ebay_mcp/server.py:mcp --transport http --port 8000

OpenClaw and HTTP access

OpenClaw integration is planned to provide MCP client capabilities, with future support for remote access through an HTTP endpoint.

For remote usage, connect with an MCP client to the HTTP URL shown by the server start process, typically http://localhost:8000/mcp.

Available tools

search_ebay

Search eBay listings with keywords and optional filters like price, condition, and category.

track_price

Add an item to price tracking and store its price history locally.

find_deals

Identify items that are 15%+ below average market value based on historical data.

get_item_details

Retrieve comprehensive information about a specific listing, including seller reputation.

get_price_history

View historical price data for tracked items with statistics (min/max/avg/median).

watchlist

Maintain a watchlist of multiple items and set custom alerts.