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

工具、描述、默认值、选择器约束和 schema 均根据公开 OpenAPI 契约生成。使用 list_assets 查找任何股票、大宗商品、指数或加密资产，然后将其 asset_id 和 asset_class 传递给下游工具。

身份验证

端点https://nebula-api.hiddensystems.ai/mcp
插件带 PKCE 的 OAuth 2.1 授权码
直接客户端X-API-Key: YOUR_API_KEY 或 API 密钥作为 Authorization: Bearer
传输Streamable 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 重新运行 mindshare 或情绪预测时，费用为 10 个额度而非 5 个。情绪始终花费 1 个额度，无论是否使用集群筛选。
  • 某一行也可能为较次的结果标注更低的价格：资产无法生成的预测（not_forecastable）免费，每个账户每小时最多 30 次此类回答；超出后，该端点会返回 429，直到该小时结束。以错误结束的请求不产生任何费用。
  • Agent 请求采用基于 token 用量、模型成本和工具调用的可变定价。完成的响应会报告所使用的额度数。
  • 所有操作在所有套餐中均可用。套餐的差异在于历史窗口（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 配置后重启客户端。