eBay MCP Server Documentation

Comprehensive Model Context Protocol server for eBay’s Sell APIs - 230+ tools, 99.1% API coverage

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.

Inventory Management (20 tools)

• Create and manage inventory items
• Configure offers and pricing
• Manage inventory locations
• Bulk operations support
• Product compatibility and specifications

Order Fulfillment (15 tools)

• Retrieve and track orders
• Create shipping fulfillments
• Issue refunds and returns
• Handle payment disputes
• Manage shipping labels

Marketing & Promotions (30 tools)

• Create and manage ad campaigns
• Configure promoted listings
• Set up item promotions
• Manage markdown sales
• Track advertising performance

Analytics & Reporting (4 tools)

• Generate traffic reports
• Access seller standards
• View customer service metrics
• Analyze sales performance

Account Management (36 tools)

• Configure payment and return policies
• Manage fulfillment policies
• Set up sales tax
• Handle subscription status
• KYC verification

API Coverage by Category

Category	Endpoints	Coverage	Tools
Account API	36/37	97.3%	✅
Analytics API	4/4	100%	✅
Fulfillment API	15/15	100%	✅
Inventory API	20/20	100%	✅
Marketing API	30/30	100%	✅
Metadata API	5/5	100%	✅

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/day

Full API access with automatic token refresh

Client Credentials (Fallback)

Rate Limits: 1,000 requests/day

Automatic 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+