Skip to content

v1.0.0 - Initial Production Release

Choose a tag to compare

View all tags
@YosefHayim YosefHayim released this 12 Nov 14:36
· 533 commits to main since this release
v1.0.0
57f186b

🚀 Initial Production Release

This is the first production-ready release of the eBay API MCP Server, providing comprehensive access to eBay's Sell APIs through the Model Context Protocol.

✨ Added

Core Infrastructure

  • 170+ eBay Sell API tools across 9 categories:
    • Account Management (28 tools)
    • Inventory Management (30 tools)
    • Fulfillment (4 tools)
    • Marketing & Promotions (9 tools)
    • Analytics & Reporting (4 tools)
    • Communication (20+ tools)
    • Metadata (25 tools)
    • Taxonomy (4 tools)
    • Other (8+ tools)

Transport Modes

  • STDIO transport for local MCP clients (Claude Desktop, etc.)
  • HTTP transport with OAuth 2.1 for multi-user remote deployments
  • Support for both sandbox and production eBay environments

Authentication & Security

  • OAuth 2.0/2.1 authentication with automatic token refresh
  • File-based token persistence (.ebay-mcp-tokens.json)
  • Two-tier authentication strategy:
    • User tokens (priority): 10k-50k req/day, full API access
    • App tokens (fallback): 1k req/day, limited access
  • Secure token storage with automatic expiry handling

Rate Limiting & Error Handling

  • Client-side rate limiting (5000 req/min)
  • Automatic retry on 429 rate limit errors
  • Exponential backoff for 5xx server errors (3 retries max)
  • Comprehensive error messages with eBay API context

Type Safety & Validation

  • OpenAPI-generated TypeScript types for all API responses
  • Zod validation schemas for all tool inputs
  • Path aliases (@/) for clean imports
  • Strict TypeScript configuration

Testing & Quality

  • 870 tests across 26 test files
  • 99%+ function coverage
  • 85%+ line coverage
  • Unit tests for all API categories
  • Integration tests for MCP transports

Documentation

  • Comprehensive README with quick start guide
  • OAUTH-SETUP.md for authentication guide
  • CLAUDE.md for AI development assistance
  • API category-specific documentation
  • Automated setup scripts with guides

Developer Experience

  • Automated MCP client configuration script
  • Type generation from OpenAPI specs
  • Hot reload development mode
  • Code formatting (Prettier) and linting (ESLint)

📊 Statistics

  • Total Tools: 170+
  • Test Coverage: 99%+ functions, 85%+ lines
  • Test Count: 870 tests
  • API Categories: 9
  • Documentation Pages: 5+

🔧 Technical Stack

  • TypeScript with strict mode
  • Node.js with ES modules
  • Zod for runtime validation
  • Axios with interceptors
  • Vitest for testing
  • OAuth 2.0/2.1 for authentication

📦 Installation

npm install ebay-api-mcp-server

🚀 Quick Start

See README.md for full setup instructions.

Full Changelog: https://github.com/YosefHayim/ebay-api-mcp-server/commits/v1.0.0

Assets 2
Loading