BizNetAI

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:

1. Submit a request with your email, name, and a short description of your use case:

   curl -X POST https://api.merchant.registration.consumergenie.net/api/developer-keys \

-H "Content-Type: application/json" \ -d '{"email": "you@example.com", "name": "Your Name", "reason": "Building an AI shopping assistant"}'

2. 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:

{

"mcpServers": { "biznetai": { "command": "npx", "args": [ "-y", "mcp-remote", "https://biznetaimcp.consumergenie.net/mcp", "--header", "Authorization:Bearer ${BIZNETAI_API_KEY}" ] } } }

Raw HTTP

BASE_URL="https://biznetaimcp.consumergenie.net/mcp"

API_KEY="bnai_live_..."

curl -X POST "$BASE_URL" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer $API_KEY" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_categories","arguments":{}}}'

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.

query    str   required   Natural language search query

country str required ISO country code (e.g. US, CA) limit int 0 Max merchants to return (0 = all live matches)

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.

country   str   required   ISO country code (e.g. US, CA)

category str omit One value from list_categories; omit for every category limit int 0 Page size (0 = the server page cap, 10,000) offset int 0 Skip this many merchants; combine with limit to page

Returns merchants sorted by store_domain:

{

"store_domain": "naturium.com", "store_url": "https://naturium.com", "mcp_endpoint": "https://naturium.com/api/mcp", "categories": ["skincare"], "source_country": "US", "last_seen_at": "2026-06-07T02:18:00Z" }

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.

country  str   required   ISO country code (e.g. US, CA)

Returns a list of variety objects:

{

"variety": "wireless headphones", "product_count": 50 }

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.

query    str   required   Natural language product search query

country str required ISO country code (e.g. US, CA) limit int 0 Page size (0 = server default) offset int 0 Results to skip, for paging beyond the first page

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:

{

"title": "Vitamin C Brightening Serum", "description": "...", "price_min": 24.60, "price_max": 24.60, "currency": "USD", "available": true, "url": "https://merchant.com/products/vitamin-c-serum", "image_url": "https://cdn.shopify.com/...", "store_domain": "merchant.com", "mcp_endpoint": "https://merchant.com/api/mcp", "merchant_position": 0, "relevance_score": 0.79 }

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

MIT