What is Alpha Ventage Mcp

alpha-ventage-mcp is a Model Context Protocol (MCP) server that integrates with the Alpha Vantage API to provide real-time financial data, including stock prices, cryptocurrency rates, and market indicators.

Use cases

Use cases include retrieving live stock quotes, accessing historical price data for analysis, fetching cryptocurrency prices for trading, and performing technical analysis for market predictions.

How to use

To use alpha-ventage-mcp, clone the repository, install the dependencies, and configure the MCP settings file with your Alpha Vantage API key. You can then access various tools to fetch financial data.

Key features

Key features include real-time stock market data, historical price data, cryptocurrency prices, forex trading rates, and advanced technical analysis indicators.

Where to use

alpha-ventage-mcp can be used in financial applications, trading platforms, investment analysis tools, and any system requiring real-time financial data.

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

1. Clone the repository:

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

2. Install dependencies:

npm install

3. 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

Sign up for an API key at Alpha Vantage. Free tier includes:

• 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

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request

📝 License

MIT