Developers / MCP

Extension MCP for Codex and Claude Code

Codex or Claude Code sends collection tasks through MCP. Your signed-in browser extension collects the requested data and sends the results back. Collection requires the extension to be online.

Use MCP to collect Amazon reviews, product details, and BSR lists through your browser extension. MCP requires a separate key with the mcp:collect scope and uses your extension collection allowance. Check collection_capabilities first to confirm that your extension supports the tools you need.

Extension MCP capabilities

Your agent creates a task, and your signed-in SellerSide.ai extension collects the data and returns the results. For BSR, you can request the top 50 or 100 products from Best Sellers or New Releases. Provide the full URL of the category page.

  1. 1. Install the SellerSide.ai extension in your browser.
  2. 2. Sign in to the extension with the same SellerSide.ai account and check that it is connected.
  3. 3. Create an MCP key with the mcp:collect scope in your account settings, then connect Codex or Claude Code.

Codex

Add the server to your Codex config.toml file. The key is read from a local environment variable.

config.toml
[mcp_servers.sellerside]
url = "https://sellerside.ai/api/v1/developer/mcp"
bearer_token_env_var = "SELLERSIDE_MCP_KEY"

Copy this example to use in your own setup. This page does not send requests.

Claude Code

Add an HTTP server to your personal or project MCP configuration. Never commit your actual key to a code repository.

MCP configuration
{
  "mcpServers": {
    "sellerside": {
      "type": "http",
      "url": "https://sellerside.ai/api/v1/developer/mcp",
      "headers": {
        "Authorization": "Bearer ${SELLERSIDE_MCP_KEY}"
      }
    }
  }
}

Copy this example to use in your own setup. This page does not send requests.

Both clients connect to the same SellerSide.ai MCP endpoint. Your signed-in extension runs the collection tasks; Codex and Claude Code do not collect the browser data themselves.

Available tools

  • collection_capabilities — Check support and connection status for reviews, product details, and BSR lists.
  • collect_amazon_product — Submit asin, market, and idempotencyKey to collect product details. Returns a UUID task ID.
  • collect_amazon_bsr — Submit categoryUrl, market, listType, limit (50 or 100), and idempotencyKey to collect a ranking. Returns a UUID task ID.
  • get_data_collection_result — Pass the UUID as captureId to read the status, data, and missing fields. Reading results does not use another collection unit.
  • cancel_data_collection — Cancel an unfinished product detail or BSR task. Its collection unit is refunded once.
  • collect_amazon_reviews — Queue an Amazon review task using asin and a consistent idempotencyKey. Uses one unit of your extension ASIN allowance.
  • get_collection_status — Check the status of a review task in your account.
  • get_collection_reviews — Read saved reviews by page.
  • cancel_collection — Cancel a review task in your account.

Supported platforms and data

PlatformDataMCP support
AmazonReviewsCollected by your browser extension
AmazonProduct details / BSR listsCollected by your browser extension; a compatible version is required
eBay / Walmart / MercadoLibreReviewsNot available through MCP

FAQ

Do I need a separate MCP plan? No. MCP uses your existing paid membership and extension collection allowance. Can I collect data while the extension is offline? No, the extension must be connected. Does reading saved results use more allowance? No.

Product details and BSR results are kept for 7 days. Unfinished tasks time out after 5 minutes, and the collection unit is refunded. Prices and rankings reflect the page at the time of collection. Missing fields mean the information was not available. Rating counts may include ratings without written reviews.