EbayMcpServer

The EbayMcpServer exposes a single tool called list_auction. This tool queries eBay for auctions matching your search terms and returns the results from Ebay's REST API. You can use prompts like “Find me 10 auctions for batman comics” to drive the search. The tool requires a query argument to specify what you want to search for, and it has an optional amount argument to limit how many results are returned (default is 0, meaning it will return the default number provided by the API).

To use the server, run it with the Python entry point and call the list_auction tool via the MCP protocol. You’ll provide the required query and, if needed, adjust the amount. The server will fetch current auctions from Ebay and return the data in a structured format suitable for use in your prompts or downstream tools.

Prerequisites

• Python and pip installed on your system
• UV (the Python environment manager) installed and available in your PATH
• Git (optional, for cloning or installing from a repository)

Install UV (example, as shown in the README):

# Using Homebrew on macOS
brew install uv

or

# On macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Install the MCP server from source via UV:

# Install from source
uv pip install git+https://github.com/CooKey-Monster/EbayMcpServer.git

Configure environment variables (required by the Ebay API):

export CLIENT_ID="Your Ebay client ID"
export CLIENT_SECRET="Your Ebay client secret"

Run the MCP server (Python entry point):

python -m ebaymcpserver

If your environment uses UV to manage the project, you can also run the installed package directly via UV as shown above, depending on how your project is structured after installation.

Notes:

• The server relies on Ebay API credentials; obtain CLIENT_ID and CLIENT_SECRET from the Ebay developer portal.
• The list_auction tool requires a mandatory query parameter for the search term. The optional amount parameter controls the number of auction results to return.
• Ensure your environment variables are available to the process running the MCP server; otherwise, authentication with Ebay will fail.
• If you encounter network or API rate limits, consider adding wait or batching logic in your prompts or retry handling in your client.
• The MCP server is Python-based and uses the MCP Python SDK for protocol handling.