MCPサーバー
Nebula を通じて、株式、コモディティ、指数、暗号資産、AI にわたるグローバル市場インテリジェンスをクエリできます。
クイックスタート
任意の Streamable HTTP MCP クライアントを次に接続します:
https://nebula-api.hiddensystems.ai/mcp
ツール、説明、デフォルト、セレクター制約、スキーマは公開 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 として |
|---|
| トランスポート | ストリーミング可能な HTTP |
|---|
OAuth クライアントはエンドポイントから認可を自動的に検出します。呼び出しには、接続された Nebula アカウントのプラン、クレジット、レート制限が使用されます。
x402 決済
Nebula アカウントや API キーがなくても、別途提供される x402 HTTP API を通じて、Base 上の USDC で対象となる API の読み取りに対して支払うこともできます。支払いはウォレットごとに承認します。MCP と CLI の接続は引き続きアカウント認証とクレジットを使用し、ウォレットによる支払いを自動的に行うことはありません。x402 支払いガイドを参照。
Claude Code を接続する
claude mcp add nebula \
--transport http \
https://nebula-api.hiddensystems.ai/mcp
サーバーを追加した後で /mcp を開き、Nebula のサインインフローを完了します。
その他の MCP クライアント
OAuth 対応クライアントは、API キーを保存せずに Streamable HTTP URL を使用できます。レガシークライアントは 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 で再実行すると、5 クレジットではなく 10 クレジットかかります。センチメントはクラスターフィルターの有無にかかわらず、常に 1 クレジットです。
- 行には、より少ない回答に対する低い価格が記載されることもあります。資産が取り得ない予測（not_forecastable）は無料で、1アカウントあたり1時間に最大30件までです。それを超えると、エンドポイントは時間が経過するまで429を返します。エラーで終了したリクエストには料金がかかりません。
- Agentリクエストは、トークン量、モデルコスト、ツール呼び出しに基づく変動価格を使用します。完了したレスポンスには使用されたクレジットが報告されます。
- すべてのオペレーションはすべてのプランで利用できます。プランの違いは、履歴ウィンドウ（Free: 90 日、Pro: 各エンドポイントの最大値で、ほとんどの時系列では 1 年）、レート制限（Free: 1 分あたり 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 の場合は無料、1時間あたり 30） |
マインドシェア予測 |
get_sentiment_forecast |
5（refresh=true の場合は 10、not_forecastable の場合は無料、1時間あたり 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 |
アカウント |
トラブルシューティング
- 401: サインインが欠落しているか期限切れ、または API キーが無効か失効しています。
- 402: このサイクルでアカウントのクレジットを使い切りました。
- 403: リクエストがプランの履歴ウィンドウの範囲を超えています。
- 429: キーが1分あたりのレート制限に達しました。Retry-After の間隔だけ待ってください。
- 503: 依存サービスが一時的に利用できませんでした。呼び出しを再試行してください。
- ツールが表示されない場合は、MCP 設定を保存した後にクライアントを再起動してください。