mcp-wompi

Name: mcp-wompi
Author: codespar

ローカル

github.com/codespar金融データ2755 週間前に更新

リポジトリ

mcp-wompi について

mcp-wompi は、Bancolombia が運営するコロンビアの決済ゲートウェイ Wompi の MCP サーバーです。コロンビアでカード、PSE 銀行振込、Nequi による決済をエージェントから扱いたい開発者に適しています。取引、決済リンク、トークン化、返金、webhook 署名検証を扱う 22 個のツールを提供します。

主な機能

01カード、PSE、Nequi の取引処理
02決済リンクの作成と管理
03カードと Nequi のトークン化と決済ソース管理
04返金の作成と照会
05顧客プロファイルと PSE 銀行一覧の取得
06webhook イベント署名の検証

活用シーン

01エージェントによる注文向け決済リンクの作成と取引状況の追跡
02加盟店参照番号による取引の検索と取消または返金
03再利用可能な決済ソース向け顧客プロファイルとトークンの作成

MCP 対応

本プロジェクトは、Wompi の決済関連ツール 22 個を MCP クライアントに公開する MCP サーバーです。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "codespar-mcp-wompi": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-wompi"
      ],
      "env": {
        "WOMPI_PUBLIC_KEY": "<WOMPI_PUBLIC_KEY>",
        "WOMPI_PRIVATE_KEY": "<WOMPI_PRIVATE_KEY>",
        "WOMPI_EVENTS_SECRET": "<WOMPI_EVENTS_SECRET>"
      }
    }
  }
}

起動コマンドnpx -y @codespar/mcp-wompi

設定が必要な環境変数

WOMPI_PUBLIC_KEYシークレットPublic key for Wompi

WOMPI_PRIVATE_KEYシークレットPrivate key for Wompi

WOMPI_EVENTS_SECRETシークレットEvents/webhook secret for signature validation

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@codespar/mcp-wompi0.2.2stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
currency	string	はい	通貨コード（COP）
reference	string	はい	一意の取引参照
customer_data	object	いいえ	顧客データ
customer_data.legal_id	string	いいえ	法定 ID（cedula）
customer_data.full_name	string	いいえ	氏名
customer_data.phone_number	string	いいえ	電話番号
customer_data.legal_id_type	string	いいえ	法定 ID タイプ（CC、NIT、CE）
customer_email	string	はい	顧客のメールアドレス
payment_method	object	はい	支払い方法の詳細
payment_method.type	string	はい	支払いタイプ（CARD、NEQUI、PSE、BANCOLOMBIA_TRANSFER）
payment_method.token	string	いいえ	トークン化されたカードのトークン（CARD 用）
payment_method.user_type	number	いいえ	ユーザー種別：0=自然人、1=法人（PSE 用）
payment_method.installments	number	いいえ	分割払い回数（CARD 用）
payment_method.phone_number	string	いいえ	電話番号（NEQUI 用）
payment_method.payment_description	string	いいえ	説明（PSE 用）
payment_method.financial_institution_code	string	いいえ	銀行コード（PSE 用）
amount_in_cents	number	はい	金額（セント単位、COP）
acceptance_token	string	いいえ	get_acceptance_token から取得した同意トークン

詳細

@codespar/mcp-wompi

カード、PSE 銀行振込、Nequi、Bancolombia 振込に対応する、Bancolombia が提供するコロンビアの決済ゲートウェイ Wompi 用 MCP サーバー

クイックスタート

# Set your credentials
export WOMPI_PUBLIC_KEY="pub_test_..."
export WOMPI_PRIVATE_KEY="prv_test_..."
export WOMPI_SANDBOX="true"

# Run via stdio
npx -y @codespar/mcp-wompi

# Run via HTTP
MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-wompi

環境変数

変数	必須	説明
`WOMPI_PUBLIC_KEY`	はい	Wompi ダッシュボードの公開鍵
`WOMPI_PRIVATE_KEY`	はい	サーバー側の操作に使用する秘密鍵
`WOMPI_SANDBOX`	いいえ	サンドボックス環境を使用するには `"true"` を設定します
`MCP_HTTP`	いいえ	HTTP トランスポートを有効にするには `"true"` を設定します
`MCP_PORT`	いいえ	HTTP ポート（デフォルト：3000）

ツール（22）

ツール	目的
`create_transaction`	決済トランザクションを作成します
`get_transaction`	ID でトランザクションの詳細を取得します
`list_transactions`	トランザクションの一覧を取得します
`search_transaction_by_reference`	加盟店参照番号でトランザクションを検索します
`void_transaction`	トランザクションを取り消します
`create_payment_link`	決済リンクを作成します
`get_payment_link`	決済リンクの詳細を取得します
`update_payment_link`	決済リンクを更新します
`list_payment_links`	決済リンクの一覧を取得します
`list_payment_methods`	加盟店で利用可能な決済方法の一覧を取得します
`get_acceptance_token`	加盟店の同意トークンを取得します（トランザクションに必要）
`create_tokenized_card`	クレジットカード／デビットカードをトークン化します
`create_tokenized_nequi`	Nequi ウォレットをトークン化します（電話番号で非同期トークン化を開始）
`get_tokenization_status`	トークン化 ID で非同期トークン化の状態を確認します（Nequi など）
`create_payment_source`	顧客のメールアドレスに紐付けた再利用可能な決済ソース（CARD/NEQUI/PSE）を作成します
`create_customer`	顧客プロフィールを作成します
`get_customer`	ID で顧客を取得します
`list_financial_institutions`	PSE 銀行（金融機関）の一覧を取得します
`create_refund`	トランザクションの返金を作成します
`get_refund`	ID で返金の詳細を取得します
`get_merchant`	加盟店情報を取得します
`validate_webhook_signature`	Wompi イベントの署名を検証します。

認証

秘密鍵を使用した Bearer トークン認証を使用します。公開鍵は、クライアント側でのトークン化と加盟店情報の照会に使用します。

API リファレンス

Wompi API ドキュメント

エンタープライズ

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

認証

サーバーを起動する前に、以下の環境変数を設定してください。

WOMPI_PUBLIC_KEY (必須) — Wompi の公開鍵
WOMPI_PRIVATE_KEY (必須、シークレット) — Wompi の秘密鍵
WOMPI_EVENTS_SECRET (シークレット) — 署名検証に使用するイベント／Webhook シークレット

認証情報は、プロバイダーの開発者ポータルで発行してください：https://docs.wompi.co。

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: codespar
言語: node
バージョン: 0.2.2
トランスポート: stdio
掲載日: 2026年6月22日
最終更新: 5 週間前
公式 Registry: io.github.codespar/mcp-wompi

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

mcp-wompi

mcp-wompi について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

@codespar/mcp-wompi

クイックスタート

環境変数

ツール（22）

認証

API リファレンス

エンタープライズ

認証

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？