Mercado Bitcoin

v0.2.0API Key

Brazil's largest crypto exchange: BTC, ETH, and 200+ tokens. Your agent places orders, reads the orderbook, and manages wallets in BRL.

20 tools1 env vars🇧🇷 Brazilstable on npm

Install

terminal

$ npm install @codespar/mcp-mercado-bitcoin

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "mercado-bitcoin": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-mercado-bitcoin"
      ],
      "env": {
        "MB_API_KEY": "<your_mb_api_key>"
      }
    }
  }
}

After restart, your agent can call any of the 20 tools below — try get_ticker first.

Environment variables · 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

MB_API_KEY

requiredsecret

API key for mercado-bitcoin

Available tools · 20

Each tool is independent — your agent loads only what it needs to reduce context and response time.

READget_ticker

Get ticker data for a trading pair (price, volume, etc.)

READlist_orderbook

Get order book (bids and asks) for a trading pair

WRITEcreate_order

Create a buy or sell order

READget_order

Get order details by ID

DELETEcancel_order

Cancel an open order

READlist_orders

List orders with optional filters

READget_balance

Get account balances for all assets

READlist_trades

List executed trades for a trading pair

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.