SellerChamp

Provides direct MCP access to SellerChamp data for inventory, cross-listing, and order management across marketplaces.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run a Python-based MCP server that connects AI agents to the SellerChamp API to report inventory, analyze cross-listing, and manage orders across multiple marketplaces. This server exposes a set of tools your AI can call to retrieve data, update records, and perform multi-marketplace workflows seamlessly.

How to use

You will connect an MCP client to the SellerChamp MCP server so your AI agents can access marketplace data and perform operations. Start by ensuring you have a valid SellerChamp API token, then run the local MCP server and point your MCP client to it. Use the available tools to get accounts, fetch orders and products, find missing listings, manage cross-listing candidates, and bulk update inventory or pricing. Typical tasks include locating SKU gaps between marketplaces, filtering product catalogs by market statuses, and updating orders from a single interface.

How to install

Prerequisites you need before installation:

Python 3.8+ (required)
Git installed on your system
Stable internet access

Install and set up the MCP server locally by cloning the repository, creating a virtual environment, and installing dependencies:

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

Configuration and running the server

Configure the MCP client to connect to the local server using the standard Python runtime and the server script. You will provide your SellerChamp API token to authorize requests. After configuration, you can start the server and begin making requests to the available tools.

# Example: configure Claude Desktop to connect to the local MCP server
# This snippet demonstrates the required fields and should be adapted to your environment.

Run standalone for testing

You can run the server standalone by exporting your API token and starting the run workflow. This starts the MCP server in the current environment and makes its endpoints available to your MCP client.

export SELLERCHAMP_API_TOKEN="your_api_token_here"
./run.sh

Configuration snippet for Claude Desktop (example)

The following example shows how to configure Claude Desktop to connect to the SellerChamp MCP server. Replace the paths with your actual installation paths and provide your API token.

{
  "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"
      }
    }
  }
}

Available tools

sellerchamp_get_marketplace_accounts

Retrieve all connected marketplace accounts with their account IDs.

sellerchamp_get_orders

List orders with optional filtering by status, marketplace, and date range.

sellerchamp_get_order

Fetch full details for a single order, including items, shipping address, and tracking.

sellerchamp_update_order

Update order details such as tracking number, carrier, or notes.

sellerchamp_acknowledge_order

Acknowledge or confirm an order.

sellerchamp_get_products

Get products with filtering by SKU, ASIN, UPC, marketplace, or tags.

sellerchamp_get_products_compact

Get products with essential fields only for a lighter response.

sellerchamp_get_product

Retrieve a single product by SKU or product ID.

sellerchamp_update_product

Update pricing, quantity, title, condition, and other product attributes.

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.

sellerchamp_find_missing_listings

Find SKUs on one marketplace that are missing from another across the full catalog.

sellerchamp_find_crosslist_candidates

Find products by per-marketplace status filters across connected marketplaces.

sellerchamp_get_variants

Get all variants for a product (sizes, colors, etc.).

sellerchamp_update_variant

Update a variant's pricing or inventory.

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).

sellerchamp_get_manifests

Get manifests (listing collections), optionally filtered by marketplace.