finnhub

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

我该使用它吗

质量与安全性

A
描述质量
95%
模式完整度
98%
命名质量
80%
投毒风险
100%
权限匹配度
100%
协议合规性
100%

基于对工具定义和协议合规性的自动分析。

上下文开销

~2,296token 数(工具定义)
~987 B典型响应大小
对注意力有中等影响(占 128k 上下文窗口的 1.79%)

这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。

安装

一键安装

将以下内容添加到你的 `claude_desktop_config.json` 文件中:

{
  "mcpServers": {
    "finnhub": {
      "url": "https://finnhub.usefulapi.io/mcp"
    }
  }
}

远程端点

https://finnhub.usefulapi.io/mcpstreamable-http

它能做什么

工具清单

工具(15)

🟢 只读🟡 写入🔴 删除⚪ 未知
🟢finnhub_quote(symbol)

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.

输入模式

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Stock ticker symbol, e.g. 'AAPL' (required)."
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢finnhub_symbol_search(q, exchange)

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

输入模式

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

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.

输入模式

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "Stock ticker symbol, e.g. 'AAPL'.",
      "type": "string"
    },
    "isin": {
      "description": "ISIN identifier (use instead of symbol/cusip).",
      "type": "string"
    },
    "cusip": {
      "description": "CUSIP identifier (use instead of symbol/isin).",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢finnhub_company_news(symbol, from, to)

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

输入模式

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

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

输入模式

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

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

输入模式

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

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

输入模式

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Stock ticker symbol, e.g. 'AAPL' (required)."
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢finnhub_earnings_surprises(symbol, limit)

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

输入模式

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

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.

输入模式

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Stock ticker symbol, e.g. 'AAPL' (required)."
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢finnhub_peers(symbol, grouping)

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

输入模式

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

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

输入模式

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Stock ticker symbol, e.g. 'AAPL' (required)."
    },
    "from": {
      "description": "Start date, yyyy-mm-dd (optional).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "End date, yyyy-mm-dd (optional).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢finnhub_stock_symbols(exchange, mic, securityType, currency)

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

输入模式

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

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

输入模式

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "minLength": 1,
      "description": "Exchange code, e.g. 'US' (required)."
    }
  },
  "required": [
    "exchange"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢finnhub_earnings_calendar(from, to, symbol)

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

输入模式

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

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

输入模式

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

社区

评价此服务器

证据

最近观测

已验证未记录版本15 个工具