# Alpha Vantage MCP > Alpha Vantage provides instant access to real-time and historical financial data, including stock prices, company fundamentals (balance sheets, income statements), global economic metrics like GDP and CPI, and cryptocurrency rates. Turn your AI client into an expert analyst that pulls deep market intelligence directly from conversation. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** stock-market, financial-data, market-intelligence, equity-research, economic-indicators ## Description If you need market data—the kind used for valuation models or quantitative research—you don't want to jump between dozen websites or download endless CSVs. This MCP gives your agent a direct connection to global financial records, treating it like an internal database you can talk to. The toolset lets you pull everything from intraday price action on major equities to quarterly balance sheets for any listed company. Need to know how the latest CPI reading affects oil futures? You just ask, and the agent accesses both the economic indicator data and the commodity exchange rates. This capability is available through Vinkius's catalog, making it easy to connect this power source to your preferred AI client without messy API scripting. It’s about having a single point of truth for market analysis, whether you are tracking Bitcoin volatility or modeling Apple's cash flow projections. ## Tools ### get_balance_sheet Retrieves a company’s annual or quarterly balance sheets to show its assets, liabilities, and equity. ### get_cash_flow Provides annual and quarterly cash flow statements, tracking how money moves in and out of the business. ### time_series_daily_adjusted Retrieves daily OHLCV time series adjusted for corporate actions like dividends or splits. ### time_series_daily Gets the daily open, high, low, close, and volume data for a stock ticker. ### get_digital_currency_daily Fetches daily time series data for a specific cryptocurrency. ### get_economic_indicator Pulls macroeconomic figures like GDP, CPI, and unemployment rates for a given region. ### get_currency_exchange_rate Gets the current exchange rate between any two physical or digital currencies. ### get_income_statement Retrieves annual or quarterly income statements detailing revenue, costs, and profit. ### time_series_intraday Pulls high-resolution, minute-by-minute trading data for a stock ticker. ### time_series_monthly_adjusted Retrieves monthly OHLCV time series adjusted for corporate actions. ### time_series_monthly Gets the monthly open, high, low, close, and volume data for a stock ticker. ### get_news_sentiment Analyzes historical or live news articles to provide a sentiment score for a company or market. ### get_overview Gathers basic company details and calculates key financial ratios from the available data. ### get_sma Calculates a Simple Moving Average (SMA) technical indicator over specified periods. ### time_series_weekly_adjusted Retrieves weekly OHLCV time series adjusted for corporate actions like dividends or splits. ### time_series_weekly Gets the weekly open, high, low, close, and volume data for a stock ticker. ## Prompt Examples **Prompt:** ``` Show me the intraday price action for IBM with 5-minute intervals. ``` **Response:** ``` I've retrieved the 5-minute intraday data for IBM. The latest price is $182.45 (at 15:55:00). The volume for the last interval was 124,500 shares. Would you like to see the trend for the last hour? ``` **Prompt:** ``` Get the latest income statement and balance sheet for Apple (AAPL). ``` **Response:** ``` Fetching financial statements for AAPL... In the last fiscal year, Apple reported total revenue of $383.28B with a net income of $96.99B. Their balance sheet shows total assets of $352.58B. Should I break down the quarterly figures? ``` **Prompt:** ``` What are the current economic indicators for US GDP and inflation? ``` **Response:** ``` Accessing economic indicators... The latest Real GDP growth rate is 3.4% (annualized), and the Consumer Price Index (CPI) shows a year-over-year inflation rate of 3.2%. Would you like to see the historical trend for either of these? ``` ## Capabilities ### Fetch specific financial reports Retrieve annual and quarterly balance sheets, income statements, and cash flow reports for companies. ### Track historical stock price movements Get daily, weekly, monthly, or even intraday OHLCV data for global equities. ### Monitor macroeconomic shifts Access key economic metrics like GDP growth rates and Consumer Price Index figures. ### Analyze crypto and currency movements Get real-time exchange rates for physical currencies and daily time series data for digital assets. ### Gauge market sentiment and trends Pull historical news sentiment scores or calculate technical indicators like the Simple Moving Average (SMA). ## Use Cases ### Valuing a growth stock after an earnings report The analyst asks their agent to retrieve `get_income_statement` and `get_balance_sheet` for the company. Next, they ask for `get_overview` to calculate key ratios; this gives them a complete financial picture without opening Excel. ### Assessing market risk during an economic downturn The agent pulls the latest GDP data using `get_economic_indicator`, then compares that trend against the weekly adjusted price action for key indices using `time_series_weekly_adjusted` to gauge systemic risk. ### Developing a crypto trading model The quant asks for daily time series data on Bitcoin via `get_digital_currency_daily`, calculates the Simple Moving Average (SMA) using `get_sma`, and then checks related fiat exchange rates with `get_currency_exchange_rate`. ### Comparing asset performance across sectors The portfolio manager compares a tech stock's intraday volatility (`time_series_intraday`) against the overall market sentiment score pulled via `get_news_sentiment` to make an informed allocation decision. ## Benefits - You instantly get full corporate financials. Instead of searching for three different filings, you ask the agent to run `get_balance_sheet` and `get_income_statement`, getting both in one go. - Complex time series analysis is simplified. Need a high-resolution view? Use `time_series_intraday`. Want a quarterly check? Run `time_series_monthly`. The right data granularity is always available. - Macro trends inform micro decisions. You can compare the current CPI rate using `get_economic_indicator` against historical stock performance using any of the `time_series_*` tools. - Global asset tracking becomes simple. Track a local currency's movement via `get_currency_exchange_rate`, then pivot to seeing how that affects a crypto market index via `get_digital_currency_daily`. - You move beyond raw numbers. The ability to run `get_news_sentiment` adds crucial context, letting you know if the financial data is supported by public mood. ## How It Works The bottom line is, your AI client treats market data like an internal spreadsheet, instantly accessible via conversation. 1. Subscribe to this MCP and provide your Alpha Vantage API Key. 2. Connect it to your AI client via Vinkius. Your agent now has access to global financial data endpoints. 3. Ask a natural language question, like 'What was AAPL's net income last year?' or 'Show me the weekly trend for TSLA.' The agent executes the necessary calls and gives you the answer. ## Frequently Asked Questions **How do I find a company's full financial health report using get_balance_sheet?** You use `get_balance_sheet` to retrieve the annual or quarterly statement. This shows total assets, liabilities, and equity, giving you a clear view of its balance. **Can I track Bitcoin prices using get_digital_currency_daily?** Yes, `get_digital_currency_daily` fetches the daily time series data for any cryptocurrency. This gives you historical price points crucial for modeling volatility. **What is the best tool for seeing a stock's recent price movement?** If you need high detail, use `time_series_intraday`. If you just need a quick check of daily prices, `time_series_daily` works great. **How do I compare economic indicators with stock data?** You combine `get_economic_indicator` (for macro stats like GDP) with any time series tool. The agent helps you build the correlation in a single prompt. **Does get_overview give me enough information for valuation?** It gives ratios and basic company overviews, but for deep valuation, always run `get_cash_flow` and `get_income_statement` as well. You need the full picture. **What should I do if I hit rate limits when calling get_economic_indicator?** When you exceed the allowed call limit, your agent will receive an API error message. You must implement back-off logic into your workflow or check the documentation for usage quotas. This prevents service disruption and ensures reliable data retrieval. **Should I use time_series_daily or time_series_daily_adjusted when analyzing stock history?** You should always prefer using time_series_daily_adjusted for historical analysis. The adjusted data automatically accounts for corporate actions like dividends and stock splits, giving you an accurate record of the true performance over time. **How can I combine get_news_sentiment with other tools to analyze a company?** You process these tools sequentially. First, run get_news_sentiment on a ticker symbol; then, feed that resulting sentiment score into your agent's prompt alongside the data from get_overview for immediate correlation. **Can I get intraday stock prices for a specific time interval?** Yes. Use the `time_series_intraday` tool and specify the `interval` (e.g., '1min', '5min', '60min'). You can also toggle `extended_hours` to see pre-market and after-hours data. **How do I access a company's financial health and ratios?** You can use `get_overview` for general ratios and metadata, or `get_income_statement`, `get_balance_sheet`, and `get_cash_flow` for detailed annual and quarterly financial reports. **Does this server support sentiment analysis for market news?** Yes! The `get_news_sentiment` tool provides real-time news articles along with sentiment scores and relevance rankings for specific stock symbols or topics.