Servers Playground How we check Add a server Log in

Finnhub MCP by usefulapi

Working · 2.3 s

io.usefulapi/finnhubv1.21.0 Domain verified

Quotes, company profiles, fundamentals, earnings and IPO calendars, plus market and company news.

Finance & Payments

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://finnhub.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

finnhub_basic_financials Read-only

Key financial metrics for a company — valuation, margins, growth, per-share and 52-week ratios. Finnhub REST: GET /stock/metric.

symbolstring, required

Stock ticker symbol, e.g. 'AAPL' (required).

metricstring

Metric group to fetch — 'all' (default) returns every available metric.

Finnhub MCP by usefulapi MCP server | mcptry

Tools (15)

finnhub_basic_financials

Key financial metrics for a company — valuation, margins, growth, per-share and 52-week ratios. Finnhub REST: GET /stock/metric.

read-only

Argument	Type	Description
metric	string	Metric group to fetch — 'all' (default) returns every available metric.
symbol*	string	Stock ticker symbol, e.g. 'AAPL' (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "symbol"
  ],
  "properties": {
    "metric": {
      "type": "string",
      "description": "Metric group to fetch — 'all' (default) returns every available metric."
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Stock ticker symbol, e.g. 'AAPL' (required)."
    }
  }
}

finnhub_company_news

Latest company news for a symbol over a date range (up to 1 year back). Finnhub REST: GET /company-news.

read-only

Argument	Type	Description
to*	string	End date, yyyy-mm-dd (required).
from*	string	Start date, yyyy-mm-dd (required).
symbol*	string	Stock ticker symbol, e.g. 'AAPL' (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "symbol",
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End date, yyyy-mm-dd (required)."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start date, yyyy-mm-dd (required)."
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Stock ticker symbol, e.g. 'AAPL' (required)."
    }
  }
}

finnhub_company_profile

General company profile — name, country, currency, exchange, industry, market cap, share outstanding, IPO date, logo and more. Provide at least one of `symbol`, `isin` or `cusip`. Finnhub REST: GET /stock/profile2.

read-only

Argument	Type	Description
isin	string	ISIN identifier (use instead of symbol/cusip).
cusip	string	CUSIP identifier (use instead of symbol/isin).
symbol	string	Stock ticker symbol, e.g. 'AAPL'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "isin": {
      "type": "string",
      "description": "ISIN identifier (use instead of symbol/cusip)."
    },
    "cusip": {
      "type": "string",
      "description": "CUSIP identifier (use instead of symbol/isin)."
    },
    "symbol": {
      "type": "string",
      "description": "Stock ticker symbol, e.g. 'AAPL'."
    }
  }
}

finnhub_earnings_calendar

Upcoming and historical earnings release calendar, optionally filtered by date range and/or symbol. Finnhub REST: GET /calendar/earnings.

read-only

Argument	Type	Description
to	string	End date, yyyy-mm-dd (optional).
from	string	Start date, yyyy-mm-dd (optional).
symbol	string	Filter the calendar to a single symbol, e.g. 'AAPL'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End date, yyyy-mm-dd (optional)."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start date, yyyy-mm-dd (optional)."
    },
    "symbol": {
      "type": "string",
      "description": "Filter the calendar to a single symbol, e.g. 'AAPL'."
    }
  }
}

finnhub_earnings_surprises

Historical quarterly EPS surprises — actual vs. estimated EPS by period. Finnhub REST: GET /stock/earnings.

read-only

Argument	Type	Description
limit	integer	Limit the number of periods returned (most recent first).
symbol*	string	Stock ticker symbol, e.g. 'AAPL' (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "symbol"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Limit the number of periods returned (most recent first)."
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Stock ticker symbol, e.g. 'AAPL' (required)."
    }
  }
}

finnhub_insider_transactions

Insider transactions (Form 3/4/5 filings) for a company, optionally within a date range. Finnhub REST: GET /stock/insider-transactions.

read-only

Argument	Type	Description
to	string	End date, yyyy-mm-dd (optional).
from	string	Start date, yyyy-mm-dd (optional).
symbol*	string	Stock ticker symbol, e.g. 'AAPL' (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "symbol"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End date, yyyy-mm-dd (optional)."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start date, yyyy-mm-dd (optional)."
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Stock ticker symbol, e.g. 'AAPL' (required)."
    }
  }
}

finnhub_ipo_calendar

IPO calendar for a date range — upcoming and recent initial public offerings. Finnhub REST: GET /calendar/ipo.

read-only

Argument	Type	Description
to*	string	End date, yyyy-mm-dd (required).
from*	string	Start date, yyyy-mm-dd (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End date, yyyy-mm-dd (required)."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start date, yyyy-mm-dd (required)."
    }
  }
}

finnhub_market_news

General latest market news by category. Finnhub REST: GET /news.

read-only

Argument	Type	Description
minId	integer	Only return news with an id greater than this (pagination).
category	string	News category — 'general' (default), 'forex', 'crypto' or 'merger'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "minId": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Only return news with an id greater than this (pagination)."
    },
    "category": {
      "enum": [
        "general",
        "forex",
        "crypto",
        "merger"
      ],
      "type": "string",
      "description": "News category — 'general' (default), 'forex', 'crypto' or 'merger'."
    }
  }
}

finnhub_market_status

Current market open/closed status and session for an exchange. Finnhub REST: GET /stock/market-status.

read-only

Argument	Type	Description
exchange*	string	Exchange code, e.g. 'US' (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "exchange"
  ],
  "properties": {
    "exchange": {
      "type": "string",
      "minLength": 1,
      "description": "Exchange code, e.g. 'US' (required)."
    }
  }
}

finnhub_peers

Peer companies for a symbol (same country and GICS sub-industry). Finnhub REST: GET /stock/peers.

read-only

Argument	Type	Description
symbol*	string	Stock ticker symbol, e.g. 'AAPL' (required).
grouping	string	Peer grouping criterion, e.g. 'sector', 'industry' or 'subIndustry' (default).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Stock ticker symbol, e.g. 'AAPL' (required)."
    },
    "grouping": {
      "type": "string",
      "description": "Peer grouping criterion, e.g. 'sector', 'industry' or 'subIndustry' (default)."
    }
  }
}

finnhub_price_target

Analyst price targets for a symbol — high / low / median / mean target. Note: this is a premium-tier Finnhub endpoint (may return 403 on the free plan). Finnhub REST: GET /stock/price-target.

read-only

Argument	Type	Description
symbol*	string	Stock ticker symbol, e.g. 'AAPL' (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Stock ticker symbol, e.g. 'AAPL' (required)."
    }
  }
}

finnhub_quote

Real-time quote for a stock — current price (c), change (d), percent change (dp), high (h), low (l), open (o), previous close (pc) and unix timestamp (t). Finnhub REST: GET /quote.

read-only

Argument	Type	Description
symbol*	string	Stock ticker symbol, e.g. 'AAPL' (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Stock ticker symbol, e.g. 'AAPL' (required)."
    }
  }
}

finnhub_recommendation_trends

Analyst recommendation trends over time — counts of strong buy / buy / hold / sell / strong sell by period. Finnhub REST: GET /stock/recommendation.

read-only

Argument	Type	Description
symbol*	string	Stock ticker symbol, e.g. 'AAPL' (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Stock ticker symbol, e.g. 'AAPL' (required)."
    }
  }
}

finnhub_stock_symbols

List all symbols supported on an exchange. Finnhub REST: GET /stock/symbol.

read-only

Argument	Type	Description
mic	string	Filter by Market Identifier Code (MIC).
currency	string	Filter by trading currency, e.g. 'USD'.
exchange*	string	Exchange code, e.g. 'US' (required).
securityType	string	Filter by security type, e.g. 'Common Stock'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "exchange"
  ],
  "properties": {
    "mic": {
      "type": "string",
      "description": "Filter by Market Identifier Code (MIC)."
    },
    "currency": {
      "type": "string",
      "description": "Filter by trading currency, e.g. 'USD'."
    },
    "exchange": {
      "type": "string",
      "minLength": 1,
      "description": "Exchange code, e.g. 'US' (required)."
    },
    "securityType": {
      "type": "string",
      "description": "Filter by security type, e.g. 'Common Stock'."
    }
  }
}

finnhub_symbol_search

Search for stock symbols by name or ticker — returns best-matching symbols with descriptions and types. Finnhub REST: GET /search.

read-only

Argument	Type	Description
q*	string	Free-text query — a company name or ticker, e.g. 'apple' (required).
exchange	string	Restrict results to an exchange, e.g. 'US'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "description": "Free-text query — a company name or ticker, e.g. 'apple' (required)."
    },
    "exchange": {
      "type": "string",
      "description": "Restrict results to an exchange, e.g. 'US'."
    }
  }
}