mcp-transak について
mcp-transak は Transak 向けの MCP サーバーで、法定通貨と暗号資産の相互変換(オン/オフランプ)を約170か国、複数チェーンで扱います。Partner API を通じてサーバー間で注文を作成・追跡する開発者やエージェントを対象としています。見積もり、上限額、Webhook 署名の検証機能も提供します。
主な機能
- 01Partner API による注文の作成、取得、更新、キャンセル
- 02法定通貨・暗号資産・国ごとの見積もりと最小・最大上限額の取得
- 03対応法定通貨、暗号資産、支払い方法、国の一覧表示
- 04ネットワーク手数料、パートナー残高、購入者の KYC 状況の照会
- 05Transak Webhook の HMAC-SHA256 署名のローカル検証
活用シーン
- 01別のプロバイダーと見積もりを比較し、変換経路を選択するエージェント
- 02購入者の注文状況を追跡し、Webhook で照合する運用
- 03国や購入者ごとの取引上限と KYC 状況を確認する処理
MCP 対応
MCP サーバーとして 18 のツールを MCP クライアントに公開し、Transak Partner API の注文・見積もり・アカウント関連エンドポイントを呼び出します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @codespar/mcp-transakTRANSAK_API_KEYシークレットTransak partner API key (from partner dashboard). Used as partnerApiKey query param on public quote endpoint and bundled with api-secret to mint the access-token for Partner API calls.TRANSAK_API_SECRETシークレットTransak partner API secret. Sent as the api-secret header to endpoints that require server-to-server authentication (and used to mint access tokens for order endpoints).TRANSAK_ENVEnvironment selector: 'staging' (default) targets https://api-stg.transak.com; 'production' targets https://api.transak.com.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
18掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| string | はい | 購入者のメールアドレス(KYC および領収書に使用) | |
| network | string | はい | ブロックチェーンネットワーク(ethereum、polygon、bsc、solana、bitcoin、arbitrum、optimism、base など) |
| fiatAmount | number | いいえ | 法定通貨額。fiatAmount または cryptoAmount のいずれかを設定する必要があります。 |
| themeColor | string | いいえ | ホスト型ウィジェットのブランディングに使用する任意の 16 進カラーコード(# を除く) |
| isBuyOrSell | enum | はい | BUY = 法定通貨から暗号資産へのオンランプ;SELL = 暗号資産から法定通貨へのオフランプBUY | SELL |
| redirectURL | string | いいえ | ホスト型フロー完了後に Transak がリダイレクトする URL |
| cryptoAmount | number | いいえ | 暗号資産の数量。fiatAmount または cryptoAmount のいずれかを設定する必要があります。 |
| fiatCurrency | string | はい | ISO-4217 の法定通貨コード(USD、EUR、BRL、GBP、INR など) |
| paymentMethod | string | いいえ | list_payment_methods の方式 ID(credit_debit_card、apple_pay、google_pay、sepa_bank_transfer、pix、upi など) |
| walletAddress | string | はい | 暗号資産ウォレットの送付先(BUY)または送付元(SELL)アドレス |
| cryptoCurrency | string | はい | 暗号資産のティッカー(ETH、USDC、USDT、BTC、SOL、MATIC など) |
| partnerOrderId | string | はい | 加盟店側の固定注文 ID(webhook でそのまま返されます) |
| partnerCustomerId | string | いいえ | 加盟店側の固定ユーザー ID(リピーター向け) |
詳細
@codespar/mcp-transak
Transak 用の MCP サーバーです。約 170 か国で、複数のチェーン(Ethereum、Solana、Polygon、BSC、Bitcoin、Arbitrum、Optimism、Base など)に対応した法定通貨と暗号資産のオン/オフランプを提供します。
Transak は MoonPay と対をなすサービスです。どちらも同じ課題、つまり現地の法定通貨をオンチェーンの暗号資産に交換し、その逆も行うことを解決しますが、提携先、対応国、価格設定のカーブはそれぞれ異なります。両方を組み合わせることで、エージェントコマースのワークフローでは、特定のプロバイダーに固定するのではなく、通貨ペアごとに最適な経路を選択できます。
MoonPay と Transak の両方を使う理由
- 対応範囲:MoonPay は約 160 か国、Transak は約 170 か国に対応しています。重複する範囲は広いものの、差がある地域も重要です。中南米、中東・北アフリカ、アジア太平洋の一部の経路では、どちらか一方がより優れています。
- 提携先:DEX、ウォレット、dapp の提携先はそれぞれ異なり、購入者ごとの KYC 再利用やカストディの方針に影響します。
- 価格設定:手数料、為替スプレッド、最小額/最大額は経路ごとに異なります。エージェントは両方に
get_quoteを呼び出して比較し、経路を選択できます。 - 冗長性:一方のプロバイダーがレート制限を設けたり、ある国のリスクを引き下げたり、KYC 保留を発生させたりしても、もう一方で処理を継続できます。
この MCP サーバーはウィジェットではなく、Partner API(サーバー間通信)に焦点を当てています。エージェントが直接注文を作成し、ステータスをポーリングして、Webhook で照合します。
ステータス
0.1.0-alpha.1。一般公開されている通貨、支払い方法、見積もりの各エンドポイントは、api-stg.transak.com でライブ検証済みです。パートナー注文のエンドポイントパス(/api/v2/orders、/api/v2/orders/{id}、/cancel、/api/v2/partner/me)は、文書化された規則に従っていますが、一部は Transak のパートナーダッシュボード内でしか完全に確認できません。実際のキーを使って接続した際に、細かな調整が必要になる場合があります。
ツール(18)
| ツール | 目的 |
|---|---|
create_order | Transak の注文を作成します。 |
get_order | Transak の注文 ID を指定して、Transak の注文を取得します。 |
list_orders | パートナーアカウントの Transak 注文を一覧表示します。 |
update_order | 作成後の Transak 注文を更新します。 |
cancel_order | Transak の注文をキャンセルします。 |
get_quote | 法定通貨と暗号資産の価格見積もりを取得します(公開、認証不要)。 |
get_order_limits | 法定通貨、暗号資産、国の組み合わせにおける取引の最小額と最大額を取得します。米国の購入者が取引できる最小 USD 額などを確認できます… |
list_fiat_currencies | Transak が対応するすべての法定通貨を、通貨ごとの支払い方法、上限・下限、国の制限とともに一覧表示します… |
list_crypto_currencies | Transak が対応するすべての暗号資産を、ネットワーク、桁数、入金/出金の可否、管轄区域とともに一覧表示します… |
list_payment_methods | 指定した法定通貨で利用できる支払い方法(カード、Apple Pay、Google Pay、SEPA、UPI、Pix、電信送金など)を一覧表示します… |
list_countries | Transak がサービスを提供する国を、利用可能な法定通貨、支払い方法、国ごとの KYC 要件とともに一覧表示します… |
list_network_fees | 暗号資産とネットワークの組み合わせごとに、Transak が請求する(または見積もる)ネットワーク/ガス手数料を一覧表示します。 |
get_partner_account | 認証済みパートナーのアカウントプロフィール(名前、API キー情報、設定済み Webhook、デフォルト通貨)を取得します。 |
get_partner_balance | パートナーの決済残高を取得します。Transak は SELL の支払いに充てる流動性を法定通貨ごとに保有しています… |
refresh_access_token | パートナーの api-secret から、有効期間の短い新しいアクセストークンを発行します。 |
get_kyc_status | パートナーが以前 Transak に送信した購入者の KYC ステータスを取得します。 |
get_user_limits | ユーザーの KYC ティアと国に基づいて Transak が付与した、現在のユーザーごとの取引上限を取得します(da… |
verify_webhook_signature | Transak の Webhook 配信に含まれる HMAC-SHA256 署名をローカルで検証します。 |
環境
| 変数 | 必須 | 秘密情報 | 説明 |
|---|---|---|---|
TRANSAK_API_KEY | はい | いいえ | パートナー API キー(公開エンドポイントでは partnerApiKey としても渡されます) |
TRANSAK_API_SECRET | はい | はい | パートナー API シークレット(api-secret ヘッダーとして送信されます) |
TRANSAK_ACCESS_TOKEN | いいえ | はい | 有効期間の短いアクセストークン(パートナーのティアで必要な場合、access-token ヘッダーとして送信されます) |
TRANSAK_ENV | いいえ | いいえ | staging(デフォルト)または production |
インストール
npm install @codespar/mcp-transak@alpha
実行(stdio)
TRANSAK_API_KEY=... TRANSAK_API_SECRET=... mcp-transak
実行(HTTP)
TRANSAK_API_KEY=... TRANSAK_API_SECRET=... mcp-transak --http
# POST http://localhost:3000/mcp
ドキュメント
- Transak:https://docs.transak.com
- CodeSpar カタログ:https://github.com/codespar/mcp-dev-latam
エンタープライズ
エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか? CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。
認証
サーバーを起動する前に、以下の環境変数を設定してください。
TRANSAK_API_KEY(必須) — Transak パートナー API キー(パートナーダッシュボードから取得)。公開見積もりエンドポイントではpartnerApiKeyクエリパラメーターとして使用され、Partner API 呼び出し用のaccess-tokenを発行する際にapi-secretと組み合わせて使用されます。TRANSAK_API_SECRET(必須、秘密情報) — Transak パートナー API シークレット。サーバー間認証が必要なエンドポイントにapi-secretヘッダーとして送信されます(また、注文エンドポイント用のアクセストークンの発行にも使用されます)。TRANSAK_ENV— 環境の選択:'staging'(デフォルト)は https://api-stg.transak.com を指定し、'production' は https://api.transak.com を指定します。
認証情報はプロバイダーの開発者ポータルで発行してください:https://docs.transak.com。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。