SellerChamp 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

Tool	Description
sellerchamp_get_marketplace_accounts	Get all connected marketplace accounts (Amazon, eBay, Shopify, etc.) with account IDs

Orders

Tool	Description
sellerchamp_get_orders	List orders with filtering by status, marketplace, date range
sellerchamp_get_order	Get full order details (items, shipping address, tracking)
sellerchamp_update_order	Update tracking number, carrier, or notes
sellerchamp_acknowledge_order	Acknowledge/confirm an order

Products

Tool	Description
sellerchamp_get_products	Get products with filtering (SKU, ASIN, UPC, marketplace, tags)
sellerchamp_get_products_compact	Get products with essential fields only (lighter response)
sellerchamp_get_product	Get a single product by SKU or product ID
sellerchamp_update_product	Update pricing, quantity, title, condition, and more
sellerchamp_set_product_pricing	Set min/max/retail/cost price by SKU
sellerchamp_set_product_quantity	Set available quantity by SKU
sellerchamp_bulk_update_products	Bulk update up to 1,000 products at once

Cross-Listing & Analysis

Tool	Description
sellerchamp_find_missing_listings	Find SKUs on one marketplace but missing from another — any pair (full catalog scan)
sellerchamp_find_crosslist_candidates	Find products by per-marketplace status filters across any connected marketplace

Variants

Tool	Description
sellerchamp_get_variants	Get all variants for a product (sizes, colors, etc.)
sellerchamp_update_variant	Update a variant's pricing or inventory

Inventory Locations

Tool	Description
sellerchamp_get_inventory_locations	Get warehouse bin locations for a product
sellerchamp_bulk_update_inventory	Bulk update inventory quantities across locations (up to 1,000)

Manifests

Tool	Description
sellerchamp_get_manifests	Get manifests (listing collections), optionally filtered by marketplace

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