CrossFin

CrossFin MCP 服务

让你的 AI Agent 能够访问亚洲加密货币市场。 提供 16 个工具，用于获取韩国交易所的实时数据、跨交易所路由，以及在 14 家交易所执行 x402 付费 API 调用。

---

快速开始

npx -y crossfin-mcp

就这么简单。现在，你的 Agent 已拥有 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 流程	在 14 家交易所和 13 种桥接币之间寻找最优加密货币转账路径
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 Agent 指南（服务、定价、x402 流程）
get_analytics	免费	网关使用统计（调用总数、热门服务）

本地账本

工具	价格	描述
create_wallet	免费	在本地 CrossFin 账本中创建钱包
get_balance	免费	查询钱包余额（KRW）
transfer	免费	在钱包之间转账
list_transactions	免费	交易历史记录（可按钱包筛选）
set_budget	免费	设置每日支出限额（KRW）

---

示例提示词

韩语

在 Bithumb 把 500 万韩元换成 USDC 并转到 Binance，最便宜的方法是什么？

现在韩国与全球市场的价差是多少？

帮我比较各交易所的 XRP 价格

给我一份今天的韩国市场简报

英语

把 500 万韩元从 Bithumb 转到 Binance 并换成 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 协议 自动进行小额付款。当 Agent 调用付费端点时：

1. API 返回 402 Payment Required 和价格标头
2. MCP 服务使用你的 EVM_PRIVATE_KEY 在 Base（L2）上签署 USDC 付款
3. 提交付款后，API 会返回数据和交易收据

付款在链上结算。每个响应都包含 txHash 和 Basescan 链接，供你验证。每次调用的价格为 $0.01 至 $0.20。

要开始使用，请为 Base 钱包充值 USDC 并设置 EVM_PRIVATE_KEY。无需注册账号或 API 密钥。

---

Agent 发现

CrossFin 提供标准发现端点，方便 Agent 框架自动检测功能：

端点	描述
/.well-known/ai-plugin.json	OpenAI 插件清单
/.well-known/agent.json	A2A Agent Card（Google Agent-to-Agent 协议）
/.well-known/x402.json	x402 付款发现（网络、代币、payTo）
/.well-known/crossfin.json	CrossFin 元数据（MCP、API、注册表链接）
/llms.txt	面向大模型的服务描述

---

链接

• crossfin.dev -- 控制面板和 API
• live.crossfin.dev -- 实时路由演示
• docs.crossfin.dev -- 文档
• GitHub -- 源代码
• npm -- 软件包