# Shopscout MCP

> Shopscout MCP is a paid MCP server for e-commerce. Search the Shopify catalog, compare offers and shipping plans for $0.01 a call. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://forgemesh.io/shopscout
- **Repository:** https://github.com/forgemeshlabs/shopscout-mcp
- **MCP Registry name:** io.github.forgemeshlabs/shopscout-mcp
- **Categories:** e-commerce
- **Listing updated:** 2026-11-14

## About

ShopScout helps an agent research purchases without making them. It searches the Shopify Global Catalog by query, country, currency and price bounds, refreshes a product or variant with option selection, ranks offers for chosen variant ids by item price in one currency, and compares single-seller against split-basket shipping plans using rules the caller supplies, such as free-shipping thresholds and delivery limits. A fifth tool reads the service's capability list.

It is explicit about what it does not do: it cannot buy anything, does not verify tax, duties or landed cost, makes no claim that two listings are equivalent products and does not cache results. Shipping figures are estimates from your rules, not live carrier quotes, and an item-price winner is not necessarily a delivered-cost winner. Price watches, stock alerts and purchase planning are listed as planned and answer HTTP 501 without charge.

Each paid call costs $0.01 in USDC on Base via x402, including empty searches, though upstream failures are not charged. The npm server uses an optional wallet key, only talks to shopscout.forgemesh.io and caps spend at $0.01 per call and $10 per session.

## Features

- **Catalog search:** Query the Shopify Global Catalog by country, currency and price.
- **Offer ranking:** Rank two to ten variants by item price.
- **Shipping comparison:** Compare single-seller and split baskets against your rules.
- **Capability discovery:** Read what is live and what is planned.
- **Spending caps:** Per-call and session limits enforced in the wrapper.
- **No purchasing:** There is no checkout route.

## Good for

- Compare prices for the same variant across sellers
- Decide whether splitting a basket beats free-shipping thresholds
- Refresh a product's options before recommending it
- Let a shopping agent research without buying

## Install

### Claude Code (Terminal)

```sh
claude mcp add shopscout-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y @forgemeshlabs/shopscout-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "shopscout-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/shopscout-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "shopscout-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/shopscout-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "shopscout-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/shopscout-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "shopscout-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/shopscout-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "shopscout-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/shopscout-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `search_products`: Searches the configured Shopify catalog by query, country and currency.
- `get_product`: Refreshes a product or variant and selected options.
- `compare_offers`: Ranks selected variant ids by item price in one currency.
- `get_capabilities`: Reads the backend's capability catalog and planned features.
- `compare_shipping_plans`: Compares single-seller and split baskets against supplied shipping rules.

## FAQ

### Can it buy things?

No. There is no checkout or purchase route.

### How much does a call cost?

$0.01 in USDC on Base via x402; empty searches are still charged, upstream errors are not.

### Are shipping numbers exact?

No. They are estimates from supplied rules and exclude taxes, duties and handling.

### Do I need a wallet key?

It is optional; without it paid tools return the 402 payment challenge as data.

### Is Shopscout MCP free?

No. Shopscout MCP is a paid product.

### How do I add Shopscout MCP to Claude Code?

Run this command in your terminal: claude mcp add shopscout-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y @forgemeshlabs/shopscout-mcp

### What are the best alternatives to Shopscout MCP?

The closest alternatives to Shopscout MCP are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/shopscout-mcp
