概覽
- 地址
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 兩個工具。