MCP Server
Nebula aracılığıyla hisse senetleri, emtialar, endeksler, kripto ve AI genelinde küresel piyasa istihbaratını sorgulayın.
Hızlı Başlangıç
Herhangi bir Streamable HTTP MCP istemcisini şuna bağlayın:
https://nebula-api.hiddensystems.ai/mcp
Araçlar, açıklamalar, varsayılanlar, seçici kısıtlamaları ve şemalar genel OpenAPI sözleşmesinden oluşturulur. Herhangi bir hisse senedi, emtia, endeks veya kripto varlığını bulmak için list_assets kullanın, ardından asset_id ve asset_class değerlerini alt araçlara aktarın.
Kimlik Doğrulama
| Uç nokta | https://nebula-api.hiddensystems.ai/mcp |
|---|
| Eklentiler | PKCE ile OAuth 2.1 yetkilendirme kodu |
|---|
| Doğrudan istemciler | X-API-Key: YOUR_API_KEY veya Authorization: Bearer olarak bir API anahtarı |
|---|
| Taşıma | Streamable HTTP |
|---|
OAuth istemcileri yetkilendirmeyi uç noktadan otomatik olarak keşfeder. Çağrılar, bağlı Nebula hesabının planını, kredilerini ve hız limitlerini kullanır.
x402 Ödemeleri
Uygun API okumaları için ayrıca, Nebula hesabı veya API anahtarı olmadan, ayrı x402 HTTP API'si üzerinden Base üzerinde USDC ile ödeme yapabilirsiniz. Her ödemeyi cüzdanınız yetkilendirir. MCP ve CLI bağlantıları hesap kimlik doğrulamasını ve kredileri kullanmaya devam eder; otomatik olarak cüzdan ödemesi yapmazlar. x402 ödeme kılavuzuna bakın.
Claude Code'u bağlayın
claude mcp add nebula \
--transport http \
https://nebula-api.hiddensystems.ai/mcp
Sunucuyu ekledikten sonra /mcp adresini açın ve Nebula oturum açma akışını tamamlayın.
Diğer MCP İstemcileri
OAuth destekli istemciler, kayıtlı bir API anahtarı olmadan Streamable HTTP URL'sini kullanabilir. Eski istemciler bir API anahtarı başlığı sağlayabilir.
URL: https://nebula-api.hiddensystems.ai/mcp
Optional legacy header: X-API-Key: YOUR_API_KEY
Uç Noktalara Genel Bakış
Her MCP araç çağrısı, REST API, MCP, CLI ve Nebula Agent ile aynı işlem düzeyindeki fiyatlandırmayı ve paylaşılan hesap bakiyesini kullanır.
- Sabit maliyetli işlemler, istek başına listelenen kredi sayısını harcar.
- Parametreler bir işlemin maliyetini değiştirmez; ancak satırında bir parametre için fiyat belirtilen durumlar hariçtir: refresh=true ile yeniden çalıştırılan bir mindshare veya sentiment tahmini 5 yerine 10 kredi tutar. Sentiment, küme filtreleri olsun ya da olmasın her zaman 1 kredi tutar.
- Bir satır, daha düşük bir yanıt için daha düşük bir fiyat da belirtebilir: varlığın sahip olamayacağı bir tahmin (not_forecastable) ücretsizdir; hesap başına saatte en fazla 30 bu tür yanıt. Bunun ötesinde uç nokta, saat dolana kadar 429 döner. Hatayla sonuçlanan bir istek hiçbir ücrete tabi değildir.
- Agent istekleri, token hacmi, model maliyeti ve araç çağrılarına dayalı değişken fiyatlandırma kullanır. Tamamlanan yanıt, kullanılan kredileri bildirir.
- Her işlem her planda kullanılabilir. Planlar geçmiş penceresi (Free: 90 gün; Pro: her uç noktanın maksimumu, çoğu zaman serisi için bir yıl), hız sınırı (Free: dakikada 60 istek; Pro: 300) ve dahil edilen aylık krediler bakımından farklılık gösterir; kredi satın almak kullanımı uzatır ancak geçmiş penceresini veya hız sınırlarını değiştirmez.
Keşif
| Araç | Krediler | Açıklama |
|---|
screener |
2 |
Tarayıcı |
get_top_momentum |
2 |
En yüksek momentum |
get_top_trending |
2 |
En çok trend olanlar |
Sorgulama
| Araç | Krediler | Açıklama |
|---|
list_assets |
1 |
Metinden varlık ID'si |
search |
1 |
Arama |
list_subjects |
1 |
Metinden konu ID'si |
Sosyal & Duygu Durumu
| Araç | Krediler | Açıklama |
|---|
get_emotions |
1 |
Duygu dağılımı |
get_mindshare |
2 |
Zihin Payı |
get_related_subjects |
2 |
İlgili konular |
get_sentiment |
1 |
Duygu Durumu |
get_sentiment_timeframes |
1 |
Zaman dilimine göre duyarlılık |
get_social_momentum |
2 |
Sosyal momentum |
Tahminler
| Araç | Krediler | Açıklama |
|---|
list_forecast_assets |
1 |
Tahmin edilebilir varlıklar |
get_mindshare_forecast |
5 (refresh=true ile 10; not_forecastable ise ücretsiz, saatte 30) |
Mindshare tahmini |
get_sentiment_forecast |
5 (refresh=true ile 10; not_forecastable ise ücretsiz, saatte 30) |
Duyarlılık tahmini |
Piyasa Duygu Durumu
| Araç | Krediler | Açıklama |
|---|
get_calls |
2 |
Long/short çağrıları |
get_call_returns |
2 |
Çağrı sonucu dağılımı |
get_conviction_index |
2 |
Kanaat endeksi |
get_fear_greed_index |
1 |
Korku ve Açgözlülük endeksi |
get_price_levels |
2 |
Sosyal olarak bahsedilen fiyat seviyeleri |
get_social_volume_index |
2 |
Sosyal hacim ile işlem hacmi |
get_social_volume_profile |
2 |
Sosyal hacim profili |
Piyasa Verileri
| Araç | Krediler | Açıklama |
|---|
get_price_history |
1 |
Fiyat geçmişi |
İstihbarat
| Araç | Krediler | Açıklama |
|---|
list_calendar_events |
5 |
Takvim etkinlikleri |
list_insights |
5 |
İstihbarat |
get_insight_attention |
5 |
Insight ilgisi |
Kümeler
| Araç | Krediler | Açıklama |
|---|
list_clusters |
2 |
Yazar kümeleri |
compare_clusters |
2 |
Küme karşılaştırması |
get_divisive_assets |
2 |
Bölücü varlıklar |
compare_hype_cycles |
2 |
Hype döngüsü varışları |
compare_cluster_traits |
2 |
Küme özelliği karşılaştırması |
get_cluster_hype_cycles |
2 |
Küme hype döngüleri |
get_cluster_overlap |
2 |
Küme örtüşmesi |
get_cluster_profile |
2 |
Küme profili |
get_cluster_rotation |
2 |
Küme rotasyonu |
get_cluster_stances |
2 |
Küme duruşları |
Hesap
| Araç | Krediler | Açıklama |
|---|
get_account |
0 |
Hesap |
Sorun Giderme
- 401: oturum açma eksik veya süresi dolmuş ya da API anahtarı geçersiz veya iptal edilmiş.
- 402: hesabın kredileri bu döngü için tükenmiş.
- 403: istek, planın geçmiş penceresinin dışına çıkıyor.
- 429: anahtar dakika başına hız sınırına ulaştı; Retry-After aralığını bekleyin.
- 503: bir bağımlılık kısa süreliğine kullanılamadı; çağrıyı yeniden deneyin.
- Araçlar görünmezse, MCP yapılandırmasını kaydettikten sonra istemciyi yeniden başlatın.