@codespar/mcp-mercado-bitcoin
v0.1.0
Published
MCP server for Mercado Bitcoin — Brazilian crypto exchange, trading, orderbook, withdrawals
Maintainers
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-bitcoinCursor / 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
| Tool | Description |
|------|-------------|
| 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 |
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
License
MIT
