Alpha Vantage MCP Server

Alpha Vantage MCP Server 📈

A Model Context Protocol (MCP) server that provides seamless integration with Alpha Vantage's financial data API, enabling real-time stock market data, cryptocurrency prices, forex rates, and technical indicators.

🌟 Features

Stock Market Data

Real-time stock quotes from global markets
Historical price data (daily, weekly)
Comprehensive company information
Support for multiple exchanges (NYSE, NASDAQ, BSE)

Cryptocurrency Data

Real-time crypto prices
Digital currency exchange rates
Major cryptocurrency market data

Forex Trading

Live foreign exchange rates
Currency pair conversions
Global forex market data

Technical Analysis

Advanced technical indicators
Moving averages (SMA, EMA)
Market momentum indicators
Trading signals and patterns

🚀 Quick Start

Installation

Clone the repository:

git clone https://github.com/deepsuthar496/alpha-ventage-mcp
cd alpha-vantage-server

Install dependencies:

npm install

Build the server:

npm run build

Configuration

Configure the server in your MCP settings file:

{
  "mcpServers": {
    "alpha-vantage": {
      "command": "node",
      "args": ["path/to/alpha-vantage-server/build/index.js"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

🛠️ Available Tools

Stock Market Tools

get_stock_price

// Get real-time stock quotes
<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_stock_price</tool_name>
<arguments>
{
  "symbol": "AAPL" 
}
</arguments>
</use_mcp_tool>

get_daily_time_series

// Get daily stock price history
<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_daily_time_series</tool_name>
<arguments>
{
  "symbol": "MSFT",
  "outputsize": "compact"
}
</arguments>
</use_mcp_tool>

Cryptocurrency Tools

get_crypto_price

// Get cryptocurrency prices
<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_crypto_price</tool_name>
<arguments>
{
  "symbol": "BTC",
  "market": "USD"
}
</arguments>
</use_mcp_tool>

Forex Tools

get_forex_rate

// Get currency exchange rates
<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_forex_rate</tool_name>
<arguments>
{
  "from_currency": "USD",
  "to_currency": "EUR"
}
</arguments>
</use_mcp_tool>

📊 Technical Analysis

get_technical_indicator

// Get technical indicators
<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_technical_indicator</tool_name>
<arguments>
{
  "symbol": "AAPL",
  "indicator": "SMA",
  "interval": "daily"
}
</arguments>
</use_mcp_tool>

🔑 API Key

25 API calls per day
Real-time and historical data access
Global market coverage

🌐 Supported Markets

US Stock Markets (NYSE, NASDAQ)
Global Cryptocurrency Markets
Foreign Exchange Markets
International Stock Markets

🤝 Contributing

Fork the repository
Create your feature branch
Commit your changes
Push to the branch
Create a new Pull Request

📝 License

MIT