CartScout

io.github.Veselin15Published by GitHub account Veselin15v0.1.0Updated Oct 24, 2026

Live product prices, stock, variants and deal ratings from Shopify, Walmart, eBay and more.

Overview

AI-generated overview

CartScout lets an assistant read live product prices, stock, variants and deal ratings from product URLs on Shopify, WooCommerce, Walmart and eBay stores.

What you can do
Fetch a product's price, discount, stock, variants, SKU/GTIN, rating and optional reviews or description from a product URL, with results cached up to 60 minutes and trimmed unless details are requested. Compare 2-10 listings to rank cheapest, cheapest in stock, best rated and biggest discount, or match the same product by GTIN. Rate a current price against recorded history and retrieve recorded price and stock changes with current, lowest and highest prices. All tools are read-only and return structured JSON.
When to use it
Useful when you want an assistant to judge whether a listed price is good, compare the same product across several store links, check whether a size or colour is in stock, or review how a product's price moved over time. It reads product pages only, so you supply the URLs or find them with a search tool first.
Requirements
Runs locally as a Python package via uvx (or Docker). Needs a RapidAPI subscription to CartScout and a RAPIDAPI_KEY environment variable; the free plan includes 300 extractions a month. CARTSCOUT_RAPIDAPI_HOST defaults to the CartScout API host, and a directly issued CartScout key can be used instead. Network access is required.
Before you install
The RAPIDAPI_KEY is a secret passed by environment variable; when serving over HTTP, every connected client uses that same key, so keep it on a private address. Tool calls consume paid extractions from your plan, and compare_products requires a PRO plan or higher. Only the product URLs you ask about are sent to the CartScout API. Price history is limited by plan (14 days on free) and is thin for newly seen products.

Installation

In SourceWeft

  1. Open CartScout in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

CartScout MCP server

[PyPI] [Tests]

Give Claude, Cursor or any MCP-capable AI agent live product prices, stock, variants and deal ratings from online stores. Paste a product link into the chat and ask "is this a good price?", "which of these three stores is cheapest and in stock?" or "does it come in size 10?".

Works with Shopify, WooCommerce, Walmart and eBay stores, with Amazon in beta. The data comes from the CartScout API, which handles fetching, bot filters and parsing. Try the API in your browser first, no sign-up needed.

Tools

ToolWhat the agent getsUses
get_productPrice, list price and discount, stock, variants (sizes, colours) with their own price and stock, SKU / GTIN, rating, optional reviews and description1 extraction
compare_products2-10 pages ranked: cheapest, cheapest in stock, best rated, biggest discount, price spread, same product by GTIN1 extraction per URL, PRO plan or higher
check_dealDeal rating of the current price against its recorded history, with average, lowest and highest price1 extraction (or none with refresh: false)
get_price_historyRecorded price and stock changes with current, lowest and highest priceNo extractions

Every tool is read-only and returns structured JSON with an output schema. Responses are trimmed for agents: bulky parts such as all variants, reviews and the description are included only when the agent asks for them.

Setup

  1. Subscribe to CartScout on RapidAPI. The free plan includes 300 extractions a month: plans.
  2. Copy your X-RapidAPI-Key from the RapidAPI dashboard.
  3. Add the server to your client. It runs with uv, which installs it on first use.

Claude Code

bash
claude mcp add cartscout -e RAPIDAPI_KEY=your-rapidapi-key -- uvx cartscout-mcp

Claude Desktop

Settings → Developer → Edit config, then add:

json
{  "mcpServers": {    "cartscout": {      "command": "uvx",      "args": ["cartscout-mcp"],      "env": { "RAPIDAPI_KEY": "your-rapidapi-key" }    }  }}

Cursor

Add the same mcpServers block to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project).

Example prompts

CartScout reads product pages; it does not search stores. Give the agent product URLs, or let it find them with a web search tool first.

Configuration

VariableDefaultPurpose
RAPIDAPI_KEYrequiredYour RapidAPI key
CARTSCOUT_RAPIDAPI_HOSTcartscout-api.p.rapidapi.comRapidAPI host of the API
CARTSCOUT_API_URL, CARTSCOUT_API_KEYunsetUse a directly issued CartScout key instead of RapidAPI

The server sends only the product URLs your agent asks about to the CartScout API. Without a key it still starts and lists its tools (handy for MCP inspectors); each tool call then explains how to add RAPIDAPI_KEY.

Docker

bash
docker build -t cartscout-mcp .docker run -i --rm -e RAPIDAPI_KEY=your-rapidapi-key cartscout-mcp

HTTP transport

cartscout-mcp --transport streamable-http --port 8000 serves the tools at http://127.0.0.1:8000/mcp. Every client connected to it uses the key from the environment, so keep it on a private address.

Good to know

  • Prices follow each store's own region and currency.
  • Results can be cached for up to 60 minutes (cached: true).
  • Price history and deal ratings build up as products are read. A product seen for the first time has little history to compare against.
  • History range depends on the plan: 14 days on the free plan, up to 365 days on MEGA.
  • When a store blocks a request, the tool returns an error explaining it, and the failed request is not billed.

Development

bash
uv syncuv run pytest

License

MIT

Source: README.md at commit 282c037

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts