mcp-bold-co

@codespar/mcp-bold-co

Bold 向け MCP サーバー — コロンビアの決済サービスプロバイダー（bold.co）。カード、PSE、Nequi、Botón Bancolombia に対応した決済リンクのほか、チェックアウトの整合性署名と Webhook 検証のヘルパーを提供します。

Bold の公開連携 API はリンクを中心としています。固定額または金額指定の決済リンクを作成し、支払人に payload.url を渡して、リンクのステータスが PAID になるまでポーリングします。埋め込み型チェックアウトボタンのフローは SHA-256 整合性署名で保護され、Webhook は HMAC 署名されます。どちらも、この MCP サーバーのローカルツールで扱えます。

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "bold-co": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-bold-co"],
      "env": {
        "BOLD_API_KEY": "your-identity-key",
        "BOLD_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Claude Code

claude mcp add bold-co --env BOLD_API_KEY=your-identity-key -- npx -y @codespar/mcp-bold-co

ツール（7）

ツール	説明
create_payment_link	決済リンクを作成します（POST /online/link/v1）。カード、PSE、Nequi、Botón Bancolombia に対応します
create_pse_payment_link	PSE 銀行口座引き落としに限定したリンクを簡単に作成します
create_card_payment_link	カードに限定したリンクを簡単に作成します
get_payment_link	リンクのステータスを照会します：ACTIVE、PROCESSING、PAID、REJECTED、EXPIRED
list_payment_methods	この加盟店で有効な決済方法を一覧表示します
generate_checkout_signature	埋め込み型チェックアウトボタン用の SHA-256 整合性ハッシュを生成します（ローカル）
validate_webhook_signature	Bold の Webhook に付与された HMAC 署名を検証します（ローカル）

環境変数

変数	必須	説明
BOLD_API_KEY	はい	ID キー（llave de identidad）。Authorization: x-api-key として送信されます
BOLD_SECRET_KEY	いいえ	シークレットキー。ローカルの署名／Webhook ツールでのみ必要です

Bold には独立したサンドボックスホストはありません。テストモードは Bold ダッシュボードで発行されたテストキーによって有効になります。

ドキュメント

• プロバイダーのドキュメント：https://developers.bold.co
• マネージドプラン（LATAM のすべてのプロバイダーで共通のインターフェース、ガバナンスと監査）：https://codespar.dev/agents

エンタープライズ

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

ライセンス

MIT