mcp-dlocal

Name: mcp-dlocal
Author: codespar

ローカル

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

リポジトリ

mcp-dlocal について

mcp-dlocal は、dLocal 向けの MCP サーバーで、単一の API で 15 か国以上のラテンアメリカを対象とした越境決済、ペイアウト、返金を扱います。複数の中南米市場で現地決済手段が必要な加盟店や開発者に向けたものです。

主な機能

01ラテンアメリカ各国の現地決済手段による決済受付
02決済、返金、ペイアウトの照会と管理
03ラテンアメリカの受取人への送金（ペイアウト）
04国ごとの決済手段一覧の実行時取得
05税務書類の検証と為替レートの照会

活用シーン

01複数のラテンアメリカ諸国で現地決済手段により代金を受け取る
02域内のサプライヤーや受取人への送金
03国ごとの利用可能な決済手段を、ハードコードせず実行時に取得する

MCP 対応

MCP クライアントに dLocal の決済、返金、ペイアウト、照会ツールを公開する MCP サーバーです。リクエストは V2 HMAC-SHA256 で自動的に署名されます。

設定

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

mcp.json · 共通設定

{
  "mcpServers": {
    "codespar-mcp-dlocal": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-dlocal"
      ],
      "env": {
        "DLOCAL_LOGIN": "<DLOCAL_LOGIN>",
        "DLOCAL_TRANS_KEY": "<DLOCAL_TRANS_KEY>",
        "DLOCAL_SECRET_KEY": "<DLOCAL_SECRET_KEY>",
        "DLOCAL_BASE_URL": "<DLOCAL_BASE_URL>"
      }
    }
  }
}

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

設定が必要な環境変数

DLOCAL_LOGINdLocal API Login (X-Login header)

DLOCAL_TRANS_KEYシークレットdLocal API Trans-Key (X-Trans-Key header)

DLOCAL_SECRET_KEYシークレットdLocal API Secret Key used to sign V2 HMAC-SHA256 requests

DLOCAL_BASE_URLdLocal API base URL. Defaults to https://api.dlocal.com (prod). Use https://sandbox.dlocal.com for sandbox.

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

パッケージ

npm@codespar/mcp-dlocal0.2.2stdio

ツール

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

パラメーター	型	必須	説明
card	object	いいえ	DIRECT カードフロー専用 — トークン化されたカードオブジェクトです。REDIRECT の場合は省略してください。
payer	object	はい	支払人の識別情報
payer.name	string	はい	支払人の氏名
payer.email	string	はい	支払者のメールアドレス
payer.document	string	はい	現地の納税者番号（BR は CPF/CNPJ、MX は RFC、AR は DNI など）
payer.user_reference	string	いいえ	加盟店側で固定されたユーザー ID
amount	number	はい	国の通貨の主要単位での金額（例：100 = 100 BRL。センターボではありません）
country	string	はい	ISO-3166 alpha-2 国コード（BR、MX、AR、CO、CL、PE、UY、EC、BO、CR、GT）
currency	string	はい	ISO-4217 通貨コード（BRL、MXN、ARS、COP、CLP、PEN、USD など）
order_id	string	はい	マーチャント側の注文参照番号（レポートに表示されます）
description	string	いいえ	支払者向けのわかりやすい説明
callback_url	string	いいえ	REDIRECT フロー完了後のブラウザーのリダイレクト先
notification_url	string	いいえ	ステータス変更時に dLocal が呼び出す Webhook URL
payment_method_id	string	はい	/payments-methods の決済方法 ID（例：CARD、PIX、OX、PSE、SPEI）。list_payment_methods を使用して国の決済方法を列挙します。
payment_method_flow	enum	はい	トークン化カードには DIRECT、ホスト型フロー（OXXO バウチャー、Pix QR コード、PSE 銀行選択）には REDIRECT を指定します。DIRECT \| REDIRECT

詳細

@codespar/mcp-dlocal

dLocal 向け MCP サーバー — ラテンアメリカの国境を越えた決済。

1 つの API で、ラテンアメリカの 15 か国以上と、現地の決済方法（Pix、OXXO、PSE、SPEI、Boleto、カード）に対応します。国ごとの PSP サーバーだけでは実現できない抽象化を提供します。

ツール（18）

ツール	目的
`create_payment`	現地の決済方法を使って、ラテンアメリカの国で決済（入金）を作成します。
`get_payment`	dLocal の決済 ID を指定して、決済ステータスと詳細情報を取得します。
`get_payment_by_order_id`	作成時に指定した加盟店側の order_id を使って決済を取得します。
`list_payments`	日付／国／ステータスで任意に絞り込んで決済を一覧表示します。
`capture_payment`	AUTHORIZED 状態のカード決済を売上確定します。
`cancel_payment`	オーソリ済み・未売上確定の決済をキャンセルするか、PENDING 状態の決済を無効化します。
`create_refund`	売上確定済みの決済を返金します。
`get_refund`	返金 ID を指定して返金ステータスを取得します。
`list_refunds`	任意で payment_id を指定して返金を一覧表示します。
`create_payout`	ラテンアメリカの国にいる受取人へ送金します。
`get_payout`	dLocal の送金 ID を指定して送金ステータスを取得します。
`get_payout_by_external_id`	作成時に指定した加盟店の external_id／order_id を使って送金を取得します。
`list_payouts`	日付／国／ステータスで任意に絞り込んで送金を一覧表示します。
`list_payment_methods`	指定した国で利用可能なすべての決済方法を一覧表示します。
`get_balance`	通貨ごとの加盟店の現在の利用可能残高を取得します。
`get_exchange_rate`	仕向国／通貨の組み合わせについて、dLocal の為替レートを照会します。
`create_card_token`	DIRECT フローの create_payment で使うカードをトークン化します。
`validate_document`	ラテンアメリカの納税者番号／身分証明書（BR の CPF または CNPJ、AR の CUIT/CUIL/DNI、CL/UY の RUT、M...）を検証します。

インストール

npm install @codespar/mcp-dlocal

環境

DLOCAL_LOGIN="..."        # X-Login header value
DLOCAL_TRANS_KEY="..."    # X-Trans-Key header value
DLOCAL_SECRET_KEY="..."   # HMAC secret used to sign V2 requests
DLOCAL_BASE_URL="..."     # Optional. Defaults to https://api.dlocal.com. Use https://sandbox.dlocal.com for sandbox.

認証

すべてのリクエストに V2 HMAC-SHA256 で署名します。

X-Date: <ISO-8601 UTC>
X-Login: <login>
X-Trans-Key: <trans_key>
Authorization: V2-HMAC-SHA256, Signature: <hex(hmac_sha256(login + x_date + body, secret_key))>

署名はサーバーが自動的に処理するため、設定するのは 3 つの環境変数だけです。

実行

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-dlocal

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-dlocal

対応国

アルゼンチン、ボリビア、ブラジル、チリ、コロンビア、コスタリカ、エクアドル、グアテマラ、メキシコ、ペルー、ウルグアイなどに対応しています。国ごとに利用可能な決済方法をハードコードするのではなく、list_payment_methods を使って実行時に一覧を取得してください。

エンタープライズ

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

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

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

問題を報告

MCP は初めてですか？

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

入門ガイドを読む

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

mcp-dlocal

mcp-dlocal について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

@codespar/mcp-dlocal

ツール（18）

インストール

環境

認証

実行

対応国

エンタープライズ

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

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

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

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

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

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