Brmarket Mcp

io.github.thomenzPublished by GitHub account thomenzv0.3.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingFinanceBusiness & Commerce

Overview

AI-generated overview

Searches Brazilian marketplaces (Mercado Livre, Shopee, AliExpress) and calculates import taxes, paying per call with USDC via x402.

What you can do
Combines Mercado Livre, Shopee and AliExpress into one search call, returning normalized BRL prices in integer cents, canonical and affiliate links, shipping, rating, sold count and seller details. A free preview tool returns a single result, and a free import-tax calculator turns a price into a landed price including Brazilian import tax and state ICMS. An image search tool accepts a product photo and reports the interpreted query. Every response reports each marketplace as ok, error, timeout or not_configured.
When to use it
Useful when comparing cross-border purchases for delivery in Brazil, especially when the real cost after import tax matters more than the listed price. The free preview and tax calculator work without any wallet, so it can be tried before paying for full searches.
Requirements
Runs locally over stdio, typically via npx brmarket-mcp, so Node.js is needed. Paid tools require a funded USDC wallet: EVM_PRIVATE_KEY for Base or SOLANA_PRIVATE_KEY for Solana, optionally with SOLANA_RPC_URL. BRMARKET_BASE_URL defaults to the hosted API and X402_NETWORK selects base or base-sepolia. Network access is required.
Before you install
The wallet keys EVM_PRIVATE_KEY and SOLANA_PRIVATE_KEY spend real money, so use dedicated wallets with small balances rather than personal or treasury keys, and note that anything able to read the process environment can spend from them. Paid calls cost about $0.01 for search and $0.05 for image search; without a key those tools fail with HTTP 402. Search results may be incomplete when a marketplace reports error or timeout, so a short list does not mean the market is thin.

Installation

In SourceWeft

  1. Open Brmarket Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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. [email protected] 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

bash
npx brmarket-mcp

Claude Desktop / Claude Code (claude_desktop_config.json):

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

bash
npm installnpm run build          # tsc -> dist/npm run typechecknpm run version:check  # all FIVE version sites must agree

Publishing (manual — Thiago only)

bash
npm run version:check   # wired into prepublishOnly toonpm publish

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

bash
npm pack brmarket-mcp@<version> --registry https://registry.npmjs.orgtar -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

Source: README.md at commit d7da237

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.3.0LatestSep 16, 2026

Score

50% 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 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • 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