About mcp-mercado-bitcoin
mcp-mercado-bitcoin is an MCP server for Mercado Bitcoin, a Brazilian cryptocurrency exchange. It is aimed at developers and agents that need market data or account operations through an MCP client. It exposes tools for trading, order books, balances and withdrawals.
Key features
- 01Ticker and candlestick market data
- 02Order book and trade history queries
- 03Order creation, cancellation and lookup
- 04Account balances and trade records
- 05Deposit and withdrawal records
- 06Trading fee queries
Use cases
- 01Querying prices and order books for a trading pair from an AI assistant
- 02Cancelling all open orders for a symbol
- 03Reviewing deposits and withdrawals for an account
MCP support
This is an MCP server that exposes 20 tools to MCP clients for market data, trading, account and withdrawal operations.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @codespar/mcp-mercado-bitcoinMB_API_KEYSecretAPI key for mercado-bitcoinLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
20Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Trading pair symbol (e.g. BTC-BRL, ETH-BRL, USDC-BRL) |
Details
From the project README@codespar/mcp-mercado-bitcoin
MCP server for Mercado Bitcoin — Brazilian cryptocurrency exchange with trading, orders, and market data
Quick Start
Claude Desktop
Add to ~/.config/claude/claude_desktop_config.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
claude mcp add mercado-bitcoin -- npx @codespar/mcp-mercado-bitcoin
Cursor / VS Code
Add to .cursor/mcp.json or .vscode/mcp.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)
| Tool | Purpose |
|---|---|
get_ticker | Get ticker data for a trading pair (price, volume, etc.) |
list_orderbook | Get order book (bids and asks) for a trading pair |
create_order | Create a buy or sell order |
get_order | Get order details by ID |
cancel_order | Cancel an open order |
list_orders | List orders with optional filters |
get_balance | Get account balances for all assets |
list_trades | List executed trades for a trading pair |
get_candles | Get candlestick/OHLCV data for a trading pair |
withdraw | Create a withdrawal request |
cancel_all_orders | Cancel all open orders for a symbol |
list_account_trades | List authenticated account fills/trades for a symbol |
list_deposits | List deposits (crypto + fiat) for the authenticated account |
list_withdrawals | List withdrawals (crypto + fiat) for the authenticated account |
get_withdrawal | Get withdrawal details by ID |
list_symbols | List available trading symbols (pairs) on the exchange |
list_assets | List supported assets/coins on the exchange |
list_networks | List supported blockchain networks for a given asset |
get_fees | Query trading fees (maker/taker) for a symbol |
list_positions | List 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
- Go to Mercado Bitcoin
- Create an account
- Navigate to API settings to generate key and secret
- Set the environment variables
Environment Variables
| Variable | Required | Description |
|---|---|---|
MB_API_KEY | Yes | API key from Mercado Bitcoin |
MB_API_SECRET | Yes | API secret from Mercado Bitcoin |
Roadmap
v0.2 (planned)
get_account_info— Get account information and limitslist_currencies— List available cryptocurrenciesget_order_history— Get order history with filterscreate_stop_order— Create a stop-limit orderget_fees— Get trading fees for an account
v0.3 (planned)
margin_trading— Margin trading operationslending— 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.