Octagon MCP Server

resmi

Memberikan riset investasi real-time dengan data pasar privat dan publik yang ekstensif.

GitHub
134

Dokumentasi

Octagon: MCP untuk Intelijen Pasar Publik & Prediksi

smithery badge

Favicon Server MCP Octagon menyediakan riset dan analisis keuangan bertenaga AI khusus dengan mengintegrasikan API Intelijen Pasar Octagon, memungkinkan pengguna untuk menganalisis dan mengekstrak wawasan dari pengajuan publik, panggilan laba, metrik keuangan, data saham & kripto, berita saham, serta berita & riset pasar prediksi di dalam Claude Desktop dan klien MCP populer lainnya.

Demo

Alat

āœ… octagon-agent mengorkestrasi analisis intelijen pasar yang luas

  • Wawasan pasar publik: pengajuan SEC (10-K, 10-Q, 20-F, 8-K, S-1, 13-F, DEF 14A), transkrip panggilan laba
  • Data pasar saham & kripto: data perdagangan saham, perdagangan kripto, berita, siaran pers, kepemilikan dan portofolio

āœ… octagon-deep-research-agent untuk riset mendalam yang komprehensif

  • Sintesis multi-sumber untuk pertanyaan riset investasi
  • Terbaik untuk analisis tematik lintas sumber yang terkini

āœ… Perangkat riset pasar prediksi

  • octagon-prediction-markets-agent untuk laporan riset terbaru pada setiap pasar prediksi
  • prediction_markets_history untuk pengambilan data pasar historis terstruktur

āœ… Akses dokumentasi Octagon langsung

  • octagon-docs-search, octagon-docs-read, octagon-docs-list, dan octagon-docs-refresh
  • Sumber daya MCP untuk octagon-docs://catalog, octagon-docs://status, dan octagon-docs://page/{target}

Dapatkan Kunci API Octagon Anda

Untuk menggunakan Octagon MCP, Anda perlu:

  1. Mendaftar akun gratis di Octagon
  2. Setelah masuk, dari menu kiri, navigasikan ke API Keys
  3. Buat kunci API baru
  4. Gunakan kunci API ini dalam konfigurasi Anda sebagai nilai OCTAGON_API_KEY

Prasyarat

Sebelum menginstal atau menjalankan Octagon MCP, Anda harus menginstal npx (yang disertakan dengan Node.js dan npm) di sistem Anda.

Mac (macOS)

  1. Instal Homebrew (jika belum ada):

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

  2. Instal Node.js (termasuk npm dan npx):

    brew install node

    Ini akan menginstal versi terbaru Node.js, npm, dan npx.

  3. Verifikasi instalasi:

    node -v
npm -v
npx -v

Windows

  1. Unduh penginstal Node.js:
  2. Jalankan penginstal dan ikuti petunjuknya. Ini akan menginstal Node.js, npm, dan npx.
  3. Verifikasi instalasi: Buka Command Prompt dan jalankan: 
    node -v
npm -v
npx -v

Jika Anda melihat nomor versi untuk ketiganya, Anda siap melanjutkan ke langkah instalasi di bawah.

Instalasi

Menjalankan di Claude Desktop

Untuk mengonfigurasi Octagon MCP untuk Claude Desktop:

  1. Buka Claude Desktop
  2. Buka Settings > Developer > Edit Config
  3. Tambahkan yang berikut ke claude_desktop_config.json Anda (Ganti your-octagon-api-key dengan kunci API Octagon Anda):
{
  "mcpServers": {
    "octagon-mcp-server": {
      "command": "npx",
      "args": ["-y", "octagon-mcp@latest"],
      "env": {
        "OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}
  1. Mulai ulang Claude agar perubahan diterapkan

Menjalankan di Cursor

Mengonfigurasi Cursor Desktop šŸ–„ļø Catatan: Memerlukan Cursor versi 0.45.6+

Untuk mengonfigurasi Octagon MCP di Cursor:

  1. Buka Pengaturan Cursor
  2. Buka Features > MCP Servers
  3. Klik "+ Add New MCP Server"
  4. Masukkan yang berikut:
    • Nama: "octagon-mcp" (atau nama pilihan Anda)
    • Tipe: "command"
    • Perintah: env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-mcp

Jika Anda menggunakan Windows dan mengalami masalah, coba cmd /c "set OCTAGON_API_KEY=your-octagon-api-key && npx -y octagon-mcp"

Ganti your-octagon-api-key dengan kunci API Octagon Anda.

Setelah menambahkan, segarkan daftar server MCP untuk melihat alat baru. Composer Agent akan otomatis menggunakan Octagon MCP saat sesuai, tetapi Anda dapat secara eksplisit memintanya dengan menjelaskan kebutuhan riset investasi Anda. Akses Composer melalui Command+L (Mac), pilih "Agent" di samping tombol kirim, dan masukkan kueri Anda.

Menjalankan dengan npx

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

Instalasi Manual

npm install -g octagon-mcp

Dokumentasi

Untuk dokumentasi komprehensif tentang penggunaan agen Octagon, silakan kunjungi dokumentasi resmi kami di: https://octagonai.co/docs/

Dokumentasi mencakup:

  • Referensi API terperinci
  • Panduan kueri spesifik agen
  • Contoh dan kasus penggunaan
  • Praktik terbaik untuk riset investasi

Untuk panduan pengaturan klien MCP terbaru yang dihosting, lihat:

Server MCP ini juga mengekspos korpus dokumen langsung ke klien MCP. Akses dokumentasi diambil dari titik masuk LLM dokumen publik Octagon di https://octagonai.co/docs/llms.txt; ini tidak menggunakan atau mengirimkan OCTAGON_API_KEY.

Alat yang Tersedia

Server MCP saat ini mengekspos alat-alat berikut:

Alat Dokumentasi

Alat-alat ini mengekspos dokumen Octagon langsung di dalam sesi MCP. Mereka berfungsi bahkan sebelum OCTAGON_API_KEY dikonfigurasi, yang membuatnya berguna untuk pengaturan, pemecahan masalah, dan menemukan agen atau alur kerja API Octagon yang tepat.

octagon-docs-list

Mencantumkan bagian dan halaman dokumen langsung dari korpus dokumen Octagon.

Parameter

  • section (string, opsional): filter berdasarkan bagian dokumen.
  • source (docs, site, atau all, opsional): default ke korpus dokumen.
  • limit (number, opsional): entri maksimum yang dikembalikan.

octagon-docs-search

Mencari dokumen API, agen, MCP, dan plugin Octagon dengan URL sumber dan cuplikan opsional.

Parameter

  • query (string, wajib): kueri pencarian.
  • section (string, opsional): filter berdasarkan bagian dokumen.
  • source (docs, site, atau all, opsional): default ke korpus dokumen.
  • limit (number, opsional): hasil maksimum yang dikembalikan.
  • includeSnippets (boolean, opsional): sertakan cuplikan yang cocok dalam hasil.

Contoh:

Search Octagon docs for Claude plugin connector setup.

octagon-docs-read

Membaca satu halaman atau bagian dokumen sebagai Markdown berdasarkan judul, URL, jalur, atau id katalog.

Parameter

  • target (string, wajib): judul dokumen, URL, jalur, atau id katalog.
  • source (docs, site, atau all, opsional): default ke korpus dokumen.
  • maxChars (number, opsional): karakter Markdown maksimum yang dikembalikan.
  • preferCachedContent (boolean, opsional): gunakan korpus dokumen terindeks jika tersedia.

Contoh:

Read the Octagon MCP server guide.

octagon-docs-refresh

Menyegarkan katalog dokumen dalam memori dari titik akhir dokumen ramah-LLM langsung.

Parameter

  • includeSite (boolean, opsional): juga segarkan indeks situs https://octagonai.co/llms.txt yang lebih luas.

Sumber Daya Dokumentasi

Klien yang mendukung sumber daya MCP juga dapat menjelajahi:

  • octagon-docs://catalog: katalog dokumen langsung yang dinormalisasi.
  • octagon-docs://status: status cache, titik akhir sumber, dan metadata penyegaran.
  • octagon-docs://page/{target}: satu halaman atau bagian dokumen sebagai Markdown.

octagon-agent

Mengorkestrasi analisis intelijen pasar publik dan privat.

Parameter

  • prompt (string, wajib): permintaan riset bahasa alami.
  • conversation (string, opsional): ID percakapan Octagon yang ada untuk melanjutkan utas octagon-agent sebelumnya. Abaikan ini pada giliran pertama.
  • newConversation (boolean, opsional): jika true, memulai utas Octagon baru untuk jangkar sesi/utas aktif. Direkomendasikan untuk giliran pertama obrolan baru yang terlihat di host lapisan atas seperti Claude Desktop.

Penggunaan berutas

octagon-agent adalah satu-satunya alat MCP yang meneruskan threading percakapan Octagon. Ini adalah alat stateful dan mengharapkan kontinuitas sesi. MCP menyelesaikan status sesi/utas dalam urutan ini:

  1. percakapan tersimpan untuk identitas sesi transport MCP, ketika transport benar-benar menyediakannya
  2. percakapan tersimpan untuk sesi stdio default yang dikelola server
  3. conversation eksplisit masih dapat mengganti percakapan sesi aktif untuk panggilan itu

Paket ini saat ini berjalan sebagai server MCP stdio. Dalam mode stdio, server secara otomatis membuat sesi lokal proses untuk kontinuitas di seluruh panggilan. Sebagian besar host lokal seperti Claude Desktop atau Cursor karenanya dapat menggunakan octagon-agent tanpa menyediakan bidang threading tambahan untuk perilaku tindak lanjut dasar.

Ketika host lapisan atas mengetahui bahwa panggilan adalah giliran pertama dari obrolan baru yang terlihat, ia harus mengirimkan newConversation: true. Itu secara eksplisit menghapus utas Octagon yang tersimpan untuk jangkar sesi MCP aktif sebelum panggilan, yang mencegah kontinuitas basi ketika host stdio menggunakan kembali proses MCP berumur panjang yang sama di beberapa obrolan yang terlihat.

Ini berarti Anda dapat menggunakan salah satu pola berikut:

  1. Panggilan pertama: kirim hanya prompt
  2. Biarkan host MCP mempertahankan kontinuitas sesi transport atau andalkan sesi stdio default
  3. Panggilan kedua: baik
    • kirim prompt baru di sesi MCP yang sama, atau
    • terus gunakan proses MCP stdio yang sama, atau
    • secara eksplisit berikan conversation sebelumnya

Identitas sesi transport adalah primitif kontinuitas kanonik untuk transport MCP stateful yang sesuai standar. Untuk penggunaan stdio lokal, sesi proses yang dikelola server menyediakan kontinuitas default.

Identitas sesi dan identitas percakapan Octagon adalah konsep yang berbeda:

  • Identitas sesi MCP mengontrol kontinuitas sisi server di seluruh panggilan alat
  • conversation Octagon mengontrol utas Octagon aktif di dalam sesi itu

Hasil MCP menyimpan jawaban di content, dan juga mengembalikan metadata terstruktur untuk orkestrator di structuredContent:

{
  "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."
  }
}

Contoh penerusan eksplisit:

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

Contoh obrolan baru yang terlihat:

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

Contoh penyegaran eksplisit:

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

Kebijakan alat stateful

  • octagon-agent: stateful, menggunakan jangkar kontinuitas yang dapat digunakan. Di host stdio, itu default ke sesi proses yang dikelola server kecuali Anda memberikan conversation eksplisit
  • alat MCP lainnya: stateless dan dapat berjalan tanpa kontinuitas sesi

Contoh:

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

Contoh lainnya:

  • "Berapa angka pendapatan dan laba bersih Amazon di Q4 2023?"
  • "Analisis tren pengeluaran R&D Tesla selama 3 tahun terakhir."
  • "Panduan apa yang diberikan CEO NVIDIA mengenai permintaan chip AI dalam panggilan laba terbaru mereka?"
  • "Bandingkan rasio price-to-earnings, price-to-sales, dan EV/EBITDA untuk 5 perusahaan semikonduktor teratas."
  • "Berapa ukuran putaran pendanaan terbaru Anthropic, valuasi, dan investor kunci?"
  • "Berapa banyak investasi yang dilakukan Andreessen Horowitz di startup AI dalam 12 bulan terakhir?"
  • "Apa artikel berita terbaru untuk saham NVIDIA dari minggu lalu?"

octagon-deep-research-agent

Melakukan riset mendalam dan sintesis multi-sumber yang komprehensif.

Parameter

  • prompt (string, wajib): permintaan riset bahasa alami.

Contoh:

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

Contoh lainnya:

  • "Ekstrak semua bidang data dari zillow.com/san-francisco-ca/"
  • "Riset dampak keuangan dari perubahan privasi Apple pada pendapatan dan margin perusahaan periklanan digital"
  • "Ambil data harga Bitcoin historis dari 2023 dan analisis tren volatilitas harga"
  • "Analisis dinamika kompetitif di pasar infrastruktur pengisian daya EV"

octagon-prediction-markets-agent

Menghasilkan laporan riset untuk acara pasar prediksi Kalshi.

Parameter

  • prompt (string, wajib): permintaan riset bahasa alami.
  • cache (boolean, opsional): mengontrol perutean varian agen.
    • dihilangkan: prediction-markets-agent
    • false: prediction-markets-agent:refresh
    • true: prediction-markets-agent:cache

Contoh:

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

prediction_markets_history

Mengambil data historis untuk ticker acara pasar prediksi dengan paginasi dan filter waktu opsional.

Parameter

  • event_ticker (string, wajib)
  • limit (number, opsional)
  • cursor (string, opsional)
  • captured_from (string, opsional)
  • captured_to (string, opsional)
  • include_analysis (boolean, opsional; ketika true, meminta kolom analisis)

Contoh:

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

Pemecahan Masalah

  1. Masalah Kunci API: Pastikan kunci API Octagon Anda telah diatur dengan benar di environment atau berkas konfigurasi.
  2. Masalah Koneksi: Pastikan konektivitas ke API Octagon berfungsi dengan baik.
  3. Pembatasan Laju: Jika Anda mengalami galat pembatasan laju, kurangi frekuensi permintaan Anda.

Lisensi

MIT

Server MCP Khusus Individual

Meskipun server ini menyediakan intelijen pasar komprehensif yang menggabungkan semua agen khusus kami, Anda juga dapat menggunakan server MCP individual kami untuk kasus penggunaan spesifik:

Alat Riset

ā­ Beri bintang pada repo ini jika Anda merasa terbantu!