# Finnhub MCP > Finnhub: Access real-time financial data and market news directly through your AI client. This server lets your agent run financial audits, fetch live stock quotes, check crypto symbols, and review company profiles without you leaving your chat window. It's a full financial research terminal, built for AI. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** stock-market, cryptocurrency, financial-data, real-time-quotes, market-news, forex ## Description **Finnhub MCP Server - Real-time Stock & Crypto Data** Your agent hooks up to Finnhub, giving it a full financial research terminal. You don't gotta click through dashboards anymore; you just ask your AI client to run the numbers, check live quotes, or grab market news. It's built to handle complex financial audits straight in your chat window. **Get Live Stock Pricing** Your agent grabs the real-time quote data for any specific stock symbol. You'll see the current price and how much it's moved that day. **`get_stock_quote`** does this. You can also search for potential stock or crypto symbols by name using **`search_symbols`**. You can list all supported crypto symbols for a given exchange with **`list_crypto_symbols`**. **`get_basic_financials`** pulls basic financial metrics for a company based on its stock symbol. **`get_company_profile`** gets general info about a company using its stock symbol. **`get_market_news`** returns the latest market news articles based on a specified category. Your agent combines these tools so you can ask complex questions, like what's the news on Apple and what are its basic financials. You'll get a combined answer. ## Tools ### get_basic_financials Retrieves basic financial metrics for a company using its stock symbol. ### get_company_profile Gets general information about a company using its stock symbol. ### get_market_news Retrieves the latest market news articles based on a specified category. ### get_stock_quote Gets the real-time quote data for a specific stock symbol. ### list_crypto_symbols Lists all supported crypto symbols for a specified exchange. ### search_symbols Searches for potential stock or crypto symbols by entering a name. ## Prompt Examples **Prompt:** ``` Get the current stock quote for 'AAPL' (Apple) using Finnhub. ``` **Response:** ``` I've retrieved the quote for AAPL! The current price is $185.20, with a daily high of $186.50. The change for the day is +1.5%. Would you like to see the company profile or basic financials? ``` **Prompt:** ``` Show the latest news in the 'crypto' category. ``` **Response:** ``` I've retrieved the latest crypto market news. Notable headlines include updates on Bitcoin ETFs and new Ethereum upgrades. I can provide the links to the full articles if you'd like. ``` **Prompt:** ``` What are the basic financial metrics for 'MSFT' (Microsoft)? ``` **Response:** ``` I've retrieved the financial metrics for Microsoft. Notable data includes a P/E ratio of 35.2 and a current dividend yield. I can provide the full breakdown of valuation and profitability markers if you'd like. ``` ## Capabilities ### Get Live Stock Pricing The agent retrieves real-time quote data for a specific stock symbol, including current price and daily movement. ### Audit Corporate Metrics The agent pulls basic financial metrics and general information about a company using its stock symbol. ### Track Market News The agent searches and returns the latest market news articles based on a specified category. ### Discover Financial Symbols The agent searches for new stock or crypto symbols by name or lists all supported symbols for a given crypto exchange. ### Understand Company Profiles The agent retrieves general background information and key facts about a company using its symbol. ## Use Cases ### Checking a Stock's Health After an Earnings Call A financial analyst needs to know if a company's recent earnings report is reflected in the market. They prompt their agent: 'Show me the latest news for AAPL, and what are its basic financials?' The agent runs `get_market_news` and `get_basic_financials`, giving the analyst a full picture of sentiment and metrics immediately. ### Comparing a New Crypto Project A quant researcher is vetting a new digital asset. They use `search_symbols` to find the asset's ticker, then `list_crypto_symbols` to confirm the exchange listing, followed by `get_stock_quote` to see its current market price. This confirms the asset's liquidity and status. ### Researching a Brand New Company An investment strategist encounters a company name. They use `search_symbols` to find the ticker, then `get_company_profile` to learn what the company does. Finally, they run `get_basic_financials` to see if the company has established financial metrics. ### Monitoring Market Trends During a Crisis An operations lead needs to track multiple global assets during high volatility. They ask the agent to pull news from the 'forex' category (`get_market_news`) and simultaneously check the quotes for three different stocks using `get_stock_quote`. ## Benefits - Stop leaving your chat window. You get real-time data (like the current price from `get_stock_quote`) and company reports (using `get_basic_financials`) without opening a new tab. - Cross-reference everything. Ask the agent to pull market news (`get_market_news`) and then compare it to the company profile (`get_company_profile`) for instant context. - Streamline asset discovery. Instead of guessing symbols, use `search_symbols` to find any stock or crypto asset by name, then use `get_stock_quote` to check its price. - Maintain full market visibility. `list_crypto_symbols` lets you quickly audit dozens of crypto exchanges, ensuring you don't miss any key digital asset data. - Consolidate research. Your agent handles the whole workflow—from checking a symbol using `search_symbols` to getting its financial history using `get_basic_financials`—all in one prompt. ## How It Works The bottom line is: you tell your agent what data you need, and it runs the specific financial tool to get the answer. 1. Subscribe to the Finnhub server and input your API Key. 2. Your AI client sends a natural language prompt to the agent. 3. The agent selects and executes the necessary tool (e.g., `get_stock_quote` or `get_company_profile`) and returns the structured data. ## Frequently Asked Questions **How do I use the `get_stock_quote` tool with Finnhub?** You just tell your agent the ticker you want. For example, 'Get the current stock quote for TSLA.' The agent handles the tool call and returns the live price and daily changes. **Is Finnhub better than just looking at a website for market news?** Yes. Instead of browsing, you ask the agent to run `get_market_news` for a specific category. It pulls structured, filtered headlines and summaries directly into your conversation. **What is the difference between `get_company_profile` and `get_basic_financials`?** `get_company_profile` gives general background info—what the company is. `get_basic_financials` gives numbers—the P/E ratio, revenue, and other measurable metrics. **Can I find crypto symbols using the Finnhub MCP Server?** Yes. You can use `search_symbols` to find a crypto asset by name, or `list_crypto_symbols` to see all available symbols for a specific exchange. **How do I handle rate limits when using the `get_stock_quote` tool?** The server adheres to standard API rate limits. If you hit a limit, your AI client will receive a 429 status code, which you should handle with an exponential backoff strategy. You'll need to implement retries to manage high-frequency calls. **Can I use `get_market_news` to filter by a specific time range?** Currently, the `get_market_news` tool retrieves the latest available articles. While you can't specify a start or end date in the tool call, you can filter the resulting list of articles using your AI client's logic. **What information does `get_company_profile` return about a company's operations?** The `get_company_profile` tool provides general company data, such as the company's description, sector, and website. It's useful for understanding the company's general business scope and market positioning. **How do I find a symbol to use with `get_basic_financials` if I only know the company name?** Use the `search_symbols` tool first. This searches for stock or crypto symbols by name, giving you the necessary identifier to then feed into `get_basic_financials` or other data tools. **How do I find my Finnhub API Key?** Log in to your [**Finnhub dashboard**](https://finnhub.io/dashboard), and you will find your API Key on the main page. Copy and paste it below. **Does it support real-time stock prices?** Yes. The `get_stock_quote` tool provides real-time pricing data for supported exchanges globally. **Can the agent show news for a specific category?** Yes. Use the `get_market_news` tool providing the `category` parameter (e.g., 'forex' or 'crypto'). Your agent will retrieve latest headlines for that vertical instantly.