Wise

@mindstone/mcp-server-wise

Model Context Protocol ホスト向けの Wise（旧 TransferWise）MCP サーバーです。複数通貨の残高と為替レートの確認、取引やアクティビティの確認、受取人の管理、見積もりによる送金の料金確認ができ、明示的にオプトインすると、すべて標準化された MCP インターフェースを通じて送金の作成、入金、キャンセルも行えます。

ステータス

• バージョン： 0.1.1 · npm
• 認証： API トークン（環境変数、または WISE_CONFIG_PATH を介してディスク上に保存）
• ツール： 17（アカウント、残高、受取人、見積もり、送金、検出）
• 対象： cloud-api
• 機械可読データ： STATUS.json

要件

• Node.js 20+
• npm
• Wise API トークン：wise.com → Settings → API tokens

ワンクリックインストール

ボタンをクリックすると、ホストから WISE_API_TOKEN の入力を求められます。

{
  "mcpServers": {
    "Wise": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-wise"
      ],
      "env": {
        "WISE_API_TOKEN": ""
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/wise
npm install
npm run build

npx（公開後）

npx -y @mindstone/mcp-server-wise

ローカル

node dist/index.js

設定

環境変数

• WISE_API_TOKEN — Wise API トークンです。configure_wise ツールを使って接続する場合は省略できます。設定されている場合は、保存済みのトークンより優先されます。
• WISE_ENVIRONMENT — production（デフォルト）または sandbox です。Sandbox を使用するには、Wise sandbox で作成したトークンが必要です。
• WISE_CONFIG_PATH — configure_wise が書き込んだトークンを保存する設定ディレクトリへのパスです（デフォルトは ~/.mcp/wise）。
• WISE_REQUEST_TIMEOUT_MS — 外部リクエストのタイムアウト（ミリ秒）です（デフォルトは 30000）。
• MCP_HOST_BRIDGE_STATE — 認証情報の管理に使用するホストブリッジ状態ファイルへの任意のパスです。
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE と後方互換性のあるエイリアスです。

ホスト設定の例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Wise": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-wise"],
      "env": {
        "WISE_API_TOKEN": "your-wise-api-token"
      }
    }
  }
}

ローカル開発（npm での公開は不要）

{
  "mcpServers": {
    "Wise": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/wise/dist/index.js"],
      "env": {
        "WISE_API_TOKEN": "your-wise-api-token"
      }
    }
  }
}

ツール（17）

アカウント管理

• configure_wise — API トークンを使って Wise アカウントを接続します（保存前に Wise API で検証します）
• remove_wise_account — Wise アカウントの接続を解除します

プロフィールと残高

• list_wise_profiles — トークンでアクセス可能な個人および法人のプロフィールを一覧表示します。ID は profile_id として使用します
• list_wise_balances — 通貨ごとの金額とともに、残高（複数通貨口座および貯蓄ジャー）を一覧表示します
• get_wise_balance_statement — 指定した期間の単一残高の取引明細を取得します（最大469日）
• list_wise_activities — ステータス付きのアクティビティ（送金、カード決済、入金）を時系列で表示します

為替レートと見積もり

• get_wise_exchange_rate — 2 つの通貨間の現在または過去のミッドマーケットレート
• create_wise_quote — レートを固定し、入金方法ごとの正確な手数料を取得します（資金は移動しません）

受取人

• list_wise_recipients — 保存済みの受取人（銀行口座）の一覧を取得します。通貨または種類で絞り込めます
• get_wise_recipient — 銀行口座情報を含む、1 人の受取人の詳細を取得します
• get_wise_recipient_requirements — 見積もりを指定して、送金経路で Wise が必要とする銀行口座情報の項目を確認します
• create_wise_recipient — 保存済みの受取人を作成します（資金は移動しません）

送金

• list_wise_transfers — フィルター（ステータス、通貨、作成日の期間）を指定して送金一覧を取得します
• get_wise_transfer — 1 件の送金の現在の状態を取得します
• create_wise_transfer — 見積もりから受取人への送金を作成します（まだ入金されていません）
• fund_wise_transfer — 作成済みの送金に Wise 残高から入金します（資金が移動します）
• cancel_wise_transfer — funds_converted 段階に進む前に送金をキャンセルします

一般的な支払いフロー

1. list_wise_profiles → profile_id を選択します
2. create_wise_quote — 送金額を算出し、レートを固定します
3. （新しい受取人の場合）get_wise_recipient_requirements → create_wise_recipient
4. create_wise_transfer — 送金を作成します（まだ入金されていません）
5. fund_wise_transfer — Wise 残高から支払います。この手順で資金が移動します

セキュリティ

• 資金移動はデフォルトで実行されます。 create_wise_transfer、fund_wise_transfer、cancel_wise_transfer は常に利用可能で、destructiveHint: true を宣言します。個々の呼び出しを制御するのはホスト側のツール承認レイヤーの役割であり、コネクターの役割ではありません。見積もりや受取人の作成では資金は移動せず、残高から引き落とされるのは fund_wise_transfer のみです。
• 信頼できないコンテンツのエンベロープ。 外部の関係者が作成した文字列（受取人名と銀行口座情報、送金の参照情報、明細の説明と加盟店名、アクティビティのタイトル、見積もりの通知）は、<untrusted-content source="…"> エンベロープで囲まれます。これにより、ホストの LLM はそれらを指示ではなくデータとして扱います。コネクターが制御するメタデータ（ID、金額、通貨、ステータス、タイムスタンプ）は加工せずに返されます。
• 認証情報の保存。 configure_wise によって書き込まれるトークンは、WISE_CONFIG_PATH 配下の credentials.json に、アクセス権限 0600（設定ディレクトリは 0700）で保存されます。アクセス先は Wise の固定ホスト 2 つ（api.wise.com、api.wise-sandbox.com）のみで、任意のベース URL への上書きはできません。
• エラー情報の保護。 ベンダーのエラーボディ、未加工の Retry-After ヘッダー文字列、クエリを含む URL がログに書き込まれたり、ツールのエラーとして表示されたりすることはありません。エラーメッセージにトークンが含まれることもありません。
• 送金作成の冪等性。 create_wise_transfer は customer_transaction_id を Wise の冪等性キーとして使用するため、再試行しても送金が重複して作成されることはありません。
• 入力の検証。 通貨コード、数値 ID、UUID、日時の期間は、リクエストを行う前に検証されます。

ライセンス

FSL-1.1-MIT — MIT の将来ライセンスが適用される Functional Source License Version 1.1 です。このソフトウェアは 2030-04-08 に MIT ライセンスへ移行します。