API

MCP 服务器

把 Iris 的工具交给 AI 智能体：它会自行分析钱包、深入查看其关联、追踪转账、找出代币的内部钱包，使用你的 API 密钥，或通过 x402 按次付费。

这是什么

Model Context Protocol 让 AI 智能体（Claude、Cursor、Copilot、ChatGPT）可以调用外部工具。Iris 的 MCP 服务器把它的引擎交给它们：问一句“这次黑客攻击的资金去哪儿了？”，智能体就会分析钱包、打开被标记的关联、穿过混币器追踪存入，并写出它的发现，每个结论都附有交易。


接口地址	`https://iriscan.app/mcp`
传输方式	Streamable HTTP，无状态 JSON。协议版本 2025-06-18（也接受 2025-03-26 和 2024-11-05）。
认证	你的 API 密钥，与REST API相同。列出工具无需密钥。不带密钥时，付费工具通过x402 按次付费。

工具

工具	作用	费用
`analyze_address`	Iris 支持的任意链上的钱包，或 Solana 代币或程序，为智能体做的摘要：身份、风险、行为、被标记的交易对手、主要资金流。`address`、`chain`?（从地址识别；0x 地址为某条 EVM 链，默认 Ethereum）、`depth`? 1 到 10,000（默认 1,000）。首次分析的代币可能需要约一分钟。	1 次分析，超过 1,000 笔交易为 2 次
`get_connections`	过去一小时内通过 MCP 分析过的地址的交易对手：`filter`? all、flagged、exchange 或 mixer，`limit`? 1 到 50（默认 12），使用 x402 付费时还需 `receipt`?。包含兑换场所；会说明读取了哪些交易。	免费
`trace_transfer`	一笔经过混币器、交易所或即时兑换的转账从哪里出来：`wallet`、`signature`、`chain`?（Solana、某条 EVM 链、Bitcoin 或 Tron），交易向多方付款时还需 `counterparty`? 和 `direction`?，`hops`? 设为 2 时按经两家交易所的私密兑换（Houdini 式）追踪（收款地址 Iris 不认识也可以）。转入交易所充值地址的存款会得到一个结论，涵盖其可能立刻转出的每种方式（数分钟内经同一家交易所、经两家交易所、按已知地址经 Husher），或“最可能只是普通存款”。是线索，不是证据。	1 次追踪（积分包为 3 积分）
`find_token_insiders`	与 Solana 代币创建者有资金关联的钱包：`mint`、`limit`? 1 到 100（默认 50）。最多约需两分钟。	2 次分析，或 2 积分
`scan_launch_tool`	Solana 钱包是否使用发射工具包（Proxima、BlockX）发币或交易，附证据、手续费钱包、创建者手续费领取和为它注资的钱包树：`wallet`（传入代币铸造地址时扫描其创建者），`mint`? 可限定到一个代币。最多约需两分钟。	免费
`get_credits`	你的套餐和剩余额度。	免费

结果是纯文本，写给模型阅读，时间为 ISO 8601 UTC。失败的调用会退款，包括因客户端断开而中断的调用。一个账户最多同时运行三个调用，每个请求最多一个付费调用；使用密钥的调用计入其调用限额，超出后工具会返回错误码为 quota_exceeded 的错误。工具支持的链与 /analyze 和 /trace 相同：Solana、EVM 链、Bitcoin、Tron、dYdX 和 Noble（追踪支持 Solana、EVM 链、Bitcoin 和 Tron）。金额以该链原生币计，稳定币以美元计，交易链接到该链的浏览器。

x402：按次付费

没有 Iris 账户的智能体可以按照 x402 的 MCP 传输规范，在 Solana 上（或提供时在 Base 上）用 USDC 为每次调用付费。不带密钥连接：付费工具会返回一个付款请求，即一个 isError 结果，其 structuredContent（以及文本）是 x402 的 PaymentRequired，对应 mcp://tool/analyze_address 等。@x402/mcp 等 x402 客户端会签署付款，并在 _meta["x402/payment"] 中带上付款再次调用该工具；响应会在 _meta["x402/payment-response"] 中带上已结算的交易。

价格与 REST API 相同：analyze_address $0.05（超过 1,000 笔交易为 $0.10）、trace_transfer $0.25、find_token_insiders $0.10、scan_launch_tool $0.02。失败的调用永远不会结算。get_credits 会列出价格，get_connections 仍然免费：把付费 analyze_address 返回的 receipt 传给它即可。

连接客户端

在账户 → API中创建密钥，然后把 Iris 添加到你的客户端，用你的密钥替换 iris_live_YOUR_KEY。

Claude Code

terminal

1claude mcp add --transport http iris https://iriscan.app/mcp \2  --header "Authorization: Bearer iris_live_YOUR_KEY"

加上 --scope user 可在所有项目中使用。/mcp 会显示它已连接及其工具。

Cursor

~/.cursor/mcp.json

1{2  "mcpServers": {3    "iris": {4      "url": "https://iriscan.app/mcp",5      "headers": { "Authorization": "Bearer iris_live_YOUR_KEY" }6    }7  }8}

VS Code

.vscode/mcp.json

1{2  "servers": {3    "iris": {4      "type": "http",5      "url": "https://iriscan.app/mcp",6      "headers": { "Authorization": "Bearer iris_live_YOUR_KEY" }7    }8  }9}

Claude Desktop

claude_desktop_config.json

1{2  "mcpServers": {3    "iris": {4      "command": "npx",5      "args": ["-y", "mcp-remote", "https://iriscan.app/mcp", "--header", "Authorization: Bearer iris_live_YOUR_KEY"]6    }7  }8}

通过 Settings → Developer → Edit Config 打开该文件；mcp-remote 需要 Node.js。保存后重启 Claude Desktop。

claude.ai、ChatGPT 和其他只支持 URL 的客户端

connector URL

1https://iriscan.app/mcp/iris_live_YOUR_KEY

将其添加为自定义连接器：claude.ai 中在 Settings → Connectors 下，ChatGPT 中在开发者模式下。

更简单、URL 中也不含密钥的方式：ChatGPT 和 Claude 可以直接用 https://iriscan.app/mcp 登录 Iris。见 ChatGPT 和 Claude。

URL 中的密钥就是密码

任何看到这个 URL 的人都能消耗你的额度。请专门为这个连接器创建一个单独的密钥，以便单独撤销；只要客户端支持，就改用请求头方式。

可以问什么

“分析 6mmiAP…。它最大的受害者是谁？它把钱转到了哪里？”
“这个钱包昨天往 Privacy Cash 存了钱：追踪它从哪里出来。”
“在我买这个代币之前：它的内部钱包是谁，他们还持有吗？”