{"_id":"@codespar/mcp-mercado-bitcoin","_rev":"6-89269734eb4c0bc6aee4a8b665f400ee","name":"@codespar/mcp-mercado-bitcoin","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-mercado-bitcoin","version":"0.1.0","keywords":["mcp","mercado-bitcoin","crypto","exchange","trading","brazil"],"license":"MIT","_id":"@codespar/mcp-mercado-bitcoin@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-mercado-bitcoin":"dist/index.js"},"dist":{"shasum":"6d7309f27d3111b487fac65d680533b897cde285","tarball":"https://registry.npmjs.org/@codespar/mcp-mercado-bitcoin/-/mcp-mercado-bitcoin-0.1.0.tgz","fileCount":5,"integrity":"sha512-W3jw3PW/j+6HnsfIA1oMmfyW0zAS4j8kPHg48XxZjcninmmmLZLjyrnTgS22M60bD5QeMC9GaHdyFqi+oz/pAQ==","signatures":[{"sig":"MEYCIQCWAglnpbBwnDSxM5Rjo114nJl+Nrpsd2cbHawEPmJPdgIhANJ2898SOSOVINWfyu2ZU9VqbxjPiUZbmv0UuwkXN2b7","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25153},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"2f4996f5df31d6f8bf3a3e606ecc416783ceaf2b","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"10.9.4","description":"MCP server for Mercado Bitcoin — Brazilian crypto exchange, trading, orderbook, withdrawals","directories":{},"_nodeVersion":"22.22.1","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-mercado-bitcoin_0.1.0_1775044070122_0.377077697706792","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-mercado-bitcoin","version":"0.1.2","keywords":["mcp","mercado-bitcoin","crypto","exchange","trading","brazil"],"license":"MIT","_id":"@codespar/mcp-mercado-bitcoin@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-mercado-bitcoin":"dist/index.js"},"dist":{"shasum":"7ee58f964416d6f2c25c5ca85adac6ae2614a76e","tarball":"https://registry.npmjs.org/@codespar/mcp-mercado-bitcoin/-/mcp-mercado-bitcoin-0.1.2.tgz","fileCount":7,"integrity":"sha512-4aw+4z8/Jv8+FQ4F5O5jjIyWyF/72kdNncNk8VToSRpFEBpz+gx/JF1IIQn5IanMkDDEovOqofypFg9vpicLCw==","signatures":[{"sig":"MEUCIFi9lBDH7j1TeXhoJDNwO8RVMzfPhXB0oYuVK/ulhoDeAiEAt3BC1f1JsmgbOkifq233Q50SSxtC2m0Mq84V1id243o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32221},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-mercado-bitcoin","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Mercado Bitcoin — Brazilian crypto exchange, trading, orderbook, withdrawals","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-mercado-bitcoin_0.1.2_1775953683855_0.06869184511462723","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-mercado-bitcoin","version":"0.2.0","keywords":["mcp","mercado-bitcoin","crypto","exchange","trading","brazil"],"license":"MIT","_id":"@codespar/mcp-mercado-bitcoin@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-mercado-bitcoin":"dist/index.js"},"dist":{"shasum":"657270080ddb04dc5afb88212b8ef5aa96cc61ce","tarball":"https://registry.npmjs.org/@codespar/mcp-mercado-bitcoin/-/mcp-mercado-bitcoin-0.2.0.tgz","fileCount":7,"integrity":"sha512-tE+fA7fMDyeesU5IHaU05BGJCXqbbwW1w4dWhyaKmKyDEM2rLHoeYxDffcOnos87mxDtaXzmD+8kiVU+gstXig==","signatures":[{"sig":"MEUCIQCb6bLyzcibFJkZ3rOGVJkTO/iSWkwh8Dv/Df5dfi1BOwIgBAHSDOSNuLpw6dKme925Cg50XAcE2Skfa1d98Xir09U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48507},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"4d61b23e069b421d30d91b4b27c118ae36267449","mcpName":"io.github.codespar/mcp-mercado-bitcoin","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Mercado Bitcoin — Brazilian crypto exchange, trading, orderbook, withdrawals","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-mercado-bitcoin_0.2.0_1777115031886_0.11685953017453676","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-mercado-bitcoin","version":"0.2.1","keywords":["mcp","mercado-bitcoin","crypto","exchange","trading","brazil"],"license":"MIT","_id":"@codespar/mcp-mercado-bitcoin@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-mercado-bitcoin":"dist/index.js"},"dist":{"shasum":"59ca82ea3e88e5091483c98f8c5b00ea206e3fc9","tarball":"https://registry.npmjs.org/@codespar/mcp-mercado-bitcoin/-/mcp-mercado-bitcoin-0.2.1.tgz","fileCount":7,"integrity":"sha512-5DuBXHGH1fm+bcnWOe/w3QNhm51g6wfykz/hdC6W/y3DG3qGuJ7/OP9k2+wIu2xnwK4uXelHqk+bTDq2Au+O5Q==","signatures":[{"sig":"MEUCIQC6UlZvYglubiX1pAzuhaIPiDQMpcTfB4Iye5ZhUquwaAIgHX13m6t/6kuPBpxPLeq8ng8dAlriyKkZL2pqpjK6wwU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":49230},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-mercado-bitcoin","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Mercado Bitcoin — Brazilian crypto exchange, trading, orderbook, withdrawals","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-mercado-bitcoin_0.2.1_1777123020173_0.920224394133369","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-mercado-bitcoin","version":"0.2.2","description":"MCP server for Mercado Bitcoin — Brazilian crypto exchange, trading, orderbook, withdrawals","type":"module","main":"./dist/index.js","bin":{"mcp-mercado-bitcoin":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","mercado-bitcoin","crypto","exchange","trading","brazil"],"mcpName":"io.github.codespar/mcp-mercado-bitcoin","_id":"@codespar/mcp-mercado-bitcoin@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-Jg/vLHx2yF+GZDOFhocPjM/kxKPIE0T8n+dt5o0i4i9LMXGfuHPNPPcO4iRlH+f09ekKvDNJHxwj7VSDLwgZrQ==","shasum":"6c435a48636fd33427ea7584850fe0939cb24265","tarball":"https://registry.npmjs.org/@codespar/mcp-mercado-bitcoin/-/mcp-mercado-bitcoin-0.2.2.tgz","fileCount":7,"unpackedSize":50540,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDIbF6C3BH8ZSziBX94OGU8SQm/SGNfzPm3moV593UxUgIgQ21iLnNMVUqO2Z/11yk7WXJR1BwgwrgIPStptauCEdw="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-mercado-bitcoin_0.2.2_1782153532699_0.7569191522844085"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-01T11:47:50.057Z","modified":"2026-06-22T18:38:52.967Z","0.1.0":"2026-04-01T11:47:50.257Z","0.1.2":"2026-04-12T00:28:04.018Z","0.2.0":"2026-04-25T11:03:52.023Z","0.2.1":"2026-04-25T13:17:00.320Z","0.2.2":"2026-06-22T18:38:52.822Z"},"license":"MIT","keywords":["mcp","mercado-bitcoin","crypto","exchange","trading","brazil"],"description":"MCP server for Mercado Bitcoin — Brazilian crypto exchange, trading, orderbook, withdrawals","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-mercado-bitcoin\n\n> MCP server for **Mercado Bitcoin** — Brazilian cryptocurrency exchange with trading, orders, and market data\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-mercado-bitcoin)](https://www.npmjs.com/package/@codespar/mcp-mercado-bitcoin)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mercado-bitcoin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-mercado-bitcoin\"],\n      \"env\": {\n        \"MB_API_KEY\": \"your-key\",\n        \"MB_API_SECRET\": \"your-secret\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add mercado-bitcoin -- npx @codespar/mcp-mercado-bitcoin\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"mercado-bitcoin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-mercado-bitcoin\"],\n      \"env\": {\n        \"MB_API_KEY\": \"your-key\",\n        \"MB_API_SECRET\": \"your-secret\"\n      }\n    }\n  }\n}\n```\n\n## Tools (20)\n\n| Tool | Purpose |\n|---|---|\n| `get_ticker` | Get ticker data for a trading pair (price, volume, etc.) |\n| `list_orderbook` | Get order book (bids and asks) for a trading pair |\n| `create_order` | Create a buy or sell order |\n| `get_order` | Get order details by ID |\n| `cancel_order` | Cancel an open order |\n| `list_orders` | List orders with optional filters |\n| `get_balance` | Get account balances for all assets |\n| `list_trades` | List executed trades for a trading pair |\n| `get_candles` | Get candlestick/OHLCV data for a trading pair |\n| `withdraw` | Create a withdrawal request |\n| `cancel_all_orders` | Cancel all open orders for a symbol |\n| `list_account_trades` | List authenticated account fills/trades for a symbol |\n| `list_deposits` | List deposits (crypto + fiat) for the authenticated account |\n| `list_withdrawals` | List withdrawals (crypto + fiat) for the authenticated account |\n| `get_withdrawal` | Get withdrawal details by ID |\n| `list_symbols` | List available trading symbols (pairs) on the exchange |\n| `list_assets` | List supported assets/coins on the exchange |\n| `list_networks` | List supported blockchain networks for a given asset |\n| `get_fees` | Query trading fees (maker/taker) for a symbol |\n| `list_positions` | List open margin/futures positions (if applicable to the account) |\n\n## Authentication\n\nMercado Bitcoin uses an API key and secret passed via request headers.\n\n## Sandbox / Testing\n\nMercado Bitcoin provides a sandbox via the dashboard for testing.\n\n### Get your credentials\n\n1. Go to [Mercado Bitcoin](https://www.mercadobitcoin.com.br)\n2. Create an account\n3. Navigate to API settings to generate key and secret\n4. Set the environment variables\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `MB_API_KEY` | Yes | API key from Mercado Bitcoin |\n| `MB_API_SECRET` | Yes | API secret from Mercado Bitcoin |\n\n## Roadmap\n\n### v0.2 (planned)\n- `get_account_info` — Get account information and limits\n- `list_currencies` — List available cryptocurrencies\n- `get_order_history` — Get order history with filters\n- `create_stop_order` — Create a stop-limit order\n- `get_fees` — Get trading fees for an account\n\n### v0.3 (planned)\n- `margin_trading` — Margin trading operations\n- `lending` — Crypto lending operations\n\nWant to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).\n\n## Links\n\n- [Mercado Bitcoin Website](https://www.mercadobitcoin.com.br)\n- [Mercado Bitcoin API Documentation](https://api.mercadobitcoin.net/api/v4/docs)\n- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)\n- [Landing Page](https://codespar.dev/mcp)\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}