Alpha Ventage MCP

🚀 Alpha Vantage MCP Server 📈

An MCP (Model Context Protocol) server that seamlessly integrates with Alpha Vantage's financial data API, providing real-time stock market data, cryptocurrency prices, foreign exchange rates, and technical indicators.

✨ Features

Stock Market Data

• Real-time stock quotes from global markets
• Historical stock price data (daily, weekly)
• Company details
• Support for multiple exchanges (NYSE, NASDAQ, NSE)

Cryptocurrency Data

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

Foreign Exchange

• Real-time foreign exchange rates
• Currency pair conversions
• Global foreign exchange market data

Technical Analysis

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

🚀 Quick Start

Installation

1. Clone the repository:

git clone [your-repo-url]
cd alpha-vantage-server

2. Install dependencies:

npm install

3. Build the server:

npm run build

Configuration

Configure the server in the 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": []
    }
  }
}

💻 Usage Examples

Basic Usage

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 historical stock price data
<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>

Foreign Exchange Tools

get_forex_rate

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

Technical Analysis Tools

get_technical_indicators

// Get technical indicator data
<use_mcp_tool>
<server_name>alpha-vantage</server_name>
<tool_name>get_technical_indicators</tool_name>
<arguments>
{
  "symbol": "AAPL",
  "interval": "1D"
}
</arguments>
</use_mcp_tool>

📌 API Key

To use Alpha Vantage's API, please register and obtain a free API key: Alpha Vantage Signup Page

🌍 Supported Markets

• US stock markets (NYSE, NASDAQ)
• European stock markets (LSE, etc.)
• Asian stock markets (TSE, etc.)
• Global cryptocurrency markets
• Major foreign exchange markets

💡 Contribution Guidelines

If you want to contribute to the project, please refer to our Contribution Guidelines

📄 License

MIT License