# Alpha Vantage MCP MCP > Alpha Vantage connects your AI agent directly to global financial markets. Pull real-time stock quotes, deep historical time series (daily, weekly, intraday), complex technical indicators like RSI and MACD, company fundamentals, and crypto/forex rates—all in one place. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** stock-market, forex, cryptocurrency, technical-indicators, time-series-data, financial-analysis ## Description You can explore any major market using natural conversation via this MCP. Need to compare the current price of Apple against its 5-year average? Your agent pulls that data immediately. Want to know if a stock's recent news is making it look overbought or oversold? It runs sentiment analysis and calculates indicators on the fly. This tool handles everything from basic real-time quotes to detailed company financial health checks, covering market capitalization, earnings history, and sector performance across 11 industries. When you connect this MCP through Vinkius, your AI client becomes a dedicated quantitative analyst, giving you access to global data without ever leaving your chat window. ## Tools ### get_company_overview Retrieves basic financial data and company fundamentals, useful for initial screening of stocks. ### get_crypto_daily Gets the daily closing price history for any specified cryptocurrency pair (e.g., BTC/USD). ### get_daily_time_series Pulls historical stock prices on a day-by-day basis, allowing you to view 20+ years of data. ### get_earnings Retrieves the history of company earnings reports, showing if the company met or missed analyst expectations. ### get_forex_daily Provides daily opening, high, low, close, and volume data for major foreign exchange currency pairs (e.g., EUR/USD). ### get_intraday_time_series Gets highly granular price movement data at specific intervals like 5-minute or 60-minute bars, ideal for day trading. ### get_monthly_time_series Returns prices aggregated by month, which is best for checking long-term trends and portfolio performance over years. ### get_news_sentiment Analyzes recent news articles about a ticker and calculates whether the overall mood is bullish or bearish. ### get_quote Fetches the immediate, current trading price of a stock, including today's change percent. ### get_rsi Calculates the Relative Strength Index (RSI) to measure if a security is overbought or oversold based on its momentum. ### get_sector_performance Shows the current day's percentage change across all major industry sectors, helping you spot market leaders. ### get_weekly_time_series Provides historical stock prices aggregated by week, useful for medium-term trend analysis without needing daily data. ### search_symbol Looks up a company name or keyword and returns the correct trading symbol needed for all other queries. ## Prompt Examples **Prompt:** ``` Show me the current quote for Apple stock. ``` **Response:** ``` AAPL is currently trading at $189.45, up 1.23 (0.65%) from yesterday's close. Today's range: $187.80 - $190.12. Volume: 52.3M shares. ``` **Prompt:** ``` Show me the RSI for Tesla over the last 14 days. ``` **Response:** ``` TSLA's current RSI (14-day) is 68.5, approaching the overbought threshold of 70. The RSI has been trending up from 52 three weeks ago, indicating strengthening momentum. ``` **Prompt:** ``` What are the top performing sectors today? ``` **Response:** ``` Today's sector performance: Technology (+2.1%), Healthcare (+1.5%), Financials (+1.2%), Energy (-0.3%), Utilities (-0.8%). Technology is leading with strong gains across semiconductor and software stocks. ``` ## Capabilities ### Check Current Market Prices Instantly retrieve current trading prices and key metrics for any publicly traded stock. ### Analyze Historical Trends Get structured price data spanning daily, weekly, monthly, or intraday intervals over decades of history. ### Calculate Technical Signals Run standard quantitative models like RSI and SMA to determine if a stock is trending strongly or nearing an extreme. ### Assess Company Health Pull fundamental data, including market cap, PE ratios, and historical earnings reports for deep company analysis. ### Monitor Market Sentiment Fetch recent news articles related to a ticker symbol and calculate the overall bullish or bearish sentiment score. ### Track Global Assets Access daily rates for cryptocurrency pairs and major foreign exchange currency movements (Forex). ## Use Cases ### The Day Trader Spotting Momentum A day trader needs to assess if a stock is ready for action. They first check the current price with `get_quote`, then zoom into 5-minute bars using `get_intraday_time_series`. Finally, they run `get_rsi` to confirm that momentum is building before placing an order. ### The Investor Checking Corporate Health An investor vetting a potential buy checks the company's long-term stability. They use `get_company_overview` for market cap, then check `get_earnings` to see if quarterly revenue beats estimates over the last five years. ### The Global Hedge Fund Manager A manager needs a full view of global risk. They use `get_forex_daily` for currency rates, check `get_crypto_daily` for digital asset movements, and compare all against the current market sectors using `get_sector_performance`. ### The Student Learning Technical Analysis A student learns about long-term trends. They pull monthly data via `get_monthly_time_series`, then ask their agent to compare that trend against the current sector performance using `get_sector_performance`. ## Benefits - Stop opening multiple financial terminals. You can pull real-time quotes using `get_quote` and then immediately compare that data to years of historical movement from `get_daily_time_series` in one chat session. - Need to know if a stock is overbought? Instead of running complex calculations, simply call `get_rsi`. It gives you the exact momentum signal needed for trading decisions. - Don't just look at prices. Use `get_news_sentiment` to see how public opinion is affecting the ticker right now, giving your analysis context beyond pure numbers. - For portfolio management, use `get_sector_performance`. This lets you quickly identify which industry—like Technology or Healthcare—is leading the market today without manually checking 11 different dashboards. - Developers can build complex financial tools by using specialized data points. For instance, combining a company's fundamentals from `get_company_overview` with their earnings history via `get_earnings` creates a powerful research packet. ## How It Works The bottom line is you get immediate, actionable financial metrics without writing any code yourself. 1. Subscribe to this MCP on Vinkius, then provide your Alpha Vantage API Key. 2. Ask your AI client a question like, 'What was the 30-day RSI for TSLA?' 3. Your agent calls the relevant function and returns structured data containing the calculated indicator or price point. ## Frequently Asked Questions **How do I get an Alpha Vantage API key?** Visit [**alphavantage.co/support/#api_key**](https://www.alphavantage.co/support/#api_key), fill in your name and email, and click **GET FREE API KEY**. The key is delivered instantly on the page. Free tier includes 25 requests per day. **What technical indicators are available?** Alpha Vantage supports 50+ technical indicators including SMA, EMA, RSI, MACD, Bollinger Bands, Stochastic, ADX, ATR, CCI, Williams %R, and many more. Currently this MCP server exposes RSI, with more indicators available on request. **Can I get cryptocurrency data?** Yes! Use `get_crypto_daily` with the crypto symbol (e.g. 'BTC', 'ETH', 'SOL') and market currency (e.g. 'USD', 'EUR'). Returns daily OHLCV data for the cryptocurrency pair. **How much historical data is available?** Alpha Vantage provides 20+ years of historical data for most stocks. Use the `get_daily_time_series` tool with outputsize 'full' to access the complete history. The compact mode returns the last 100 data points. **How do I use the get_earnings tool to check a company's financial history?** The `get_earnings` tool provides historical earnings data, helping you spot trends. You can run this for any ticker symbol to review past quarterly reports and see if the company has been beating or missing analyst expectations. **What does get_sector_performance tell me about the market?** This tool gives a real-time snapshot of how all 11 major market sectors are performing. It returns change percentages, allowing you to quickly identify which industries are leading or lagging in today's trading session. **When should I use get_intraday_time_series instead of get_daily_time_series?** You need `get_intraday_time_series` when you are day trading or analyzing short-term volatility. This tool provides price data at granular intervals like 1, 5, or 15 minutes, which daily data cannot capture. **How do I use search_symbol if I don't know the correct stock ticker?** The `search_symbol` tool helps you find the precise symbol for any company. Simply provide keywords, and it returns best matches along with their type and region to ensure your subsequent price queries are accurate.