# Finnhub MCP for AI Agents AI Agent Connect

> Finnhub MCP lets your AI agent pull real-time stock quotes, crypto prices, and market news directly into your workflow. It turns your agent into a live financial analyst that can audit company profiles, track global symbols, and monitor forex or crypto trends without you having to switch tabs or manual search.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_cWEocGvZM0k6z18mu1o6nkY5EmmOYK5g4R0f3xRu/ai-agent-connect
- **Tags:** stock-market, cryptocurrency, financial-data, real-time-quotes, market-news, forex

## Description

Stop jumping between multiple tabs to check a ticker price or dig through news feeds for a specific crypto trend. This Connector connects your agent to live market data, allowing you to ask questions about any global stock or digital asset and get answers grounded in current reality. You can pull up a company's financial health or check the latest headlines in a specific category like forex or crypto. It takes the manual labor out of market auditing. When you use this with Vinkius, your agent becomes a first-class citizen in your research process, handling the heavy lifting of data gathering so you can focus on making decisions. Instead of copy-pasting data from a terminal, you just ask for the latest quote or a summary of a company's metrics. It's about having live data at your fingertips whenever you're working in your preferred AI client.

## Tools

### list_crypto_symbols
List supported crypto symbols for an exchange. Use this to verify which coins are available on a specific platform.

### get_basic_financials
Get basic financial metrics for a company. This pulls core stats like P/E ratios for quick valuation checks.

### get_market_news
Get latest market news in a category. This pulls headlines for specific areas like forex or crypto.

### get_company_profile
Get general information about a company by symbol. Use this to quickly see the core profile of a public entity.

### get_stock_quote
Get real-time quote data for a specific stock symbol. This provides the current price and daily movement.

### search_symbols
Search for stock or crypto symbols by name. This helps you find the correct ticker without guessing.

## Prompt Examples

**Prompt:** 
```
Get the current price for Tesla.
```

**Response:** 
```
### Tesla (TSLA) Live Quote

| Metric | Value |
| :--- | :--- |
| **Current Price** | $175.20 |
| **Day High** | $178.00 |
| **Day Low** | $173.50 |
| **Change** | +1.2% |

Would you like to see the basic financials or the latest news for TSLA?
```

**Prompt:** 
```
What's the news for crypto today?
```

**Response:** 
```
### Latest Crypto Market News

* **Bitcoin ETF Updates:** New filings show increased institutional interest.
* **Ethereum Upgrade:** Network scalability improvements are now live.
* **Market Sentiment:** General bullish sentiment across major exchanges.

Would you like me to find more news in a specific category?
```

**Prompt:** 
```
Give me the financials for Microsoft.
```

**Response:** 
```
### Microsoft (MSFT) Financial Metrics

* **P/E Ratio:** 35.2
* **Dividend Yield:** 0.72%
* **Market Status:** Active

I can also pull the full company profile if you need more details on their organizational health.
```

## Capabilities

### Pull real-time stock quotes
Get live price data and daily changes for global stocks instantly.

### Audit company profiles
Retrieve general information and organizational health metrics for any ticker.

### Search for stock or crypto symbols
Find the correct ticker or asset name using only the company name.

### List crypto symbols by exchange
See which digital assets are supported on specific cryptocurrency exchanges.

### Get basic financial metrics
Pull core data like P/E ratios and dividend yields for company analysis.

### Fetch market news by category
Get the latest headlines for forex, crypto, or general market news.

## Use Cases

### Checking multiple tickers for a portfolio
A trader asks their agent to get the current price for AAPL and MSFT. The agent uses get_stock_quote to provide a live comparison.

### Researching a new company for an investment thesis
An analyst asks for the P/E ratio and profile of a tech giant. The agent uses get_basic_financials and get_company_profile to summarize the data.

### Monitoring crypto news
A crypto enthusiast wants the latest headlines. The agent uses get_market_news to pull the latest updates on Bitcoin ETFs.

### Mapping out a crypto portfolio
A developer needs to know which coins are on a specific exchange. The agent uses list_crypto_symbols to provide a clean list.

## Benefits

- Get real-time stock quotes instantly with get_stock_quote instead of refreshing a browser tab.
- Audit company health using get_company_profile and get_basic_financials to see the numbers behind the brand.
- Track crypto trends across different exchanges by using list_crypto_symbols to see what is available.
- Stay on top of news with get_market_news to see headlines for forex or crypto as they happen.
- Find the right ticker for any company quickly with search_symbols to avoid manual searching.

## How It Works

The bottom line is your agent gets live market data feeds without any manual data entry from you.

1. Subscribe to this Connector on the Vinkius marketplace.
2. Enter your Finnhub API key in the configuration settings.
3. Ask your agent for live stock quotes or market news in any supported category.

## Frequently Asked Questions

**Can the Finnhub MCP track crypto prices?**
Yes, it pulls live prices for dozens of digital assets across various exchanges.

**Does the Finnhub MCP work for forex?**
Yes, it can pull the latest news and headlines specifically for the forex category.

**Can I use Finnhub MCP to find company tickers?**
Yes, you can search for stock or crypto symbols by using the company name.

**What kind of news does Finnhub MCP provide?**
It provides the latest headlines for general market news, forex, and cryptocurrency.

**Can I get basic stats for stocks with Finnhub MCP?**
Yes, it pulls core metrics like P/E ratios and dividend yields for quick valuation checks.

**Is the data from Finnhub MCP real-time?**
Yes, the Connector provides real-time quotes and live market news to keep your agent grounded in current data.

**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.