# Finnhub MCP > Finnhub connects your AI client to real-time financial data for instant market auditing. Check live quotes for thousands of global stocks, track crypto movements across exchanges, and monitor breaking news across general, forex, and crypto categories, all through natural conversation. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** stock-market, cryptocurrency, financial-data, real-time-quotes, market-news, forex ## Description Need to audit a company's standing or check the latest Bitcoin ETF updates without opening ten different browser tabs? Finnhub lets your agent act like a dedicated financial analyst. You simply ask your AI client for what you need—say, 'What are the basic financials for MSFT?'—and it pulls the live data immediately. It handles everything from retrieving real-time stock quotes to searching for relevant crypto symbols and compiling market news reports across different categories. This means complex market analysis stops being a chore of manual searches. When you connect Finnhub through Vinkius, your agent gets an instant connection to global financial intelligence, making sure every decision is grounded in the absolute latest numbers. ## Tools ### list_crypto_symbols Retrieves a list of supported cryptocurrency symbols for a specified exchange. ### get_basic_financials Gathers fundamental financial metrics and data points for any given company. ### get_market_news Fetches the latest market news headlines based on a specified category (e.g., forex, general). ### get_company_profile Provides general background information and details about a company using its stock symbol. ### get_stock_quote Gets the current, real-time price quote data for any specific global stock symbol. ### search_symbols Searches across markets to find potential stock or crypto symbols using a name query. ## 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 real-time stock quotes Retrieves current price data and market metrics for specific global stocks. ### Audit company financial health Pulls basic financial metrics and general corporate information using a company's symbol. ### Search and identify assets Finds stock or crypto symbols by name to determine if an asset is supported for tracking. ### Monitor market news Gathers the latest headlines from specified market categories, like general news or forex updates. ### Track cryptocurrency data Lists supported crypto symbols across various exchanges for digital asset tracking. ## Use Cases ### Investigating a new market sector A junior analyst wants to see what the general sentiment is around clean energy. They ask their agent to use get_market_news for the 'general' category, then run search_symbols to find key company names in that space. Finally, they request the current quote for those symbols using get_stock_quote to build a quick market overview. ### Auditing a startup's viability A venture capitalist needs to vet two companies quickly. They first run get_company_profile on both, then use get_basic_financials for each to compare metrics like revenue and market cap side-by-side in the chat window. ### Tracking a volatile crypto play A trader wants to know which altcoins are supported on Binance. They use list_crypto_symbols first, then ask for get_stock_quote and basic financials for the top three candidates found, all without leaving their primary workspace. ### Preparing a cross-functional investment report The operations lead needs to gather data on a global portfolio. They start by running search_symbols for multiple tickers, then use get_market_news across 'forex' and 'general' categories to provide context before finalizing the report. ## Benefits - Get immediate price context. Instead of opening a terminal, you ask for the quote using get_stock_quote, and your agent provides the current price, daily high, and change instantly. - Understand company fundamentals fast. You can run basic financials on any organization with get_basic_financials, giving you metrics like P/E ratio without leaving your workflow. - Stay informed about trends. Use get_market_news to pull the latest headlines across entire categories (like crypto or forex), keeping you updated instantly. - Map out assets quickly. If you're unsure of a symbol, search_symbols helps you find it by name before requesting data. It saves time and prevents lookup errors. - Manage digital assets efficiently. list_crypto_symbols lets your agent check every supported crypto symbol for an exchange, ensuring no digital asset is missed during auditing. ## How It Works The bottom line is that you talk about financial data in plain English, and the MCP handles all the complex API calls behind the scenes. 1. First, subscribe to the Finnhub MCP and supply your unique API key. 2. Next, connect this MCP to your preferred AI client like Claude or Cursor. 3. Finally, simply ask your agent a question—like 'Show me the quote for AAPL'—and it executes the data pull instantly. ## Frequently Asked Questions **How do I get real-time stock quotes using Finnhub MCP?** You simply ask your agent for a quote and provide the ticker symbol. The system executes the get_stock_quote tool, giving you the current price and daily change immediately. **Can I check crypto symbols with Finnhub MCP?** Yes, use list_crypto_symbols to see all supported assets on a given exchange. This helps ensure you don't miss any important digital currency data. **What is the difference between get_company_profile and get_basic_financials?** get_company_profile gives general background info about the company, while get_basic_financials pulls specific quantitative metrics like P/E ratios or dividend yield. **Does Finnhub MCP include forex news?** Yes. You can use get_market_news and specify 'forex' as the category to pull the latest foreign exchange market headlines directly into your workflow. **Is this good for tracking multiple symbols? (Finnhub MCP)** Absolutely. You don't have to run commands individually; you can prompt your agent to check quotes and profiles for a list of tickers, consolidating the results into one readable response.