Stables

Stables MCP Server

Stables の法定通貨から暗号資産への API を AI エージェントに提供する MCP（Model Context Protocol）サーバーです。これにより、Claude、ChatGPT、Cursor、Codex などの AI アシスタントや、その他の MCP 対応クライアントが、顧客の管理、USDC および USDT の見積もり作成、承認済み送金の実行、バーチャルアカウントのプログラムによる処理を行えます。

AI エージェントやエージェント型コマース向けのステーブルコイン決済ワークフローの構築にお使いください。支払い、バーチャルアカウントへの入金、資金管理、法定通貨へのオフランプ、Webhook による照合に対応しています。

MCP とは？

MCP（Model Context Protocol）は、AI アプリケーションを外部のツールやデータソースに接続するための標準化された方法を提供するオープンスタンダードです。「AI のための USB-C ポート」のようなものです。MCP に対応する AI であれば、どの MCP サーバーでも利用できます。

機能

この MCP サーバーは、docs.stables.money に記載されている各操作に対応する、11 カテゴリにわたる 51 個のツールを提供します（これを確認するコントラクトテストについては、以下をご覧ください）。

顧客管理

• create_customer - 個人または法人の顧客を作成します
• create_customer_onboarding_link - 1 回の呼び出しで顧客とホスト型の本人確認リンクを作成します
• get_customer - 顧客の詳細と本人確認状況を取得します
• list_customers - すべての顧客を一覧表示します
• get_verification_link - KYC 本人確認リンクを生成します
• update_customer - 顧客の詳細と利用資格を更新します
• update_customer_metadata - 顧客のメタデータのキーと値のペアを更新します

利用資格

• list_available_entitlements - 顧客がまだ申請できる商品と決済レールを一覧表示します
• request_entitlements - 既存の顧客に利用資格（例：aed_local）を申請します
• submit_entitlement_requirements - Stables が求める追加の本人確認情報を提出します

コンプライアンスリクエスト（RFI）

• list_rfis - 組織の RFI を一覧表示します。保留中の支払いや本人確認を解除する前にコンプライアンス部門が必要とする情報を確認できます
• list_customer_rfis - 1 人の顧客の RFI を一覧表示します
• get_rfi - 1 件の RFI、その要件、および各要件への回答方法を取得します
• get_rfi_evidence_form - evidence 要件で求められるフォームを取得します
• submit_rfi_evidence - evidence 要件に対する回答と書類を提出します
• get_kyc_capabilities - 顧客が保有する本人確認機能を取得します

書類

• add_document - 請求書、契約書、その他の書類を送金または入金に添付します
• list_documents - 送金または入金に関連付けられた書類を一覧表示します
• get_document_download_url - 書類の有効期間が短いダウンロードリンクを取得します
• delete_document - 書類を削除します

見積もり

• create_quote - 為替レートの見積もりを取得します（USDC／USDT から法定通貨）
• get_quote - 見積もりのステータスと詳細を確認します

送金

• validate_payment_method - 送金前に、決済経路のルールに照らして支払い詳細を確認します
• create_transfer - 有効な見積もりを使用し、入金または残高から支払って送金を実行します
• get_transfer - 送金のステータスを確認します
• list_transfers - フィルターを指定して送金を一覧表示します

バーチャルアカウント

• create_virtual_account - 法定通貨の入金用にバーチャル銀行口座を作成します
• list_virtual_accounts - 顧客ごと、またはすべての顧客を対象に、バーチャルアカウントを一覧表示します
• update_virtual_account - バーチャルアカウントの設定を更新します
• register_route_payid - AUD 決済ルートに PayID を登録します
• get_virtual_account_history - 決済ルートの入金と、それに伴う支払いを取得します
• update_route_destination - 既存のルートの送金先ウォレットを変更します
• list_route_whitelist / add_route_whitelist_account / update_route_whitelist_account - AUD ルートの送金元アカウントをホワイトリストに登録します

残高

• get_balance - 組織の資産およびネットワークごとの残高を取得します
• get_balance_wallet / create_balance_wallet - 残高に入金するためのウォレットを取得または作成します
• list_balance_activity - 残高に入金済みの入金を一覧表示します
• list_pending_balance_deposits - 残高に反映される前の入金と、その理由を一覧表示します
• list_whitelisted_wallets - 残高への入金が許可されているウォレットを一覧表示します

サンドボックス

• simulate_route_deposit - 決済ルートへの法定通貨の入金をシミュレートします（サンドボックスのみ）
• simulate_transfer_deposit - オフランプ送金が待機している暗号資産の入金をシミュレートします（サンドボックスのみ）

API キー

• create_api_key - 新しい API キーを作成します
• list_api_keys - すべての API キーを一覧表示します
• get_api_key - API キーの詳細を取得します
• revoke_api_key - API キーを失効させます

Webhook

• create_webhook - Webhook 経由でイベントを購読します
• list_webhooks - すべての Webhook 購読を一覧表示します
• delete_webhook - Webhook 購読を削除します
• list_webhook_deliveries - 最近の配信試行、ステータスコード、再試行状態を表示します

ホスト型サーバー（推奨）

サーバーはホスト型サービスとして実行されるため、インストールは不要です。MCP クライアントの接続先を次のように設定します。

https://mcp.stables.money/mcp

そのうえで、Stables API キーをベアラートークンとして送信するか、OAuth でサインインします。オンボーディング時に取得したキーだけで十分です。sti_test_… キーはサンドボックスに接続し、sti_live_… キーは本番環境に接続して、実際のお金を移動します。キーを保持できないクライアント（Claude.ai、ChatGPT）は、代わりにサインインします。詳しくは以下をご覧ください。

Claude Code

claude mcp add --transport http stables https://mcp.stables.money/mcp --header "Authorization: Bearer ${STABLES_API_KEY}"

url フィールドを持つ Cursor、VS Code、Windsurf などのクライアント

{
  "mcpServers": {
    "stables": {
      "url": "https://mcp.stables.money/mcp",
      "headers": {
        "Authorization": "Bearer sti_test_..."
      }
    }
  }
}

Codex

[mcp_servers.stables]
url = "https://mcp.stables.money/mcp"
bearer_token_env_var = "STABLES_API_KEY"

Claude.ai、ChatGPT など、OAuth でサインインするクライアント

https://mcp.stables.money/mcp をキーなしのカスタムコネクターとして追加します。クライアントはサーバーの OAuth エンドポイントを検出して自身を登録し、サンドボックスと本番環境のどちらに接続するか、およびそのクライアントに権限を付与するかを尋ねる Stables のページに移動します。その後、Stables ダッシュボードのアカウントでサインインし（複数の組織に所属している場合は、組織を選択します）。

読み取り専用（デフォルト）または読み取りと変更を選択します。読み取り専用の場合、エージェントは情報を参照できますが、何かを変更するツールは、再接続して変更を許可するまで拒否されます。この方法で接続されたエージェントは、API キーを作成したり失効させたりすることはできません。すべてのツールには読み取り専用または破壊的操作のラベルが付いているため、Claude などのクライアントは変更のたびに確認を求めます。Auth0 は毎回、認証情報（および第 2 要素）を要求し（エージェントの接続では既存のブラウザーセッションは再利用されません）、複数の組織に所属している場合は使用する組織を尋ねます。認証に成功すると、サーバーはその組織に、クライアント名とサインインしたアカウント名を付けた API キー（例：Claude via MCP ([email protected])）を作成し、クライアントからのすべての呼び出しに使用します。ダッシュボードの Developer → API keys からいつでもキーを失効させることができ、その場合クライアントは切断されます。それ以外の情報は保存されません。サインイントークンはキーの作成に一度だけ使用され、その後破棄されます。

• Claude.ai / Claude Desktop： Settings → Connectors → Add custom connector で URL https://mcp.stables.money/mcp を指定し、OAuth クライアントのフィールドはデフォルトのままにします。
• ChatGPT： Settings → Connectors → Create（developer mode）で、MCP server URL に https://mcp.stables.money/mcp を指定し、認証方式を OAuth にします。
• キーなしの Claude Code： claude mcp add --transport http stables https://mcp.stables.money/mcp を実行し、その後 /mcp でサインインします。

OAuth エンドポイントは標準仕様に準拠しています。/.well-known/oauth-protected-resource/mcp、/.well-known/oauth-authorization-server、/authorize、/oauth/token、/oauth/register。Client ID Metadata Documents と動的登録の両方に対応しています。PKCE（S256）が必須です。

ローカルでの実行

同じサーバーは stdio 経由のローカルプロセスとしても実行できます。npx stables-mcp-server はこの方法で実行します。独自のデプロイ環境で sti_local_… キーを使う場合や、クライアントがインターネットに接続できない場合に使用します。

インストール

# Install from npm
npm install -g stables-mcp-server

# Or clone and build from source
git clone https://github.com/stables-money/mcp-server.git
cd mcp-server
npm install
npm run build

設定

サーバーには、次の環境変数が必要です。

変数	必須	説明
STABLES_API_KEY	はい	Stables API キー
STABLES_API_URL	いいえ	API のベース URL。デフォルトでは、キーが属する環境が使用されます（以下を参照）。HTTPS を使用する必要があります。

接続先の環境

Stables のキーには環境が含まれています。sti_test_… はサンドボックスキー、sti_live_… は本番キーで、API は環境が合わないキーを拒否します。そのため、URL を設定する必要はありません。STABLES_API_URL は未設定のままにしておけば、キーによって接続先が決まります。

キー	リクエストの送信先
sti_test_…	https://api.sandbox.stables.money
sti_live_…	https://api.stables.money — 実際の資金が動きます
sti_local_… またはその他の値	STABLES_API_URL を設定しない限り、本番環境

STABLES_API_URL を設定すると、常にその値が優先されます。これにより、ステージング環境、開発環境、またはローカルデプロイに接続できます。

まずはサンドボックスキーを使用してください。 ライブキーを持つエージェントは、あなたに代わって実際の資金を移動できます。エージェントの安全性をご覧ください。

使用方法

Claude Desktop を使用する場合

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "stables": {
      "command": "npx",
      "args": ["stables-mcp-server"],
      "env": {
        "STABLES_API_KEY": "your-api-key",
        "STABLES_API_URL": "https://api.sandbox.stables.money"
      }
    }
  }
}

その後、Claude Desktop を再起動します。

Cursor、Codex、ChatGPT、またはその他の MCP クライアントを使用する場合

MCP 対応クライアントで、同じコマンドと環境変数を使用します。

{
  "mcpServers": {
    "stables": {
      "command": "npx",
      "args": ["stables-mcp-server"],
      "env": {
        "STABLES_API_KEY": "your-api-key",
        "STABLES_API_URL": "https://api.sandbox.stables.money"
      }
    }
  }
}

エージェントの安全性

Stables は金融インフラストラクチャです。エージェントは見積もりの作成、支払いオブジェクトの準備、Webhook の照合を行えますが、送金やその他の資金移動を作成する前に、明示的な人間の承認を必須にする必要があります。取引を伴う操作を行う前に、顧客の KYC/KYB ステータスと利用資格を確認してください。また、制裁、非対応の管轄区域、本人確認、コンプライアンスに関するエラーは、処理を停止する条件として扱ってください。

MCP Inspector を使用する場合（テスト用）

# Set environment variables
export STABLES_API_KEY=your-api-key
export STABLES_API_URL=https://api.sandbox.stables.money

# Run the inspector
npm run inspect

直接実行

STABLES_API_KEY=your-api-key node build/index.js

会話の例

顧客を作成して見積もりを取得する

ユーザー：「[email protected] の顧客を作成して、1000 USDT を EUR に換算する見積もりを取得してください」

AI（MCP ツールを使用）：

1. メールアドレスと種別を指定して create_customer を呼び出します
2. 送金元の USDT とネットワーク、送金先の EUR と国、および destinationNetwork（swift または bank）を指定して create_quote を呼び出します
3. 顧客の詳細と見積もり情報を返します

送金状況を確認する

ユーザー：「保留中の送金はすべて、現在どのような状況ですか？」

AI（MCP ツールを使用）：

1. status=created または status=in_progress（ステータスは小文字）を指定して list_transfers を呼び出します
2. 処理中の送金を一覧に整形して返します

自動支払いを設定する

ユーザー：「顧客 abc123 の AUD 入金を、私の Polygon の USDT ウォレット 0x... に払い出す決済ルートを作成してください」

AI（MCP ツールを使用）：

1. 顧客 ID、送金元通貨 AUD、Polygon の送金先を指定して create_virtual_account を呼び出します（支払い先アドレスは必須です）
2. 顧客に共有する入金手順を返します

欧州の受取人に支払う

ユーザー：「このドイツの銀行口座に 500 EUR を支払ってください」

AI（MCP ツールを使用）：

1. ほかの処理を行う前に、EUR で必要な追加の受取人情報（recipientType、完全な住所、個人の場合は dateOfBirth）を収集します
2. create_quote を呼び出し、その後、人間の承認を得てから create_transfer を呼び出します

ホスト型サーバーの運用

ホスト型サーバーは、src/worker.ts (wrangler.toml) にある Cloudflare Worker です。次の設定が必要です。

• OAUTH_KV：OAuth クライアント、許可、トークン用の KV ネームスペースです。トークンとシークレットはハッシュとして保存されます。許可の API キーは、その許可のトークンのみが復号できるキーで暗号化されます。
• Vars MCP_PUBLIC_URL、AUTH0_DOMAIN、AUTH0_CLIENT_ID：公開オリジン、Auth0 のカスタムドメイン、「Stables MCP」レギュラーウェブアプリケーション（コールバック https://mcp.stables.money/callback）です。
• Secret AUTH0_CLIENT_SECRET：そのアプリケーションのシークレットです。
• Secret MCP_GATEWAY_SIGNING_SECRET：API ゲートウェイの IP 認証機能と共有するシークレットです。Worker には固定の送信元 IP がないため、転送する各リクエストに署名します（X-Stables-Mcp-Signature）。本番環境では送信元 IP のチェックの代わりにこの署名を受け入れます。この設定がない場合、ホスト型サーバー経由の本番環境での呼び出しはゲートウェイに拒否されますが、サンドボックスには影響しません。

wrangler secret put AUTH0_CLIENT_SECRET
wrangler secret put MCP_GATEWAY_SIGNING_SECRET

OAUTH_KV がない場合、Worker はベアラキーのみで動作します。単体テストではこの方法で Worker をテストしています。

開発

# Watch mode for development
npm run dev

# Build for production
npm run build

# Run tests
npm test

# Run linter
npm run lint

# Format code
npm run format

# Test with MCP Inspector
npm run inspect

プロジェクト構成

stables-mcp-server/
├── src/
│   ├── index.ts              # Main entry point
│   ├── lib/
│   │   ├── stables-client.ts # Stables API client (with retries, timeouts)
│   │   └── stables-client.test.ts
│   └── tools/
│       ├── customers.ts      # Customer management tools (7)
│       ├── entitlements.ts   # Entitlement tools (3)
│       ├── compliance.ts     # RFI and KYC capability tools (6)
│       ├── documents.ts      # Transfer and deposit document tools (4)
│       ├── quotes.ts         # Quote tools (2)
│       ├── transfers.ts      # Transfer tools (4)
│       ├── virtual-accounts.ts # Payment route tools (9)
│       ├── balances.ts       # Balance tools (6)
│       ├── api-keys.ts       # API key tools (4)
│       ├── webhooks.ts       # Webhook tools (3)
│       └── sandbox.ts        # Sandbox deposit simulation (2)
├── package.json
├── tsconfig.json
├── vitest.config.ts
├── eslint.config.js
└── README.md

API リファレンス

顧客ツール

create_customer

KYC と送金のために新しい顧客を作成します。

パラメーター	型	必須	説明
email	string	はい	顧客のメールアドレス
customerType	"individual" | "business"	はい	顧客の種類
firstName	string	いいえ	名（個人の場合）
lastName	string	いいえ	姓（個人の場合）
companyName	string	いいえ	会社名（法人の場合）
entitlements	string[]	いいえ	申請する権限（例：["base_payout", "virtual_account"]）

get_customer

顧客の詳細を取得します。

パラメーター	型	必須	説明
customerId	string	はい	顧客 ID

list_customers

認証済みテナントのすべての顧客を一覧表示します。パラメーターは不要です。

get_verification_link

KYC 認証リンクを生成します。

パラメーター	型	必須	説明
customerId	string	はい	顧客 ID
ttlInSecs	number	いいえ	リンクの有効期限（秒）（デフォルト：1800）
successUrl	string	いいえ	認証成功後のリダイレクト URL
rejectUrl	string	いいえ	認証が拒否された後のリダイレクト URL

update_customer

顧客の詳細または権限を更新します。

パラメーター	型	必須	説明
customerId	string	はい	顧客 ID
email	string	いいえ	更新後のメールアドレス
phone	string	いいえ	更新後の電話番号
firstName	string	いいえ	更新後の名
lastName	string	いいえ	更新後の姓
entitlements	string[]	いいえ	更新後の権限

update_customer_metadata

顧客のメタデータのキーと値のペアを更新します。

パラメーター	型	必須	説明
customerId	string	はい	顧客 ID
metadata	object	はい	設定するキーと値のペア

見積もりツール

create_quote

通貨交換（暗号資産から法定通貨）の見積もりを取得します。

パラメーター	型	必須	説明
fromCurrency	"USDC" | "USDT"	はい	交換元の暗号資産
fromAmount	string	はい	交換する金額
fromNetwork	"ethereum" | "polygon" | "polygon-amoy"	はい	ブロックチェーンネットワーク
toCurrency	string	はい	交換先の通貨（例：「EUR」）
toCountry	string	はい	交換先の国コード（例：「GR」）
paymentMethodType	"SWIFT" | "LOCAL"	はい	出金に使用する支払い方法

get_quote

見積もりの詳細を取得します。

パラメーター	型	必須	説明
quoteId	string	はい	見積もり ID

送金ツール

create_transfer

見積もりに基づいて送金を実行します。

パラメーター	型	必須	説明
customerId	string	はい	顧客 ID
quoteId	string	はい	実行する見積もりの ID
accountHolderName	string	いいえ	銀行口座名義人の氏名
iban	string	いいえ	IBAN
accountNumber	string	いいえ	銀行口座番号
bankName	string	いいえ	銀行名
bankCountry	string	いいえ	銀行の国コード
bankCurrency	string	いいえ	送金先通貨
accountType	"savings" | "checking" | "payment"	いいえ	口座の種類
swiftCode	string	いいえ	SWIFT/BIC コード
routingNumber	string	いいえ	ABA ルーティング番号（米国）
sortCode	string	いいえ	ソートコード（英国）
ifscCode	string	いいえ	IFSC コード（インド）
bsbCode	string	いいえ	BSB コード（オーストラリア）

get_transfer

送金のステータスを取得します。

パラメーター	型	必須	説明
transferId	string	はい	送金 ID

list_transfers

フィルターを指定して送金の一覧を取得します。

パラメーター	型	必須	説明
status	string	いいえ	ステータスで絞り込みます
type	string	いいえ	種類で絞り込みます
customerId	string	いいえ	顧客で絞り込みます
pageSize	number	いいえ	1 ページあたりの結果数
pageToken	string	いいえ	ページネーショントークン

バーチャル口座ツール

create_virtual_account

バーチャル銀行口座を作成します。

パラメーター	型	必須	説明
customerId	string	はい	顧客 ID
sourceCurrency	string	はい	通貨（例："USD"）
depositHandlingMode	string	いいえ	"auto_payout"、"hold"、または "manual"
destinationAddress	string	いいえ	暗号資産ウォレットのアドレス
destinationPaymentRail	string	いいえ	ブロックチェーンネットワーク
destinationCurrency	string	いいえ	ステーブルコイン（デフォルト："usdc"）

list_virtual_accounts

顧客のバーチャル口座の一覧を取得します。

パラメーター	型	必須	説明
customerId	string	はい	顧客 ID
status	string	いいえ	ステータスで絞り込みます
limit	number	いいえ	結果の最大数

update_virtual_account

バーチャル口座の設定を更新します。

パラメーター	型	必須	説明
customerId	string	はい	顧客 ID
virtualAccountId	string	はい	バーチャル口座 ID
depositHandlingMode	string	はい	新しい入金処理モード

get_virtual_account_history

バーチャル口座のアクティビティ履歴を取得します。

パラメーター	型	必須	説明
customerId	string	はい	顧客 ID
virtualAccountId	string	はい	バーチャル口座 ID
limit	number	いいえ	返すイベントの最大数
eventType	string	いいえ	イベントの種類で絞り込みます

API キーツール

create_api_key

新しい API キーを作成します。

パラメーター	型	必須	説明
name	string	はい	キーを説明する名前
metadata	object	いいえ	任意のメタデータ

list_api_keys

すべての API キーの一覧を取得します。

パラメーター	型	必須	説明
pageSize	number	いいえ	1 ページあたりの結果数
pageToken	string	いいえ	ページネーショントークン

get_api_key

API キーの詳細を取得します。

パラメーター	型	必須	説明
apiKeyId	string	はい	API キー ID

revoke_api_key

API キーを取り消します（取り消し後は元に戻せません）。

パラメーター	型	必須	説明
apiKeyId	string	はい	API キー ID

Webhook ツール

create_webhook

Webhook 経由でイベントを購読します。

パラメーター	型	必須	説明
name	string	はい	Webhook 名
url	string	はい	HTTPS エンドポイント URL
eventTypes	string[]	はい	購読するイベント
secret	string	いいえ	HMAC-SHA256 署名シークレット

利用可能なイベントタイプ：

• WEBHOOK_EVENT_TYPE_CUSTOMER_CREATED
• WEBHOOK_EVENT_TYPE_CUSTOMER_UPDATED
• WEBHOOK_EVENT_TYPE_KYC_STATUS_CHANGED
• WEBHOOK_EVENT_TYPE_PAYMENT_CREATED
• WEBHOOK_EVENT_TYPE_PAYMENT_STATUS_CHANGED
• WEBHOOK_EVENT_TYPE_QUOTE_CREATED
• WEBHOOK_EVENT_TYPE_QUOTE_EXPIRED
• WEBHOOK_EVENT_TYPE_VA_DEPOSIT_RECEIVED
• WEBHOOK_EVENT_TYPE_VA_PAYOUT_COMPLETED
• WEBHOOK_EVENT_TYPE_VA_PAYOUT_FAILED
• WEBHOOK_EVENT_TYPE_ALL

list_webhooks

すべてのWebhook購読を一覧表示します。パラメーターは不要です。

delete_webhook

Webhook購読を削除します。

パラメーター	型	必須	説明
webhookId	string	はい	Webhook購読 ID

セキュリティ

• API キーは環境変数からのみ読み取ります
• API URL には HTTPS が必要です（起動時に適用）
• stderr へのデバッグログ出力はありません（MCP STDIO トランスポートが破損するため）
• すべての入力は Zod スキーマで検証されます
• リクエストタイムアウト（30s）により、接続がハングするのを防ぎます
• 一時的な障害に対して、指数バックオフによる自動再試行を行います

ライセンス

MIT

リンク

• Stables API ドキュメント
• npm パッケージ
• Model Context Protocol
• MCP TypeScript SDK