SellerChamp MCP Server

An MCP (Model Context Protocol) server that connects AI agents to the SellerChamp API for inventory reporting, cross-listing analysis, and multi-marketplace management.

Why This Exists

SellerChamp is a great platform for managing multi-marketplace ecommerce, but its built-in reporting has gaps. This MCP server fills those gaps by giving AI agents (Claude, etc.) direct access to your SellerChamp data so you can:

• Find missing listings — discover SKUs listed on one marketplace but missing from another (any pair: Amazon, eBay, Shopify, Walmart, etc.)
• Cross-listing analysis — filter your catalog by per-marketplace status across any combination of connected marketplaces
• Bulk inventory reporting — scan your entire catalog and get structured data back, not spreadsheets
• Order management — query, filter, and update orders across all marketplaces from one interface

None of these workflows are available as a single action in SellerChamp's UI.

Available Tools (20)

Marketplace Accounts

Orders

Products

Cross-Listing & Analysis

Variants

Inventory Locations

Manifests

Setup

Prerequisites

• Python 3.8+
• A SellerChamp account with API access
• Your API token (found in SellerChamp → Settings → API Settings)

Install

git clone https://github.com/WowWashington/sellerchamp-mcp.git
cd sellerchamp-mcp

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Configure Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "sellerchamp": {
      "command": "/path/to/sellerchamp-mcp/venv/bin/python",
      "args": ["/path/to/sellerchamp-mcp/server.py"],
      "env": {
        "SELLERCHAMP_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Replace /path/to/sellerchamp-mcp with the actual path where you cloned the repo.

Run Standalone

export SELLERCHAMP_API_TOKEN="your_api_token_here"
./run.sh

Example Workflows

Find items on Amazon but missing from eBay

Use sellerchamp_find_missing_listings with:
  source_marketplace: "amazon"
  missing_from_marketplace: "ebay"

Find items on Shopify but missing from Walmart

Use sellerchamp_find_missing_listings with:
  source_marketplace: "shopify"
  missing_from_marketplace: "walmart"

Legacy call (still works)

Use sellerchamp_find_missing_listings with missing_from="ebay"

Automatically sets source to "amazon" for backwards compatibility.

Cross-list candidates: active on Amazon, missing from eBay

Use sellerchamp_find_crosslist_candidates with:
  marketplace_filters: '{"amazon": "active", "ebay": "missing"}'
  min_quantity: 1

Cross-list across 3 marketplaces

Use sellerchamp_find_crosslist_candidates with:
  marketplace_filters: '{"amazon": "active", "shopify": "active", "walmart": "missing"}'

Returns SKUs active on both Amazon and Shopify but not listed on Walmart.

Filter by country (e.g. Canada only)

Use sellerchamp_find_missing_listings with:
  source_marketplace: "amazon"
  missing_from_marketplace: "ebay"
  country_code: "CA"

Get open orders from a specific marketplace

1. Use sellerchamp_get_marketplace_accounts to get the account ID
2. Use sellerchamp_get_orders with order_status="open" and the marketplace_account_id

Bulk price update

Use sellerchamp_bulk_update_products with an array of:
  { "sku": "ABC-123", "retail_price": 29.99, "min_price": 24.99 }

Rate Limiting

The server enforces SellerChamp's API limit of 120 requests per 60 seconds using a sliding window rate limiter. It caps at 110 requests per window to leave headroom for automatic retries. When the limit is reached, the server sleeps until capacity is available (logged to stderr for visibility).

Automatic retries with exponential backoff handle transient 429/5xx errors.

Technical Details

• Protocol: MCP (Model Context Protocol) over JSON-RPC 2.0 on stdin/stdout
• Language: Python 3
• Dependencies: requests (with urllib3 retry adapter)
• Catalog scan time: ~2 minutes for 20,000 listings (rate-limit bound)

License

MIT