Skip to main content
eBay MCP Server Hero

​
What is eBay MCP Server?

The eBay MCP Server is a comprehensive Model Context Protocol (MCP) implementation that provides AI assistants with full access to eBay’s Sell APIs through 230+ tools. With 99.1% API coverage, it enables AI-powered automation for inventory management, order fulfillment, marketing campaigns, analytics, and more.

99.1% API Coverage

Implementing 110 of 111 eBay Sell APIs endpoints across all major categories

230+ eBay Tools

Comprehensive toolset for inventory, orders, marketing, analytics, and account management

OAuth 2.0 Authentication

Full user token support with automatic refresh and fallback to client credentials

870+ Tests

Extensively tested with 99%+ function coverage for reliability

​
Quick Start

Get up and running in minutes with our interactive setup wizard.
1

Install

Clone and install the eBay MCP Server
git clone https://github.com/YosefHayim/ebay-mcp-server.git
cd ebay-mcp-server
npm install
2

Configure

Run the interactive setup wizard
npm run setup
The wizard will guide you through eBay Developer credential configuration with real-time validation.
3

Connect

Connect to your favorite MCP client (Claude Desktop, Cursor, etc.)The server auto-detects and configures supported clients automatically.

Complete Quickstart Guide

Follow our detailed guide for step-by-step setup instructions

​
Core Capabilities

Explore what you can do with eBay MCP Server.
  • Create and manage inventory items
  • Configure offers and pricing
  • Manage inventory locations
  • Bulk operations support
  • Product compatibility and specifications
  • Retrieve and track orders
  • Create shipping fulfillments
  • Issue refunds and returns
  • Handle payment disputes
  • Manage shipping labels
  • Create and manage ad campaigns
  • Configure promoted listings
  • Set up item promotions
  • Manage markdown sales
  • Track advertising performance
  • Generate traffic reports
  • Access seller standards
  • View customer service metrics
  • Analyze sales performance
  • Configure payment and return policies
  • Manage fulfillment policies
  • Set up sales tax
  • Handle subscription status
  • KYC verification

​
API Coverage by Category

CategoryEndpointsCoverageTools
Account API36/3797.3%✅
Analytics API4/4100%✅
Fulfillment API15/15100%✅
Inventory API20/20100%✅
Marketing API30/30100%✅
Metadata API5/5100%✅

​
Why Choose eBay MCP Server?

Smart Authentication

Automatic token refresh with fallback authentication ensures uninterrupted operation

Auto-Configuration

Detects and configures MCP clients automatically - no manual setup required

Type-Safe

TypeScript with Zod validation and OpenAPI-generated types

Interactive Setup

Beautiful CLI wizard with step-by-step guidance and validation

Production Ready

Extensively tested with 870+ tests and 99%+ coverage

Well Documented

Comprehensive guides for both beginners and advanced users

​
MCP Client Support

Works seamlessly with popular MCP clients:

Claude Desktop

Official Anthropic desktop app

Cursor

AI-first code editor

Other Clients

Cline, Gemini, ChatGPT, and more

​
For New Developers

If you’re new to MCP or eBay APIs, start here:
1

Understand MCP

Learn about the Model Context Protocol and how it connects AI assistants to tools

What is MCP?

Read the official MCP documentation
2

Get eBay Credentials

Create a developer account and get your API credentials

eBay Developer Portal

Sign up and create your application
3

Follow the Quickstart

Our interactive quickstart guide walks you through everything step-by-step

Quickstart Guide

Start here for complete setup instructions

​
For Experienced Developers

Jump straight into advanced topics:

Architecture Overview

Understand the system design and implementation details

API Reference

Complete API documentation with all 230+ tools

Contributing

Learn how to contribute to the project

Testing Guide

Run and write tests for the server

​
Authentication Methods

Choose the authentication method that fits your needs:

User Tokens (Recommended)

Rate Limits: 10,000-50,000 requests/dayFull API access with automatic token refresh

Client Credentials (Fallback)

Rate Limits: 1,000 requests/dayAutomatic authentication for app-level operations

​
Need Help?

Troubleshooting

Common issues and solutions

FAQ

Frequently asked questions

GitHub Issues

Report bugs or request features

Changelog

See what’s new in each release
This project is licensed under Apache 2.0 and requires Node.js 18+ with TypeScript 5.9.3+