alpha-ventage-mcp

# Alpha Vantage MCP Server 📈 [](https://smithery.ai/server/@deepsuthar496/alpha-ventage-mcp) 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 #### Installing via Smithery To install Alpha Vantage Financial Data Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@deepsuthar496/alpha-ventage-mcp): ```bash npx -y @smithery/cli install @deepsuthar496/alpha-ventage-mcp --client claude ``` ### Manual Installation [Administered by Repo Owner] 1. Clone the repository: ```bash git clone https://github.com/deepsuthar496/alpha-ventage-mcp cd alpha-vantage-server ``` 2. Install dependencies: ```bash npm install ``` 3. Build the server: ```bash npm run build ``` ### Configuration Configure the server in your MCP settings file: ```json { "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 ```typescript // 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 ```typescript // 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 ```typescript // 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 ```typescript // 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 ```typescript // 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](https://www.alphavantage.co/support/#api-key). 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