Ebay Mcp
About
Open source local MCP server providing AI assistants with comprehensive access to eBay's Sell APIs. Includes 325 tools for inventory management, order fulfillment, marketing campaigns, analytics, developer tools, and more.
Explore
- 325 eBay API Tools - 100% coverage of eBay Sell APIs across inventory, orders, marketing, analytics, developer tools, and more
- 9 AI Clients Supported - Auto-configuration for Claude Desktop, Cursor, Zed, Cline, Continue.dev, Windsurf, Roo Code, Claude Code CLI, and Amazon Q
- OAuth 2.0 Support - Full user token management with automatic refresh
- Type Safety - Built with TypeScript, Zod validation, and OpenAPI-generated types
- MCP Integration - STDIO transport for direct integration with AI assistants
- Smart Authentication - Automatic fallback from user tokens (10k-50k req/day) to client credentials (1k req/day)
- Well Tested - 958+ tests with comprehensive coverage
- Interactive Setup Wizard - Run npm run setup for guided configuration with auto browser-open for OAuth
- Developer Analytics - Rate limit monitoring and signing key management
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Ebay McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
> 📖 For a comprehensive configuration guide with detailed explanations of all environment variables, OAuth flow steps, and troubleshooting, see Configuration Documentation.
> Let your AI assistant set this up for you! Copy the prompt below and paste it into Claude, ChatGPT, or any AI assistant with MCP support.
<details>
<summary><strong>Click to copy the AI setup prompt</strong></summary>
I want to set up the eBay MCP Server for my AI assistant. Please help me:
1. Install the eBay MCP server:
npm install -g ebay-mcp
2. I need to configure it for [Claude Desktop / Cursor / Cline / Zed / Continue.dev / Windsurf / Claude Code CLI / Amazon Q] (choose one)
3. My eBay credentials are:
- Client ID: [YOUR_CLIENT_ID]
- Client Secret: [YOUR_CLIENT_SECRET]
- Environment: [sandbox / production]
- Redirect URI (RuName): [YOUR_REDIRECT_URI]
Please:
- Create the appropriate config file for my MCP client
- Set up the environment variables
- Help me complete the OAuth flow to get a refresh token for higher rate limits
- Test that the connection works
If I don't have eBay credentials yet, guide me through creating a developer account at https://developer.ebay.com/
</details>
---
Option A: Install from npm (Recommended)
npm install -g ebay-mcp
Option B: Install from source
git clone https://github.com/YosefHayim/ebay-mcp.git
cd ebay-mcp
npm install
npm run build
The interactive setup wizard handles everything for you:
npm run setup
> Powered by grimoire-wizard — a config-driven CLI wizard framework
The wizard will:
- Configure your eBay credentials
- Set up OAuth authentication (for higher rate limits)
- Auto-detect and configure your MCP client (Claude Desktop, etc.)
- Save all configuration automatically
---
The setup wizard (npm run setup) handles OAuth authentication automatically. Here's where to find your credentials in the eBay Developer Portal:
Run npm run setup and enter your credentials when prompted. The wizard will:
1. Open your browser for OAuth login automatically
2. Guide you through the eBay sign-in process
3. Ask you to paste the authorization code from the callback URL
4. Exchange the code for tokens and save them automatically
5. Configure your MCP client (Claude Desktop, etc.)
Success! You now have user token authentication with 10k-50k requests/day instead of the default 1k/day.
---
The setup wizard (npm run setup) automatically creates and configures your .env file. For reference, these are the environment variables used:
EBAY_CLIENT_ID=your_client_id
EBAY_CLIENT_SECRET=your_client_secret
EBAY_ENVIRONMENT=sandbox # or "production"
EBAY_REDIRECT_URI=your_runame
EBAY_MARKETPLACE_ID=EBAY_US # Default marketplace (overridable by many tools)
EBAY_CONTENT_LANGUAGE=en-US # Default request content language (global)
EBAY_USER_REFRESH_TOKEN=your_refresh_token # For higher rate limits
Client Credentials (Default): 1,000 requests/day - works automatically with just Client ID and Secret.
User Tokens (Recommended): 10,000-50,000 requests/day - the setup wizard handles the OAuth flow automatically. Tokens refresh automatically.
For detailed OAuth setup and comprehensive configuration guide, see the Configuration Documentation.
Here are some common tasks you can accomplish with the eBay MCP server:
git clone https://github.com/YOUR_USERNAME/ebay-mcp.git
cd ebay-mcp
npm install
npm run setup # Interactive setup wizard
npm run build
npm test
Problem: "Invalid credentials" or "Authentication failed" errors.
Solutions:
1. Verify your EBAY_CLIENT_ID and EBAY_CLIENT_SECRET are correct
2. Ensure you're using the right environment (sandbox vs production)
3. Check if your app keys are active in the eBay Developer Portal
4. For user tokens, verify your EBAY_USER_REFRESH_TOKEN is valid
5. Run npm run diagnose to check your configuration
If you're still experiencing issues:
1. Check existing GitHub Issues
2. Create a new issue with:
- Your diagnostic report (npm run diagnose:export)
- Steps to reproduce the problem
- Error messages or logs
- Your environment (OS, Node version, MCP client)
ebay_get_inventory_items
List all inventory items
ebay_get_orders
Retrieve seller orders
ebay_create_offer
Create new listing offer
ebay_get_campaigns
Get marketing campaigns
ebay_get_oauth_url
Generate OAuth authorization URL
The server provides 325 tools with 100% API coverage organized into the following categories:
- Account Management - Policies, programs, subscriptions, sales tax
- Inventory Management - Items, offers, locations, bulk operations, SKU location mapping
- Order Fulfillment - Orders, shipping, refunds, disputes, payment dispute evidence
- Marketing & Promotions - Campaigns, ads, promotions, bidding, bulk operations
- Analytics - Traffic reports, seller standards, metrics
- Communication - Buyer-seller messaging, negotiations, notifications, feedback
- Metadata & Taxonomy - Categories, item aspects, policies
- Developer Tools - Rate limits, signing keys, client registration
- Token Management - OAuth URL generation, token management
Example Tools:
- ebay_get_inventory_items - List all inventory items
- ebay_get_orders - Retrieve seller orders
- ebay_create_offer - Create new listing offer
- ebay_get_campaigns - Get marketing campaigns
- ebay_get_oauth_url - Generate OAuth authorization URL
For the complete tool list, see src/tools/definitions/.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"ebay mcp": {
"ebay-mcp": {
"command": "npx",
"args": [
"ebay-mcp",
"setup",
"#",
"Interactive",
"setup",
"wizard",
"-",
"auto-detects",
"installed",
"clients"
]
}
}
}
}McpServers
{
"ebay-mcp": {
"command": "npx",
"args": [
"ebay-mcp",
"setup",
"#",
"Interactive",
"setup",
"wizard",
"-",
"auto-detects",
"installed",
"clients"
]
}
}eBay API MCP Server
<div align="center">
<a href="https://www.buymeacoffee.com/yosefhayim" target="_blank">
</a>
A Model Context Protocol (MCP) server providing AI assistants with comprehensive access to eBay's Sell APIs. Includes 325 tools for inventory management, order fulfillment, marketing campaigns, analytics, developer tools, and more.
API Coverage: 100% (270 unique eBay API endpoints)
</div>
---
One-Click AI Setup
> Let your AI assistant set this up for you! Copy the prompt below and paste it into Claude, ChatGPT, or any AI assistant with MCP support.
<details>
<summary><strong>Click to copy the AI setup prompt</strong></summary>
I want to set up the eBay MCP Server for my AI assistant. Please help me:
1. Install the eBay MCP server:
npm install -g ebay-mcp
2. I need to configure it for [Claude Desktop / Cursor / Cline / Zed / Continue.dev / Windsurf / Claude Code CLI / Amazon Q] (choose one)
3. My eBay credentials are:
- Client ID: [YOUR_CLIENT_ID]
- Client Secret: [YOUR_CLIENT_SECRET]
- Environment: [sandbox / production]
- Redirect URI (RuName): [YOUR_REDIRECT_URI]
Please:
- Create the appropriate config file for my MCP client
- Set up the environment variables
- Help me complete the OAuth flow to get a refresh token for higher rate limits
- Test that the connection works
If I don't have eBay credentials yet, guide me through creating a developer account at https://developer.ebay.com/
</details>
---
⚠️ Disclaimer
IMPORTANT: Please read this disclaimer carefully before using this software.
This is an open-source project provided "as is" without warranty of any kind, either express or implied. By using this software, you acknowledge and agree to the following:
- No Liability: The authors, contributors, and maintainers of this project accept NO responsibility or liability for any damages, losses, or issues that may arise from using this software, including but not limited to:
- Data loss or corruption
- Financial losses
- Service disruptions
- eBay account suspension or termination
- Violations of eBay's Terms of Service or API usage policies
- Any other direct or indirect damages
- eBay API Usage: This project is an unofficial third-party implementation and is NOT affiliated with, endorsed by, or sponsored by eBay Inc. You are solely responsible for:
- Complying with eBay's API Terms of Use
- Ensuring your usage stays within eBay's rate limits and policies
- Managing your eBay Developer credentials securely
- Understanding and complying with eBay's data handling requirements
- Any actions performed through the API
- Use at Your Own Risk: This software is provided for educational and development purposes. Users must:
- Test thoroughly in eBay's sandbox environment before production use
- Understand the API calls being made on their behalf
- Maintain backups of critical data
- Monitor their API usage and account status
- Security: You are responsible for:
- Keeping your API credentials secure
- Properly configuring environment variables
- Understanding the security implications of MCP server usage
- Following security best practices
- No Warranty: This software is provided without any guarantees of functionality, reliability, or fitness for a particular purpose.
By using this software, you accept all risks and agree to hold harmless the authors, contributors, and maintainers from any claims, damages, or liabilities.
For official eBay API support, please refer to the eBay Developer Program.
---
Table of Contents
- ⚠️ Disclaimer
- Features
- Quick Start
- Demo
- Visual Setup Guide
- Configuration
- Available Tools
- Usage Examples
- Development
- Contributing
- Logging
- Troubleshooting
- Resources
- License
Features
- 325 eBay API Tools - 100% coverage of eBay Sell APIs across inventory, orders, marketing, analytics, developer tools, and more
- 9 AI Clients Supported - Auto-configuration for Claude Desktop, Cursor, Zed, Cline, Continue.dev, Windsurf, Roo Code, Claude Code CLI, and Amazon Q
- OAuth 2.0 Support - Full user token management with automatic refresh
- Type Safety - Built with TypeScript, Zod validation, and OpenAPI-generated types
- MCP Integration - STDIO transport for direct integration with AI assistants
- Smart Authentication - Automatic fallback from user tokens (10k-50k req/day) to client credentials (1k req/day)
- Well Tested - 958+ tests with comprehensive coverage
- Interactive Setup Wizard - Run npm run setup for guided configuration with auto browser-open for OAuth
- Developer Analytics - Rate limit monitoring and signing key management
Quick Start
1. Get eBay Credentials
1. Create a free eBay Developer Account
2. Generate application keys in the Developer Portal
3. Save your Client ID and Client Secret
2. Install
Option A: Install from npm (Recommended)
npm install -g ebay-mcp
Option B: Install from source
git clone https://github.com/YosefHayim/ebay-mcp.git
cd ebay-mcp
npm install
npm run build
3. Run Setup Wizard
The interactive setup wizard handles everything for you:
npm run setup
> Powered by grimoire-wizard — a config-driven CLI wizard framework
The wizard will:
- Configure your eBay credentials
- Set up OAuth authentication (for higher rate limits)
- Auto-detect and configure your MCP client (Claude Desktop, etc.)
- Save all configuration automatically
---
Demo
See the eBay MCP Server in action with Claude Desktop:
https://github.com/user-attachments/assets/0173c8df-221c-4943-a4ce-cd20bce79f4b
---
Visual Setup Guide
The setup wizard (npm run setup) handles OAuth authentication automatically. Here's where to find your credentials in the eBay Developer Portal:
Finding Your Credentials
Step 1: Navigate to eBay Developer Portal and copy your App ID (Client ID) and Cert ID (Client Secret):
…
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
