MCP Merchant Scout

Tools

Related MCP server: agentic-commerce

Setup

git clone https://github.com/davillafer/mcp-merchant-scout.git
cd mcp-merchant-scout
npm install
npm run build

Claude Code

Create a .mcp.json file in your project directory:

{
  "mcpServers": {
    "ucp-merchant-scout": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-merchant-scout/dist/index.js"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ucp-merchant-scout": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-merchant-scout/dist/index.js"]
    }
  }
}

Usage

Once configured, use natural language in Claude:

1. Discover a merchant: "Discover the merchant at https://puddingheroes.com"

2. Search products: "Search for products under $20"

3. Search with keywords: "Find me a sci-fi book"

4. Get details: "Get details on pudding-heroes-paperback"

5. Compare: "Compare these two products side by side"

UCP Spec Compatibility

Supports both the official UCP spec (2026-01-23) and legacy implementations:

The client tries spec-compliant endpoints first and falls back to legacy formats automatically.

Live UCP Merchants

Development

npm run dev    # Run with tsx (auto-reload)
npm run build  # Compile TypeScript
npm start      # Run compiled output

Architecture

Claude <--stdio--> MCP Server <--HTTP--> Merchant A (/.well-known/ucp -> /catalog/search)
                               <--HTTP--> Merchant B (/.well-known/ucp -> /products)

The server maintains an in-memory registry of discovered merchants. Product searches fan out to all registered merchants in parallel using Promise.allSettled().

Tech Stack

• TypeScript

• @modelcontextprotocol/sdk - MCP server framework

• zod - Schema validation

• UCP (Universal Commerce Protocol) - Open commerce standard