Mcp Mercado Bitcoin

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

MCP server for Mercado Bitcoin — Brazilian crypto exchange, trading, orderbook, withdrawals

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Local MCP server for the Mercado Bitcoin exchange that lets an assistant read market data and account balances and place, cancel or withdraw funds.

What you can do
Read market data: tickers, order books, trades, candles, symbols, assets, networks and fees for trading pairs. Check the account: balances, open margin or futures positions, deposits and withdrawals. Manage orders: create buy or sell orders, list and inspect orders, cancel one order or all open orders for a symbol. Move funds: create withdrawal requests and look up their details.
When to use it
Useful when you want an assistant to monitor Mercado Bitcoin markets, review balances and order history, or place and cancel orders and request withdrawals through conversation instead of the exchange dashboard.
Requirements
Runs locally via npx from the npm package, so Node.js is needed. Requires a Mercado Bitcoin account and API credentials supplied as the environment variables MB_API_KEY and MB_API_SECRET. Network access to the exchange is required; a sandbox is available for testing.
Before you install
The server can create orders, cancel orders and initiate withdrawals, which move real money. It needs an API key and secret with trading and withdrawal rights; keep them scoped and stored safely. The README also mentions an enterprise offering with payment routing and budget controls, which is a separate product.

Installation

In SourceWeft

  1. Open Mcp Mercado Bitcoin 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

@codespar/mcp-mercado-bitcoin

MCP server for Mercado Bitcoin — Brazilian cryptocurrency exchange with trading, orders, and market data

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "mercado-bitcoin": {      "command": "npx",      "args": ["-y", "@codespar/mcp-mercado-bitcoin"],      "env": {        "MB_API_KEY": "your-key",        "MB_API_SECRET": "your-secret"      }    }  }}

Claude Code

bash
claude mcp add mercado-bitcoin -- npx @codespar/mcp-mercado-bitcoin

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "mercado-bitcoin": {      "command": "npx",      "args": ["-y", "@codespar/mcp-mercado-bitcoin"],      "env": {        "MB_API_KEY": "your-key",        "MB_API_SECRET": "your-secret"      }    }  }}

Tools (20)

ToolPurpose
get_tickerGet ticker data for a trading pair (price, volume, etc.)
list_orderbookGet order book (bids and asks) for a trading pair
create_orderCreate a buy or sell order
get_orderGet order details by ID
cancel_orderCancel an open order
list_ordersList orders with optional filters
get_balanceGet account balances for all assets
list_tradesList executed trades for a trading pair
get_candlesGet candlestick/OHLCV data for a trading pair
withdrawCreate a withdrawal request
cancel_all_ordersCancel all open orders for a symbol
list_account_tradesList authenticated account fills/trades for a symbol
list_depositsList deposits (crypto + fiat) for the authenticated account
list_withdrawalsList withdrawals (crypto + fiat) for the authenticated account
get_withdrawalGet withdrawal details by ID
list_symbolsList available trading symbols (pairs) on the exchange
list_assetsList supported assets/coins on the exchange
list_networksList supported blockchain networks for a given asset
get_feesQuery trading fees (maker/taker) for a symbol
list_positionsList open margin/futures positions (if applicable to the account)

Authentication

Mercado Bitcoin uses an API key and secret passed via request headers.

Sandbox / Testing

Mercado Bitcoin provides a sandbox via the dashboard for testing.

Get your credentials

  1. Go to Mercado Bitcoin
  2. Create an account
  3. Navigate to API settings to generate key and secret
  4. Set the environment variables

Environment Variables

VariableRequiredDescription
MB_API_KEYYesAPI key from Mercado Bitcoin
MB_API_SECRETYesAPI secret from Mercado Bitcoin

Roadmap

v0.2 (planned)

  • get_account_info — Get account information and limits
  • list_currencies — List available cryptocurrencies
  • get_order_history — Get order history with filters
  • create_stop_order — Create a stop-limit order
  • get_fees — Get trading fees for an account

v0.3 (planned)

  • margin_trading — Margin trading operations
  • lending — Crypto lending operations

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/crypto/mercado-bitcoin/README.md at commit d0a519a

Tools

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

Version history

1
  1. v0.2.2LatestSep 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