MCP Server

透過 Nebula 查詢涵蓋股票、大宗商品、指數、加密貨幣與 AI 的全球市場情報。

開始使用

快速入門將 Streamable HTTP 用戶端連線至 Nebula MCP 伺服器。 驗證使用 OAuth 連結你的 Nebula 帳戶，或直接使用 API 金鑰。 Claude Code用一個設定指令將 Nebula 加入 Claude Code。 產生的工具瀏覽由公開 API 合約產生的工具。

快速入門

將任何支援 Streamable HTTP 的 MCP 用戶端連線至：

https://nebula-api.hiddensystems.ai/mcp

工具、說明、預設值、選擇器限制與結構描述皆由公開的 OpenAPI 合約產生。使用 list_assets 尋找任何股票、大宗商品、指數或加密貨幣資產，再將其 asset_id 與 asset_class 傳遞給下游工具。

驗證

端點https://nebula-api.hiddensystems.ai/mcp
外掛程式OAuth 2.1 授權碼搭配 PKCE
直接用戶端X-API-Key: YOUR_API_KEY 或 API 金鑰作為 Authorization: Bearer
傳輸可串流 HTTP

OAuth 用戶端會自動從端點探索授權資訊。呼叫會使用所連結 Nebula 帳戶的方案、點數與速率限制。

x402 付款

你也可以透過獨立的 x402 HTTP API，以 Base 上的 USDC 支付符合資格的 API 讀取費用，無需 Nebula 帳戶或 API 金鑰。每筆付款都由你的錢包授權。MCP 與 CLI 連線仍使用帳戶驗證與額度；它們不會自動進行錢包付款。請參閱 x402 付款指南。

連結 Claude Code

claude mcp add nebula \
  --transport http \
  https://nebula-api.hiddensystems.ai/mcp

新增伺服器後開啟 /mcp，並完成 Nebula 登入流程。

其他 MCP 用戶端

支援 OAuth 的用戶端可使用 Streamable HTTP URL，無需儲存 API 金鑰。舊版用戶端則可提供 API 金鑰標頭。

URL: https://nebula-api.hiddensystems.ai/mcp
Optional legacy header: X-API-Key: YOUR_API_KEY

端點總覽

每次 MCP 工具呼叫都採用與 REST API、MCP、CLI 及 Nebula Agent 相同的作業層級計價與共用帳戶餘額。

  • 固定成本的作業每次要求會扣除表列數量的點數。
  • 參數不會改變作業的費用，除非該作業的資料列另有註明價格：以 refresh=true 重新執行心智佔有率或情緒預測時，費用為 10 點而非 5 點。情緒一律為 1 點，無論是否使用叢集篩選條件。
  • 資料列也可能為較簡略的答案標明較低的價格：資產不可能有的預測（not_forecastable）免費，每個帳戶每小時最多可有 30 個這類答案；超過之後，端點會傳回 429，直到該小時結束。以錯誤收尾的要求不收費。
  • Agent 要求採用變動定價，依據權杖量、模型成本與工具呼叫次數計算。完成的回應會回報所使用的點數。
  • 每個方案都能使用所有作業。方案的差異在於歷史資料範圍（Free：90 天；Pro：各端點的上限，多數時間序列為一年）、速率限制（Free：每分鐘 60 次請求；Pro：300 次），以及每月包含的額度；購買額度可延長使用量，但不會改變歷史資料範圍或速率限制。

探索

工具點數說明
screener 2 選股器
get_top_momentum 2 熱門動能
get_top_trending 2 熱門趨勢

查詢

工具點數說明
list_assets 1 文字轉資產 ID
search 1 搜尋
list_subjects 1 文字轉主體 ID

社群與情緒

工具點數說明
get_emotions 1 情緒分布
get_mindshare 2 心智占有率
get_related_subjects 2 相關主體
get_sentiment 1 情緒
get_sentiment_timeframes 1 各時間範圍的情緒
get_social_momentum 2 社群動能

預測

工具點數說明
list_forecast_assets 1 可預測資產
get_mindshare_forecast 5（refresh=true 時為 10；若為 not_forecastable 則免費，每小時 30） 關注度預測
get_sentiment_forecast 5（refresh=true 時為 10；若為 not_forecastable 則免費，每小時 30） 情緒預測

市場情緒

工具點數說明
get_calls 2 多空喊單
get_call_returns 2 喊單結果分布
get_conviction_index 2 信念指數
get_fear_greed_index 1 恐懼與貪婪指數
get_price_levels 2 社群提及的價位
get_social_volume_index 2 社群量與交易量
get_social_volume_profile 2 社群成交量分布

市場資料

工具點數說明
get_price_history 1 價格歷史

情報

工具點數說明
list_calendar_events 5 行事曆事件
list_insights 5 情報
get_insight_attention 5 洞察關注度

叢集

工具點數說明
list_clusters 2 作者叢集
compare_clusters 2 叢集比較
get_divisive_assets 2 具爭議性資產
compare_hype_cycles 2 熱潮週期到來
compare_cluster_traits 2 叢集特徵比較
get_cluster_hype_cycles 2 叢集熱潮週期
get_cluster_overlap 2 叢集重疊
get_cluster_profile 2 叢集概況
get_cluster_rotation 2 叢集輪動
get_cluster_stances 2 叢集立場

帳戶

工具點數說明
get_account 0 帳戶

產生的工具

每個支援 MCP 的 OpenAPI 資料作業都會成為一項工具。Nebula Agent 的聊天完成作業刻意排除在外，因為推理由主機模型提供。

compare_cluster_traits叢集特徵比較
compare_clusters叢集比較
compare_hype_cycles熱潮週期到來
get_account帳戶
get_call_returns喊單結果分布
get_calls多空喊單
get_cluster_hype_cycles叢集熱潮週期
get_cluster_overlap叢集重疊
get_cluster_profile叢集概況
get_cluster_rotation叢集輪動
get_cluster_stances叢集立場
get_conviction_index信念指數
get_divisive_assets具爭議性資產
get_emotions情緒分布
get_fear_greed_index恐懼與貪婪指數
get_insight_attention洞察關注度
get_mindshare心智占有率
get_mindshare_forecast關注度預測
get_price_history價格歷史
get_price_levels社群提及的價位
get_related_subjects相關主體
get_sentiment情緒
get_sentiment_forecast情緒預測
get_sentiment_timeframes各時間範圍的情緒
get_social_momentum社群動能
get_social_volume_index社群量與交易量
get_social_volume_profile社群成交量分布
get_top_momentum熱門動能
get_top_trending熱門趨勢
list_assets文字轉資產 ID
list_calendar_events行事曆事件
list_clusters作者叢集
list_forecast_assets可預測資產
list_insights情報
list_subjects文字轉主體 ID
screener選股器
search搜尋

疑難排解

  • 401：缺少登入資訊或登入已過期，或 API 金鑰無效或已撤銷。
  • 402：此週期內帳戶的點數已用盡。
  • 403：請求超出方案可存取的歷史區間。
  • 429：金鑰已達到每分鐘速率上限；請等待 Retry-After 指定的時間後再試。
  • 503：相依服務暫時無法使用；請重試呼叫。
  • 若工具未出現，請在儲存 MCP 設定後重新啟動用戶端。