@agentutility/mcp-retail

Product copy + product discovery, per call.

Turn a product name into a marketing-ready description and selling points, and turn a shopping query into ranked products with buy links and prices. The e-commerce primitives a shopping or merchandising agent needs.

Pricing: pay-per-call in USDC on Base. No subscriptions, no API keys. See per-tool prices below.

Install — Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "agentutility-retail": {
      "command": "npx",
      "args": ["-y", "@agentutility/mcp-retail"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HEX" }
    }
  }
}

Restart Claude Desktop. 8 tools appear in the tool palette.

Install — Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "agentutility-retail": {
      "command": "npx",
      "args": ["-y", "@agentutility/mcp-retail"],
      "env": { "X402_PRIVATE_KEY": "0x..." }
    }
  }
}

Funding

Send any amount of USDC on Base mainnet to the address derived from your X402_PRIVATE_KEY. The MCP server uses it to pay for tool calls automatically.

USDC on Base contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Tools (8)

| Tool | Description | |---|---| | find-products | (0.02 USDC/call) Find products API (alias of product-search). Returns ranked product results with buy links, retailer, snippet, and detected price for a shopping query. Backed by Decodo Google search scoped to buy intent. | | product-describe | (0.01 USDC/call) Writes conversion-focused product descriptions and listing copy from a product name and optional category, audience, and attributes. Returns a description, bullet selling points, key features, a positioning angle, and suggested listing titles. AI-written copy generated from the facts you supply; it does not invent specs or claims. Use it as a product description generator, e-commerce copywriter, or selling points API. | | product-description | (0.01 USDC/call) Product description API (alias of product-describe). Turns a product name + attributes into a marketing-ready description, selling points, key features, and listing titles. AI-written copy from supplied facts only. | | product-search | (0.02 USDC/call) Searches shopping results for a product query (and optional retailer), returning ranked results with product title, buy link, retailer domain, snippet, and any detected price. Backed by Decodo Google search scoped to buy intent. For general web search use search/web-search. Use it as a product search or shopping search API to find products and buy links for agents. | | return-policy-extract | (0.015 USDC/call) Turns a merchant's raw return policy text into structured refund terms an agent can act on before buying or returning something. Send the policy wording pasted from a terms page, packing slip, or support doc and get back the return window in days, restocking fee, condition requirements, whether an RMA is required, listed exceptions, and refund method. This is return policy extract, not advice: every field is pulled from the text you send, and anything the policy doesn't state comes back null instead of guessed. Use it as a return policy extract API, refund terms parser, restocking fee checker, or RMA parse tool ahead of a purchase or return decision. | | shop-search | (0.02 USDC/call) Shopping search API (alias of product-search). Find products and buy links for a query with title, buy link, retailer, snippet, and detected price. Backed by Decodo Google search scoped to buy intent. | | sku-normalize | (0.01 USDC/call) Turns a messy marketplace product title or SKU string into structured attributes for catalog matching: brand, model, variant, capacity, color, and a canonical key you can join against other catalogs. Feed it the raw title (or SKU) plus an optional category hint and it derives each attribute from what the string implies, with a confidence score, instead of guessing at specs the string doesn't carry. Use it as a sku normalize API, product title parse tool, catalog matching helper, or product attribute extraction service for price-comparison feeds and marketplace listings. | | warranty-parse | (0.015 USDC/call) Turns raw warranty terms text from a manual, warranty card, or manufacturer page into a structured coverage record an agent can check before a purchase or claim. Send the warranty wording and get back what's covered, duration in months, exclusions, the claim process, and whether coverage transfers to a new owner. This is warranty parse and coverage terms extraction, not a legal read on your rights: every field comes from the text you send, and anything unstated comes back null rather than guessed. Use it as a warranty parse API, coverage terms extractor, warranty duration checker, or claim process extraction tool. |

How it works

1. Agent calls a tool (e.g. find-products).
2. MCP server POSTs to https://x402.agentutility.ai/find-products.
3. The endpoint responds HTTP 402 with payment instructions.
4. The MCP server signs an EIP-3009 USDC transfer authorization with X402_PRIVATE_KEY and retries.
5. CDP facilitator settles on Base.
6. The endpoint returns the actual response.

The agent never sees the payment flow — it just gets the result.

Links

• Cluster overview: https://agentutility.ai/retail/
• All MCP packages: https://mcp.agentutility.ai/
• Source: https://github.com/rooz21/x402/tree/main/packages/mcp-retail

Version: 0.2.1 · License: MIT