Skip to main content

CartScout MCP server

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

Tool What the agent gets Uses
get_product Price, list price and discount, stock, variants (sizes, colours) with their own price and stock, SKU / GTIN, rating, optional reviews and description 1 extraction
compare_products 2-10 pages ranked: cheapest, cheapest in stock, best rated, biggest discount, price spread, same product by GTIN 1 extraction per URL, PRO plan or higher
check_deal Deal rating of the current price against its recorded history, with average, lowest and highest price 1 extraction (or none with refresh: false)
get_price_history Recorded price and stock changes with current, lowest and highest price No 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

claude mcp add cartscout -e RAPIDAPI_KEY=your-rapidapi-key -- uvx --from git+https://github.com/Veselin15/cartscout-mcp cartscout-mcp

Claude Desktop

Settings → Developer → Edit config, then add:

{
  "mcpServers": {
    "cartscout": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Veselin15/cartscout-mcp", "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

Variable Default Purpose
RAPIDAPI_KEY required Your RapidAPI key
CARTSCOUT_RAPIDAPI_HOST cartscout-api.p.rapidapi.com RapidAPI host of the API
CARTSCOUT_API_URL, CARTSCOUT_API_KEY unset Use 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

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

uv sync
uv run pytest

License

MIT

Release files for cartscout-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cartscout-mcp 0.1.0
File Size Uploaded
cartscout_mcp-0.1.0.tar.gz 15.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for cartscout-mcp 0.1.0
File Interpreter ABI Platform
cartscout_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 28.3 kB

Release files / cartscout_mcp-0.1.0.tar.gz

Download URL cartscout_mcp-0.1.0.tar.gz
Size 15.3 kB
Tags Source
SHA-256 checksum
How to use checksums
820e17232f1ef866f3918a4675d62a021d7aba069852b2c3338630bd603d2547
BLAKE2b-256 checksum
How to use checksums
5c75d0afa45522f5600fbf888fe25e7af0d3126f2f976b0e643000de49fb33ab
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.

Transparency log

Release files / cartscout_mcp-0.1.0-py3-none-any.whl

Download URL cartscout_mcp-0.1.0-py3-none-any.whl
Size 13.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1238df334076fedb4e44cecae450f3a429d79eb09283d372605808d3f0c8fab9
BLAKE2b-256 checksum
How to use checksums
a13fe7af7f758e003e45a85019395464c4621e338636a0a0c133ea952055f924
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page