English Français العربية

io.github.thomenz/brmarket-mcp

Registre officiel Recherche et web

FREE Brazilian marketplace search (ML, Shopee, AliExpress) + import-tax calculator (x402)

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package brmarket-mcp
Claude Code 
claude mcp add brmarket-mcp -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -e 'SOLANA_PRIVATE_KEY=<your solana_private_key>' -e 'SOLANA_RPC_URL=<SOLANA_RPC_URL>' -e 'BRMARKET_BASE_URL=<BRMARKET_BASE_URL>' -e 'X402_NETWORK=<X402_NETWORK>' -- npx -y brmarket-mcp@0.3.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "brmarket-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "brmarket-mcp@0.3.0"
            ],
            "env": {
                "EVM_PRIVATE_KEY": "<your evm_private_key>",
                "SOLANA_PRIVATE_KEY": "<your solana_private_key>",
                "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
                "BRMARKET_BASE_URL": "<BRMARKET_BASE_URL>",
                "X402_NETWORK": "<X402_NETWORK>"
            }
        }
    }
}

Variables d'environnement

  • EVM_PRIVATE_KEY secret 0x private key of a DEDICATED wallet holding USDC on Base. OPTIONAL: product search and the tax calculator are free and work without any wallet; only search_by_image and the link comparison return 402 without it.
  • SOLANA_PRIVATE_KEY secret base58 or JSON-array secret key of a DEDICATED Solana wallet holding USDC (pays per call). Configure this and/or EVM_PRIVATE_KEY; the x402 layer settles on whichever rail the 402 advertises.
  • SOLANA_RPC_URL Optional Solana RPC override used to build the payment (e.g. a Helius URL).
  • BRMARKET_BASE_URL Base URL of a brmarket Worker. Defaults to the hosted production API (https://brmarket.thomenz.me).
  • X402_NETWORK 'base' (mainnet, default) or 'base-sepolia' (testnet).

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. brmarket-mcp
  2. Tools
  3. Install
  4. Environment
  5. Develop
  6. Publishing (manual — Thiago only)
  7. License

brmarket-mcp

MCP server for Brazilian marketplace product search, paid automatically with x402 micropayments (USDC on Base or Solana).

One call searches Mercado Livre, Shopee and AliExpress together and returns a single normalized shape: BRL prices in integer cents, canonical + affiliate links, and a per-marketplace sources state so a degraded marketplace is never silent. A free import-tax calculator turns a price into the real landed price — the honest "best value with Brazilian import tax" comparison.

Status: not published yet. brmarket-mcp@0.1.0 is built and ready; publishing to npm and the MCP registry is a manual step. See Publishing below.

Tools

ToolPriceWhat it does
search_products$0.01Mercado Livre + Shopee + AliExpress in one call. Normalized BRL prices (integer cents), canonical + affiliate links, free shipping, rating, sold count, seller id/name/official-store, dataAsOf.
search_by_image$0.05Same, but from a product photo. Returns interpreted_query so you can see what was actually searched.
search_products_previewfreeOne result, canonical link only, no affiliate link.
calculate_import_taxesfreeBrazilian import tax + landed price of a cross-border purchase (Import Tax 0% ≤ US$50 else 30% − US$20, ICMS por-dentro by state, Bacen PTAX rate). BRL cents or USD in; pass uf on search_products too for per-offer landed_price_estimate.
Always read sources

Every response reports each marketplace as ok / error / timeout / not_configured. A short result list may mean a marketplace was down, not that the market is thin. Never present a degraded page as the whole market.

Install

npx brmarket-mcp

Claude Desktop / Claude Code (claude_desktop_config.json):

{
  "mcpServers": {
    "brmarket": {
      "command": "npx",
      "args": ["-y", "brmarket-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x…"
      }
    }
  }
}

The free preview tool works with no wallet at all.

Environment

VariableRequiredDescription
EVM_PRIVATE_KEYno0x… key of a dedicated wallet holding USDC on Base.
SOLANA_PRIVATE_KEYnobase58 or JSON-array secret key of a dedicated Solana wallet holding USDC.
SOLANA_RPC_URLnoRPC override used to build the Solana payment (e.g. a Helius URL).
BRMARKET_BASE_URLnoDefaults to https://brmarket.thomenz.me.
X402_NETWORKnobase (default) or base-sepolia.

Configure either rail, or both — the x402 layer settles on whichever the server's 402 advertises. Without any key, paid tools fail with HTTP 402.

⚠️ These keys spend real money. Use dedicated wallets with small balances, never a personal or treasury key. Anything that can read this process' environment can spend from them.

Develop

npm install
npm run build          # tsc -> dist/
npm run typecheck
npm run version:check  # all FIVE version sites must agree

Publishing (manual — Thiago only)

npm run version:check   # wired into prepublishOnly too
npm publish

Then verify the tarball from the registry, not the local build:

npm pack brmarket-mcp@<version> --registry https://registry.npmjs.org
tar -xzOf brmarket-mcp-<version>.tgz package/dist/index.js | grep -o 'version: "[^"]*"'

A green build proves nothing about what was published — brdata-mcp 0.3.4 shipped from a stale source copy and its MCP handshake reported 0.3.2 while npm said 0.3.4. Check the tarball.

For the MCP registry, server.json carries the full environmentVariables block. Do not drop it: brdata-mcp 0.3.3 published without it and the registry entry lost every variable.

License

MIT © Thiago Menzinger

Questions fréquentes

Qu'est-ce que io.github.thomenz/brmarket-mcp ?

FREE Brazilian marketplace search (ML, Shopee, AliExpress) + import-tax calculator (x402)

Comment installer io.github.thomenz/brmarket-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add brmarket-mcp -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -e 'SOLANA_PRIVATE_KEY=<your solana_private_key>' -e 'SOLANA_RPC_URL=<SOLANA_RPC_URL>' -e 'BRMARKET_BASE_URL=<BRMARKET_BASE_URL>' -e 'X402_NETWORK=<X402_NETWORK>' -- npx -y brmarket-mcp@0.3.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.thomenz/brmarket-mcp ?

Oui. Il attend EVM_PRIVATE_KEY, SOLANA_PRIVATE_KEY, à renseigner dans sa configuration.

io.github.thomenz/brmarket-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.thomenz/brmarket-mcp ?

Il est publié par thomenz. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.