
BizNetAI
io.github.biznetaiPublished by GitHub account biznetaiv1.0.0Updated Oct 25, 2026
Routes natural-language shopping queries to merchant storefronts, returns normalized results.
Overview
Hosted MCP server that routes natural-language shopping queries to live independent merchant storefronts and returns normalized product and merchant results.
- What you can do
- List merchant categories and the merchant directory by country, with paging and optional category filter, or find live merchants matching a query with reachability confirmed now. List the product varieties available for a country and how many results each has. Search products by matching a query to a curated variety and return that variety's ranked, normalized results with prices, availability, URLs and relevance scores.
- When to use it
- Use it when building an AI shopping assistant or agent that needs real-time product and merchant data from many independent US and Canadian storefronts without integrating each merchant separately. It suits discovery of which merchants and product varieties exist in a country before running targeted searches.
- Requirements
- A remote streamable-HTTP endpoint; nothing to install locally. A bearer API key in the Authorization header on every request, obtained by submitting an email, name and use-case description for approval. Clients that only speak stdio need a bridge such as mcp-remote. Network access to the hosted service.
Installation
In SourceWeft
- Open BizNetAI in the dashboard and add it to a workspace.
- Connect Authorization token credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.biznetai%2Fbiznetai-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config.
{
"mcpServers": {
"biznetai": {
"type": "http",
"url": "https://biznetaimcp.consumergenie.net/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}README
BizNetAI MCP Server
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.
Merchant Coverage
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, or list_merchants for the complete merchant directory (no liveness filtering) — both updated periodically.
Endpoint
The server is stateless per request — there is no session handshake to perform first.
Getting an API Key
Access is self-serve:
- Submit a request with your email, name, and a short description of your use case:
- Once approved, you'll receive an email with your key (
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.
Connecting
MCP client (Claude Desktop, Claude Code, etc.)
Most clients speak stdio, so bridge through
mcp-remote, passing your key as a header:
Raw HTTP
Tools
list_categories
Return the full BizNetAI merchant category vocabulary. Useful for understanding what kinds of merchants are available before querying.
find_merchants
Find live merchants matching a query — useful when you want merchant identity before doing a custom product lookup.
list_merchants
List every active merchant straight from the database — no liveness probing and no
ranking, so the result is complete and the same from one call to the next. Use it when
you need the merchant directory; use find_merchants when you need endpoints confirmed
reachable right now (a merchant whose endpoint is slow to answer can be missing from a
find_merchants result). Some listed endpoints may be temporarily unreachable.
Returns merchants sorted by store_domain:
list_product_varieties
List 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_products
Search 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.
Rate Limits & Errors
Support
Questions or issues with the API — email the address you used to request your key, or open an issue on this repository.
License
Source: README.md at commit 7a409d0
Tools
0Version history
1- v1.0.0LatestSep 16, 2026
Score
85% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts