How to Connect Finnhub to ChatGPT via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Finnhub, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Finnhub + ChatGPT

Give your AI live market data from Finnhub: stock, forex and crypto quotes, company profiles and key financials, company and market news, analyst recommendations, earnings and IPO calendars, insider transactions, SEC filings and market status. Works on Finnhub's free plan; read-only.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

FINNHUB_API_KEY

Step 1 — Get credentials

Setting up takes about 1 minute. You need a Finnhub API key; the free plan covers every tool except price history candles.

1. Sign up at finnhub.io/register. It is free.
2. Open the Dashboard at finnhub.io/dashboard and copy the API key shown there.
3. Paste the key alone into FINNHUB_API_KEY, without token= or spaces. The connector sends it in the X-Finnhub-Token header, never in the URL.
4. Install the connector and run finnhub_get_market_status with exchange US: it tells you whether the US market is open right now and which session it is in.

What it reads: quotes for stocks, ETFs, forex and crypto; company profiles with market capitalisation and shares outstanding; key figures such as the 52-week high and low, beta, P/E, P/B, EPS, margins, ROE and dividend yield; company news and market news (general, forex, crypto, merger); peers; monthly analyst recommendations; earnings surprises and the earnings calendar; the IPO calendar; insider transactions and insider sentiment; financial statements as reported to the SEC and the list of SEC filings; market status and holidays; and the symbol lists of forex providers and crypto exchanges.

Symbols first: the AI resolves the ticker with finnhub_search_symbols, by company name, symbol, ISIN or CUSIP. US tickers are plain, such as AAPL; other exchanges have a suffix, such as SAP.DE or VOD.L. Forex and crypto quotes use the exchange symbol, such as OANDA:EUR_USD or BINANCE:BTCUSDT, which the AI looks up with finnhub_list_forex_symbols or finnhub_list_crypto_symbols.

Reading the numbers: quote fields are short: c current, d change, dp percent change, h high, l low, o open, pc previous close, t time in Unix seconds. Market capitalisation and shares outstanding are in millions. Dates are YYYY-MM-DD. Reported financials are large answers, so the AI narrows finnhub_get_financials_reported with a from and to date.

Free plan: every tool works except finnhub_get_stock_candles (price history), which needs a paid plan and answers 403 on free keys; there the AI uses finnhub_get_quote and the 52-week figures of finnhub_get_basic_financials instead. Some data is shorter on free keys: company news goes one year back, earnings surprises cover the last 4 quarters, and the earnings calendar one month back plus upcoming dates. Real-time quotes cover US stocks; other markets need a paid plan.

Read-only: every tool only reads. The connector places no orders and moves no money, so there is nothing to confirm and no tool is switched off at install.

Limits: the free plan allows 60 calls a minute and 30 a second. After a 429 the AI waits a minute, and it prefers one targeted call over many broad ones.

Common errors: 401 means Finnhub refused the key: copy it again from the dashboard. 403 "You don't have access to this resource" means the key works, but that data is not on your plan. 429 means the per-minute limit was reached.

Not investment advice: market data is information. When you ask what to buy or sell, the AI shows you the numbers and tells you it is not investment advice.

The connector does not trade, place orders, connect to a brokerage account or read your portfolio.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in ChatGPT

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.

1. Go to chatgpt.com/plugins, click +, then Add custom MCP server.
2. Enter a name, e.g. Name: Finnhub.
3. Under Connection, enter the Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID and keep Authentication on OAuth.
4. Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
5. Install the new plugin from your personal plugins, then type @ in a chat and pick it.

Available tools

Example prompts

• "What is Apple trading at right now, and how much has it moved today?"
• "Compare the P/E ratio, margins and dividend yield of Microsoft, Alphabet and Amazon."
• "Which companies report earnings next week, and what EPS do analysts expect?"
• "Have Nvidia insiders been buying or selling shares over the last three months?"
• "Give me the latest news on Tesla and what analysts have recommended over the past few months."

FAQ

Does the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.

Next steps

• Connector landing page
• Connect to Claude
• Connect to Cursor
• Connect to Gemini
• Connect to Meta Muse