Alpha Vantage

By deepsuthar496 GitHub

alpha-vantage financial-data

Overview

What is Alpha Vantage?

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

How to use Alpha Vantage?

To use Alpha Vantage, clone the repository, install dependencies, build the server, and configure it with your API key in the MCP settings file.

Key features of Alpha Vantage?

Real-time stock quotes and historical price data from global markets.
Real-time cryptocurrency prices and exchange rates.
Live foreign exchange rates and currency pair conversions.
Advanced technical indicators and trading signals.

Use cases of Alpha Vantage?

Fetching real-time stock prices for analysis.
Monitoring cryptocurrency market trends.
Performing technical analysis for trading strategies.

FAQ from Alpha Vantage?

How many API calls can I make?

The free tier allows 25 API calls per day.

What markets does Alpha Vantage support?

It supports US stock markets, global cryptocurrency markets, and foreign exchange markets.

Do I need an API key?

Yes, you need to sign up for an API key at Alpha Vantage.

Content

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 [your-repo-url]
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>