CrossFin

CrossFin MCP Server

AI エージェントがアジアの暗号資産市場にアクセスできるようにします。 韓国の取引所のリアルタイムデータ、取引所間のルーティング、14 の取引所を対象とした x402 有料 API の実行を可能にする 16 個のツールを提供します。

---

クイックスタート

npx -y crossfin-mcp

以上です。これでエージェントが 16 個のツールを利用できるようになります。ほとんどのツールはウォレットの設定なしで動作しますが、決済対応ツールには EVM_PRIVATE_KEY が必要です。

オープンベータに関する注意：現在、CrossFin API エンドポイントは無料ですが、x402 フローとの互換性を保つため、決済対応の MCP ツールには引き続きウォレット設定が必要です。

---

クライアントの設定

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "crossfin": {
      "command": "npx",
      "args": ["-y", "crossfin-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Cursor

プロジェクトルートの .cursor/mcp.json：

{
  "mcpServers": {
    "crossfin": {
      "command": "npx",
      "args": ["-y", "crossfin-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

VS Code

プロジェクトルートの .vscode/mcp.json（または設定内のユーザーレベル）：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "evm-key",
      "description": "Base wallet private key for x402 payments (optional)",
      "password": true
    }
  ],
  "servers": {
    "crossfin": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "crossfin-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "${input:evm-key}"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "crossfin": {
      "command": "npx",
      "args": ["-y", "crossfin-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

npx（スタンドアロン）

EVM_PRIVATE_KEY=0x... npx -y crossfin-mcp

EVM キーがありませんか？ EVM_PRIVATE_KEY を省略してください。無料ツールはキーがなくても動作します。

---

16 個すべてのツール

ルーティングエンジン

ツール	価格	説明
find_optimal_route	x402 フロー	13 種類のブリッジコインを利用し、14 の取引所間で最適な暗号資産の送金経路を検索します
list_exchange_fees	無料	すべての取引所の取引手数料と出金手数料を比較します
compare_exchange_prices	無料	Bithumb の KRW 価格と Binance の USD 価格をリアルタイムで比較します
get_kimchi_premium	無料	韓国とグローバルの経路間のスプレッドをプレビューします（上位 3 ペア）

有料 API ゲートウェイ

ツール	価格	説明
call_paid_service	x402 フロー	x402 による USDC 決済を自動で行い、カタログ内のプレミアムエンドポイントを呼び出します

サービスレジストリ

ツール	価格	説明
search_services	無料	キーワードで登録済みサービスを検索します
list_services	無料	カテゴリで絞り込みながらサービスカタログを閲覧します
get_service	無料	指定したサービスの詳細を取得します
list_categories	無料	サービスカテゴリを件数とともにすべて表示します
get_guide	無料	CrossFin エージェントガイドの全文を取得します（サービス、料金、x402 フロー）
get_analytics	無料	ゲートウェイの利用統計を取得します（総呼び出し数、上位サービス）

ローカル台帳

ツール	価格	説明
create_wallet	無料	ローカルの CrossFin 台帳にウォレットを作成します
get_balance	無料	ウォレット残高（KRW）を確認します
transfer	無料	ウォレット間で資金を送金します
list_transactions	無料	取引履歴を表示します（ウォレットでの絞り込みは任意）
set_budget	無料	1 日あたりの支出上限（KRW）を設定します

---

プロンプト例

韓国語

빗썸에서 바이낸스로 500만원 USDC 만들려면 가장 싼 방법이 뭐야?

지금 한국-글로벌 스프레드 얼마야?

거래소별 XRP 가격 비교해줘

오늘 한국 시장 브리핑해줘

英語

Bithumb から Binance に 500 万 KRW を USDC として送るには、最も安い方法は何ですか？

現在の韓国とグローバルの暗号資産スプレッドを表示してください。

取引所間で XRP の価格を比較してください。

今朝の韓国市場の概要を教えてください。

---

対応取引所

韓国： Bithumb、Upbit、Coinone、GoPax 地域通貨： bitFlyer、WazirX、bitbank、Indodax、Bitkub グローバル： Binance、OKX、Bybit、KuCoin、Coinbase

ブリッジコイン

BTC、ETH、XRP、SOL、DOGE、ADA、DOT、LINK、AVAX、TRX、KAIA、SUI、APT

---

環境変数

変数	必須	説明
EVM_PRIVATE_KEY	有料ツールの場合	x402 の USDC 決済に使用する Base ウォレットの秘密鍵
CROSSFIN_API_URL	いいえ	API のベース URL（デフォルト：https://crossfin.dev）
CROSSFIN_LEDGER_PATH	いいえ	ローカル台帳ファイルのパス（デフォルト：~/.crossfin/ledger.json）

---

x402 決済

有料ツールでは、自動マイクロペイメントに x402 プロトコル を使用します。エージェントが有料エンドポイントを呼び出すと、次の処理が行われます。

1. API が 402 Payment Required と価格ヘッダーを返します
2. MCP サーバーが EVM_PRIVATE_KEY を使用して、Base（L2）上で USDC 決済に署名します
3. 決済が送信され、API がトランザクションレシートとともにデータを返します

決済はオンチェーンで精算されます。各レスポンスには txHash と、検証用の Basescan リンクが含まれます。料金は1回の呼び出しにつき $0.01～$0.20 です。

利用を開始するには、Base ウォレットに USDC を入金し、EVM_PRIVATE_KEY を設定してください。アカウント登録や API キーは不要です。

---

エージェントの検出

CrossFin は標準の検出エンドポイントを公開しているため、エージェントフレームワークが機能を自動検出できます。

エンドポイント	説明
/.well-known/ai-plugin.json	OpenAI プラグインマニフェスト
/.well-known/agent.json	A2A エージェントカード（Google Agent-to-Agent プロトコル）
/.well-known/x402.json	x402 決済の検出（ネットワーク、トークン、payTo）
/.well-known/crossfin.json	CrossFin メタデータ（MCP、API、レジストリのリンク）
/llms.txt	LLM 向けサービスの説明

---

リンク

• crossfin.dev -- ダッシュボードと API
• live.crossfin.dev -- ライブのルーティングデモ
• docs.crossfin.dev -- ドキュメント
• GitHub -- ソースコード
• npm -- パッケージ