mcp-nequi

MCP Nequi

アルファリリース — npm の alpha dist-tag で公開されています。エンドポイントのパスは公開ドキュメントと BACEN／プロバイダーの規約に準拠していますが、実環境での検証は完了していません。0.x.x-alpha の期間中は正確なバージョンを固定してください。npm install <pkg>@alpha でインストールできます。

Nequi 向け MCP サーバーです。Bancolombia が提供する、コロンビアを代表するデジタルウォレットで、5,000 万人以上のユーザーが利用しています。プッシュ決済、QR 決済、サブスクリプションに対応しています。

クイックスタート

# Set your credentials
export NEQUI_API_KEY="your-api-key"
export NEQUI_CLIENT_ID="your-client-id"
export NEQUI_CLIENT_SECRET="your-client-secret"

# Run via stdio
npx tsx packages/colombia/nequi/src/index.ts

# Run via HTTP
npx tsx packages/colombia/nequi/src/index.ts --http

環境変数

変数	必須	説明
NEQUI_API_KEY	はい	Nequi 開発者ポータルで取得した API キー
NEQUI_CLIENT_ID	はい	OAuth2 クライアント ID
NEQUI_CLIENT_SECRET	はい	OAuth2 クライアントシークレット
NEQUI_ENV	いいえ	"sandbox" または "production"（デフォルト：sandbox）
MCP_HTTP	いいえ	HTTP トランスポートを有効にするには "true" を設定
MCP_PORT	いいえ	HTTP ポート（デフォルト：3000）

ツール（16）

ツール	目的
create_push_payment	Nequi ユーザーにプッシュ決済通知を送信
get_payment_status	決済のステータスを確認
create_qr_payment	決済用 QR コードを生成
reverse_payment	完了した決済を取り消し
get_subscription	電話番号のサブスクリプション詳細を取得
unsubscribe	サブスクリプションをキャンセル
create_static_qr	加盟店向けに静的（再利用可能な）Nequi QR コードを生成
reverse_transaction	取引 ID を指定して任意の Nequi 取引を取り消し（返金フロー）
validate_phone	電話番号が Nequi に登録されているか確認
notify_unregistered_payment	Nequi 未登録の受取人に、決済の受け取り方法を通知
list_transactions	指定期間内の加盟店の取引を一覧表示
get_balance	加盟店自身の Nequi アカウント残高を取得
schedule_payment	将来の日付に Nequi プッシュ決済を予約
authorize_recurring_charge	Nequi ユーザーに対する継続課金契約を承認
get_merchant_info	登録済み加盟店の事業者プロフィールを取得
get_settlement	指定日の決済精算を照会

認証

OAuth2 クライアントクレデンシャルフローを使用します。サーバーはクライアント ID とシークレットを使用してアクセストークンを取得し、すべてのリクエストヘッダーに API キーを含めます。

API リファレンス

• Nequi API ドキュメント

---

エンタープライズ

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

認証

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

• NEQUI_API_KEY (必須、シークレット) — Nequi の API キー
• NEQUI_CLIENT_ID (必須) — OAuth2 クライアント ID
• NEQUI_CLIENT_SECRET (必須、シークレット) — OAuth2 クライアントシークレット

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

ライセンス

MIT