eBay
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.
What is eBay?
eBay is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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, deve...
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.
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Open source local MCP server providing AI assistants with co
Use Cases
Maintainer
Works with
Installation
NPM
npx -y ebayManual Installation
npx -y ebayConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use eBay
The eBay MCP server gives AI assistants comprehensive access to eBay's Sell APIs through a locally-run Python server, covering inventory management, order fulfillment, marketing campaigns, buyer communication, and analytics. With over 325 tools derived from eBay's official API surface, sellers can automate complex multi-step workflows — listing items, managing orders, running promotions, and pulling performance data — entirely through natural language. The server uses eBay's OAuth 2.0 flow for secure access and supports both sandbox and production environments.
Prerequisites
- Python 3.10 or later installed on your system
- An eBay Developer account at developer.ebay.com with an application created to obtain EBAY_CLIENT_ID and EBAY_CLIENT_SECRET
- An eBay seller account (sandbox or production) for user-level API operations
- An MCP-compatible client such as Claude Desktop or Cursor
- Git to clone the repository
Register an eBay developer application
Go to https://developer.ebay.com, create an account, and register a new application. Note your App ID (Client ID) and Cert ID (Client Secret). Set the OAuth redirect URI in the Dev Console — for local use, 'http://localhost:8765/oauth/callback' is the default.
Clone the repository and install dependencies
Clone the ebay-mcp repository, create a Python virtual environment, and install the package in editable mode.
git clone https://github.com/taka392/ebay-mcp.git
cd ebay-mcp
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e .Run the OAuth helper to get user tokens
Run the built-in auth helper to complete the browser-based OAuth flow and obtain your access and refresh tokens. The helper prints a ready-to-use environment fragment when complete.
EBAY_ENV=sandbox \
EBAY_CLIENT_ID=your-app-id \
EBAY_CLIENT_SECRET=your-cert-id \
python -m ebay_mcp.authVerify end-to-end connectivity
Use the built-in check command to confirm your credentials work against the eBay API before wiring up the MCP client.
EBAY_ENV=sandbox \
EBAY_CLIENT_ID=your-app-id \
EBAY_CLIENT_SECRET=your-cert-id \
EBAY_REFRESH_TOKEN=your-refresh-token \
ebay-mcp-checkAdd the server to your MCP client configuration
Add the eBay MCP server to your claude_desktop_config.json, setting all required environment variables. Switch EBAY_ENV to 'production' when ready to work with your live store.
{
"mcpServers": {
"ebay": {
"command": "/path/to/.venv/bin/ebay-mcp",
"env": {
"EBAY_ENV": "sandbox",
"EBAY_CLIENT_ID": "your-app-id",
"EBAY_CLIENT_SECRET": "your-cert-id",
"EBAY_REFRESH_TOKEN": "your-refresh-token",
"EBAY_MARKETPLACE_ID": "EBAY_US"
}
}
}
}eBay Examples
Client configuration
Claude Desktop config for the eBay MCP server using the installed Python entry point with all required OAuth credentials.
{
"mcpServers": {
"ebay": {
"command": "/path/to/ebay-mcp/.venv/bin/ebay-mcp",
"env": {
"EBAY_ENV": "production",
"EBAY_CLIENT_ID": "YourApp-12345",
"EBAY_CLIENT_SECRET": "PRD-abc123",
"EBAY_REFRESH_TOKEN": "v1.1~your-long-refresh-token",
"EBAY_MARKETPLACE_ID": "EBAY_US"
}
}
}
}Prompts to try
Example requests you can make to Claude once the eBay MCP server is connected.
- "Show me my eBay seller profile and account status"
- "Search eBay for listings of vintage cameras with Buy It Now price under $200"
- "List my active eBay inventory and flag items with low stock"
- "What are my unfulfilled orders from the past week?"
- "Create a promotional campaign for my electronics listings with 10% off"Troubleshooting eBay
ebay-mcp-check returns 401 Unauthorized
Your access token has likely expired. Re-run 'python -m ebay_mcp.auth' to get a fresh refresh token, then update EBAY_REFRESH_TOKEN in your config. Make sure EBAY_ENV matches the environment (sandbox vs. production) the token was issued for.
OAuth redirect fails during the auth flow
Ensure the redirect URI registered in your eBay Developer Console exactly matches what the auth helper uses (default: http://localhost:8765/oauth/callback). Even a trailing slash difference will cause the flow to fail. Set EBAY_OAUTH_LOCAL_PORT if port 8765 is in use.
Command not found when starting the server
Make sure you installed the package inside the virtual environment ('pip install -e .' with the venv activated) and that the venv path in your MCP config matches where you installed it. Run 'which ebay-mcp' inside the activated venv to find the correct path.
Frequently Asked Questions about eBay
What is eBay?
eBay is a Model Context Protocol (MCP) server that 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. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install eBay?
Install via npm with the command: npx -y ebay. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with eBay?
eBay works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is eBay free to use?
Yes, eBay is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
eBay Alternatives — Similar Business Applications Servers
Looking for alternatives to eBay? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台,「低代码 + 零代码」双模式驱动:低代码一键生成前后端代码,零代码 5 分钟搭建系统,AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等,兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式,消除 Java 项目 80% 的重复工作,提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理,能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长,比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入,可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI,能处理文本、语音、图片和文件,可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up eBay in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use eBay?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.