home / mcp / ebay mcp server

Ebay MCP Server

Provides access to eBay Sell APIs via MCP with 230+ tools, OAuth handling, and STDIO/HTTP transport.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "yosefhayim-ebay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ebay-mcp"
      ],
      "env": {
        "EBAY_CLIENT_ID": "your_client_id",
        "EBAY_ENVIRONMENT": "sandbox",
        "EBAY_REDIRECT_URI": "your_runame",
        "EBAY_CLIENT_SECRET": "your_client_secret",
        "EBAY_USER_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN"
      }
    }
  }
}

You run an MCP server that exposes eBay Sell APIs to AI assistants, giving you ready-to-use tools for inventory, orders, marketing, analytics, and more. This server provides extensive automation capabilities and auto-manages token handling to keep your integration productive without frequent manual re-authentication.

How to use

Install the MCP server, configure credentials, and connect it to your MCP client. Your AI assistant can then call tools like inventory lookups, order retrieval, marketing campaign management, and analytics. Start by setting up your credentials, then run the server locally or connect to it over HTTP, depending on your environment. Use the assistant to orchestrate eBay Sell API tasks in natural language, with automatic token handling and rate-limit support.

How to install

# Prerequisites
- Node.js >= 18.0.0
- npm or pnpm
- An eBay Developer Account with App Keys

# 1. Install the MCP server (recommended)
npm install -g ebay-mcp

# 2. Run setup to configure credentials (interactive)
npm run setup

# Or configure manually
cp .env.example .env
# Edit .env with your credentials
npm run auto-setup

# 3. Start the server (stdio mode)
npx ebay-mcp

Configuration

Create and populate a configuration that provides your credentials and runtime mode. You can run an interactive setup or configure via a manual environment file. The following options illustrate how to run the server locally with STDIO transport and with a path to a built index when using a locally built version.

{
  "mcpServers": {
    "ebay": {
      "command": "npx",
      "args": ["-y", "ebay-mcp"],
      "env": {
        "EBAY_CLIENT_ID": "your_client_id",
        "EBAY_CLIENT_SECRET": "your_client_secret",
        "EBAY_ENVIRONMENT": "sandbox",
        "EBAY_REDIRECT_URI": "your_runame"
      }
    }
  }
}

{
  "mcpServers": {
    "ebay": {
      "command": "node",
      "args": ["/absolute/path/to/ebay-mcp/build/index.js"],
      "env": {
        "EBAY_CLIENT_ID": "your_client_id",
        "EBAY_CLIENT_SECRET": "your_client_secret",
        "EBAY_ENVIRONMENT": "sandbox"
      }
    }
  }
}

Security and environment variables

Store sensitive values securely in environment variables. The following variables are used to configure the MCP server.

EBAY_CLIENT_ID=your_client_id
EBAY_CLIENT_SECRET=your_client_secret
EBAY_ENVIRONMENT=sandbox  # or "production"
EBAY_REDIRECT_URI=your_runame

# Optional: for higher rate limits
EBAY_USER_REFRESH_TOKEN=your_refresh_token

Troubleshooting

If you encounter issues, check credentials, environment selection, and token status. Ensure the MCP client is configured to use STDIO or HTTP transport as appropriate, and review logs for authentication or rate-limit messages.

Notes on usage with MCP clients

This server supports STDIO transport for direct integration with MCP clients and can also operate in HTTP mode for testing and debugging. Default transport is STDIO.

Available tools

ebay_get_inventory_items

List all inventory items currently stored in your eBay catalog, with details such as SKU, quantity, and status.

ebay_get_orders

Retrieve seller orders, with options to filter by date range, status, and fulfillment.

ebay_create_offer

Create or update an offer related to an inventory item, including pricing and quantity controls.

ebay_get_campaigns

Fetch marketing campaigns and related performance data for your listings.

ebay_get_oauth_url

Generate an OAuth authorization URL to start the user-token flow for higher rate limits.