概览
- 地址
https://btc.com/api/mcp- 传输
- Streamable HTTP
- 鉴权
- 不需要
- 读写
- 只读
| 项目 | 内容 |
|---|---|
| 协议 | MCP，规范版本 2025-11-25 |
| 传输 | Streamable HTTP。不保存会话，每个请求直接返回 JSON；不开推送流 |
| 服务器 | btc-museum 1.0.0 |
| 连接说明 | 连接时下发一段说明：五个展厅的名称和编号、先 search 再 fetch、引用要求、不提供行情和投资建议 |
工具
只有 search 和 fetch 两个工具。名称和返回格式按 OpenAI 对 ChatGPT 深度研究的要求定，其他客户端也通用。两个都标了只读（readOnlyHint），参数和返回结构按 JSON Schema 2020-12 声明。
search只读
按关键词或短问题查找，中文、英文都可以，最多返回 10 条。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
query | string | 必填。关键词或短问题，1–200 字 |
locale | "zh" | "en" | 可选。标题、摘要和链接用的语言：zh 或 en。不传时按问题的语言：含汉字用中文，否则用英文；缺英文的字段回落成中文 |
limit | integer | 可选。返回几条，1–10，默认 10 |
返回
| 字段 | 说明 |
|---|---|
results[].id | 编号，交给 fetch 读全文 |
results[].title | 标题 |
results[].url | 本馆页面地址，带锚点，直接落到那一条 |
results[].text | 截短的摘要，不带来源；引用前先用 fetch 读全文 |
hint | 只在没有结果，或问到实时价格、价格预测、投资建议时出现。没有结果就是馆里没有，不要拿不相关的条目当答案 |
fetch只读
按 search 给的编号读全文。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
id | string | 必填。search 返回的编号，比如 narrative:events-pizza-day |
locale | "zh" | "en" | 可选。标题、全文和链接用的语言：zh 或 en（默认 en）；缺英文的字段逐个回落成中文 |
返回
| 字段 | 说明 |
|---|---|
id · title | 编号和标题 |
text | Markdown 全文 |
url | 本馆页面地址 |
metadata.type · hall · locale · updatedAt | 类型、所属展厅、语言、更新时间 |
metadata.sources[] | 本馆标注的来源，每条有标题和链接 |
metadata.images[] | 可以在站外展示的图片（免授权或本馆自制），带替代文字、署名和许可；其余图片只在本馆页面上展示 |
metadata.license · contributors | 现在留空 |
编号不存在或内容已下线时，返回 isError 和一句说明。
调用示例
不需要先握手，直接发 JSON-RPC 请求就行。Accept 要同时带 application/json 和 text/event-stream：
curl -s https://btc.com/api/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"比特币披萨日","locale":"zh"}}}'编号与链接
编号一律是「类型:slug」。slug 全馆固定、各环境一致，公开后不改。
| 类型 | 内容 | 链接落到 |
|---|---|---|
hall | 展厅 | 展厅页；fetch 另外列出厅里各条展项的编号 |
narrative | 叙事展项 | 展厅页上的那一条 |
exhibit | 展品 | 展示它的那条展项；没有展项卡片的展品指向所属展厅页 |
library | 文献 | 文献馆里的那一条 |
term | 词条 | 术语百科里的那一条 |
faq | 常见问题 | 常见问题页上的那一条，打开时自动展开 |
post | 博客文章 | 文章页 |
whitepaper | 白皮书各节 | 创世之源厅「白皮书章节导读」里的那一节 |
引用要求
- 引用本馆内容时，附上返回的页面链接（url）。
- 图片只用 fetch 返回的 images；其他图片因为授权只在本馆页面上展示。
- 这个接口不提供实时价格、价格预测和投资建议。
- 有争议的问题，本馆会并列各方说法、附上来源。转述时请保留这些不同说法。
限制与错误
| 情况 | 返回 |
|---|---|
| 同一个 IP 每分钟超过 120 次 | 429 |
| 同一个客户端（按 User-Agent 区分）每分钟超过 600 次 | 429 |
| 全站每分钟超过 3000 次 | 429 |
| 请求体超过 64 KB | 413 |
| 浏览器里发出的请求，来源（Origin）不在允许名单里 | 403 |
| 用 GET 或 DELETE 请求（只接受 POST，没有推送流） | 405 |
| Accept 没有同时带 application/json 和 text/event-stream | 406 |
AI 平台的请求从它们自己的服务器发出，同一个 IP 背后可能是很多用户，所以按 IP 的额度放得比较宽。请不要批量抓取。
版本与变更
当前版本 1.0.0。工具名、参数和返回格式公开后不随便改，有改动会写在这里。
1.0.0（2026-09-30）：search、fetch 两个工具。