FinQuest Korea Stocks & Bonds MCP
An MCP server providing access to Korean stock and bond data, including DART filings, segment trends, earnings drivers, dividends, prices, and bonds. It allows agents to query financial metrics, search filings, and analyze business trends using standardized data from the Financial Supervisory Service.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://mcp.finquest.space/public/mcpWhat its tools do
20 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to finquest.space ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Query why a company's operating profit increased using official disclosure sentences
- Search for companies citing specific reasons like 'price increase' in their reports
- Analyze quarterly financials including revenue, operating profit, and ROE
- Search bond details and interest payment schedules
Source and maintenance
Protocol and capabilities
- Server
- finquest-dart 1.0.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 20 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
20 advertised
search — 종목 찾기
[국내 주식·채권 MCP] 종목 찾기 (이름·코드·업종·그룹명·테마). 종목코드를 모를 때 먼저. 테마어('방산', '2차전지')는 사업 설명에 그 말이 많이 나오는 회사 순.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string",
"description": "검색어. 비우면 시총 상위"
}
}
}{
"title": "종목 찾기",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}rank — 순위
[국내 주식·채권 MCP] 순위 — 전 종목을 한 지표로 줄 세우기: 시가총액·배당수익률·주당배당·배당성향·자사주 소각/매입(최근 1년)·주주환원수익률·매출·영업이익·순이익·영업이익률·ROE·성장률·부채비율·PER·PBR·주가 수익률. 시장·업종·테마(예: '방산', '2차전지')로 좁힐 수 있음. '배당 많이 주는 회사', '자사주 소각 많이 한 회사', 'ROE 높은 회사' 같은 질문에.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"by"
],
"properties": {
"by": {
"enum": [
"mcap",
"div_yield",
"dps",
"payout",
"cancel_12m",
"buyback_12m",
"sh_yield",
"rev",
"op",
"ni",
"opm",
"roe",
"rev_growth",
"op_growth",
"debt_ratio",
"per",
"pbr",
"ret_1m",
"ret_1y"
],
"type": "string",
"description": "줄 세울 지표"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"theme": {
"type": "string",
"description": "테마 — 사업 설명에 그 말이 나오는 회사만 (예: '방산', '2차전지', 'HBM')"
},
"market": {
"enum": [
"KOSPI",
"KOSDAQ"
],
"type": "string"
},
"max_per": {
"type": "number",
"description": "PER 상한"
},
"min_opm": {
"type": "number",
"description": "영업이익률(%) 하한"
},
"min_roe": {
"type": "number",
"description": "ROE(%) 하한 — 예: 'ROE 높고 PER 낮은' 은 by='per' + min_roe=15"
},
"industry": {
"type": "string",
"description": "업종 이름 일부 (예: '은행', '반도체')"
},
"min_mcap": {
"type": "number",
"description": "시가총액 하한(억원). 기본: 비율·배당 순위는 1,000억"
},
"ascending": {
"type": "boolean",
"description": "낮은 순 (PER·PBR·부채비율은 기본 낮은 순)"
},
"min_div_yield": {
"type": "number",
"description": "배당수익률(%) 하한"
},
"max_debt_ratio": {
"type": "number",
"description": "부채비율(%) 상한"
}
}
}{
"title": "순위",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}company — 종목 한눈에
[국내 주식·채권 MCP] 종목 한눈에 — 특정 종목 질문은 여기서 시작. 최근 정기보고서로 본 사업부문 구성(매출·영업이익·비중), 분기 실적 추이, 회사가 밝힌 최근 실적 변동 이유(원문 인용 + DART 링크), 사업 개요, 배당·자사주, 다가오는 배당 기준일. 모두 DART 공시 기반.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stock"
],
"properties": {
"stock": {
"type": "string",
"description": "종목코드(6자리) 또는 종목명. 예: '005930', '삼성전자'"
}
}
}{
"title": "종목 한눈에",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}earnings — 실적 변동 이유
[국내 주식·채권 MCP] 실적이 왜 바뀌었나 — 한 분기 실적 분석(DART 정기보고서 기반). 연결 매출·영업이익·순이익의 YoY·QoQ, 부문별 매출·영업이익 증감, 회사가 정기보고서에 쓴 변동 이유(원문 문장 + 출처 [S#] + DART 링크). '영업이익이 왜 늘었어?' 같은 질문에 사용.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stock"
],
"properties": {
"stock": {
"type": "string",
"description": "종목코드(6자리) 또는 종목명. 예: '005930', '삼성전자'"
},
"period": {
"type": "string",
"description": "기간. 분기 '2026Q2'(또는 '2Q26'), 월 '2026.06', 연간 '2025'. 생략하면 최신"
}
}
}{
"title": "실적 변동 이유",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}business_trend — 사업 지표 추이
[국내 주식·채권 MCP] 사업 지표 추이 — 여러 정기보고서를 이어 붙인 분기/연간 시계열 (분기 값이 없으면 누적에서 계산). topic: sales(매출 상세 — 부문·품목·매출유형·내수/수출·지역) · segment_pl(부문 매출·영업이익·자산) · sales_volume(판매 물량) · sales_price(판매 가격) · customers(주요 고객) · channel(판매경로) · backlog(수주) · market_share(점유율) · market_size(시장 규모) · capacity/production/utilization(생산능력·실적·가동률) · raw_material_purchase/raw_material_price(원재료 매입·가격) · capex(시설투자) · rnd(연구개발비) · kpi(운영 지표) · 주석: segment · product_sales · region_sales · revenue_disagg · cost_by_nature · sga · inventory. topic 을 비우면 그 회사에 있는 topic 목록.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stock"
],
"properties": {
"dim": {
"type": "string",
"description": "부문·제품·지역 이름 필터 (예: 'DS', 'HBM', '미주')"
},
"freq": {
"enum": [
"Q",
"FY"
],
"type": "string",
"description": "Q=분기(기본), FY=연간"
},
"item": {
"type": "string",
"description": "항목 필터 (예: '매출액', '영업이익', '가동률', '판매량')"
},
"stock": {
"type": "string",
"description": "종목코드(6자리) 또는 종목명. 예: '005930', '삼성전자'"
},
"topic": {
"type": "string"
},
"where": {
"type": "string",
"description": "차원=값 조건, 쉼표로 여러 개 (예: '판매지역=수출', '품목=RV, 기준=연결'). 차원: 부문·품목·매출유형·판매지역·지역·국가·고객·판매경로·법인·사업장·원재료·기준(연결/별도)·상태(계획/전망)"
},
"periods": {
"type": "integer",
"maximum": 40,
"minimum": 2,
"description": "최근 몇 기간 (기본 분기 9 / 연간 6)"
}
}
}{
"title": "사업 지표 추이",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}filing — 정기보고서 읽기
[국내 주식·채권 MCP] 정기보고서(사업·반기·분기) 공시 정리본 읽기 — 표준 양식으로 정리된 표·회사 설명·실적 변동 이유, 모든 숫자에 출처 [S#]. sections 로 필요한 부분만: drivers(변동 이유), segment, product_sales, region_sales, cost_by_nature, sga, inventory, raw_materials, capacity, production, utilization, capex, rnd, market_share, backlog, texts(회사 설명·MD&A), check(검증). list=true 면 정리된 보고서 목록.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stock"
],
"properties": {
"list": {
"type": "boolean"
},
"stock": {
"type": "string",
"description": "종목코드(6자리) 또는 종목명. 예: '005930', '삼성전자'"
},
"period": {
"type": "string",
"description": "기간. 분기 '2026Q2'(또는 '2Q26'), 월 '2026.06', 연간 '2025'. 생략하면 최신"
},
"sections": {
"type": "array",
"items": {
"type": "string"
}
},
"max_chars": {
"type": "integer",
"maximum": 150000,
"minimum": 2000,
"description": "최대 글자 수 (기본 40000)"
}
}
}{
"title": "정기보고서 읽기",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_filings — 공시 문장 검색
[국내 주식·채권 MCP] 전 종목 정기보고서 문장 검색 — 회사가 직접 쓴 실적 변동 이유(전 기간), MD&A, 최신 보고서의 사업·산업 설명. 예: 'HBM', '가동률 하락', '판가 인상', '환율 효과'. 어떤 회사들이 어떤 이유를 대는지 찾을 때.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"sort": {
"enum": [
"recent",
"relevance"
],
"type": "string",
"description": "기본: 실적 변동 이유는 최신순, 사업 설명은 관련도순"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string",
"description": "검색어 (3글자 이상이면 전문검색, 공백은 AND)"
},
"since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "이 날짜 이후 기간 끝 (YYYY-MM-DD)"
},
"stock": {
"type": "string",
"description": "이 종목만"
},
"topic": {
"enum": [
"drivers",
"mdna",
"business"
],
"type": "string",
"description": "drivers=실적 변동 이유, mdna=경영진단, business=사업·산업 설명"
},
"metric": {
"type": "string",
"description": "실적 변동 이유 중 이 지표만 (예: '영업이익', '매출액')"
},
"direction": {
"enum": [
"증가",
"감소"
],
"type": "string",
"description": "실적 변동 이유 중 이 방향만 (예: 원자재 가격 때문에 이익이 '감소')"
},
"per_company": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "회사당 최대 결과 수 (기본 2 — 한 회사가 결과를 다 차지하지 않게)"
}
}
}{
"title": "공시 문장 검색",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}financials — 재무 추이
[국내 주식·채권 MCP] 재무 추이 (억원, DART 정기보고서 주요계정 2015~). freq=A: 연간 매출·영업이익·순이익·성장률·이익률·자산·부채·자본·부채비율·ROE. freq=Q: 분기 매출·영업이익·순이익의 YoY·QoQ(4분기는 연간 − 3분기 누적). 둘 다 DART 전체 재무제표의 영업현금흐름·설비투자·FCF·배당 지급·자사주 취득·현금·차입금·순현금(모으는 중).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stock"
],
"properties": {
"freq": {
"enum": [
"A",
"Q"
],
"type": "string",
"description": "A=연간(기본), Q=분기"
},
"stock": {
"type": "string",
"description": "종목코드(6자리) 또는 종목명. 예: '005930', '삼성전자'"
},
"years": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"statement": {
"enum": [
"IS",
"BS",
"CF"
],
"type": "string"
}
}
}{
"title": "재무 추이",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}price — 주가 흐름
[국내 주식·채권 MCP] 주가·지수 흐름 — 일별 종가 기준 기간 수익률, 지수 대비 초과수익, 최대낙폭(MDD), 변동성, 고저 + 봉 데이터 [날짜,시가,고가,저가,종가,거래량]. index 로 KOSPI/KOSDAQ/KOSPI200. 출처 금융위원회 공공데이터(KRX), 다음 영업일 반영(장중 실시간 아님). 분할·병합은 보정.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "종료일"
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "시작일"
},
"index": {
"enum": [
"KOSPI",
"KOSDAQ",
"KOSPI200"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 3000,
"minimum": 1,
"description": "최근 N봉 (기본 120)"
},
"stock": {
"type": "string",
"description": "종목코드(6자리) 또는 종목명. 예: '005930', '삼성전자'"
},
"interval": {
"enum": [
"d",
"w",
"m"
],
"type": "string",
"description": "d=일(기본), w=주, m=월 — 1년 넘으면 w·m 권장"
},
"intraday": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "이 날짜 1분봉 (YYYY-MM-DD)"
},
"realtime": {
"type": "boolean"
}
}
}{
"title": "주가 흐름",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}screen — 조건 검색·순위
[국내 주식·채권 MCP] 조건 검색·순위 — 전 종목(약 2,650)을 지표 여러 개로 거르고, 원하는 지표로 줄 세우거나, 여러 지표를 가중 점수로 합쳐 순위를 매긴다. 주가는 금융위 시세, 재무는 DART 정기보고서 주요계정, 배당·자사주는 공시, 사업 지표는 사업보고서. 금액 억원, 비율 %. 칸(col): 기본: market(시장), industry(업종) / 주가: close(종가, 원), mcap(시가총액, 억원), chg(등락률, %), ret_1w(1주 수익률, %), ret_1m(1개월 수익률, %), ret_3m(3개월 수익률, %), ret_6m(6개월 수익률, %), ret_1y(1년 수익률, %), ret_ytd(연초 대비 수익률, %), high_52w(52주 최고(종가), 원), low_52w(52주 최저(종가), 원), from_high(52주 최고 대비, %), from_low(52주 최저 대비, %), ma20_gap(20일 이동평균 대비, %), ma60_gap(60일 이동평균 대비, %), ma200_gap(200일 이동평균 대비, %), rsi14(RSI(14)), vol_60d(변동성(60일, 연환산), %), mdd_1y(1년 최대낙폭, %), value_20d(하루 평균 거래대금(20일), 억원), value_ratio(거래대금 증가, 배) / 밸류: per(PER, 배), pbr(PBR, 배), psr(PSR, 배), por(POR, 배) / 규모: fy(최근 사업연도), rev(매출(최근 사업연도), 억원), op(영업이익(최근 사업연도), 억원), ni(순이익(최근 사업연도), 억원), rev_ttm(매출(최근 4분기), 억원), op_ttm(영업이익(최근 4분기), 억원), ni_ttm(순이익(최근 4분기), 억원), assets(자산총계, 억원), equity(자본총계, 억원) / 수익성: opm(영업이익률(최근 사업연도), %), npm(순이익률(최근 사업연도), %), roe(ROE(최근 사업연도), %), opm_ttm(영업이익률(최근 4분기), %), roe_ttm(ROE(최근 4분기), %), roa(ROA(최근 4분기), %), gpm(매출총이익률(최근 사업연도), %) / 성장: rev_growth(매출 성장률(전년), %), op_growth(영업이익 성장률(전년), %), ni_growth(순이익 성장률(전년), %), rev_cagr_3y(매출 3년 연평균 성장률, %), op_cagr_3y(영업이익 3년 연평균 성장률, %), ni_cagr_3y(순이익 3년 연평균 성장률, %), rev_cagr_5y(매출 5년 연평균 성장률, %), rev_up_years(매출 연속 증가, 년), profit_years(영업흑자 연속, 년) / 분기: q_end(최근 분기(끝)), q_filed(최근 분기 보고서 제출일), rev_q(분기 매출, 억원), op_q(분기 영업이익, 억원), ni_q(분기 순이익, 억원), opm_q(분기 영업이익률, %), rev_yoy_q(분기 매출 YoY, %), op_yoy_q(분기 영업이익 YoY, %), ni_yoy_q(분기 순이익 YoY, %), rev_qoq(분기 매출 QoQ, %), op_qoq(분기 영업이익 QoQ, %), op_turn(분기 영업이익 흑자·적자), op_up_streak(분기 영업이익 연속 증가(YoY), 분기), rev_up_streak(분기 매출 연속 증가(YoY), 분기) / 안정성: debt_ratio(부채비율, %), net_cash(순현금, 억원), net_cash_pct(순현금 ÷ 시총, %) / 현금흐름: cfo(영업현금흐름(최근 4분기), 억원), capex(설비투자(최근 4분기), 억원), fcf(잉여현금흐름(최근 4분기), 억원), fcf_yield(FCF 수익률, %), cfo_ni(영업현금흐름 ÷ 순이익, 배) / 주주환원: dps(주당배당(최근 1년), 원), div_yield(배당수익률, %), payout(배당성향, %), div_years(배당 연속, 년), div_up_years(배당 연속 증가, 년), buyback_12m(자사주 매입(최근 1년), 억원), cancel_12m(자사주 소각(최근 1년), 억원), sh_yield(주주환원수익률, %) / 사업 지표: export_share(수출(해외) 매출 비중, %), top_customer_share(최대 고객 매출 비중, %), utilization(평균 가동률, %), asp_yoy(판매가격 전년 대비, %), raw_price_yoy(원재료 가격 전년 대비, %), backlog_to_sales(수주잔고 ÷ 연간 매출, 배), backlog_yoy(수주잔고 전년 대비, %), volume_yoy(판매 물량 전년 대비, %), capacity_yoy(생산능력 전년 대비, %), production_yoy(생산실적 전년 대비, %), capex_plan(향후 투자 계획, 억원), capex_plan_to_sales(투자 계획 ÷ 연간 매출, %), rnd_ratio(연구개발비 / 매출, %), market_share(시장점유율(당사), %). 예: filters [{col:'per',op:'between',value:0,value2:10},{col:'op_yoy_q',op:'>=',value:30}], sort 'roe' / score [{col:'per'},{col:'roe'}] (PER 낮고 ROE 높은 순). PER·PBR·부채비율·변동성은 기본 낮은 순.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"desc": {
"type": "boolean",
"description": "true=높은 순. 생략하면 칸에 맞게 (PER 등은 낮은 순)"
},
"sort": {
"type": "string",
"description": "정렬 칸 (기본 mcap, score 를 주면 점수)"
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "기본 30"
},
"score": {
"type": "array",
"items": {
"type": "object",
"required": [
"col"
],
"properties": {
"col": {
"type": "string"
},
"high": {
"type": "boolean",
"description": "높을수록 좋음 (기본: PER·PBR·PSR·POR·부채비율·변동성만 낮을수록)"
},
"weight": {
"type": "number",
"description": "가중치 (기본 1)"
}
}
},
"maxItems": 8,
"description": "여러 지표를 합친 점수 순위 — 조건을 통과한 종목 안의 백분위를 가중 평균(0~100)"
},
"theme": {
"type": "string",
"description": "테마 — 사업 설명에 그 말이 많이 나오는 회사 (예: '방산', '2차전지', 'HBM', '원전')"
},
"market": {
"enum": [
"KOSPI",
"KOSDAQ"
],
"type": "string"
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"columns": {
"type": "array",
"items": {
"type": "string"
},
"description": "보여 줄 칸 (생략하면 조건·정렬 칸 + 주요 지표)"
},
"filters": {
"type": "array",
"items": {
"type": "object",
"required": [
"col",
"op"
],
"properties": {
"op": {
"enum": [
">",
">=",
"<",
"<=",
"=",
"!=",
"between",
"in",
"like",
"notnull"
],
"type": "string"
},
"col": {
"type": "string"
},
"value": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "array",
"items": {
"type": [
"number",
"string"
]
}
}
]
},
"value2": {
"type": "number"
}
}
},
"description": "조건 — 모두 만족(AND). 문자 칸(market·industry·op_turn·q_end)은 =·in·like"
},
"industry": {
"type": "string",
"description": "업종 이름 일부 (예: '반도체', '은행', '제약') — 업종 목록은 sectors"
},
"min_mcap": {
"type": "number",
"description": "시가총액 하한(억원)"
}
}
}{
"title": "조건 검색·순위",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}sectors — 업종 한눈에
[국내 주식·채권 MCP] 업종 한눈에 — 거래소 업종별 회사 수·시가총액·수익률(1·3개월·1년, 시총 가중)·합산 PER·PBR·영업이익률·최근 분기 매출/영업이익 증감(전년 같은 분기 합계 대비)·시총 상위 회사. industry 를 주면 그 업종 요약 + 회사 목록. '어느 업종 실적이 좋아지나', '반도체 업종 PER', '업종별 수익률' 같은 질문에.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"sort": {
"enum": [
"mcap",
"n",
"ret_1m",
"ret_3m",
"ret_1y",
"per",
"pbr",
"opm_ttm",
"rev_yoy_q",
"op_yoy_q",
"rev_growth"
],
"type": "string",
"description": "업종 표 정렬 (기본 mcap). per·pbr 은 낮은 순"
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"market": {
"enum": [
"KOSPI",
"KOSDAQ"
],
"type": "string"
},
"industry": {
"type": "string",
"description": "업종 이름 (예: '전기·전자', '제약', '은행'). 생략하면 전 업종 표"
}
}
}{
"title": "업종 한눈에",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}earnings_season — 분기 실적 시즌
[국내 주식·채권 MCP] 분기 실적 시즌 — 한 분기(기본: 가장 최근 보고 분기)에 실적을 낸 전 종목을 모아 합계(매출·영업이익 YoY, 증익 회사 비율, 흑자전환·적자전환 수), 업종별 영업이익 증감 상·하위, 그리고 종목 목록(영업이익·매출·순이익 YoY·QoQ, 이익률, 제출일, DART 링크). kind 로 증익·감익·흑자전환·적자전환만, by 로 정렬. '이번 분기 실적 좋은 회사', '흑자전환한 회사', '3분기 실적 시즌 어땠어' 같은 질문에.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"by": {
"enum": [
"op_diff",
"op_yoy",
"rev_yoy",
"ni_yoy",
"op_qoq",
"rev_qoq",
"op",
"rev",
"ni",
"opm",
"filed"
],
"type": "string",
"description": "정렬 — op_diff(영업이익 증감액, 기본)·op_yoy·rev_yoy·ni_yoy·op_qoq·rev_qoq·op·rev·ni·opm·filed(최근 제출 순)"
},
"kind": {
"enum": [
"all",
"growth",
"decline",
"turnaround",
"to_loss"
],
"type": "string",
"description": "all(기본) · growth(영업이익 증가) · decline(감소) · turnaround(흑자전환) · to_loss(적자전환)"
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"theme": {
"type": "string",
"description": "테마 (예: '방산', '2차전지')"
},
"market": {
"enum": [
"KOSPI",
"KOSDAQ"
],
"type": "string"
},
"period": {
"type": "string",
"description": "분기 — '2026Q3', '3Q26', '2026-09'. 생략하면 가장 최근 보고 분기"
},
"industry": {
"type": "string",
"description": "업종 이름 일부"
},
"min_mcap": {
"type": "number",
"description": "시가총액 하한(억원). 증감률 정렬은 기본 1,000억"
}
}
}{
"title": "분기 실적 시즌",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}price_events — 주가 이벤트
[국내 주식·채권 MCP] 주가 이벤트 찾기 — 최근 N거래일(기본 5) 동안 전 종목에서 일어난 일: high_52w(52주 신고가(종가)), low_52w(52주 신저가(종가)), golden_cross(20일선이 60일선 위로), dead_cross(20일선이 60일선 아래로), volume_spike(거래대금 급증), up_streak(연속 상승), down_streak(연속 하락), limit_up(상한가(+29.5% 이상)), limit_down(하한가(-29.5% 이하)). event 를 비우면 이벤트별 건수와 상위 5건씩. '52주 신고가 종목', '거래량 터진 종목', '골든크로스 난 종목', '며칠째 오르는 종목' 같은 질문에. 일별 종가 기준(장중 아님).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"days": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "최근 몇 거래일 (기본 5)"
},
"event": {
"enum": [
"high_52w",
"low_52w",
"golden_cross",
"dead_cross",
"volume_spike",
"up_streak",
"down_streak",
"limit_up",
"limit_down"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"ratio": {
"type": "number",
"description": "volume_spike 기준 배수 (기본 3 = 60일 평균의 3배)"
},
"theme": {
"type": "string"
},
"market": {
"enum": [
"KOSPI",
"KOSDAQ"
],
"type": "string"
},
"streak": {
"type": "integer",
"maximum": 20,
"minimum": 2,
"description": "up_streak·down_streak 최소 일수 (기본 5)"
},
"industry": {
"type": "string"
},
"min_mcap": {
"type": "number",
"description": "시가총액 하한(억원, 기본 500)"
},
"min_value": {
"type": "number",
"description": "하루 평균 거래대금 하한(억원, 기본 1)"
}
}
}{
"title": "주가 이벤트",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}disclosures — 수시공시
[국내 주식·채권 MCP] 수시공시 찾기 — 정기보고서 말고 주가에 직접 영향을 주는 공시를 분류별 핵심 내용과 함께 (OpenDART 원문 서식에서 정리, 원문 링크). 분류: 공급계약, 잠정실적, 유상증자, CB발행, BW발행, EB발행, 가액조정, 권리행사, 실적전망, 최대주주변경, 최대주주지분, 합병분할, 양수도, 시설투자, 주식수변동, 소송, 위험(실적전망 = 회사가 낸 실적 가이던스, 최대주주지분 = 최대주주측 소유주식 변동, 위험 = 관리종목·거래정지·상장폐지 우려·감사의견·횡령배임·회생 등, '(자회사)' 는 종속회사 사항). 종목을 주면 그 회사(기본 최근 3년), 없으면 시장 전체(기본 최근 30일). query 로 원문 검색(예: '특허', '현대차'), min_amount·sort=amount 로 큰 계약·증자만. '최근 대규모 수주', '소송 걸린 회사', 'CB 발행 많이 한 회사', '이 회사 최근 공시' 같은 질문에.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "종료일"
},
"cats": {
"type": "array",
"items": {
"enum": [
"공급계약",
"잠정실적",
"유상증자",
"CB발행",
"BW발행",
"EB발행",
"가액조정",
"권리행사",
"실적전망",
"최대주주변경",
"최대주주지분",
"합병분할",
"양수도",
"시설투자",
"주식수변동",
"소송",
"위험"
],
"type": "string"
},
"description": "분류 (여러 개 가능, 생략하면 전부)"
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "시작일"
},
"sort": {
"enum": [
"date",
"amount",
"ratio"
],
"type": "string",
"description": "date(기본, 최신순) · amount(금액 큰 순) · ratio(공급계약의 매출 대비 비율 큰 순)"
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 60,
"description": "원문 검색어 (공백으로 여러 개 = 모두 포함)"
},
"stock": {
"type": "string",
"description": "종목코드(6자리) 또는 종목명. 예: '005930', '삼성전자'"
},
"market": {
"enum": [
"KOSPI",
"KOSDAQ"
],
"type": "string"
},
"corrected": {
"type": "boolean",
"description": "정정 공시 포함 (기본 뺌)"
},
"min_amount": {
"type": "number",
"description": "금액 하한(억원) — 계약·증자·사채 권면·양수도·투자·소송 청구 금액"
}
}
}{
"title": "수시공시",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}stake_changes — 지분 변동
[국내 주식·채권 MCP] 지분 변동 — 5% 대량보유 보고(연기금·운용사 등)와 임원·주요주주 소유 보고. 종목을 주면 그 회사 보고 이력(보고자·직위·보유·증감·비율·사유), 없으면 시장 전체에서 최근 N일 늘어난·줄어든 지분을 금액(증감 주식 × 현재 종가) 순으로. '최근 임원이 많이 산 회사', '국민연금이 지분 늘린 회사', '이 회사 대주주 지분 변화' 같은 질문에. 출처 OpenDART.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"days": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "시장 전체: 최근 며칠 (기본 30)"
},
"kind": {
"enum": [
"대량보유",
"임원·주요주주"
],
"type": "string",
"description": "생략하면 둘 다"
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"stock": {
"type": "string",
"description": "종목코드(6자리) 또는 종목명. 예: '005930', '삼성전자'"
},
"market": {
"enum": [
"KOSPI",
"KOSDAQ"
],
"type": "string"
},
"min_mcap": {
"type": "number",
"description": "시가총액 하한(억원)"
},
"direction": {
"enum": [
"buy",
"sell",
"both"
],
"type": "string",
"description": "시장 전체: 늘어남·줄어듦·둘 다(기본)"
}
}
}{
"title": "지분 변동",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}calendar — 일정
[국내 주식·채권 MCP] 배당 일정 — 배당기준일·배당지급·주주명부기준일(DART 공시 기준, 공시 링크 포함). 종목 생략 시 시장 전체.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "종료일"
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "시작일 (기본 오늘)"
},
"kinds": {
"type": "array",
"items": {
"enum": [
"배당기준일",
"배당지급",
"주주명부기준일",
"정기주총",
"임시주총",
"실적발표"
],
"type": "string"
}
},
"limit": {
"type": "integer",
"maximum": 2000,
"minimum": -9007199254740991
},
"stock": {
"type": "string",
"description": "종목코드(6자리) 또는 종목명. 예: '005930', '삼성전자'"
}
}
}{
"title": "일정",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}shareholders — 주주와 환원
[국내 주식·채권 MCP] 주주와 환원 — returns: 연도별 DPS·배당총액·자사주 취득/처분/소각, 배당·자사주 결정 공시 / ownership: 연도별 최대주주측 지분 변화(사업보고서). 기본 둘 다. 모두 DART 공시 기반.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stock"
],
"properties": {
"stock": {
"type": "string",
"description": "종목코드(6자리) 또는 종목명. 예: '005930', '삼성전자'"
},
"years": {
"type": "integer",
"maximum": 11,
"minimum": 1,
"description": "지분 이력 최근 N년 (기본 5)"
},
"section": {
"enum": [
"returns",
"ownership",
"all"
],
"type": "string"
}
}
}{
"title": "주주와 환원",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}bonds — 회사채 찾기
[국내 주식·채권 MCP] 장내 회사채·금융채 찾기 (KRX 상장, 만기 전). 발행사·종목명, 상장사 종목, 수익률·표면이율·잔존기간·등급·후순위·지급월·유동성 조건. 결과: 표면이율(coupon %), 이자주기(cycle_m)·지급일·지급월, 1만원당 1회 이자(coupon_10k), 다음 이자일, 만기·잔존년수, 등급, 마지막 체결 가격(액면 1만원당)·수익률, 최근 20거래일 체결일수 — 체결이 드문 종목의 수익률은 극단값일 수 있음.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"kind": {
"enum": [
"일반회사채",
"금융채",
"유동화SPC채",
"유사집합투자기구채"
],
"type": "string"
},
"rank": {
"enum": [
"선순위",
"후순위"
],
"type": "string"
},
"sort": {
"enum": [
"last_yield",
"coupon",
"years_left",
"grade_rank",
"balance",
"trade_days_20",
"next_coupon"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 300,
"minimum": 1
},
"query": {
"type": "string",
"description": "종목명·발행사명·ISIN 일부"
},
"stock": {
"type": "string",
"description": "상장 발행사 — 그 회사 채권만"
},
"cycle_m": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 6
},
{
"type": "number",
"const": 12
}
],
"description": "이자 주기(개월): 1=매월 이자, 3=분기"
},
"ascending": {
"type": "boolean"
},
"max_years": {
"type": "number",
"description": "잔존 기간(년) 상한"
},
"max_yield": {
"type": "number"
},
"min_grade": {
"enum": [
"AAA",
"AA+",
"AA",
"AA-",
"A+",
"A",
"A-",
"BBB+",
"BBB",
"BBB-",
"BB+",
"BB",
"BB-",
"B+",
"B",
"B-"
],
"type": "string",
"description": "이 등급 이상만"
},
"min_years": {
"type": "number"
},
"min_yield": {
"type": "number"
},
"no_option": {
"type": "boolean",
"description": "콜·풋 옵션·영구채·조건부자본(상각형)·주식 관련 사채(CB·BW·EB) 제외"
},
"pay_month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "이 달에 이자를 주는 채권"
},
"min_coupon": {
"type": "number"
},
"min_trade_days_20": {
"type": "integer",
"maximum": 20,
"minimum": 0,
"description": "최근 20거래일 중 체결일 수 하한 (유동성)"
}
}
}{
"title": "회사채 찾기",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}bond — 채권 상세
[국내 주식·채권 MCP] 채권 한 종목 상세 — 발행조건(순위·옵션·보증·금리·이자주기), 평가사별 등급, 일별 시세(가격·수익률·체결액면), 원리금 지급 내역과 예정일, 같은 발행사 다른 채권. 금융위원회 공공데이터 기반.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"bond"
],
"properties": {
"bond": {
"type": "string",
"description": "ISIN(KR6…) 또는 종목명"
},
"price_days": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "최근 시세 일수 (기본 60)"
}
}
}{
"title": "채권 상세",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}bond_calendar — 채권 이자 일정
[국내 주식·채권 MCP] 기간 내 채권 이자·원금 지급 일정. 오늘 이전은 실제 지급(actual=1), 이후는 예정(계산값, 공휴일 미반영). per_10k = 액면 1만원당 이자(원).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"bonds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"description": "ISIN 목록"
},
"stock": {
"type": "string",
"description": "종목코드(6자리) 또는 종목명. 예: '005930', '삼성전자'"
},
"min_grade": {
"type": "string"
}
}
}{
"title": "채권 이자 일정",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1214 ms
- 95th percentile latency
- 1214 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1214 ms · metadata changed · 20 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http finquest-korea-stocks-bonds-mcp https://mcp.finquest.space/public/mcpCodex
codex mcp add finquest-korea-stocks-bonds-mcp --url https://mcp.finquest.space/public/mcpCursor
{
"mcpServers": {
"finquest-korea-stocks-bonds-mcp": {
"url": "https://mcp.finquest.space/public/mcp"
}
}
}Cline
{
"mcpServers": {
"finquest-korea-stocks-bonds-mcp": {
"type": "streamableHttp",
"url": "https://mcp.finquest.space/public/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"finquest-korea-stocks-bonds-mcp": {
"type": "http",
"url": "https://mcp.finquest.space/public/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http finquest-korea-stocks-bonds-mcp https://mcp.finquest.space/public/mcpClaude Desktop
https://mcp.finquest.space/public/mcpWindsurf
{
"mcpServers": {
"finquest-korea-stocks-bonds-mcp": {
"serverUrl": "https://mcp.finquest.space/public/mcp"
}
}
}Let your agent find its tools
Find servers like FinQuest Korea Stocks & Bonds MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other data and analytics servers
Do you run FinQuest Korea Stocks & Bonds MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.