Swervie/swervie-mcp

One scored answer per product, across every retailer, for AI agents.
Remote MCP server · Streamable HTTP · no auth · no API key · free
Developer docs ·
Tool reference ·
Connect a client ·
Response shapes ·
Data handling
https://us-central1-swervie-prod.cloudfunctions.net/mcp
Swervie is a cross-retailer product catalog built for assistants. Ask a normal
shopping question and get one consolidated, scored answer per product: live
prices, comparable specifications, review-derived ratings with verbatim evidence
quotes, and a buy link for every seller. Instead of eight duplicate listings and
a stale listicle.
Consolidated. Listings of the same product across retailers collapse into
one row. White-label clones sold under different brands are grouped too.
Structured. Every category has its own spec schema; specs are extracted
from manufacturer pages, retailer listings and spec tables, with provenance.
Scored. Each product carries a quality score and a value score, plus
review-derived sub-ratings backed by quotes from real reviews.
Deterministic and compact. No LLM in the serving path. Answers are
precomputed pipeline output: ~4k tokens, sub-second for a full shelf.
Interactive in hosts that support MCP Apps. Results render as a shelf
with sort controls, seller-by-seller offers and the review evidence
(io.modelcontextprotocol/ui extension); plain JSON everywhere else.
Coverage today: 300+ categories, from robot vacuums and televisions to
espresso machines, mattresses and hiking boots, across hundreds of sellers.
The live list is at swervie.xyz/llms.txt.
## Quick start
Claude Code
bash
claude mcp add --transport http swervie https://us-central1-swervie-prod.cloudfunctions.net/mcp
Cursor, Windsurf, VS Code, Claude Desktop, ChatGPT, Gemini CLI and others:
see docs/clients.md. Every config is the same one line, the
URL above, with no headers and no secrets.
curl
bash
MCP=https://us-central1-swervie-prod.cloudfunctions.net/mcp
H=(-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream')
# Handshake: server info, capabilities, agent instructions
curl -s -X POST $MCP "${H[@]}" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'
# A whole shopping answer in one call
curl -s -X POST $MCP "${H[@]}" -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"searchproducts","arguments":{"query":"65 inch OLED TV under $1500","limit":3}}}'
More in examples/: a Node client using the official SDK, a Python
client, and the curl script above.
## Tools
| Tool | Kind | What it does |
| searchproducts | read | The one-call path. Resolves a free-text query to a named product, an "A vs B" comparison, or a category shelf with constraints as filters and wishes as ranking preferences. Returns an interpretation receipt. |
| lookupproduct | read | One product by name, ASIN, UPC/EAN/GTIN, or brand + model. Full detail, every seller offer, and its rank on its shelf. |
| findcategory | read | The matching category and its filter contract: every filterable spec with type, units, allowed values and importance, plus price bands. |