莫信解读｜UniSat MCP 正式版上线 npm：一段配置，AI Agent 就能查比特币链上数据
今天 11:49，UniSat（@unisat_wallet）把 MCP server @unisat/openapi-mcp 发到了 npm，第一个正式版本直接是 1.0.0。前一分钟，命令行工具 @unisat/openapi-cli 也从 8 月的 0.1.0 升到 1.0.0。截至 12:30，UniSat 官推还没发公告。
下面讲讲它能让 Agent 查什么、怎么接、哪些操作要你点头。
🐋 MCP 一分钟版
- MCP 是一套让 AI 助手调用外部工具的接口标准，Claude、Cursor、Codex 都支持。装上一个 MCP server，助手就多了一组能直接调用的工具
- UniSat 这个 server 跑在你自己电脑上，替 Agent 去调 UniSat Open API，比特币主网和 Fractal 主网都能查
- 查一个地址的铭文、一个 BRC-20 的持有人，原来要自己写代码调接口，接上以后直接用中文问 Agent
🐋 怎么接
在 Claude、Cursor 这类客户端的 MCP 配置里加一段：
{
"mcpServers": {
"unisat-ai-kit": {
"command": "npx",
"args": ["-y", "@unisat/openapi-mcp"],
"env": { "UNISAT_BITCOIN_API_KEY": "你的 key" }
}
}
}
- key 在 developer.unisat.io 申请。查 Fractal 要另申请一个，填进 UNISAT_FRACTAL_API_KEY
- 电脑上要有 Node.js，版本 22.23.4 以上（或 24、26 的新版）
- 官方给的第一个测试：让 Agent 查比特币最新区块高度，不需要地址，也不需要钱包
https://www.npmjs.com/package/@unisat/openapi-mcp
🐋 Agent 能查什么
server 只给 Agent 4 个工具：
1. list_operations：按关键词找接口，这一步不需要 key
2. get_operation：看这个接口要什么参数、是不是只读
3. call_api：真正去调接口
4. get_status：看服务和配置是否正常
Agent 自己先找、再看、最后调，不用另装 skill。它能找到的接口来自 UniSat 公开的接口文档（v2.1.0，10/23 更新），一共 308 个，分 18 类：
- 区块、交易、地址余额和 UTXO
- 铭文、BRC-20（持有人、铸造进度、历史记录）、符文、Alkanes
- BRC-20 swap，铭文合集、BRC-20、符文、Alkanes、域名几个市场的挂单和成交
- BTC、FB、CAT20 价格，Fractal 流通量和持币排行
比如问「这个地址有哪些 BRC-20」「某个符文前 20 大持有人是谁」，对应的接口都在里面。
🐋 哪些操作要你点头
- 308 个接口里 195 个只读，113 个会动东西：广播交易、铭刻下单、市场挂单和买入、swap 等
- 这 113 个，Agent 不带确认参数去调，会被直接退回「需要用户授权」。工具说明里写明，只有用户明确同意这一次操作后，Agent 才能带上确认参数
- 包里不碰私钥。挂单、买入这类接口返回的是待签名的交易，还要你在钱包里签名后再提交
- 只读查询也要 key，额度按 key 计算，call_api 也能查当前 key 还剩多少额度
🐋 这次发布之前
- 8/18：CLI 0.1.0 发到 npm
- 10/23：开发文档先加了「OpenAPI CLI & MCP」一页，写好了 npx 配置，当时 npm 上还搜不到这个包；同一天代码仓库推上一笔「准备 v0.1.5 发版」的提交
- 10/30 11:47 先发了一个测试版，11:48 CLI 1.0.0，11:49 MCP 1.0.0，跳过了 0.1.5
——
本文首发于 X @musinoot
今天 11:49，UniSat（@unisat_wallet）把 MCP server @unisat/openapi-mcp 发到了 npm，第一个正式版本直接是 1.0.0。前一分钟，命令行工具 @unisat/openapi-cli 也从 8 月的 0.1.0 升到 1.0.0。截至 12:30，UniSat 官推还没发公告。
下面讲讲它能让 Agent 查什么、怎么接、哪些操作要你点头。
🐋 MCP 一分钟版
- MCP 是一套让 AI 助手调用外部工具的接口标准，Claude、Cursor、Codex 都支持。装上一个 MCP server，助手就多了一组能直接调用的工具
- UniSat 这个 server 跑在你自己电脑上，替 Agent 去调 UniSat Open API，比特币主网和 Fractal 主网都能查
- 查一个地址的铭文、一个 BRC-20 的持有人，原来要自己写代码调接口，接上以后直接用中文问 Agent
🐋 怎么接
在 Claude、Cursor 这类客户端的 MCP 配置里加一段：
{
"mcpServers": {
"unisat-ai-kit": {
"command": "npx",
"args": ["-y", "@unisat/openapi-mcp"],
"env": { "UNISAT_BITCOIN_API_KEY": "你的 key" }
}
}
}
- key 在 developer.unisat.io 申请。查 Fractal 要另申请一个，填进 UNISAT_FRACTAL_API_KEY
- 电脑上要有 Node.js，版本 22.23.4 以上（或 24、26 的新版）
- 官方给的第一个测试：让 Agent 查比特币最新区块高度，不需要地址，也不需要钱包
https://www.npmjs.com/package/@unisat/openapi-mcp
🐋 Agent 能查什么
server 只给 Agent 4 个工具：
1. list_operations：按关键词找接口，这一步不需要 key
2. get_operation：看这个接口要什么参数、是不是只读
3. call_api：真正去调接口
4. get_status：看服务和配置是否正常
Agent 自己先找、再看、最后调，不用另装 skill。它能找到的接口来自 UniSat 公开的接口文档（v2.1.0，10/23 更新），一共 308 个，分 18 类：
- 区块、交易、地址余额和 UTXO
- 铭文、BRC-20（持有人、铸造进度、历史记录）、符文、Alkanes
- BRC-20 swap，铭文合集、BRC-20、符文、Alkanes、域名几个市场的挂单和成交
- BTC、FB、CAT20 价格，Fractal 流通量和持币排行
比如问「这个地址有哪些 BRC-20」「某个符文前 20 大持有人是谁」，对应的接口都在里面。
🐋 哪些操作要你点头
- 308 个接口里 195 个只读，113 个会动东西：广播交易、铭刻下单、市场挂单和买入、swap 等
- 这 113 个，Agent 不带确认参数去调，会被直接退回「需要用户授权」。工具说明里写明，只有用户明确同意这一次操作后，Agent 才能带上确认参数
- 包里不碰私钥。挂单、买入这类接口返回的是待签名的交易，还要你在钱包里签名后再提交
- 只读查询也要 key，额度按 key 计算，call_api 也能查当前 key 还剩多少额度
🐋 这次发布之前
- 8/18：CLI 0.1.0 发到 npm
- 10/23：开发文档先加了「OpenAPI CLI & MCP」一页，写好了 npx 配置，当时 npm 上还搜不到这个包；同一天代码仓库推上一笔「准备 v0.1.5 发版」的提交
- 10/30 11:47 先发了一个测试版，11:48 CLI 1.0.0，11:49 MCP 1.0.0，跳过了 0.1.5
——
本文首发于 X @musinoot
