Brmarket MCP

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "brmarket-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "brmarket-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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

Tool	Price	What it does
`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`.
`search_by_image`	$0.05	Same, but from a product photo. Returns `interpreted_query` so you can see what was actually searched.
`search_products_preview`	free	One result, canonical link only, no affiliate link.
`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`.

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

Terminal

npx brmarket-mcp

Claude Desktop / Claude Code (claude_desktop_config.json):

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

Variable	Required	Description
`EVM_PRIVATE_KEY`	no	`0x…` key of a dedicated wallet holding USDC on Base.
`SOLANA_PRIVATE_KEY`	no	base58 or JSON-array secret key of a dedicated Solana wallet holding USDC.
`SOLANA_RPC_URL`	no	RPC override used to build the Solana payment (e.g. a Helius URL).
`BRMARKET_BASE_URL`	no	Defaults to `https://brmarket.thomenz.me`.
`X402_NETWORK`	no	`base` (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

Terminal

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

Publishing (manual — Thiago only)

Terminal

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

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

Terminal

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Brmarket MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "brmarket-mcp": { "command": "npx", "args": ["-y", "brmarket-mcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/brmarket-mcp?style=directory)](https://allmcps.com/mcp/brmarket-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/brmarket-mcp"><img src="https://allmcps.com/api/badge/brmarket-mcp?style=directory" alt="Brmarket MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

36Quality signal: Fair · 36/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Brmarket MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Brmarket MCP

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "brmarket-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "brmarket-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

brmarket-mcp

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

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

Tool	Price	What it does
`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`.
`search_by_image`	$0.05	Same, but from a product photo. Returns `interpreted_query` so you can see what was actually searched.
`search_products_preview`	free	One result, canonical link only, no affiliate link.
`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`.

Always read `sources`

Install

Terminal

npx brmarket-mcp

Claude Desktop / Claude Code (claude_desktop_config.json):

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

Variable	Required	Description
`EVM_PRIVATE_KEY`	no	`0x…` key of a dedicated wallet holding USDC on Base.
`SOLANA_PRIVATE_KEY`	no	base58 or JSON-array secret key of a dedicated Solana wallet holding USDC.
`SOLANA_RPC_URL`	no	RPC override used to build the Solana payment (e.g. a Helius URL).
`BRMARKET_BASE_URL`	no	Defaults to `https://brmarket.thomenz.me`.
`X402_NETWORK`	no	`base` (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

Terminal

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

Publishing (manual — Thiago only)

Terminal

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

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

Terminal

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Brmarket MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "brmarket-mcp": { "command": "npx", "args": ["-y", "brmarket-mcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/brmarket-mcp?style=directory)](https://allmcps.com/mcp/brmarket-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/brmarket-mcp"><img src="https://allmcps.com/api/badge/brmarket-mcp?style=directory" alt="Brmarket MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

36Quality signal: Fair · 36/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity1/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Brmarket MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Brmarket MCP

Quick Install

Client Config & Setup

Documentation Overview

brmarket-mcp

Tools

Always read sources

Install

Environment

Develop

Publishing (manual — Thiago only)

License

Related MCP Servers

Reviews

Frequently Asked Questions about Brmarket MCP

AllMCPs Directory Badge

Technical Specs & Signals

Feature Your MCP Server

Own this project?

Share & Embed

Explore more

Brmarket MCP

Quick Install

Client Config & Setup

Documentation Overview

brmarket-mcp

Tools

Always read sources

Install

Environment

Develop

Publishing (manual — Thiago only)

License

Related MCP Servers

Reviews

Frequently Asked Questions about Brmarket MCP

AllMCPs Directory Badge

Technical Specs & Signals

Feature Your MCP Server

Own this project?

Share & Embed

Explore more

Always read `sources`

Always read `sources`