Alpha Vantage
About
Provides real-time financial data retrieval from Alpha Vantage, enabling developers and analysts to access comprehensive stock prices, market indicators, forex rates, and cryptocurrency information with instant, structured results.
Details
- Author
- deepsuthar496
- Repository
- deepsuthar496/alpha-ventage-mcp
- GitHub stars
- 2
- Downloads
- 416
- Categories
- Cloud Service, Finance, Other, API, Design, Developer Tools, Infrastructure, Knowledge Base
Jump to
- Retrieve OHLCV data for a specific ticker and date.
- Fetch dividend data for any ticker.
- Obtain ETF holdings data.
- Simple JSON input for all tools.
- Configured via environment variable for the API key.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Alpha VantageCommand (node, npx, python, etc.)nodeArguments-
Argument 1
path/to/alpha-vantage-server/build/index.js
Environment-
ALPHA_VANTAGE_API_KEY
your-api-key-here
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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": []
}
}
}
To install Alpha Vantage Financial Data Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @deepsuthar496/alpha-ventage-mcp --client claude
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
get_stock_price
Get real-time stock quotes. Parameters: symbol (string) - the stock symbol you want the price for.
get_daily_time_series
Get daily stock price history. Parameters: symbol (string) - the stock symbol for which to retrieve data; outputsize (string) - the size of the output data (e.g., 'compact').
get_crypto_price
Get cryptocurrency prices. Parameters: symbol (string) - the cryptocurrency symbol; market (string) - the market to convert to (e.g., 'USD').
get_forex_rate
Get currency exchange rates. Parameters: from_currency (string) - the currency you are converting from; to_currency (string) - the currency you are converting to.
get_technical_indicator
Get technical indicators. Parameters: symbol (string) - the stock symbol; indicator (string) - the type of technical indicator (e.g., 'SMA'); interval (string) - the time interval for the indicator (e.g., 'daily').
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"alpha vantage": {
"env": {
"ALPHA_VANTAGE_API_KEY": "your-api-key-here"
},
"args": [
"path/to/alpha-vantage-server/build/index.js"
],
"command": "node"
}
}
}Linux
{
"env": {
"ALPHA_VANTAGE_API_KEY": "your-api-key-here"
},
"args": [
"path/to/alpha-vantage-server/build/index.js"
],
"command": "node"
}Macos
{
"env": {
"ALPHA_VANTAGE_API_KEY": "your-api-key-here"
},
"args": [
"path/to/alpha-vantage-server/build/index.js"
],
"command": "node"
}Windows
{
"env": {
"ALPHA_VANTAGE_API_KEY": "your-api-key-here"
},
"args": [
"path/to/alpha-vantage-server/build/index.js"
],
"command": "node"
}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 dataForex Trading
- Live foreign exchange rates - Currency pair conversions - Global forex market dataTechnical Analysis
- Advanced technical indicators - Moving averages (SMA, EMA) - Market momentum indicators - Trading signals and patterns🚀 Quick Start
Installation
Installing via Smithery
To install Alpha Vantage Financial Data Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @deepsuthar496/alpha-ventage-mcp --client claude
Manual Installation [Administered by Repo Owner]
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
