mcp-stp-spei

MCP STP/SPEI

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

STP/SPEI 用の MCP サーバー — メキシコの即時銀行振込システム（ブラジルの PIX に相当）です。

クイックスタート

# Set your credentials
export STP_API_KEY="your-api-key"
export STP_COMPANY="your-company-id"

# Run via stdio
npx tsx packages/mexico/stp-spei/src/index.ts

# Run via HTTP
npx tsx packages/mexico/stp-spei/src/index.ts --http

環境変数

変数	必須	説明
STP_API_KEY	はい	STP の API キー
STP_COMPANY	はい	会社識別子
MCP_HTTP	いいえ	HTTP トランスポートを有効にするには "true" を設定します
MCP_PORT	いいえ	HTTP ポート（デフォルト：3000）

ツール（18）

ツール	用途
create_transfer	SPEI 振込を作成します
get_transfer	ID で振込の詳細を取得します
list_transfers	フィルターを指定して振込を一覧表示します
cancel_transfer	clave_rastreo で保留中の SPEI orden をキャンセルします（orden が保留中の場合のみ有効です）
get_balance	口座残高を取得します
list_account_balances	会社のすべての口座の残高を一覧表示します
validate_account	受取銀行に対して CLABE 口座番号を検証します（オンライン照会）
validate_clabe	CLABE の構造とチェックサムをローカルで検証します（API 呼び出しはありません）。
list_banks	SPEI 参加銀行を一覧表示します
lookup_bank_by_code	ABM/SPEI コード（CLABE の先頭 3 桁）で参加銀行を検索します
get_cep	振込の検証用に CEP（Comprobante Electronico de Pago）を取得します
register_beneficiary	受取人の口座を登録します
create_refund	以前に受け取った振込に対する SPEI の返金／devolución を作成します
list_refunds	日付範囲を指定して devoluciones（返金）を一覧表示します
conciliation_report	日付を指定して取引の照合レポートを取得します（受取および送金の ordenes をすべて含みます）
register_webhook	STP イベント通知を受け取る Webhook URL を登録します
list_webhooks	会社に登録されている Webhook を一覧表示します
delete_webhook	ID で登録済みの Webhook を削除します

認証

API キー＋デジタル署名による認証を使用します。API キーは Bearer トークンとして送信され、会社識別子はリクエストに含まれます。STP から認証情報を取得してください。

API リファレンス

• STP API ドキュメント

---

Enterprise

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

認証

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

• STP_API_KEY (必須、シークレット) — STP の API キー
• STP_COMPANY (必須) — STP の会社識別子

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

ライセンス

MIT