Server MCP
Interroga l'intelligence sui mercati globali in azioni, materie prime, indici, cripto e AI tramite Nebula.
Avvio rapido
Collega qualsiasi client MCP Streamable HTTP a:
https://nebula-api.hiddensystems.ai/mcp
Strumenti, descrizioni, valori predefiniti, vincoli dei selettori e schemi sono generati dal contratto OpenAPI pubblico. Usa list_assets per trovare qualsiasi azione, materia prima, indice o asset cripto, poi passa il suo asset_id e asset_class agli strumenti a valle.
Autenticazione
| Endpoint | https://nebula-api.hiddensystems.ai/mcp |
|---|
| Plugin | Authorization code OAuth 2.1 con PKCE |
|---|
| Client diretti | X-API-Key: YOUR_API_KEY oppure un'API key come Authorization: Bearer |
|---|
| Trasporto | HTTP streamable |
|---|
I client OAuth scoprono automaticamente l'autorizzazione dall'endpoint. Le chiamate usano il piano, i crediti e i limiti di frequenza dell'account Nebula collegato.
Pagamenti x402
Puoi anche pagare le letture API idonee con USDC su Base tramite l'API HTTP x402 separata, senza un account Nebula o una chiave API. Il tuo wallet autorizza ogni pagamento. Le connessioni MCP e CLI continuano a usare l'autenticazione dell'account e i crediti; non effettuano automaticamente pagamenti dal wallet. Consulta la guida ai pagamenti x402.
Collega Claude Code
claude mcp add nebula \
--transport http \
https://nebula-api.hiddensystems.ai/mcp
Apri /mcp dopo aver aggiunto il server e completa il flusso di accesso a Nebula.
Altri client MCP
I client compatibili con OAuth possono usare l'URL Streamable HTTP senza un'API key memorizzata. I client legacy possono fornire un header con l'API key.
URL: https://nebula-api.hiddensystems.ai/mcp
Optional legacy header: X-API-Key: YOUR_API_KEY
Panoramica degli endpoint
Ogni chiamata a uno strumento MCP usa la stessa tariffazione a livello di operazione e lo stesso saldo account condiviso di REST API, MCP, CLI e Nebula Agent.
- Le operazioni a costo fisso consumano il numero di crediti indicato per richiesta.
- I parametri non modificano il costo di un'operazione, tranne dove la relativa riga indica un prezzo specifico: una previsione di mindshare o sentiment rieseguita con refresh=true costa 10 crediti invece di 5. Il sentiment costa sempre 1 credito, con o senza filtri di cluster.
- Una riga può anche indicare un prezzo inferiore per una risposta di livello inferiore: una previsione che l'asset non può avere (not_forecastable) è gratuita, fino a 30 risposte di questo tipo per account all'ora; oltre tale soglia l'endpoint risponde 429 finché l'ora non si azzera. Una richiesta che termina con un errore non costa nulla.
- Le richieste dell'Agent usano prezzi variabili in base al volume di token, al costo del modello e alle chiamate agli strumenti. La risposta completata riporta i crediti utilizzati.
- Ogni operazione è disponibile in tutti i piani. I piani si differenziano per finestra storica (Free: 90 giorni; Pro: il massimo di ogni endpoint, un anno per la maggior parte delle serie temporali), limite di frequenza (Free: 60 richieste al minuto; Pro: 300) e crediti mensili inclusi; l'acquisto di crediti estende l'utilizzo ma non modifica la finestra storica né i limiti di frequenza.
Discovery
| Strumento | Crediti | Descrizione |
|---|
screener |
2 |
Screener |
get_top_momentum |
2 |
Top momentum |
get_top_trending |
2 |
Top trending |
Lookup
| Strumento | Crediti | Descrizione |
|---|
list_assets |
1 |
Da testo ad asset ID |
search |
1 |
Ricerca |
list_subjects |
1 |
Da testo a subject ID |
Social & Sentiment
| Strumento | Crediti | Descrizione |
|---|
get_emotions |
1 |
Distribuzione delle emozioni |
get_mindshare |
2 |
Mindshare |
get_related_subjects |
2 |
Soggetti correlati |
get_sentiment |
1 |
Sentiment |
get_sentiment_timeframes |
1 |
Sentiment per intervallo temporale |
get_social_momentum |
2 |
Momentum social |
Previsioni
| Strumento | Crediti | Descrizione |
|---|
list_forecast_assets |
1 |
Asset prevedibili |
get_mindshare_forecast |
5 (10 con refresh=true; gratuito se not_forecastable, 30 all'ora) |
Previsione di mindshare |
get_sentiment_forecast |
5 (10 con refresh=true; gratuito se not_forecastable, 30 all'ora) |
Previsione del sentiment |
Sentiment di mercato
| Strumento | Crediti | Descrizione |
|---|
get_calls |
2 |
Chiamate long/short |
get_call_returns |
2 |
Distribuzione degli esiti delle chiamate |
get_conviction_index |
2 |
Indice di convinzione |
get_fear_greed_index |
1 |
Indice Fear and Greed |
get_price_levels |
2 |
Livelli di prezzo menzionati sui social |
get_social_volume_index |
2 |
Volume social vs volume di trading |
get_social_volume_profile |
2 |
Profilo del volume social |
Market Data
| Strumento | Crediti | Descrizione |
|---|
get_price_history |
1 |
Storico dei prezzi |
Intelligence
| Strumento | Crediti | Descrizione |
|---|
list_calendar_events |
5 |
Eventi del calendario |
list_insights |
5 |
Intelligence |
get_insight_attention |
5 |
Attenzione degli insight |
Cluster
| Strumento | Crediti | Descrizione |
|---|
list_clusters |
2 |
Cluster di autori |
compare_clusters |
2 |
Confronto tra cluster |
get_divisive_assets |
2 |
Asset divisivi |
compare_hype_cycles |
2 |
Arrivi del ciclo di hype |
compare_cluster_traits |
2 |
Confronto dei tratti dei cluster |
get_cluster_hype_cycles |
2 |
Cicli di hype dei cluster |
get_cluster_overlap |
2 |
Sovrapposizione dei cluster |
get_cluster_profile |
2 |
Profilo del cluster |
get_cluster_rotation |
2 |
Rotazione dei cluster |
get_cluster_stances |
2 |
Posizioni dei cluster |
Account
| Strumento | Crediti | Descrizione |
|---|
get_account |
0 |
Account |
Risoluzione dei problemi
- 401: l'accesso è assente o scaduto, oppure l'API key non è valida o è stata revocata.
- 402: i crediti dell'account sono esauriti per questo ciclo.
- 403: la richiesta supera la finestra storica del piano.
- 429: la chiave ha raggiunto il limite di richieste al minuto; attendi l'intervallo indicato da Retry-After.
- 503: una dipendenza è stata temporaneamente non disponibile; riprova la chiamata.
- Se gli strumenti non compaiono, riavvia il client dopo aver salvato la sua configurazione MCP.