mcp-mercado-bitcoin

@codespar/mcp-mercado-bitcoin

Mercado Bitcoin 向け MCP サーバー — 取引、注文、マーケットデータに対応するブラジルの暗号資産取引所

クイックスタート

Claude Desktop

~/.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

.cursor/mcp.json または .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"
      }
    }
  }
}

ツール（20）

ツール	目的
get_ticker	取引ペアのティッカーデータ（価格、出来高など）を取得します
list_orderbook	取引ペアのオーダーブック（買い注文と売り注文）を取得します
create_order	買い注文または売り注文を作成します
get_order	ID で注文の詳細を取得します
cancel_order	未決済の注文をキャンセルします
list_orders	オプションのフィルターを指定して注文の一覧を取得します
get_balance	すべての資産のアカウント残高を取得します
list_trades	取引ペアの約定済み取引の一覧を取得します
get_candles	取引ペアのローソク足／OHLCV データを取得します
withdraw	出金リクエストを作成します
cancel_all_orders	シンボルの未決済注文をすべてキャンセルします
list_account_trades	認証済みアカウントのシンボルに関する約定／取引の一覧を取得します
list_deposits	認証済みアカウントの入金（暗号資産＋法定通貨）の一覧を取得します
list_withdrawals	認証済みアカウントの出金（暗号資産＋法定通貨）の一覧を取得します
get_withdrawal	ID で出金の詳細を取得します
list_symbols	取引所で利用可能な取引シンボル（ペア）の一覧を取得します
list_assets	取引所でサポートされている資産／コインの一覧を取得します
list_networks	指定した資産でサポートされているブロックチェーンネットワークの一覧を取得します
get_fees	シンボルの取引手数料（メイカー／テイカー）を照会します
list_positions	オープン中のマージン／先物ポジションの一覧を取得します（アカウントで利用可能な場合）

認証

Mercado Bitcoin では、リクエストヘッダーで API キーとシークレットを渡します。

サンドボックス／テスト

Mercado Bitcoin では、テスト用にダッシュボードからサンドボックスを利用できます。

認証情報を取得する

1. Mercado Bitcoin にアクセスします
2. アカウントを作成します
3. API 設定に移動して、キーとシークレットを生成します
4. 環境変数を設定します

環境変数

変数	必須	説明
MB_API_KEY	はい	Mercado Bitcoin の API キー
MB_API_SECRET	はい	Mercado Bitcoin の API シークレット

ロードマップ

v0.2（予定）

• get_account_info — アカウント情報と制限を取得します
• list_currencies — 利用可能な暗号資産の一覧を取得します
• get_order_history — フィルターを指定して注文履歴を取得します
• create_stop_order — ストップリミット注文を作成します
• get_fees — アカウントの取引手数料を取得します

v0.3（予定）

• margin_trading — マージン取引の操作
• lending — 暗号資産の貸し出し操作

貢献したい場合は、PR を作成するか、ツールをリクエストしてください。

リンク

• Mercado Bitcoin のウェブサイト
• Mercado Bitcoin API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？ CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT