The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the BizNetAI listing page.
A hosted Model Context Protocol server that routes natural-language shopping queries to live, independent merchant storefronts and returns normalized product and merchant results — built for AI agents and shopping assistants that need real-time commerce data without integrating each merchant individually.
This repository documents the hosted service — there is nothing to install or run locally. Point your MCP client at the endpoint below with an API key and start calling tools.
18,000+ live merchants and growing, across the US and Canada.
Current focus verticals:
skincare · haircare · cosmetics · personal_care · sports_active_wear · clothing · accessories · fine_jewelry · fashion_jewelry · specialty_food · gourmet_food · food_and_beverage · home_decor · home_furnishings · candles_fragrance · wellness · luxury · electronics · consumer_goods · pet · baby_kids
Use list_categories for the authoritative, up-to-date list at query time — new verticals are added periodically.
Use find_merchants for live merchant coverage — also updated periodically.
| URL | https://biznetaimcp.consumergenie.net/mcp |
| Transport | streamable-http |
| Auth | Required — Authorization: Bearer <api_key> on every request |
The server is stateless per request — there is no session handshake to perform first.
Access is self-serve:
bnai_live_...). It's shown
once and never stored in plaintext anywhere — if you lose it, request a new one.Each key has its own rate limit (default 60 requests/minute). Exceeding it returns
429 with a Retry-After header; a missing, invalid, or revoked key returns 401.
Most clients speak stdio, so bridge through
mcp-remote, passing your key as a header:
list_categoriesReturn the full BizNetAI merchant category vocabulary. Useful for understanding what kinds of merchants are available before querying.
find_merchantsFind live merchants matching a query — useful when you want merchant identity before doing a custom product lookup.
list_product_varietiesList the product varieties available for a country, with how many results each has.
find_products always resolves your query to one of these, so this is useful for
discovering what specific product searches are likely to succeed — and how many
results to expect — before calling it.
Returns a list of variety objects:
Varieties are country-specific — the same product type can exist under a differently-worded variety, or not at all, in a different country.
find_productsSearch for products by matching your query to one of BizNetAI's curated product
varieties (e.g. "wireless headphones", "vitamin c serum") and returning that
variety's already-ranked top results. Call list_product_varieties first if you
want to see upfront what's available for a country before searching.
Results are capped by how many products the matched variety has (usually around 50,
sometimes fewer for a niche search) — offset/limit beyond that returns whatever's
left, not an error. A query that doesn't match any known variety returns [].
Returns a list of normalized product objects:
available reflects whether at least one product variant was in stock as of the last
catalog refresh (boolean only — exact stock counts aren't available from all merchant
backends). relevance_score is a similarity score (higher is more relevant) — there's
no cutoff applied, so you can use it yourself to judge what's a good enough match for
your use case.
| Status | Meaning |
|---|---|
401 | Missing, malformed, invalid, or revoked API key |
429 | Rate limit exceeded — see Retry-After header for when to retry |
Questions or issues with the API — email the address you used to request your key, or open an issue on this repository.