Finnhub MCP Server

Overview

What it does

Access comprehensive financial market data and news powered by the Finnhub API. Get real-time stock quotes, company profiles, financial metrics, analyst recommendations, and market news through natural language in NimbleBrain Studio.Key Features:

Real-time stock quotes with pricing and volume data
Company profiles and business information
Financial metrics including P/E ratios, ROE, margins
Analyst recommendation trends over time
Market news across multiple categories

Use Cases

Perfect for building AI-powered financial assistants and market analysis tools without any coding required.Examples:

Portfolio performance tracking and monitoring
Investment research and company analysis
Market sentiment analysis from news
Stock comparison and valuation screening
Analyst consensus tracking
Real-time market alerts and notifications

Quick Start

Get Your API Key

60 API calls/minute
Real-time US stock data
Company profiles and basic financials
Market news across categories
Analyst recommendations

Copy your API key from the dashboard - you’ll need it in the next step.

Add to NimbleBrain Studio

In NimbleBrain Studio:

Navigate to MCP Servers in the sidebar
Click Add Server
Search for “Finnhub” in the server registry
Click Configure
Paste your API key in the FINNHUB_API_KEY field
Click Save & Enable

The server will automatically connect and become available in your AI assistant within seconds.

Test the Connection

In your Studio chat, try this prompt:

"What's the current stock price of Apple (AAPL)?"

You should see real-time quote data including current price, change, percent change, high, low, open, previous close, and timestamp.

Look for the 🔧 tool usage indicator in Studio to confirm the server is working correctly.

Available Tools

get_stock_quote

Get real-time stock quote data including current price, change, volume, and trading metrics for any stock symbol.Parameters:

Parameter	Type	Required	Description
symbol	string	Yes	Stock ticker symbol (e.g., AAPL, MSFT, GOOGL)
api_key	string	No	Override default API key (rarely needed)

Returns: JSON object containing:

current_price - Current trading price
change - Dollar change from previous close
percent_change - Percentage change from previous close
high - Today’s high price
low - Today’s low price
open - Opening price
previous_close - Previous day’s closing price
timestamp - Quote timestamp
retrieved_at - When the data was fetched

Example Usage:

"What's the current price of Tesla stock?"

Example Response:

{
  "symbol": "TSLA",
  "current_price": 242.84,
  "change": 5.22,
  "percent_change": 2.20,
  "high": 245.50,
  "low": 238.12,
  "open": 240.00,
  "previous_close": 237.62,
  "timestamp": "2025-01-15T20:00:00",
  "retrieved_at": "2025-01-15T20:15:30.123456+00:00"
}

This tool is perfect for portfolio tracking in Studio. You can request multiple quotes in a single prompt: “Show me current prices for AAPL, MSFT, and GOOGL”

get_company_profile

Get detailed company information including business description, market cap, industry, and corporate details for any publicly traded company.Parameters:

Parameter	Type	Required	Description
symbol	string	Yes	Stock ticker symbol (e.g., AAPL, MSFT, GOOGL)
api_key	string	No	Override default API key (rarely needed)

Returns: JSON object containing:

name - Company name
country - Country of incorporation
currency - Trading currency
exchange - Stock exchange (e.g., NASDAQ, NYSE)
industry - Finnhub industry classification
logo - URL to company logo
market_cap - Market capitalization
phone - Corporate phone number
share_outstanding - Outstanding shares
ticker - Stock ticker symbol
web_url - Company website
ipo_date - Initial public offering date
retrieved_at - When the data was fetched

Example Usage:

"Tell me about Microsoft - what industry are they in and what's their market cap?"

Example Response:

{
  "symbol": "MSFT",
  "name": "Microsoft Corporation",
  "country": "US",
  "currency": "USD",
  "exchange": "NASDAQ",
  "industry": "Technology",
  "logo": "https://static2.finnhub.io/file/publicdatany/finnhubimage/stock_logo/MSFT.png",
  "market_cap": 2847000,
  "phone": "14258828080",
  "share_outstanding": 7432.64,
  "ticker": "MSFT",
  "web_url": "https://www.microsoft.com",
  "ipo_date": "1986-03-13",
  "retrieved_at": "2025-01-15T20:15:30.123456+00:00"
}

Use this tool in Studio for investment research and company due diligence. Combine it with get_basic_financials for a complete company overview.

get_basic_financials

Get comprehensive financial metrics and ratios including profitability, valuation, efficiency, and liquidity measures for fundamental analysis.Parameters:

Parameter	Type	Required	Description
symbol	string	Yes	Stock ticker symbol (e.g., AAPL, MSFT, GOOGL)
metric	string	No	Metric type (default: “all”)
api_key	string	No	Override default API key (rarely needed)

Returns: JSON object containing key_metrics with:

52_week_high - Highest price in past 52 weeks
52_week_low - Lowest price in past 52 weeks
beta - Stock volatility vs market
pe_ratio - Price-to-earnings ratio (TTM)
eps - Earnings per share (TTM)
market_cap - Market capitalization
dividend_yield - Current dividend yield (TTM)
roe - Return on equity (TTM)
roa - Return on assets (TTM)
debt_to_equity - Debt to equity ratio (quarterly)
current_ratio - Current ratio (quarterly)
gross_margin - Gross profit margin (TTM)
operating_margin - Operating margin (TTM)
net_margin - Net profit margin (TTM)

Example Usage:

"Show me Apple's financial metrics including P/E ratio, margins, and returns"

Example Response:

{
  "symbol": "AAPL",
  "key_metrics": {
    "52_week_high": 199.62,
    "52_week_low": 164.08,
    "beta": 1.24,
    "pe_ratio": 29.34,
    "eps": 6.42,
    "market_cap": 2940000,
    "dividend_yield": 0.51,
    "roe": 1.47,
    "roa": 0.27,
    "debt_to_equity": 1.78,
    "current_ratio": 0.98,
    "gross_margin": 0.44,
    "operating_margin": 0.30,
    "net_margin": 0.26
  },
  "all_metrics_available": true,
  "total_metrics": 67,
  "retrieved_at": "2025-01-15T20:15:30.123456+00:00"
}

Use financial metrics in Studio to compare companies in the same industry. For example: “Compare the P/E ratios and profit margins of AAPL, MSFT, and GOOGL”

get_recommendation_trends

Get analyst recommendation trends showing buy, hold, and sell ratings over time from financial analysts covering the stock.Parameters:

Parameter	Type	Required	Description
symbol	string	Yes	Stock ticker symbol (e.g., AAPL, MSFT, GOOGL)
api_key	string	No	Override default API key (rarely needed)

Returns: JSON object containing:

recommendations - Array of recommendation periods with:
- period - Time period (e.g., “2025-01”)
- strong_buy - Number of strong buy ratings
- buy - Number of buy ratings
- hold - Number of hold ratings
- sell - Number of sell ratings
- strong_sell - Number of strong sell ratings
periods_available - Number of periods with data
retrieved_at - When the data was fetched

Example Usage:

"What are analysts saying about NVIDIA? Show me the recommendation trends."

Example Response:

{
  "symbol": "NVDA",
  "recommendations": [
    {
      "period": "2025-01",
      "strong_buy": 28,
      "buy": 12,
      "hold": 5,
      "sell": 0,
      "strong_sell": 0
    },
    {
      "period": "2024-12",
      "strong_buy": 27,
      "buy": 11,
      "hold": 6,
      "sell": 1,
      "strong_sell": 0
    }
  ],
  "periods_available": 2,
  "retrieved_at": "2025-01-15T20:15:30.123456+00:00"
}

Track changes in analyst sentiment over time in Studio to identify shifting market consensus. A change from hold to buy ratings can signal improving fundamentals.

get_market_news

Get latest market news articles from multiple sources across different categories including general market, forex, crypto, and merger news.Parameters:

Parameter	Type	Required	Description
category	string	No	News category: “general”, “forex”, “crypto”, “merger” (default: “general”)
min_id	string	No	Minimum news ID for pagination (default: “0”)
api_key	string	No	Override default API key (rarely needed)

Returns: JSON object containing:

news - Array of up to 10 news articles with:
- headline - Article headline
- summary - Article summary/description
- url - Full article URL
- datetime - Publication timestamp
- source - News source
- category - Article category
category - Requested category
count - Number of articles returned
timestamp - When the data was fetched

Example Usage:

"What's the latest general market news?"

Example Response:

{
  "news": [
    {
      "headline": "Fed Signals Potential Rate Cut in March",
      "summary": "Federal Reserve officials indicated openness to cutting interest rates as inflation shows signs of moderating...",
      "url": "https://example.com/article/123",
      "datetime": "2025-01-15T14:30:00",
      "source": "Reuters",
      "category": "general"
    },
    {
      "headline": "Tech Stocks Rally on Strong Earnings",
      "summary": "Major technology stocks surged today following better-than-expected quarterly earnings reports...",
      "url": "https://example.com/article/124",
      "datetime": "2025-01-15T13:15:00",
      "source": "Bloomberg",
      "category": "general"
    }
  ],
  "category": "general",
  "count": 10,
  "timestamp": "2025-01-15T20:15:30.123456+00:00"
}

Use different categories in Studio to track specific market segments. Try: “Show me the latest crypto news” or “What’s happening in merger and acquisition news?”

Authentication

API Key Required: This server requires a Finnhub API key to function.

Getting Your API Key

Create a free account at finnhub.io/register
Verify your email address
Copy your API key from the dashboard
Add it to your Studio server configuration

Rate Limits

Plan	Requests/Minute	Features
Free	60	Real-time US stocks, basic data
Starter	300	+ International stocks, extended data
Professional	600	+ Premium data feeds, priority support

If you exceed rate limits, requests will fail with a 429 error. Monitor your usage in Studio’s server settings and consider upgrading your Finnhub plan for production use.

Managing Your API Key in Studio

Your API key is securely stored in NimbleBrain Studio. To update it:

Go to Settings → MCP Servers
Find “Finnhub” in your server list
Click Edit Configuration
Update your API key in the FINNHUB_API_KEY field
Click Save

Studio automatically manages server connections - no manual restarts required. Changes take effect immediately.

Example Workflows

Portfolio Tracking
Company Research
Market Screening
News Monitoring
Sentiment Analysis

Scenario: Monitor your investment portfolio in real-timePrompt:

"Show me current prices and today's performance for AAPL, GOOGL, MSFT, and TSLA"

What happens:

Retrieves real-time quotes for all 4 stocks
Calculates daily change ($ and %)
Shows volume and trading status
Presents data in an easy-to-read format

Time: ~2 seconds API calls: 4

You can track up to 10 stocks in a single prompt in Studio without hitting rate limits on the free tier.

All examples work in NimbleBrain Studio’s natural language interface - no code or configuration required!

Troubleshooting

Rate Limit Exceeded

Error Message:

429 Too Many Requests - API rate limit exceeded

Cause: You’ve exceeded 60 requests/minute (free tier)Solutions:

Wait 1 minute before making more requests
Upgrade to a paid Finnhub plan (300 or 600 requests/minute)
Reduce the number of stocks you’re tracking simultaneously
Space out your requests over time in Studio conversations

To check your usage:

Go to Studio Settings → MCP Servers
Click on Finnhub
View API usage metrics

Studio shows real-time API usage. Consider upgrading your Finnhub plan if you frequently hit limits during market hours.

Invalid API Key

Error Message:

401 Unauthorized - Invalid API key

Cause: API key is missing, incorrect, or expiredSolutions:

Verify your API key in Studio server settings
Check for extra spaces or characters when you pasted it
Regenerate your API key from the Finnhub dashboard
Ensure your Finnhub account is active and email verified

To update in Studio:

Settings → MCP Servers → Finnhub
Click Edit Configuration
Paste your new API key in FINNHUB_API_KEY field
Click Save
Test with a simple query like “What’s AAPL stock price?”

Studio validates your API key automatically when you save. You’ll see a success message if it’s correct.

Symbol Not Found

Error Message:

Symbol not found or invalid

Cause: Invalid ticker symbol or the stock is not available in Finnhub’s databaseSolutions:

Verify the ticker symbol is correct (e.g., AAPL not APPLE)
Use the company name instead: “What’s Apple’s stock price?” (Studio will find the symbol)
Check if the symbol is listed on a supported exchange
Try alternative ticker formats (e.g., BRK.B for Berkshire Hathaway Class B)

Common Mistakes:

Using company name as symbol: “APPLE” instead of “AAPL”
Wrong exchange suffix: “AAPL.US” instead of “AAPL”
Delisted or merged companies
International stocks not in free tier

Let Studio’s AI help! Ask: “What’s the ticker symbol for Tesla?” before requesting detailed data.

Server Not Responding

Error Message:

Server connection timeout or Server not responding

Cause: Studio cannot connect to the Finnhub MCP serverSolutions:

Check your internet connection
Verify the server is enabled in Studio (Settings → MCP Servers)
Try disabling and re-enabling the server in Studio
Check Studio status page for any service interruptions
Refresh your Studio browser tab

Quick Fix in Studio:

Go to Settings → MCP Servers
Find Finnhub in the list
Toggle it Off, wait 5 seconds
Toggle it On again
Try your query again

Studio manages all server infrastructure automatically - there’s no local setup or Docker containers to troubleshoot.

Data Unavailable

Error Message:

Data not available for this symbol/timeframe

Cause: Some data requires paid Finnhub plans or isn’t available for certain stocksFree tier limitations:

US stocks only (NYSE, NASDAQ)
Basic fundamentals
Limited historical data
No international exchanges

Solutions:

Verify the stock is actively traded on US exchanges
Check if your plan includes the requested data type
Try requesting data for major stocks (AAPL, MSFT, GOOGL) as a test
Upgrade to a paid Finnhub plan for extended data access

To upgrade:

Visit finnhub.io/pricing
Choose a plan (Starter or Professional)
Update your API key in Studio if it changes

Most common US stocks work perfectly on the free tier. Upgrade only if you need international stocks or advanced data feeds.

Slow Response Times

Symptoms:

Queries taking longer than 5 seconds
Studio showing “thinking” indicator for extended periods
Intermittent timeouts

Possible Causes:

Finnhub API experiencing high load
Network connectivity issues
Requesting too much data at once

Solutions:

Break large queries into smaller ones
Avoid requesting 10+ stocks simultaneously
Check Finnhub status at status.finnhub.io
Try again during off-peak market hours
Clear Studio cache (Settings → Clear Cache)

Expected Response Times in Studio:

Single stock quote: 1-2 seconds
Company profile: 1-2 seconds
Financial metrics: 2-3 seconds
News articles: 2-3 seconds
Multi-stock comparison: 3-5 seconds

Studio automatically retries failed requests. If you see consistent slowness, check the Finnhub status page or contact support.

Links & Resources

GitHub Repository

View source code, report issues, and contribute to the project

Finnhub API Documentation

Official Finnhub API reference, data coverage, and features

NimbleBrain Studio

Access your Studio workspace and manage MCP servers

Report Issues

Found a bug or have a feature request? Submit an issue on GitHub

Alpha Vantage

Alternative financial data with forex and crypto support

Yahoo Finance

Historical market data, options chains, and free data access

CoinGecko

Cryptocurrency prices and comprehensive crypto market data

Need help? Join the NimbleBrain Discord or email [email protected]

Get Started

Core Features

Developer Tools

Overview

What it does

Use Cases

Quick Start

Available Tools

Authentication

Getting Your API Key

Rate Limits

Managing Your API Key in Studio

Example Workflows

Troubleshooting

Links & Resources

GitHub Repository

Finnhub API Documentation

NimbleBrain Studio

Report Issues

Alpha Vantage

Yahoo Finance

CoinGecko

Get Started

Core Features

Developer Tools

​Overview

What it does

Use Cases

​Quick Start

​Available Tools

​Authentication

​Getting Your API Key

​Rate Limits

​Managing Your API Key in Studio

​Example Workflows

​Troubleshooting

​Links & Resources

GitHub Repository

Finnhub API Documentation

NimbleBrain Studio

Report Issues

​Related MCP Servers

Alpha Vantage

Yahoo Finance

CoinGecko

Overview

Quick Start

Available Tools

Authentication

Getting Your API Key

Rate Limits

Managing Your API Key in Studio

Example Workflows

Troubleshooting

Links & Resources

Related MCP Servers