BizNetAI

io.github.biznetaiPublished by GitHub account biznetaiv1.0.0Updated Oct 25, 2026

Routes natural-language shopping queries to merchant storefronts, returns normalized results.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated 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.
Before you install
The API key is shown once and cannot be recovered; treat it as a secret and keep it out of shared configs. Each key is rate limited (default 60 requests per minute), and exceeding it returns 429. Results come from third-party merchant catalogs, so prices, availability and relevance scores may be stale or incomplete, and some listed merchant endpoints may be temporarily unreachable.

Installation

In SourceWeft

  1. Open BizNetAI in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. 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.

Read the install guide the agent follows

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

URLhttps://biznetaimcp.consumergenie.net/mcp
Transportstreamable-http
AuthRequired — Authorization: Bearer <api_key> on every request

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:
    bash
    curl -X POST https://api.merchant.registration.consumergenie.net/api/developer-keys \  -H "Content-Type: application/json" \  -d '{"email": "[email protected]", "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:

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

Raw HTTP

bash
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 querycountry  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 categorylimit     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:

json
{  "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:

json
{  "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 querycountry  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:

json
{  "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

StatusMeaning
401Missing, malformed, invalid, or revoked API key
429Rate limit exceeded — see Retry-After header for when to retry

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

Source: README.md at commit 7a409d0

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  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