Universal shopping MCP server · PayPal Sandbox checkout

One AI. Every Store. The Best Deal.

Ask in plain language. ShopMCP searches every connected retailer, identifies identical products, compares real totals including shipping, and explains the best deal — without ever inventing a price.

Press “Run live search” — this calls the ShopMCP backend, queries every connector in parallel and matches identical products.

How ShopMCP works

From a sentence to a verified, explained recommendation.

1 · Understand

Your natural-language request becomes structured intent: product, budget, country, condition, GTIN.

2 · Search every store

Official retailer APIs and merchant-authorised stores are queried in parallel with timeouts, retries and rate limits.

3 · Match identical products

GTIN, brand + model, MPN and specs decide identity. Different storage, size, colour or condition are never merged.

4 · Rank and explain

Cheapest, best overall value, fastest verified delivery and top-rated seller — with the reasoning and every missing field called out.

Retailers & integrations

Modular connectors on a common interface. Status below is read live from the backend — real mode, not marketing.

Official APIs, merchant-authorised connections and permitted affiliate feeds only. No scraping.

An assistant you can trust with a budget

Asks before assuming

Vague request? It asks for brand, model, storage or budget instead of guessing.

Explains equivalence

Shows exactly why listings are exact, high-confidence or merely similar.

Never invents data

Missing price, stock, shipping or ratings are marked unavailable. Demo fixtures are always labelled.

Never buys on its own

Checkout needs your explicit confirmation — twice: in chat and on the payment screen.

Model Context Protocol

Plug ShopMCP into ChatGPT or Claude

A remote MCP server over HTTPS (Streamable HTTP) built with the official Python SDK. Bearer API keys, per-key rate limits, audit logs and validated JSON schemas on every tool.

  • search_products
  • compare_prices
  • get_product_details
  • find_best_deal
  • get_available_retailers
  • add_to_wishlist
  • create_cart
  • create_checkout
  • get_order_status
  • get_price_history
Claude Code
claude mcp add --transport http shopmcp https://shopmcp.autobot360.com/mcp \
  --header "Authorization: Bearer smcp_YOUR_KEY"
MCP Inspector
npx @modelcontextprotocol/inspector
# Transport: Streamable HTTP
# URL: https://shopmcp.autobot360.com/mcp
# Header: Authorization: Bearer smcp_YOUR_KEY

PayPal Sandbox checkout, verified server-side

A real Orders v2 transaction against the ShopMCP demo merchant — approved by a Sandbox buyer and captured by the backend.

Create order

Amount recomputed from the database. The browser's total is never trusted.

Buyer approves

Redirect to PayPal Sandbox login and approval.

Capture

Backend captures and verifies order id, amount, currency and reference.

Webhooks

Signature-verified, idempotent events as a second source of truth.

Confirmed

Order and receipt shown only after PayPal confirms capture.

PayPal Sandbox demonstrates a purchase from the ShopMCP demo merchant only. It does not pay unrelated retailers on your behalf — external marketplaces use their own authorised checkout.

Security & privacy by design

Built so judges — and real users — can trust what they see.

  • Secrets stay on the server

    Retailer & PayPal credentials are encrypted at rest and never reach the browser.

  • Row Level Security

    Supabase RLS on every table; users only read their own records.

  • Hashed API keys

    Only SHA-256 hashes are stored; keys are revocable and rate limited.

  • Idempotent payments

    Request ids, unique constraints and verified webhooks prevent double charges.

  • Explicit consent

    No purchase without an explicit confirmation. No automatic payments.

  • Audit trail

    Every MCP tool call, admin change and payment event is logged.

Prototype tier
Free

Open-source hackathon prototype

  • Unlimited comparisons (rate limited)
  • All connectors you configure
  • MCP server + 10 tools
  • PayPal Sandbox demo checkout
  • Wishlist and recorded price history

Frequently asked questions

Does ShopMCP pay other retailers for me?+

No. PayPal Sandbox demonstrates a payment to the ShopMCP demo merchant only. For external marketplaces you are redirected to the retailer's own authorised checkout.

Are the prices live?+

Prices come from retailer APIs when credentials are configured (status shown per connector). Without credentials, connectors fall back to clearly labelled demo fixtures that cannot be purchased.

How do you decide two listings are the same product?+

Deterministically: identical GTIN/UPC/EAN, then brand + model number, manufacturer part number, title similarity and specifications. AI only explains the verdict; it never creates identity.

What data is stored?+

Searches, wishlist, orders and payment records live in your Supabase project behind Row Level Security. Retailer and PayPal secrets stay on the backend, encrypted at rest.

Can I use it from ChatGPT or Claude?+

Yes. Create an API key in the dashboard and connect the remote MCP server over HTTPS. Ten tools are exposed with validated schemas, auth, rate limits and audit logs.

Is there any price history?+

Only what ShopMCP has actually observed. If there are fewer than two observations, the chart says so rather than drawing a trend.