Alpha Vantage MCP Server

resmi

Yapay zeka ajanlarının ve uygulamalarının, doğal dil sorguları aracılığıyla gerçek zamanlı ve 20+ yıllık geçmiş finansal piyasa verilerine erişmesini sağlar.

alphavantage.co üzerinde görüntüle

Dokümantasyon

İçindekiler

Resmi Alpha Vantage API MCP sunucusu, LLM'lerin ve ajan tabanlı iş akışlarının Model Bağlam Protokolü (MCP) aracılığıyla gerçek zamanlı ve geçmiş borsa verileriyle sorunsuz bir şekilde etkileşime girmesini sağlar. Bu sunucuyu Claude, Claude Code, Cursor, VS Code ve daha birçok favori uygulamanıza ekleyerek kapsamlı finansal verilere erişmelerini sağlayın.

Hızlı Başlangıç

Sunucuyu kullanmak için ücretsiz Alpha Vantage API anahtarınızı alın, panoya kopyalayın ve ardından ilgilendiğiniz ajan aracı/platformu için aşağıdaki talimatları izleyin.

⚡ MCP sunucusu çağrıldığında mükemmel yanıt kalitesini korurken tüketilen token sayısını (dolayısıyla oluşan maliyeti) en aza indirmek için Aşamalı Araç Keşfi adı verilen bir optimizasyon tekniği kullanıyoruz. Bu teknik hakkında daha fazla bilgiyi buradan edinebilirsiniz.

⭐ MCP kaynak kodunu Github üzerinde görüntüleyin.

👉 Sorularınız mı var? Lütfen [email protected] adresine ulaşın.

Bağlantı Örnekleri

Uzak Sunucu Bağlantısı:

https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY

Yerel Sunucu Bağlantısı:

uvx marketdata-mcp-server YOUR_API_KEY

Kullanım Durumuna Göre Kurulum Talimatları

💬📊 Sohbet robotunuzu finansal verilerle güçlendirin

Claude'a Kurulum

Gereksinimler:

Claude Pro hesabı (veya daha üst seviye)

Claude Uzak Sunucu Bağlantısı

Claude'u (Web veya Masaüstü) bu MCP sunucusuna bağlamak için:

📺 Kurulum eğitimini izleyin - Adım adım video kılavuzunu izlemek için aşağıdaki resme tıklayın:

📺 Alpha Vantage MCP sunucunuz zaten kurulu mu? Aşağıda Claude'un çeşitli hisse senedi analizi ve grafik oluşturma görevlerini yerine getirdiği birkaç örnek bulunmaktadır:

OAuth Seçeneği (Önerilir):

claude.ai/settings/connectors (Web) veya Ayarlar → Bağlayıcılar (Masaüstü) adresine gidin
"Özel Bağlayıcı Ekle"ye tıklayın
MCP sunucu URL'sini ekleyin: https://mcp.alphavantage.co/mcp
"Bağlan"a tıklayın
Alpha Vantage API anahtarınızı girin
"Erişime Yetki Ver"e tıklayın

URL'de API Anahtarı (Alternatif):

claude.ai/settings/connectors (Web) veya Ayarlar → Bağlayıcılar (Masaüstü) adresine gidin
"Özel Bağlayıcı Ekle"ye tıklayın
API anahtarınızla birlikte MCP sunucu URL'sini ekleyin: https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY (YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin)
"Bağlan"a tıklayın

Claude Yerel Sunucu Bağlantısı

Daha fazla bilgi için Claude Desktop MCP belgelerine bakın.

uv (modern bir Python paketi ve proje yöneticisi) yükleyin:

curl -LsSf https://astral.sh/uv/install.sh | sh

Claude Desktop geliştirici ayarlarını açın ve aşağıdaki yapılandırmayı eklemek için claude_desktop_config.json dosyanızı düzenleyin:

{
  "mcpServers": {
    "alphavantage": {
      "command": "uvx",
      "args": ["marketdata-mcp-server", "YOUR_API_KEY"]
    }
  }
}

YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin.

ChatGPT'ye Kurulum

Gereksinimler:

ChatGPT Plus hesabı (veya daha üst seviye)
Geliştirici modu etkin (beta özelliği) - OpenAI'nin Geliştirici Modu belgelerine bakın

📺 Kurulum eğitimini izleyin - Adım adım video kılavuzunu izlemek için aşağıdaki resme tıklayın:

📺 Alpha Vantage MCP sunucunuz zaten kurulu mu? Aşağıda ChatGPT'nin çeşitli hisse senedi analizi ve grafik oluşturma görevlerini yerine getirdiği birkaç örnek bulunmaktadır:

Kurulum:

ChatGPT Ayarlar → Uygulamalar adresine gidin
Gelişmiş ayarlar → öğesine tıklayın, Geliştirici modunu etkinleştirin
Uygulamalar alt menüsüne dönün, ardından Uygulama oluştura tıklayın.
MCP Sunucu URL'si: https://mcp.alphavantage.co/mcp
Kimlik Doğrulama: OAuth. Bağlandığınızda, Alpha Vantage API anahtarınızı girdiğiniz ve yetkilendirdiğiniz bir onay sayfası açılır.

Alternatif (URL'de API anahtarı):

ChatGPT Ayarlar → Uygulamalar adresine gidin
Gelişmiş ayarlar → öğesine tıklayın, Geliştirici modunu etkinleştirin
Uygulamalar alt menüsüne dönün, ardından Uygulama oluştura tıklayın.
MCP Sunucu URL'si: https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY (YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin).
Kimlik Doğrulama: Kimlik doğrulama yok

Not: Sohbete döndüğünüzde, kullanıcı arayüzünüz Geliştirici modunda olduğunuzu açıkça gösterecektir. ChatGPT, aynı sohbet oturumu içinde yapılan önceki yorumların hafızasını tutacaktır; ancak bu oturumlar kalıcı olmayabilir, yani Geliştirici modu etkinken oluşturulan konuşma kapatıldıktan sonra kaydedilmeyebilir veya erişilebilir olmayabilir.

ChatGPT Plus Hesapları için Sorun Giderme

Geliştirici modu hem Plus hem de Pro hesaplar için kullanılabilirken, Plus hesaplarda ilk kez MCP aracı yürütme tutarsız davranışlar sergileyebilir. Bu durum öncelikle MCP sunucusundan dönen büyük veri yüklerini etkiler. MCP çağrılarının herhangi bir JSON yanıtı döndürmeden aniden sonlandığını fark ederseniz, aşağıdakileri deneyin:

Bağlantıyı Onaylayın

Aşağıdaki komutu vererek bağlantıyı onaylayın:

List 3 functions available in Alpha Vantage MCP server.

TIME_SERIES_DAILY ve TIME_SERIES_INTRADAY gibi uç noktaları görmelisiniz.

Basit yük ile JSON Geçişini Zorlayın

ChatGPT'yi tam yükü göstermeye hazırlamak için aşağıdaki komutları sırayla kullanın:

Run ADD_TWO_NUMBERS from Alpha Vantage MCP Server using 3 and 6, and then show the JSON response.

Başarılı olursa, ChatGPT sizden çağrıyı Onaylamanızı veya Reddetmenizi istemelidir. Onaylaya tıklayın.
Olmazsa, 🔄 "Tekrar Dene..." düğmesini kullanın ve Onayla/Reddet istemini alıp almadığınıza bakın.
Bu işe yaramazsa, ChatGPT'ye aşağıdakini sorun ve eğer Thinking başlarsa, çağrıyı tekrar denememesi ve bunun yerine konuşma yanıtını vermesi için Atla yapın.

Why aren't you receiving a JSON response?

Ardından, yanıt ne olursa olsun, ChatGPT'ye şunu söyleyin:

Explicitly request a return value from the tool response to verify what the server outputs.

Genellikle bu, ChatGPT'nin sizden çağrıyı Onaylamanızı veya Reddetmenizi istemesini sağlar. Onaylaya tıklayın.
Bazen ChatGPT, Alpha Vantage MCP Sunucusuna aktif bir bağlantısı olmadığında ısrar edecektir. Sadece "tekrar dene" deyin.
Yükler hala görünmezse, Yeni Sohbet başlatın ve 2. Adımı tekrar deneyin.

Büyük yük ile JSON Geçişini Zorlayın

1. adım başarılı olduğunda, daha büyük çağrı ile 2. adımı tekrarlayın:

Run TIME_SERIES_DAILY using NVDA, and then show the JSON response.

ChatGPT sizden çağrıyı Onaylamanızı veya Reddetmenizi istemezse, 2. Adımdaki yedek adımları kullanın.
ChatGPT'nin daha büyük çağrıdan ham JSON yükünün bir kısmını başarıyla döndürdüğünü gözlemlediğinizde, genellikle daha fazla konuşma sorgusu ile devam edebilirsiniz. Grok'a Kurulum

Gereksinimler:

SuperGrok (veya daha üst seviye)

Kurulum:

+ düğmesine tıklayın → Bağlayıcılar → Bağlayıcı ekle → Özel
Ad: Alpha Vantage MCP Server (veya tercih ettiğiniz herhangi bir ad)
Sunucu URL'si: https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY (YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin).
Bağlayıcı Ekleye tıklayın

🤖📈 Nicel yatırım için ajan tabanlı iş akışları oluşturun

🦞OpenClaw🦞'a Kurulum

Gereksinimler:

Apple Silicon'lu Mac (veya özel Mac mini)
LLM API Anahtarı (Demoda OpenAI kullanılmıştır)
Mesajlaşma Platformu Bot Anahtarı (Demoda Telegram kullanılmıştır)

📺 Kurulum eğitimini izleyin (aşağıdaki resme tıklayın)

GitHub Gist'ten ayrıntılı kurulum kılavuzunu görüntüleyin
Ek destek bağlantıları için lütfen YouTube'daki video açıklamasını kontrol edin. OpenAI Agent Builder'da Yapılandırma

Gereksinimler:

Agent Builder'a erişimi olan OpenAI hesabı (ör. fatura bilgileri eklenmiş, kuruluş doğrulanmış)

📺 Kurulum eğitimini izleyin. (Aşağıdaki resme tıklayın.)

OpenAI Agent Builder Bağlantısı

OpenAI Agent Builder'ı bu MCP sunucusuna bağlamak için:

Ayrı bir MCP Sunucu nesnesi eklemeyin. Bunun yerine, MCP Sunucusunu doğrudan ajana eklemek için OpenAI Agent Builder'daki ajanınıza tıklayın.
Ajanın Araçlar bölümünü bulun ve yeni bir araç eklemek için + düğmesine tıklayın
MCP Sunucusu'nu seçin
"MCP sunucusu ekle" menüsünün sağ üst köşesindeki "+ Sunucu"ya tıklayın
MCP sunucusunu aşağıdaki ayarlarla yapılandırın:

URL: https://mcp.alphavantage.co/mcp
Etiket: Alpha Vantage MCP Server (veya tercih ettiğiniz herhangi bir ad)
Açıklama: Financial market data and technical indicators (veya tercih ettiğiniz herhangi bir açıklama)
Kimlik Doğrulama: "Erişim anahtarı / API anahtarı"nı seçin (varsayılan olmalıdır)
Erişim Anahtarı: Alpha Vantage API anahtarınızı girin

Bağlan'a tıklayın
Başarılı olursa, bir sonraki istem tüm araçları gösterecektir. En alta kaydırın ve Ekle'ye tıklayın.

Önerilen Ajan Talimatları:

Performansı optimize etmek için ajanınızın yapılandırmasına aşağıdaki talimatı ekleyin:

You are a helpful financial agent with access to market data through Alpha Vantage MCP Server.

IMPORTANT: Alpha Vantage functions are accessed via wrapper tools:
- Use TOOL_LIST to see available functions (TIME_SERIES_DAILY, RSI, COMPANY_OVERVIEW, etc.)
- Use TOOL_CALL with the format: TOOL_CALL(tool_name="FUNCTION_NAME", arguments={...})
- Example: TOOL_CALL(tool_name="TIME_SERIES_DAILY", arguments={"symbol": "AAPL", "outputsize": "compact"})

OpenAI Agents SDK'ya Kurulum

Alpha Vantage MCP sunucusunu OpenAI Agents SDK ile kullanmak için, aşağıdakileri gösteren örnek ajanımıza bakın:

Etkileşimli finansal analiz ajanı
Konuşma sürekliliği için oturum yönetimi
Alpha Vantage verileriyle gerçek zamanlı araç yürütme
Hem HTTP hem de stdio MCP bağlantıları için destek

Örnek, eksiksiz bir kurulum kılavuzu ve yapılandırma şablonları içerir.

Microsoft Foundry Agent Service'te Yapılandırma

Gereksinimler:

Azure AI Foundry erişimi olan Azure aboneliği

Microsoft Foundry Agent Service Bağlantısı

Bir Foundry ajanını bu MCP sunucusuna bağlamak için:

Azure AI Foundry'nin Agent oyun alanında veya Agent tasarımcısında ajanınızı açın (veya Ana Pano'dan Ajan Oluşturun).
Ajan yapılandırmasının Araçlar bölümünde, Ekle → Tüm Araçlara Gözata tıklayın. "Bir Araç Seçin" altındaki Özel kategorisini seçin ve Model Bağlam Protokolünü seçin
MCP sunucusunu aşağıdaki ayarlarla yapılandırın:

Kimlik doğrulamasız (önerilir):
- Sunucu etiketi: alpha-vantage-mcp-server (veya tercih ettiğiniz herhangi bir ad)
- Sunucu URL'si: https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY
  - YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin.
- Kimlik Doğrulama: Kimlik doğrulamasızı seçin
Anahtar tabanlı kimlik doğrulama (alternatif):
- Sunucu etiketi: alpha-vantage-mcp-server (veya tercih ettiğiniz herhangi bir ad)
- Sunucu URL'si: https://mcp.alphavantage.co/mcp
- Kimlik Doğrulama: Anahtar tabanlı kimlik doğrulamayı seçin
- Kimlik Bilgisi
  - "Anahtar değer çifti ekle"ye tıklayın
  - Anahtar: apikey
  - Değer: Alpha Vantage API anahtarınızı girin

Bağlana tıklayın

Önerilen Ajan Talimatları:

Performansı optimize etmek için ajanınızın sistem istemine aşağıdaki talimatı ekleyin:

You are a helpful financial agent with access to market data through Alpha Vantage MCP Server.
IMPORTANT: Alpha Vantage functions are accessed via wrapper tools:

Use TOOL_LIST to see available functions (TIME_SERIES_DAILY, RSI, COMPANY_OVERVIEW, etc.)
Use TOOL_GET to retrieve the schema for a specific function before calling it
Use TOOL_CALL with the format: TOOL_CALL(tool_name="FUNCTION_NAME", arguments={...})
Example: TOOL_CALL(tool_name="TIME_SERIES_DAILY", arguments={"symbol": "IBM", "outputsize": "compact"})

Always use Alpha Vantage MCP Server for market data queries. Do not answer from prior knowledge or web search.

💻💵 Fintech uygulamaları kodlayın

OpenAI Codex'e Kurulum

Gereksinimler:

ChatGPT Plus hesabı (veya daha üst seviye)

Daha fazla bilgi için OpenAI Codex sayfasına bakın.

📺 Kurulum eğitimini izleyin. (Aşağıdaki resme tıklayın.) Bu video ayrıca kurulum hatalarını ele alma ve dinamik, veri odaklı görselleştirmeleri güçlendirmek için piyasa verilerini almaya yetkili eksiksiz uçtan uca uygulamalar oluşturma konusunda rehberlik sağlar.

GitHub Gist'ten yardımcı .md dosyasını indirin.
Ek destek bağlantıları için lütfen YouTube'daki video açıklamasını kontrol edin.

uv (modern bir Python paketi ve proje yöneticisi) yükleyin:

curl -LsSf https://astral.sh/uv/install.sh | sh

Uyumluluk sorunlarını önlemek için Codex CLI v0.34 veya sonrasını yükleyin.

# Install (if not already installed)
npm install -g @openai/codex

# Or update to the latest version
npm update -g @openai/codex

# Verify installation and version
codex --version

~/.codex/config.toml dosyasını düzenleyerek Codex MCP sunucu ayarlarınıza aşağıdaki yapılandırmayı ekleyin:

[mcp_servers.alphavantage]
command = "uvx"
args = ["marketdata-mcp-server", "YOUR_API_KEY"]

YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin.

Proje dizininizden terminalinizde codex komutunu çalıştırın. İlk kez kullananlar ek istemlerle yönlendirilecektir.

Ardından şununla bağlanın:

/mcp

Claude Code'a Kurulum

Gereksinimler:

Claude Pro hesabı (veya daha üst seviye)

Daha fazla bilgi için Claude Code MCP belgelerine bakın.

Uzaktan bağlanıp bağlanmadığınıza veya sunucuyu yerel olarak çalıştırdığınıza bağlı olarak aşağıdaki komutlardan birini çalıştırın.

Claude Code Uzak Sunucu Bağlantısı

claude mcp add -t http alphavantage https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY

YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin.

Claude Code Yerel Sunucu Bağlantısı

İlk olarak, uv (modern bir Python paketi ve proje yöneticisi) yükleyin:

curl -LsSf https://astral.sh/uv/install.sh | sh

Ardından şunu çalıştırın:

claude mcp add alphavantage -- uvx marketdata-mcp-server YOUR_API_KEY

YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin.

Proje dizininizden terminalinizde claude komutunu çalıştırın.

Ardından şununla bağlanın:

/mcp

VS Code'a (Visual Studio Code) Kurulum

Daha fazla bilgi için VS Code MCP belgelerine bakın. Çalışma alanınızda .vscode/mcp.json (VS Code MCP yapılandırma dosyanız) oluşturun ve uzaktan bağlanıp bağlanmadığınıza veya sunucuyu yerel olarak çalıştırıp çalıştırmadığınıza bağlı olarak aşağıdaki yapılandırmalardan birini içine yapıştırın.

VS Code Uzak Sunucu Bağlantısı

Aşağıdakini .vscode/mcp.json içine yapıştırın:

{
  "servers": {
    "alphavantage": {
      "type": "http",
      "url": "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY"
    }
  }
}

YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin.

VS Code Yerel Sunucu Bağlantısı

Öncelikle uv (modern bir Python paketi ve proje yöneticisi) yükleyin:

curl -LsSf https://astral.sh/uv/install.sh | sh

Ardından aşağıdakini .vscode/mcp.json içine yapıştırın:

{
  "servers": {
    "alphavantage": {
      "type": "stdio",
      "command": "uvx",
      "args": ["marketdata-mcp-server", "YOUR_API_KEY"]
    }
  }
}

YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin.

Sohbet görünümünü açın ve Ajan modunu seçin

Continue'da Kurulum (VS Code, JetBrains için Eklenti)

Daha fazla bilgi için Continue MCP belgelerine bakın. Continue kendi yapılandırma formatını kullanır (VS Code'un mcp.json'u değil).

Çalışma alanınızda .continue/mcpServers/alphavantage.yaml oluşturun ve uzaktan bağlanıp bağlanmadığınıza veya sunucuyu yerel olarak çalıştırıp çalıştırmadığınıza bağlı olarak aşağıdaki yapılandırmalardan birini içine yapıştırın. (Önerilen: Uzak)

Continue Uzak Sunucu Bağlantısı

Aşağıdakini .continue/mcpServers/alphavantage.yaml içine yapıştırın:

name: Alpha Vantage MCP Server
version: 1.0
schema: v1
mcpServers:
  - name: alphavantage
    type: streamable-http
    url: https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY

YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin.

Continue Yerel Sunucu Bağlantısı

Öncelikle uv (modern bir Python paketi ve proje yöneticisi) yükleyin:

curl -LsSf https://astral.sh/uv/install.sh | sh

Ardından aşağıdakini .continue/mcpServers/alphavantage.yaml içine yapıştırın:

name: Alpha Vantage MCP Server
version: 1.0
schema: v1
mcpServers:
  - name: alphavantage
    type: stdio
    command: uvx
    args:
      - marketdata-mcp-server
      - YOUR_API_KEY

YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin.

Continue panelini açın ve Ajan modunu seçin. LLM sağlayıcınızı ayarlayın.

Cursor'da Kurulum

Daha fazla bilgi için Cursor MCP belgelerine bakın.

Uzaktan bağlanıp bağlanmadığınıza veya sunucuyu yerel olarak çalıştırıp çalıştırmadığınıza bağlı olarak aşağıdaki yapılandırmalardan birini Cursor ~/.cursor/mcp.json dosyanıza yapıştırın. Ayrıca proje klasörünüzde .cursor/mcp.json oluşturarak belirli bir projeye de kurabilirsiniz.

Cursor Uzak Sunucu Bağlantısı

~/.cursor/mcp.json dosyasını düzenleyerek Cursor'ı yapılandırın:

{
  "mcpServers": {
    "alphavantage": {
      "url": "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY"
    }
  }
}

YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin.

Cursor Yerel Sunucu Bağlantısı

Öncelikle uv (modern bir Python paketi ve proje yöneticisi) yükleyin:

curl -LsSf https://astral.sh/uv/install.sh | sh

Ardından aşağıdakini Cursor ~/.cursor/mcp.json dosyanıza yapıştırın:

{
  "mcpServers": {
    "alphavantage": {
      "command": "uvx",
      "args": ["marketdata-mcp-server", "YOUR_API_KEY"]
    }
  }
}

YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin.

Gemini CLI'da Kurulum

Daha fazla bilgi için Gemini CLI Yapılandırması belgelerine bakın.

Uzaktan bağlanıp bağlanmadığınıza veya sunucuyu yerel olarak çalıştırıp çalıştırmadığınıza bağlı olarak aşağıdaki komutlardan birini çalıştırın.

Gemini CLI Uzak Sunucu Bağlantısı (Önerilen):

gemini mcp add -t http alphavantage https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY

YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin.

Gemini CLI Yerel Sunucu Bağlantısı:

uv (modern bir Python paketi ve proje yöneticisi) yükleyin:

curl -LsSf https://astral.sh/uv/install.sh | sh

Ardından şunu çalıştırın:

gemini mcp add alphavantage uvx marketdata-mcp-server YOUR_API_KEY

YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin.

Manuel Yapılandırma:

Gemini CLI ayarlar dosyasını açın. Konumu ~/.gemini/settings.json şeklindedir (burada ~ ana dizininizdir).
settings.json dosyanızdaki mcpServers nesnesine aşağıdakini ekleyin (YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin):

{
  "mcpServers": {
    "alphavantage": {
      "httpUrl": "https://mcp.alphavantage.co/mcp?apikey=YOUR_API_KEY"
    }
  }
}

Veya yerel bir sunucu için (YOUR_API_KEY kısmını gerçek Alpha Vantage API anahtarınızla değiştirin):

{
  "mcpServers": {
    "alphavantage": {
      "command": "uvx",
      "args": ["marketdata-mcp-server", "YOUR_API_KEY"]
    }
  }
}

Eğer mcpServers nesnesi mevcut değilse, onu oluşturun.

💡💡 Sadece keşfediyorum

Ne inşa edeceğinizi mi keşfediyorsunuz? Hiçbir kurulum gerektirmeden Alpha Vantage piyasa verileriyle desteklenen Trading Agents hisse senedi araştırma aracına (Github'da #1 trend) göz atın.

Örnekler

Aşağıda, MCP sunucusunu kullanırken dört örnek istem ve Claude'un beklenen yanıtları bulunmaktadır.

1. Varlıklar arasında yapılandırılmış piyasa verilerini getirme ve görüntüleme

İstem: "IBM için geçen haftanın OHLCV verilerini ver"

Beklenen Davranış:

Claude, doğru aracı bulmak ve çağırmak için aşamalı keşif kullanacaktır, bu durumda TIME_SERIES_DAILY fonksiyonu.
Claude, TIME_SERIES_DAILY fonksiyonuna gerekli isteği yapacak ve ilgili yanıtı alacaktır.
Claude daha sonra sohbet arayüzünde hem metin hem de görüntü içeriğiyle doğrudan yanıt verecektir:

İşte IBM'in geçen haftaki (16–20 Mart 2026) OHLCV verileri:

IBM_price

IBM Salı günü 256,11$'a güçlü bir ralli yaptı, ardından haftanın geri kalanında geri çekildi. Cuma günü, haftalık ortalama hacmin iki katından fazla bir hacimle seansın en düşük seviyesi olan 241,77$'a keskin bir satış dalgası yaşandı — muhtemelen bu hareketi tetikleyen kayda değer bir haber veya geniş piyasa baskısı var.

2. Teknik analiz yapmak için teknik göstergeleri ve fiyat verilerini kullanma

İstem: "NVDA'nın son iki günlük saatlik fiyat verilerini al. RSI'ı da hesapla ve her ikisini de RSI için 30 ve 70'te kılavuz çizgileriyle saatlik olarak çiz"

Beklenen Davranış:

Claude, doğru araçları bulmak ve çağırmak için aşamalı keşif kullanacaktır, bu durumda TIME_SERIES_INTRADAY fonksiyonu ve RSI fonksiyonu.
Claude, TIME_SERIES_INTRADAY fonksiyonuna ve RSI fonksiyonuna iki ayrı istek yapacaktır. Claude ilgili yanıtları alacaktır.
Claude daha sonra istenen görselleştirmeleri içeren bir HTML yapıtı oluşturacaktır:

NVDA_RSI

3. Temel verileri görselleştirme

İstem: "AAPL'nin son 4 çeyreklik kazanç sürprizi eğilimlerini görselleştirmeme yardım et. Gerçek EPS'yi analist tahminleriyle karşılaştır"

Beklenen Davranış:

Claude, doğru aracı bulmak ve çağırmak için aşamalı keşif kullanacaktır, bu durumda EARNINGS fonksiyonu.
Claude, EARNINGS fonksiyonuna gerekli isteği yapacak ve ilgili yanıtı alacaktır.
Claude, dönen veriler üzerinde gerekli hesaplamaları yapacak ve bir HTML yapıtı oluşturacaktır:

4. Varlık sınıfları arasında performansı karşılaştırma

İstem: "Altın, gümüş ve Bitcoin'in son 5 yıllık performansını karşılaştır"

Beklenen Davranış:

Claude, doğru araçları bulmak ve çağırmak için aşamalı keşif kullanacaktır, bu durumda TIME_SERIES_MONTHLY fonksiyonu ve DIGITAL_CURRENCY_MONTHLY fonksiyonu.
Claude, GLD sembolünü kullanarak TIME_SERIES_INTRADAY fonksiyonuna, SLV sembolünü kullanarak TIME_SERIES_INTRADAY fonksiyonuna ve BTC sembolünü kullanarak DIGITAL_CURRENCY_MONTHLY fonksiyonuna üç ayrı istek yapacaktır. Claude ilgili yanıtları alacaktır.
Claude, dönen veriler üzerinde gerekli hesaplamaları yapacak ve bir HTML yapıtı oluşturacaktır:

Araç Referansı

Not: Aşağıda listelenen araçlara MCP sunucusunun TOOL_CALL sarmalayıcı fonksiyonu aracılığıyla erişilir.

Kategori	Araçlar
core_stock_apis	TIME_SERIES_INTRADAY, TIME_SERIES_DAILY, TIME_SERIES_DAILY_ADJUSTED, TIME_SERIES_WEEKLY, TIME_SERIES_WEEKLY_ADJUSTED, TIME_SERIES_MONTHLY, TIME_SERIES_MONTHLY_ADJUSTED, GLOBAL_QUOTE, REALTIME_BULK_QUOTES, SYMBOL_SEARCH, MARKET_STATUS
options_data_apis	REALTIME_OPTIONS, REALTIME_OPTIONS_FMV, HISTORICAL_OPTIONS
alpha_intelligence	NEWS_SENTIMENT, EARNINGS_CALL_TRANSCRIPT, TOP_GAINERS_LOSERS, INSIDER_TRANSACTIONS, INSTITUTIONAL_HOLDINGS, ANALYTICS_FIXED_WINDOW, ANALYTICS_SLIDING_WINDOW
fundamental_data	COMPANY_OVERVIEW, INCOME_STATEMENT, BALANCE_SHEET, CASH_FLOW, EARNINGS, LISTING_STATUS, EARNINGS_CALENDAR, IPO_CALENDAR
forex	FX_INTRADAY, FX_DAILY, FX_WEEKLY, FX_MONTHLY
cryptocurrencies	CURRENCY_EXCHANGE_RATE, DIGITAL_CURRENCY_INTRADAY, DIGITAL_CURRENCY_DAILY, DIGITAL_CURRENCY_WEEKLY, DIGITAL_CURRENCY_MONTHLY
commodities	WTI, BRENT, NATURAL_GAS, COPPER, ALUMINUM, WHEAT, CORN, COTTON, SUGAR, COFFEE, GOLD_SILVER_SPOT, GOLD_SILVER_HISTORY, ALL_COMMODITIES
economic_indicators	REAL_GDP, REAL_GDP_PER_CAPITA, TREASURY_YIELD, FEDERAL_FUNDS_RATE, CPI, INFLATION, RETAIL_SALES, DURABLES, UNEMPLOYMENT, NONFARM_PAYROLL
technical_indicators	SMA, EMA, WMA, DEMA, TEMA, TRIMA, KAMA, MAMA, VWAP, T3, MACD, MACDEXT, STOCH, STOCHF, RSI, STOCHRSI, WILLR, ADX, ADXR, APO, PPO, MOM, BOP, CCI, CMO, ROC, ROCR, AROON, AROONOSC, MFI, TRIX, ULTOSC, DX, MINUS_DI, PLUS_DI, MINUS_DM, PLUS_DM, BBANDS, MIDPOINT, MIDPRICE, SAR, TRANGE, ATR, NATR, AD, ADOSC, OBV, HT_TRENDLINE, HT_SINE, HT_TRENDMODE, HT_DCPERIOD, HT_DCPHASE, HT_PHASOR
ping	PING, ADD_TWO_NUMBERS

💡 Bu MCP araçlarının her biri, karşılık gelen bir Alpha Vantage API uç noktasına eşlenir. Aşağıdaki kısa araç açıklamalarına ek olarak tam API özellikleriyle ilgileniyorsanız, lütfen Alpha Vantage API belgelerine bakın. Yapay zeka aracı çağında en iyi borsa veri API'sini ve/veya MCP sunucusunu seçmeye yönelik genel rehberlik için lütfen bu makaleye başvurun.

CORE_STOCK_APIS

Kategori	Araç	Açıklama
core_stock_apis	TIME_SERIES_INTRADAY	Güncel ve 20+ yıllık geçmiş gün içi OHLCV verileri
core_stock_apis	TIME_SERIES_DAILY	20+ yılı kapsayan günlük zaman serisi (OHLCV)
core_stock_apis	TIME_SERIES_DAILY_ADJUSTED	Bölünme/temettü olaylarıyla düzeltilmiş günlük OHLCV
core_stock_apis	TIME_SERIES_WEEKLY	Haftalık zaman serisi (haftanın son işlem günü)
core_stock_apis	TIME_SERIES_WEEKLY_ADJUSTED	Temettülerle düzeltilmiş haftalık zaman serisi
core_stock_apis	TIME_SERIES_MONTHLY	Aylık zaman serisi (ayın son işlem günü)
core_stock_apis	TIME_SERIES_MONTHLY_ADJUSTED	Temettülerle düzeltilmiş aylık zaman serisi
core_stock_apis	GLOBAL_QUOTE	Bir sembol için en son fiyat ve hacim
core_stock_apis	REALTIME_BULK_QUOTES	100'e kadar sembol için gerçek zamanlı fiyatlar
core_stock_apis	SYMBOL_SEARCH	Anahtar kelimelerle sembol arama
core_stock_apis	MARKET_STATUS	Dünya genelinde güncel piyasa durumu

OPTIONS_DATA_APIS

Kategori	Araç	Açıklama
options_data_apis	REALTIME_OPTIONS	Yunan hassasiyetleriyle gerçek zamanlı ABD opsiyon verileri
options_data_apis	REALTIME_OPTIONS_FMV	Gerçek zamanlı ABD opsiyon FMV (gerçeğe uygun piyasa değeri) işaret fiyatları
options_data_apis	HISTORICAL_OPTIONS	15+ yıllık geçmiş opsiyon zinciri

ALPHA_INTELLIGENCE

Kategori	Araç	Açıklama
alpha_intelligence	NEWS_SENTIMENT	Canlı ve geçmiş piyasa haberleri & duyarlılık
alpha_intelligence	EARNINGS_CALL_TRANSCRIPT	LLM duyarlılık analiziyle kazanç görüşmesi metinleri
alpha_intelligence	TOP_GAINERS_LOSERS	En çok yükselen, düşen ve en aktif 20 hisse
alpha_intelligence	INSIDER_TRANSACTIONS	En son ve geçmiş içeriden öğrenen işlemleri
alpha_intelligence	INSTITUTIONAL_HOLDINGS	Kurumsal sahiplik ve varlık bilgileri
alpha_intelligence	ANALYTICS_FIXED_WINDOW	Sabit pencereler üzerinde gelişmiş analitik
alpha_intelligence	ANALYTICS_SLIDING_WINDOW	Kayan pencereler üzerinde gelişmiş analitik

FUNDAMENTAL_DATA

Kategori	Araç	Açıklama
fundamental_data	COMPANY_OVERVIEW	Şirket bilgileri, finansal oranlar ve metrikler
fundamental_data	INCOME_STATEMENT	Yıllık ve çeyreklik gelir tabloları
fundamental_data	BALANCE_SHEET	Yıllık ve çeyreklik bilançolar
fundamental_data	CASH_FLOW	Yıllık ve çeyreklik nakit akış tabloları
fundamental_data	EARNINGS	Yıllık ve çeyreklik kazanç verileri
fundamental_data	LISTING_STATUS	Hisse senetleri için listeleme ve listeden çıkarma verileri
fundamental_data	EARNINGS_CALENDAR	Yaklaşan kazançlar için kazanç takvimi
fundamental_data	IPO_CALENDAR	Halka arz takvimi

FOREX

Kategori	Araç	Açıklama
forex	FX_INTRADAY	Gün içi döviz kurları
forex	FX_DAILY	Günlük döviz kurları
forex	FX_WEEKLY	Haftalık döviz kurları
forex	FX_MONTHLY	Aylık döviz kurları

CRYPTOCURRENCIES

Kategori	Araç	Açıklama
cryptocurrencies	CURRENCY_EXCHANGE_RATE	Dijital/kripto para birimleri arasındaki döviz kuru
cryptocurrencies	DIGITAL_CURRENCY_INTRADAY	Dijital para birimleri için gün içi zaman serisi
cryptocurrencies	DIGITAL_CURRENCY_DAILY	Dijital para birimleri için günlük zaman serisi
cryptocurrencies	DIGITAL_CURRENCY_WEEKLY	Dijital para birimleri için haftalık zaman serisi
cryptocurrencies	DIGITAL_CURRENCY_MONTHLY	Dijital para birimleri için aylık zaman serisi

COMMODITIES

Kategori	Araç	Açıklama
commodities	WTI	Batı Teksas Ham Petrol (WTI) fiyatları
commodities	BRENT	Brent ham petrol fiyatları
commodities	NATURAL_GAS	Henry Hub doğal gaz spot fiyatları
commodities	COPPER	Küresel bakır fiyatları
commodities	ALUMINUM	Küresel alüminyum fiyatları
commodities	WHEAT	Küresel buğday fiyatları
commodities	CORN	Küresel mısır fiyatları
commodities	COTTON	Küresel pamuk fiyatları
commodities	SUGAR	Küresel şeker fiyatları
commodities	COFFEE	Küresel kahve fiyatları
commodities	GOLD_SILVER_SPOT	Altın ve gümüş için canlı spot fiyatlar
commodities	GOLD_SILVER_HISTORY	Geçmiş altın ve gümüş fiyatları (günlük, haftalık, aylık)
commodities	ALL_COMMODITIES	Tüm emtia fiyatları

ECONOMIC_INDICATORS

Kategori	Araç	Açıklama
economic_indicators	REAL_GDP	Reel Gayri Safi Yurtiçi Hasıla
economic_indicators	REAL_GDP_PER_CAPITA	Kişi başına reel GSYİH
economic_indicators	TREASURY_YIELD	Günlük hazine tahvil getiri oranları
economic_indicators	FEDERAL_FUNDS_RATE	Federal fon oranı (faiz oranları)
economic_indicators	CPI	Tüketici Fiyat Endeksi
economic_indicators	INFLATION	Enflasyon oranları
economic_indicators	RETAIL_SALES	Perakende satış verileri
economic_indicators	DURABLES	Dayanıklı mal siparişleri
economic_indicators	UNEMPLOYMENT	İşsizlik oranı
economic_indicators	NONFARM_PAYROLL	Tarım dışı istihdam verileri

TECHNICAL_INDICATORS

Kategori	Araç	Açıklama
technical_indicators	SMA	Basit hareketli ortalama (SMA) değerleri
technical_indicators	EMA	Üstel hareketli ortalama (EMA) değerleri
technical_indicators	WMA	Ağırlıklı hareketli ortalama (WMA) değerleri
technical_indicators	DEMA	Çift üstel hareketli ortalama (DEMA) değerleri
technical_indicators	TEMA	Üçlü üstel hareketli ortalama (TEMA) değerleri
technical_indicators	TRIMA	Üçgensel hareketli ortalama (TRIMA) değerleri
technical_indicators	KAMA	Kaufman uyarlanabilir hareketli ortalama (KAMA) değerleri
technical_indicators	MAMA	MESA uyarlanabilir hareketli ortalama (MAMA) değerleri
technical_indicators	VWAP	Gün içi zaman serileri için hacim ağırlıklı ortalama fiyat (VWAP)
technical_indicators	T3	Üçlü üstel hareketli ortalama (T3) değerleri
technical_indicators	MACD	Hareketli ortalama yakınsama / ıraksama (MACD) değerleri
technical_indicators	MACDEXT	Kontrol edilebilir hareketli ortalama türü ile hareketli ortalama yakınsama / ıraksama değerleri
technical_indicators	STOCH	Stokastik osilatör (STOCH) değerleri
technical_indicators	STOCHF	Hızlı stokastik (STOCHF) değerleri
technical_indicators	RSI	Göreceli güç endeksi (RSI) değerleri
technical_indicators	STOCHRSI	Stokastik göreceli güç endeksi (STOCHRSI) değerleri
technical_indicators	WILLR	Williams %R (WILLR) değerleri
technical_indicators	ADX	Ortalama yön hareketi endeksi (ADX) değerleri
technical_indicators	ADXR	Ortalama yön hareketi endeksi derecelendirmesi (ADXR) değerleri
technical_indicators	APO	Mutlak fiyat osilatörü (APO) değerleri
technical_indicators	PPO	Yüzdesel fiyat osilatörü (PPO) değerleri
technical_indicators	MOM	Momentum (MOM) değerleri
technical_indicators	BOP	Güç dengesi (BOP) değerleri
technical_indicators	CCI	Emtia kanal endeksi (CCI) değerleri
technical_indicators	CMO	Chande momentum osilatörü (CMO) değerleri
technical_indicators	ROC	Değişim oranı (ROC) değerleri
technical_indicators	ROCR	Değişim oranı oranı (ROCR) değerleri
technical_indicators	AROON	Aroon (AROON) değerleri
technical_indicators	AROONOSC	Aroon osilatörü (AROONOSC) değerleri
technical_indicators	MFI	Para akış endeksi (MFI) değerleri
technical_indicators	TRIX	Üçlü düzleştirilmiş üstel hareketli ortalamanın 1 günlük değişim oranı (TRIX) değerleri
technical_indicators	ULTOSC	Nihai osilatör (ULTOSC) değerleri
technical_indicators	DX	Yön hareketi endeksi (DX) değerleri
technical_indicators	MINUS_DI	Eksi yön göstergesi (MINUS_DI) değerleri
technical_indicators	PLUS_DI	Artı yön göstergesi (PLUS_DI) değerleri
technical_indicators	MINUS_DM	Eksi yön hareketi (MINUS_DM) değerleri
technical_indicators	PLUS_DM	Artı yön hareketi (PLUS_DM) değerleri
technical_indicators	BBANDS	Bollinger bantları (BBANDS) değerleri
technical_indicators	MIDPOINT	Orta nokta değerleri - (en yüksek değer + en düşük değer)/2
technical_indicators	MIDPRICE	Orta nokta fiyat değerleri - (en yüksek tepe + en düşük dip)/2
technical_indicators	SAR	Parabolik SAR (SAR) değerleri
technical_indicators	TRANGE	Gerçek aralık (TRANGE) değerleri
technical_indicators	ATR	Ortalama gerçek aralık (ATR) değerleri
technical_indicators	NATR	Normalleştirilmiş ortalama gerçek aralık (NATR) değerleri
technical_indicators	AD	Chaikin A/D çizgisi (AD) değerleri
technical_indicators	ADOSC	Chaikin A/D osilatörü (ADOSC) değerleri
technical_indicators	OBV	Denge hacmi (OBV) değerleri
technical_indicators	HT_TRENDLINE	Hilbert dönüşümü, anlık trend çizgisi (HT_TRENDLINE) değerleri
technical_indicators	HT_SINE	Hilbert dönüşümü, sinüs dalgası (HT_SINE) değerleri
technical_indicators	HT_TRENDMODE	Hilbert dönüşümü, trend vs döngü modu (HT_TRENDMODE) değerleri
technical_indicators	HT_DCPERIOD	Hilbert dönüşümü, baskın döngü periyodu (HT_DCPERIOD) değerleri
technical_indicators	HT_DCPHASE	Hilbert dönüşümü, baskın döngü fazı (HT_DCPHASE) değerleri
technical_indicators	HT_PHASOR	Hilbert dönüşümü, fazör bileşenleri (HT_PHASOR) değerleri

PING

Kategori	Araç	Açıklama
ping	PING	'pong' döndüren sağlık kontrolü aracı
ping	ADD_TWO_NUMBERS	İki sayıyı toplamak için örnek araç