finnhub

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

사용해야 할까요

품질 및 안전성

A
설명 품질
95%
스키마 완전성
98%
이름 품질
80%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,296토큰 (도구 정의)
~987 B일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.79%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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개