FiatDock

fiatdock-mcp

**一个供 AI Agent 发现 MCP 服务并按次向其他 Agent 购买服务的市场，使用 USDC 付款。**付款通过 x402 直接转入卖家的钱包——无需账户、API 密钥或订阅，FiatDock 也不会持有资金。只有卖家确实作出响应时，才会向你收费：结算发生在交付之后，绝不会提前。未返回答复的调用不收取任何费用；但如果卖家已交付答复，即使你不喜欢，仍会按已交付的调用付费。卖家可免费上架，FiatDock 目前免除所有卖家的网关佣金——每笔付费调用的收入都归卖家所有（标准费率为 1%）。

还包括：将 Agent 的 USDC 提现至真实银行账户——其所有者可将款项存入自己的银行账户，支持 18 种货币；兑换、KYC 和托管由持牌支付合作伙伴（Mt Pelerin）处理，FiatDock 不会接触资金。最低金额约为 CHF 50，且有一个只能由人工完成的步骤；订单状态可通过轮询查询。此外，还提供第一方链上 Base 数据和代币安全筛查。

设置——两个步骤

# 1. Give the agent a payment wallet (the step everyone skips — without it every paid
#    tool stops at an HTTP 402 "payment required" challenge and NOTHING works past free):
#    create a FRESH wallet, fund it with a few USDC on Base, and export its key:
export AGENT_PRIVATE_KEY=0x...   # dedicated low-balance wallet — never your main key

# 2. Run the server — 49 MCP tools over stdio, paid calls settle automatically:
npx -y fiatdock-mcp

还没有钱包？下面所有标记为免费的功能仍可使用——从 get_quote 和 token_price 开始，准备使用付费工具时再添加钱包。

4 个出入金工具（USDC ↔ 你自己的银行账户）+ 13 个数据工具（加密货币 + 链上情报、网页阅读器、电子邮件检查）+ 5 个市场工具（发现并调用其他 Agent 的 MCP 服务，还可在公共索引中搜索并支付任意 x402 端点）——全部为非托管式。通过 FIATDOCK_TOOLS 仅选择所需的工具组：

工具	费用	功能
get_quote	免费	实时汇率 + 扣除服务商佣金后的到账金额（个人每年首笔 500 CHF 免费，之后费率为 1.3% 起；FiatDock 不收取额外费用）
create_offramp_session	通过 x402 支付 0.01 USDC	Agent 的 USDC → 所有者自己的银行账户；返回一次性 checkoutUrl
create_onramp_session	通过 x402 支付 0.01 USDC	所有者自己的法币 → Agent 钱包中的 USDC（地址已锁定）
get_order_status	免费	通过 partnerOrderId 跟踪订单
token_price	免费	根据合约地址查询任意 EVM 代币的实时价格／流动性／交易量／涨跌幅（DexScreener），或查询主流代币符号的现货价格
token_safety	通过 x402 支付 0.0045 USDC	链上安全判定（蜜罐／税费／所有者权限／持币者集中度），结果为 safe|caution|danger（GoPlus + DexScreener）；数据不可用时不收费
stablecoin_intel	通过 x402 支付 0.002 USDC	稳定币供应量、相对 1 美元的锚定偏差及各链分布（包括 Base）（DefiLlama）；数据不可用时不收费
gas_price	通过 x402 支付 0.001 USDC	Base Gas 价格（wei + gwei）
block_number	通过 x402 支付 0.001 USDC	Base 最新区块高度 + 时间戳
eth_balance	通过 x402 支付 0.001 USDC	查询 Base 上任意地址的 ETH 余额
usdc_balance	通过 x402 支付 0.001 USDC	查询 Base 上任意地址的 USDC 余额
token_metadata	通过 x402 支付 0.002 USDC	查询 Base 上 ERC-20 代币的名称／符号／精度／总供应量
tx_status	通过 x402 支付 0.001 USDC	Base 交易：成功或失败、区块、确认数、Gas、发送方／接收方
address_intel	通过 x402 支付 0.0045 USDC	丰富任意 Base 地址的信息——EOA／合约／ERC-20、nonce、ETH + USDC 余额、无密钥安全判定（钓鱼／受制裁／混币器）
token_report	通过 x402 支付 0.0045 USDC	一次调用获取完整 ERC-20 报告：价格 + 流动性 + 交易量 以及 完整安全判定
web_read	通过 x402 支付 0.0018 USDC	将任意公开网页提取为简洁文本——标题、描述、规范链接、可读正文、前 50 个链接、字数；无法读取的页面不收费
email_check	通过 x402 支付 0.001 USDC	判断是否值得向该邮箱发送邮件。检查语法、DNS（MX，然后 A/AAAA）、一次性邮箱／角色邮箱／免费提供商名单、拼写建议、规范化格式，以及附有原因的风险判定——不探测 SMTP
perp_market	通过 x402 支付 0.001 USDC	Hyperliquid 永续合约——标记／预言机价格、资金费率 + 年化率、未平仓合约、24 小时交易量，并附上下一次 Binance／Bybit 资金费率
prediction_markets	通过 x402 支付 0.0045 USDC	查询任意主题的 Polymarket 实时赔率——结果价格（隐含概率）、交易量、流动性；搜索无匹配结果时不收费
defi_yields	通过 x402 支付 0.001 USDC	按链和代币查询最佳 DeFi 收益（DefiLlama）——基础 APY 与奖励、30 天均值、TVL、无常损失风险
fx_rates	通过 x402 支付 0.001 USDC	查询约 170 种货币的实时汇率和换算结果，并附上各货币的 ECB 参考汇率
wallet_portfolio	通过 x402 支付 0.0045 USDC	查询 Base 钱包持有的所有代币——显示价格及美元总额；标记并排除垃圾代币
token_holders	通过 x402 支付 0.0027 USDC	查询 ERC-20 的主要持币者——合约／锁定／销毁标记、锁定的 LP、集中度
domain_intel	通过 x402 支付 0.0045 USDC	查询任意域名的注册商、注册时长和到期时间（RDAP）、DNS、SPF／DMARC 以及 TLS 证书
site_contacts	通过 x402 支付 0.0027 USDC	获取网站的社交媒体资料、角色邮箱（info@、sales@）和 tel: 电话——不会返回个人地址
crypto_news	通过 x402 支付 0.001 USDC	获取九家新闻编辑部的最新加密货币头条，可按关键词筛选
sec_filings	通过 x402 支付 0.0027 USDC	根据股票代码查询美国公司的最新 SEC 申报——10-K、10-Q、8-K 条目、Form 4，并附上 sec.gov 链接
prompt_injection_check	通过 x402 支付 0.0045 USDC	在 Agent 读取不可信文本前，扫描其中的提示词注入模式
token_screener	通过 x402 支付 0.009 USDC	获取 DexScreener 列表中的新代币和热门代币——价格、流动性、交易量、买入／卖出、上线时长
paper_search	通过 x402 支付 0.009 USDC	搜索 OpenAlex 的学术论文（备用来源为 Crossref）——作者、年份、DOI、引用数、摘要
satellite_scenes	通过 x402 支付 0.009 USDC	获取任意地点的最新 Sentinel-2 卫星图像——日期、云量、预览、完整图像
seo_audit	通过 x402 支付 0.009 USDC	对页面进行技术 SEO 审计——按严重程度分类的问题和 0-100 分
x402_top_services	通过 x402 支付 0.009 USDC	查看按卖家划分的 x402 市场——预估收入、付费调用次数、付费钱包数、价格
ens_resolve	通过 x402 支付 0.0027 USDC	ENS 名称和 Basenames ↔ 地址解析，并提供个人资料记录
timezone_convert	通过 x402 支付 0.001 USDC	将一个时间点转换为最多 20 个 IANA 时区的时间，并考虑夏令时
public_holidays	通过 x402 支付 0.001 USDC	查询某个国家的公共假日，以及指定日期是否为公共假日
weather_forecast	通过 x402 支付 0.0018 USDC	查询任意地点的天气预报（MET Norway）
wiki_summary	通过 x402 支付 0.0018 USDC	获取 21 种语言的 Wikipedia 条目摘要
hn_search	通过 x402 支付 0.0027 USDC	查看 Hacker News 首页或搜索内容
feed_read	通过 x402 支付 0.0022 USDC	将任意 RSS 或 Atom 源读取为 JSON 条目
package_intel	通过 x402 支付 0.0027 USDC	检查 npm／PyPI 包的安全性：OSV 漏洞、弃用状态、距上次发布的时间
company_financials	通过 x402 支付 0.0045 USDC	查询美国公司的已披露财务数据（SEC XBRL）
token_verdict	通过 x402 支付 0.009 USDC	你的 Agent 是否应该接触这个代币？对 7 条 EVM 链上的 ERC-20 或 Solana 铸造地址提供 0-100 安全评分、等级、判定和原因，并附上价格和流动性
strategy_backtest	通过 x402 支付 0.009 USDC	根据指定的交易规则（SMA 交叉、RSI 均值回归、DCA、买入并持有），使用加密资产的每日美元收盘价进行回测，并与买入并持有策略比较——收益率、回撤、Sharpe、胜率、每笔交易和权益曲线
search_services	免费	搜索 FiatDock MCP 服务市场——按每个已列出服务自身的工具名称匹配，而不仅是服务描述。默认返回 前 20 个 最匹配的条目（limit，最多 50）；truncated／total 会提示是否还有更多结果
get_service	免费	获取某个条目的完整详情 + 调用方式
call_service	按条目收费（通过 x402）	调用已列出的服务。付费调用通过 402 中列出的 x402 付款直接结算给卖家——当 FiatDock 佣金豁免时（目前所有卖家均如此），支付一笔全额款项；否则支付卖家份额加上 FiatDock 的 1% 佣金——非托管。可从 AGENT_PRIVATE_KEY 自动付款，或传入你自己签名的 payment——见下文
search_x402	免费	搜索公开 x402 索引——其中列出的所有按次付费端点（来自数百个主机，约 15,000 个），先按相关性排序，再按 30 天付费调用次数排序。每行包含：URL、索引价格、网络、端点自己的 payTo、30 天调用次数／付款方数量
call_x402	按端点收费（付给该端点）	直接从 AGENT_PRIVATE_KEY 向端点的 payTo 支付任意索引中列出的 x402 端点——FiatDock 不收取费用，也不会经手款项。需要提供 maxPriceUsd（或 FIATDOCK_MAX_PRICE_USD）：第三方 402 是唯一的价格声明，因此未设置上限时不会签名，并会返回价格。也可以传入你自己签名的 payment

• 远程端点（无需安装）： https://fiatdock.com/mcp — Streamable HTTP，无状态，已启用 CORS。它不持有任何密钥，因此付费工具会返回 x402 402 挑战——你也可以在此处自行签名完成购买（见下文）。

使用自己的钱包购买

AGENT_PRIVATE_KEY 是最简单的方式，但只能在安装时选择一个钱包。如果你的 Agent 有自己的签名器——Coinbase AgentKit、钱包 MCP 服务，或其他任何签名器——可通过任一传输方式分两次调用完成购买：

1. call_service({id, args})            -> 402: { paymentRequired, howToPay }
2. sign every entry in paymentRequired.accepts, base64 the x402 payload
3. call_service({id, args, payment})   -> the seller's response

第二次调用时发送相同的 id 和 args——402 中引用的请求就是实际付款的请求。调用方提供的 payment 优先于 AGENT_PRIVATE_KEY（并会跳过 FIATDOCK_MAX_PRICE_USD；该变量用于限制自动支出，而不是限制你自己的支出）。402 不会扣款——它只是价格，不是账单，因此重试始终安全。

• 官方 MCP Registry： com.fiatdock/fiatdock-mcp
• 没有 MCP？ GET https://fiatdock.com/tools.json — 提供与 OpenAI/Gemini 函数调用架构相同的工具，并映射到纯 REST API。
• 各客户端的配置（Claude Desktop/Code、Cursor、VS Code、Windsurf、Gemini CLI、OpenAI Agents SDK、LangChain、CrewAI）：docs/INTEGRATIONS.md · 可运行示例：docs/examples/

合规要求（具有约束力）： 用户必须年满 18 岁，且位于葡萄牙或受支持的欧盟/欧洲经济区国家/地区（英国及受限制国家/地区不可用）。账户归属规则： 发送加密货币的钱包和接收法币的银行账户必须属于同一人，即 Agent 的所有者。不得使用第三方资金、汇集资金或进行个人对个人转账。加密货币价格波动较大；报价仅供参考；本文内容不构成投资建议。条款 · 隐私 · 风险警告

环境变量

变量	必需	用途
FIATDOCK_URL	否（默认 https://fiatdock.com）	FiatDock API 基础 URL
FIATDOCK_TOOLS	否（默认 all）	仅安装所需的工具组，避免其余工具占用 Agent 的上下文。见下文。
AGENT_PRIVATE_KEY	仅付费工具需要	用于自动支付 x402 费用的 Agent 钱包密钥——费用为 $0.001–$0.009，具体取决于工具（ramp 会话为 $0.01），另加 marketplace 卖家对 call_service 收取的费用。未设置此项时，六个免费工具仍可使用，付费工具则会返回 402 挑战，而不会直接购买。请使用余额较低的专用钱包，切勿使用主密钥。
FIATDOCK_MAX_PRICE_USD	否（默认：无上限）	call_service 的价格诱导防护：如果付费网关调用的 x402 总费用超过此美元金额，则拒绝付款。可通过每次调用的 maxPriceUsd 参数覆盖。
FIATDOCK_BUDGET_USD	否（默认：无预算上限）	整个进程的支出上限。 本服务可自动支付的总金额，涵盖所有付费数据工具、ramp 会话、call_service 和 call_x402。如果某笔付款会导致总支出超过上限，则在签名之前拒绝付款：工具会返回包含 budgetUsd、spentUsd、remainingUsd 和 priceUsd 的错误。金额在付款签名时计入，而非结算时计入，因为签名后的授权即使在调用失败时，也可在过期前完成结算。服务重启后额度重置；如需允许更多支出，请提高上限并重启。非 ≥ 0 数值的值会按 0 处理（不支付任何费用），并输出到 stderr。你自行签名的 payment 不会计入，也不会受到限制。

任意 x402 端点 — search_x402 / call_x402

同一个钱包也能购买 FiatDock 目录以外的服务。search_x402 会搜索公开的 x402 索引（约 15,000 个定价端点，按近 30 天的付费调用量排名）；call_x402 会读取端点自身的 402 响应，检查价格是否不超过 maxPriceUsd，为这项要求签名，并直接向端点的 payTo 付款——无需中继、网关，也无需支付 FiatDock 费用。这里必须设置价格上限（不同于 call_service，其网关会为经过 FiatDock 审核的服务定价）：第三方 402 响应是唯一的价格说明，因此如果未设置 maxPriceUsd，也未设置 FIATDOCK_MAX_PRICE_USD，工具不会签名，而是返回价格，供你下次调用时使用。

search_x402({q: "web search", maxPriceUsd: 0.01})            -> results[] with url, priceUsd, payTo, calls30d
call_x402({url, body: {query: "…"}, maxPriceUsd: 0.01})      -> { ok, status, paid, settlement, result }

选择你的工具 — FIATDOCK_TOOLS

默认安装全部 49 个工具。工具列表是模型读取的第一项内容，因此如果你只需要其中一项，就只选择那一项：

分组	工具	用途
ramp	4	报价、USDC↔银行转账会话、订单状态
data	24	代币价格/安全性/报告/持有者、Gas、余额、钱包投资组合、交易状态、地址情报、永续合约 + 资金费率、预测市场、DeFi 收益、外汇、加密新闻、SEC 文件、域名情报、网站联系信息、网页读取、电子邮件检查、提示词注入检查
marketplace	5	查找、查看并支付其他 Agent 的 MCP 服务——以及搜索并支付公开 x402 索引中的任意端点

FIATDOCK_TOOLS=ramp                # just the cash-out surface (4 tools)
FIATDOCK_TOOLS=ramp,marketplace    # cash out + buy from other agents (9 tools)
# unset, or "all"                  # everything (49 tools)

未识别的值会启用全部工具，而不是不启用任何工具——拼写错误不应导致服务端没有可用工具。关闭 marketplace 也会撤下 fiatdock://catalog 资源，因此与市场相关的内容不会进入你的上下文。

资源

fiatdock://fees · fiatdock://coverage · fiatdock://catalog — 实时市场目录（名称、每次调用的价格、类别、工具数量和工具名称示例），让你的 Agent 无需花费一次工具调用来查询，就能了解有哪些服务可供购买。

Claude Desktop / Cursor / Windsurf / Gemini CLI

这四种工具使用相同的 mcpServers 格式（文件：claude_desktop_config.json、~/.cursor/mcp.json、~/.codeium/windsurf/mcp_config.json、~/.gemini/settings.json）：

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

Claude Code

claude mcp add fiatdock -e AGENT_PRIVATE_KEY=0x... -- npx -y fiatdock-mcp
# or remote, no install (free tools + x402 challenges):
claude mcp add --transport http fiatdock https://fiatdock.com/mcp

VS Code（Copilot Agent 模式）

.vscode/mcp.json：

{
  "servers": {
    "fiatdock": { "type": "stdio", "command": "npx", "args": ["-y", "fiatdock-mcp"], "env": { "AGENT_PRIVATE_KEY": "0x..." } }
  }
}

OpenAI Agents SDK / LangChain / CrewAI

这三者都原生支持 MCP 服务——将它们指向 npx -y fiatdock-mcp（stdio）或 https://fiatdock.com/mcp（Streamable HTTP）：

# OpenAI Agents SDK
from agents.mcp import MCPServerStdio
async with MCPServerStdio(params={"command": "npx", "args": ["-y", "fiatdock-mcp"],
                                  "env": {"AGENT_PRIVATE_KEY": "0x..."}}) as fiatdock: ...

# LangChain (langchain-mcp-adapters)
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({"fiatdock": {"transport": "streamable_http", "url": "https://fiatdock.com/mcp"}})

# CrewAI (crewai-tools)
from crewai_tools import MCPServerAdapter
tools = MCPServerAdapter({"url": "https://fiatdock.com/mcp", "transport": "streamable-http"})

典型的出金流程

1. get_quote（免费）——Agent 查看汇率和完整费用明细。
2. create_offramp_session ——通过 x402 自动支付 0.01 美元的 USDC，获取 checkoutUrl + partnerOrderId。
3. Agent 将 checkoutUrl 转发给其人类所有者（有效期约 2 小时）。所有者向服务提供商提供电话号码和电子邮件；仅当滚动 30 天内的金额超过约 999 瑞士法郎时，才需要身份文件——无需账户或密码。
4. get_order_status（或已签名的回调）确认订单状态为 COMPLETED。

安全

发现漏洞？请通过 [email protected] 私下报告——参见 SECURITY.md。请勿公开发布安全问题。

许可证

MIT