{
  "markdown": "# brmarket-mcp\n\nMCP server for **Brazilian marketplace product search**, paid automatically with\n[x402](https://x402.org) micropayments (USDC on **Base** or **Solana**).\n\nOne call searches **Mercado Livre, Shopee and AliExpress** together and returns a\nsingle normalized shape: BRL prices in integer cents, canonical + affiliate links,\nand a per-marketplace `sources` state so a degraded marketplace is never silent.\nA free **import-tax calculator** turns a price into the real *landed price* — the\nhonest \"best value **with** Brazilian import tax\" comparison.\n\n> **Status: not published yet.** `brmarket-mcp@0.1.0` is built and ready; publishing\n> to npm and the MCP registry is a manual step. See *Publishing* below.\n\n## Tools\n\n| Tool | Price | What it does |\n|---|---|---|\n| `search_products` | $0.01 | Mercado 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`. |\n| `search_by_image` | $0.05 | Same, but from a **product photo**. Returns `interpreted_query` so you can see what was actually searched. |\n| `search_products_preview` | **free** | One result, canonical link only, no affiliate link. |\n| `calculate_import_taxes` | **free** | Brazilian 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`. |\n\n### Always read `sources`\n\nEvery response reports each marketplace as `ok` / `error` / `timeout` /\n`not_configured`. A short result list may mean a marketplace was **down**, not that\nthe market is thin. Never present a degraded page as the whole market.\n\n## Install\n\n```bash\nnpx brmarket-mcp\n```\n\nClaude Desktop / Claude Code (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"brmarket\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"brmarket-mcp\"],\n      \"env\": {\n        \"EVM_PRIVATE_KEY\": \"0x…\"\n      }\n    }\n  }\n}\n```\n\nThe free preview tool works with no wallet at all.\n\n## Environment\n\n| Variable | Required | Description |\n|---|---|---|\n| `EVM_PRIVATE_KEY` | no | `0x…` key of a **dedicated** wallet holding USDC on Base. |\n| `SOLANA_PRIVATE_KEY` | no | base58 or JSON-array secret key of a **dedicated** Solana wallet holding USDC. |\n| `SOLANA_RPC_URL` | no | RPC override used to build the Solana payment (e.g. a Helius URL). |\n| `BRMARKET_BASE_URL` | no | Defaults to `https://brmarket.thomenz.me`. |\n| `X402_NETWORK` | no | `base` (default) or `base-sepolia`. |\n\nConfigure either rail, or both — the x402 layer settles on whichever the server's\n402 advertises. Without any key, paid tools fail with HTTP 402.\n\n> **⚠️ These keys spend real money.** Use dedicated wallets with small balances,\n> never a personal or treasury key. Anything that can read this process'\n> environment can spend from them.\n\n## Develop\n\n```bash\nnpm install\nnpm run build          # tsc -> dist/\nnpm run typecheck\nnpm run version:check  # all FIVE version sites must agree\n```\n\n## Publishing (manual — Thiago only)\n\n```bash\nnpm run version:check   # wired into prepublishOnly too\nnpm publish\n```\n\nThen verify **the tarball from the registry**, not the local build:\n\n```bash\nnpm pack brmarket-mcp@<version> --registry https://registry.npmjs.org\ntar -xzOf brmarket-mcp-<version>.tgz package/dist/index.js | grep -o 'version: \"[^\"]*\"'\n```\n\nA green build proves nothing about what was published — brdata-mcp 0.3.4 shipped\nfrom a stale source copy and its MCP handshake reported `0.3.2` while npm said\n`0.3.4`. Check the tarball.\n\nFor the MCP registry, `server.json` carries the full `environmentVariables` block.\nDo not drop it: brdata-mcp 0.3.3 published without it and the registry entry lost\nevery variable.\n\n## License\n\nMIT © Thiago Menzinger\n",
  "bytes": 3867,
  "sha": "58b596ee1070db0ea72630c713da8ac9f6cce107ac3dbf7f6cd8ac0d02d0110a",
  "repo_slug": "thomenz/brmarket-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_thomenz_brmarket_mcp_d2ad5bfb/readme"
}