Octagon MCP Server

resmi

Deliver real-time investment research with extensive private and public market data.

GitHub
134

Dokümantasyon

Octagon: Kamu ve Tahmin Piyasaları İstihbaratı için MCP

smithery badge

Favicon Octagon MCP sunucusu, Octagon Piyasa İstihbaratı API'si ile entegre olarak uzmanlaşmış yapay zeka destekli finansal araştırma ve analiz sağlar; kullanıcıların Claude Desktop ve diğer popüler MCP istemcileri içinde kamuya açık dosyalamaları, kazanç görüşmelerini, finansal metrikleri, hisse senedi ve kripto verilerini, hisse senedi haberlerini ve tahmin piyasaları haberleri ile araştırmalarını analiz etmelerine ve içgörüler çıkarmalarına olanak tanır.

Demo

Araçlar

✅ octagon-agent geniş kapsamlı piyasa istihbaratı analizini düzenler

  • Kamu piyasası içgörüleri: SEC dosyalamaları (10-K, 10-Q, 20-F, 8-K, S-1, 13-F, DEF 14A), kazanç görüşmesi transkriptleri
  • Hisse senedi ve kripto piyasa verileri: hisse senedi işlemleri, kripto işlem verileri, haberler, basın bültenleri, sahiplik ve holdingler

✅ Kapsamlı derin araştırma için octagon-deep-research-agent

  • Yatırım araştırma soruları için çok kaynaklı sentez
  • Güncel, kaynaklar arası tematik analiz için en uygunu

✅ Tahmin piyasası araştırma araçları

  • Her bir tahmin piyasası için güncellenmiş araştırma raporları için octagon-prediction-markets-agent
  • Yapılandırılmış geçmiş piyasa verisi alımı için prediction_markets_history

✅ Canlı Octagon dokümantasyon erişimi

  • octagon-docs-search, octagon-docs-read, octagon-docs-list ve octagon-docs-refresh
  • octagon-docs://catalog, octagon-docs://status ve octagon-docs://page/{target} için MCP kaynakları

Octagon API Anahtarınızı Edinin

Octagon MCP'yi kullanmak için şunları yapmanız gerekir:

  1. Octagon adresinde ücretsiz bir hesap oluşturun
  2. Giriş yaptıktan sonra sol menüden API Anahtarları'na gidin
  3. Yeni bir API anahtarı oluşturun
  4. Bu API anahtarını yapılandırmanızda OCTAGON_API_KEY değeri olarak kullanın

Ön Koşullar

Octagon MCP'yi kurmadan veya çalıştırmadan önce sisteminizde npx (Node.js ve npm ile birlikte gelir) kurulu olmalıdır.

Mac (macOS)

  1. Homebrew'u yükleyin (eğer yoksa):

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  2. Node.js'i yükleyin (npm ve npx dahil):

    brew install node

    Bu, Node.js, npm ve npx'in en son sürümünü yükleyecektir.

  3. Kurulumu doğrulayın:

    node -v
npm -v
npx -v

Windows

  1. Node.js yükleyicisini indirin:
  2. Yükleyiciyi çalıştırın ve talimatları izleyin. Bu, Node.js, npm ve npx'i yükleyecektir.
  3. Kurulumu doğrulayın: Komut İstemi'ni açın ve şunu çalıştırın: 
    node -v
npm -v
npx -v

Her üçü için de sürüm numaralarını görüyorsanız, aşağıdaki kurulum adımlarına geçmeye hazırsınız demektir.

Kurulum

Claude Desktop'ta Çalıştırma

Octagon MCP'yi Claude Desktop için yapılandırmak üzere:

  1. Claude Desktop'ı açın
  2. Ayarlar > Geliştirici > Yapılandırmayı Düzenle'ye gidin
  3. claude_desktop_config.json dosyanıza aşağıdakini ekleyin (your-octagon-api-key kısmını Octagon API anahtarınızla değiştirin):
{
  "mcpServers": {
    "octagon-mcp-server": {
      "command": "npx",
      "args": ["-y", "octagon-mcp@latest"],
      "env": {
        "OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}
  1. Değişikliklerin etkili olması için Claude'u yeniden başlatın

Cursor'da Çalıştırma

Cursor Desktop'ı Yapılandırma 🖥️ Not: Cursor sürüm 0.45.6 veya üstü gerektirir

Octagon MCP'yi Cursor'da yapılandırmak için:

  1. Cursor Ayarları'nı açın
  2. Özellikler > MCP Sunucuları'na gidin
  3. "+ Yeni MCP Sunucusu Ekle"ye tıklayın
  4. Aşağıdakileri girin:
    • Ad: "octagon-mcp" (veya tercih ettiğiniz ad)
    • Tür: "command"
    • Komut: env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-mcp

Windows kullanıyorsanız ve sorun yaşıyorsanız, cmd /c "set OCTAGON_API_KEY=your-octagon-api-key && npx -y octagon-mcp" deneyin

your-octagon-api-key kısmını Octagon API anahtarınızla değiştirin.

Ekledikten sonra, yeni araçları görmek için MCP sunucu listesini yenileyin. Composer Agent uygun olduğunda Octagon MCP'yi otomatik olarak kullanacaktır, ancak yatırım araştırma ihtiyaçlarınızı açıklayarak açıkça talep edebilirsiniz. Composer'a Command+L (Mac) ile erişin, gönder düğmesinin yanındaki "Agent"ı seçin ve sorgunuzu girin.

npx ile Çalıştırma

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

Manuel Kurulum

npm install -g octagon-mcp

Dokümantasyon

Octagon ajanlarını kullanma hakkında kapsamlı dokümantasyon için lütfen resmi dokümantasyonumuzu ziyaret edin: https://octagonai.co/docs/

Dokümantasyon şunları içerir:

  • Ayrıntılı API referansları
  • Ajana özel sorgu yönergeleri
  • Örnekler ve kullanım senaryoları
  • Yatırım araştırması için en iyi uygulamalar

En güncel barındırılan MCP istemci kurulum kılavuzu için bakınız:

Bu MCP sunucusu ayrıca canlı doküman külliyatını doğrudan MCP istemcilerine sunar. Dokümantasyon erişimi, https://octagonai.co/docs/llms.txt adresindeki genel Octagon dokümanları LLM giriş noktasından alınır; OCTAGON_API_KEY kullanmaz veya iletmez.

Mevcut Araçlar

MCP sunucusu şu anda aşağıdaki araçları sunmaktadır:

Dokümantasyon Araçları

Bu araçlar, MCP oturumu içinde canlı Octagon dokümanlarını sunar. OCTAGON_API_KEY yapılandırılmadan önce bile çalışırlar, bu da onları kurulum, sorun giderme ve doğru Octagon ajanını veya API iş akışını keşfetme için kullanışlı kılar.

octagon-docs-list

Octagon doküman külliyatından canlı doküman bölümlerini ve sayfalarını listeler.

Parametreler

  • section (string, isteğe bağlı): doküman bölümüne göre filtreleme.
  • source (docs, site veya all, isteğe bağlı): varsayılan olarak doküman külliyatıdır.
  • limit (number, isteğe bağlı): döndürülecek maksimum girdi sayısı.

octagon-docs-search

Octagon API, ajan, MCP ve eklenti dokümanlarını kaynak URL'leri ve isteğe bağlı parçacıklarla arar.

Parametreler

  • query (string, zorunlu): arama sorgusu.
  • section (string, isteğe bağlı): doküman bölümüne göre filtreleme.
  • source (docs, site veya all, isteğe bağlı): varsayılan olarak doküman külliyatıdır.
  • limit (number, isteğe bağlı): döndürülecek maksimum sonuç sayısı.
  • includeSnippets (boolean, isteğe bağlı): sonuçlara eşleşen parçacıkları dahil etme.

Örnek:

Search Octagon docs for Claude plugin connector setup.

octagon-docs-read

Başlık, URL, yol veya katalog kimliğine göre bir doküman sayfasını veya bölümünü Markdown olarak okur.

Parametreler

  • target (string, zorunlu): doküman başlığı, URL'si, yolu veya katalog kimliği.
  • source (docs, site veya all, isteğe bağlı): varsayılan olarak doküman külliyatıdır.
  • maxChars (number, isteğe bağlı): döndürülecek maksimum Markdown karakter sayısı.
  • preferCachedContent (boolean, isteğe bağlı): mevcut olduğunda indekslenmiş doküman külliyatını kullanma.

Örnek:

Read the Octagon MCP server guide.

octagon-docs-refresh

Canlı LLM dostu doküman uç noktalarından bellek içi doküman kataloğunu yeniler.

Parametreler

  • includeSite (boolean, isteğe bağlı): ayrıca daha geniş https://octagonai.co/llms.txt site indeksini de yenileme.

Dokümantasyon Kaynakları

MCP kaynaklarını destekleyen istemciler ayrıca şunlara göz atabilir:

  • octagon-docs://catalog: normalleştirilmiş canlı doküman kataloğu.
  • octagon-docs://status: önbellek durumu, kaynak uç noktaları ve yenileme meta verileri.
  • octagon-docs://page/{target}: Markdown olarak bir doküman sayfası veya bölümü.

octagon-agent

Kamu ve özel piyasa istihbaratı analizini düzenler.

Parametreler

  • prompt (string, zorunlu): doğal dil araştırma talebi.
  • conversation (string, isteğe bağlı): önceki bir octagon-agent iş parçacığını sürdürmek için mevcut Octagon konuşma kimliği. İlk turda bunu atlayın.
  • newConversation (boolean, isteğe bağlı): eğer true ise, aktif oturum/iş parçacığı çapası için yeni bir Octagon iş parçacığı başlatır. Claude Desktop gibi üst katman ana bilgisayarlarda yepyeni bir görünür sohbetin ilk turu için önerilir.

İş parçacıklı kullanım

octagon-agent, Octagon konuşma iş parçacığını ileten tek MCP aracıdır. Durum bilgisi olan bir araçtır ve oturum sürekliliği bekler. MCP, oturum/iş parçacığı durumunu şu sırayla çözer:

  1. MCP aktarım oturum kimliği için saklanan konuşma, aktarım bunu gerçekten sağladığında
  2. sunucu tarafından yönetilen varsayılan stdio oturumu için saklanan konuşma
  3. açık conversation, o çağrı için aktif oturum konuşmasını yine de geçersiz kılabilir

Bu paket şu anda bir stdio MCP sunucusu olarak çalışır. stdio modunda, sunucu çağrılar arasında süreklilik için otomatik olarak süreç-yerel bir oturum oluşturur. Claude Desktop veya Cursor gibi çoğu yerel ana bilgisayar, bu nedenle temel takip davranışı için herhangi bir ekstra iş parçacığı alanı sağlamadan octagon-agent kullanabilir.

Bir üst katman ana bilgisayar, bir çağrının yeni bir görünür sohbetin ilk turu olduğunu bildiğinde, newConversation: true iletmelidir. Bu, çağrıdan önce aktif MCP oturum çapası için saklanan herhangi bir Octagon iş parçacığını açıkça temizler; bu, bir stdio ana bilgisayarının aynı uzun ömürlü MCP sürecini birden fazla görünür sohbet arasında yeniden kullandığında eski sürekliliği önler.

Bu, şu desenlerden herhangi birini kullanabileceğiniz anlamına gelir:

  1. İlk çağrı: yalnızca prompt gönderin
  2. MCP ana bilgisayarının aktarım oturum sürekliliğini korumasına izin verin veya varsayılan stdio oturumuna güvenin
  3. İkinci çağrı: ya
    • aynı MCP oturumunda yeni prompt gönderin, ya da
    • aynı stdio MCP sürecini kullanmaya devam edin, ya da
    • önceki conversation açıkça iletin

Aktarım oturum kimliği, standartlara uygun durum bilgisi olan MCP aktarımları için kanonik süreklilik ilkelidir. Yerel stdio kullanımı için, sunucu tarafından yönetilen süreç oturumu varsayılan sürekliliği sağlar.

Oturum kimliği ve Octagon konuşma kimliği farklı kavramlardır:

  • MCP oturum kimliği, araç çağrıları arasında sunucu tarafı sürekliliğini kontrol eder
  • Octagon conversation, o oturum içindeki aktif Octagon iş parçacığını kontrol eder

MCP sonucu, yanıtı content içinde tutar ve ayrıca düzenleyiciler için structuredContent içinde yapılandırılmış meta veriler döndürür:

{
  "model": "octagon-agent",
  "text": "Which stock would you like the latest price for?",
  "conversation": "conv_123",
  "responseId": "resp_123",
  "followUp": {
    "required": true,
    "inputTemplate": "<ticker or company name>",
    "instructions": "Reply with just the missing detail and reuse the conversation value from this response."
  }
}

Açık ileri taşıma örneği:

{
  "prompt": "AAPL",
  "conversation": "conv_123"
}

Yeni görünür sohbet örneği:

{
  "prompt": "Analyze Apple",
  "newConversation": true
}

Açık yenileme örneği:

{
  "prompt": "Start a fresh Octagon thread for this chat",
  "newConversation": true
}

Durum bilgisi olan araç politikası

  • octagon-agent: durum bilgisi olan, kullanılabilir bir süreklilik çapası kullanır. stdio ana bilgisayarlarında, açık conversation sağlamadığınız sürece varsayılan olarak sunucu tarafından yönetilen süreç oturumuna dayanır
  • diğer MCP araçları: durum bilgisi olmayan ve oturum sürekliliği olmadan çalışabilir

Örnek:

Compare NVIDIA and AMD on latest quarterly revenue growth, margins, and management commentary.

Daha fazla örnek:

  • "Amazon'un 2023 4. çeyrekteki gelir ve net kar rakamları neydi?"
  • "Tesla'nın son 3 yıldaki Ar-Ge harcama eğilimlerini analiz et."
  • "NVIDIA'nın CEO'su son kazanç görüşmesinde AI çip talebiyle ilgili hangi yönlendirmeyi sağladı?"
  • "En büyük 5 yarı iletken şirketi için fiyat-kazanç, fiyat-satış ve FAVÖK/EV oranlarını karşılaştır."
  • "Anthropic'in son finansman turu büyüklüğü, değerlemesi ve kilit yatırımcıları neydi?"
  • "Andreessen Horowitz son 12 ayda AI girişimlerine kaç yatırım yaptı?"
  • "NVIDIA hissesi için geçen haftadan en son haber makaleleri nelerdir?"

octagon-deep-research-agent

Kapsamlı çok kaynaklı derin araştırma ve sentez gerçekleştirir.

Parametreler

  • prompt (string, zorunlu): doğal dil araştırma talebi.

Örnek:

Research the impact of lower interest rates on late-stage private software valuations over the next 12 months.

Daha fazla örnek:

  • "zillow.com/san-francisco-ca/ adresindeki tüm veri alanlarını çıkar"
  • "Apple'ın gizlilik değişikliklerinin dijital reklamcılık şirketlerinin gelir ve marjları üzerindeki finansal etkisini araştır"
  • "2023'ten itibaren geçmiş Bitcoin fiyat verilerini al ve fiyat oynaklık eğilimlerini analiz et"
  • "EV şarj altyapısı pazarındaki rekabet dinamiklerini analiz et"

octagon-prediction-markets-agent

Kalshi tahmin piyasası olayları için araştırma raporları oluşturur.

Parametreler

  • prompt (string, zorunlu): doğal dil araştırma talebi.
  • cache (boolean, isteğe bağlı): ajan varyant yönlendirmesini kontrol eder.
    • atlanırsa: prediction-markets-agent
    • false: prediction-markets-agent:refresh
    • true: prediction-markets-agent:cache

Örnek:

Generate a report for the Kalshi market https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

prediction_markets_history

İsteğe bağlı sayfalama ve zaman filtreleriyle bir tahmin piyasası olay sembolü için geçmiş verileri getirir.

Parametreler

  • event_ticker (string, zorunlu)
  • limit (number, isteğe bağlı)
  • cursor (string, isteğe bağlı)
  • captured_from (string, isteğe bağlı)
  • captured_to (string, isteğe bağlı)
  • include_analysis (boolean, isteğe bağlı; true olduğunda analiz sütunlarını talep eder)

Örnek:

Fetch historical data for the Kalshi event https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

Sorun Giderme

  1. API Anahtarı Sorunları: Octagon API anahtarınızın ortam veya yapılandırma dosyasında doğru şekilde ayarlandığından emin olun.
  2. Bağlantı Sorunları: Octagon API'ye bağlantının düzgün çalıştığından emin olun.
  3. Hız Sınırlaması: Hız sınırlaması hatalarıyla karşılaşırsanız, isteklerinizin sıklığını azaltın.

Lisans

MIT

Bireysel Özelleşmiş MCP Sunucuları

Bu sunucu, tüm özelleşmiş aracılarımızı birleştiren kapsamlı piyasa istihbaratı sağlarken, belirli kullanım durumları için bireysel MCP sunucularımızı da kullanabilirsiniz:

Araştırma Araçları

⭐ Yardımcı bulduysanız bu repoyu yıldızlayın!