Skip to main content
Glama
kapmcp

kapmcp

kapmcp

Türkçe

Resmî değildir. Resmî olmayan, bağımsız bir projedir: resmî KAP/MKK veri yayın API'si ve Yahoo Finance verileri üzerine kurulmuştur; KAP, MKK (Merkezi Kayıt Kuruluşu), Borsa İstanbul veya Yahoo ile bir bağı yoktur, onlar tarafından onaylanmamış veya işletilmemektedir.

kapmcp, Borsa İstanbul için KAP bildirimlerini ve Yahoo Finance piyasa verilerini MCP uyumlu uygulamalara sunan bir Python sunucusudur. Resmî MKK VYK API üzerinden şirket bilgilerini, bildirim içeriklerini, finansal raporları, ek belgeleri ve fon sicilini getirir. Yahoo Finance üzerinden fiyat, geçmiş fiyat, finansal tablo, oran, analist tahmini ve haber verilerine erişim sağlar.

25 salt okunur araç sunar. Verileri yapılandırılmış JSON olarak döndürür; finansal oranları, büyümeyi ve teknik göstergeleri tanımlı formüllerle hesaplar. Yatırım önerisi, sıralama veya fiyat tahmini üretmez. Yerel kullanım için stdio, uzak bağlantılar için Streamable HTTP destekler.

Kurulum ve çalıştırma

Python 3.10 veya üzeri gerekir:

pip install kap-mcp-server
kapmcp

kap-mcp komutu da aynı sunucuyu başlatır. Yahoo Finance araçları ek anahtar gerektirmez. KAP araçları için MKK tarafından sağlanan API anahtarı ve MKK tarafında IP yetkilendirmesi gerekir:

export KAP_API_KEY="MKK_API_ANAHTARINIZ"
kapmcp

Uzak bağlantı için:

kapmcp --transport streamable-http --port 8000 --stateless

Yerel uç nokta http://127.0.0.1:8000/mcp olur. Dış erişim için HTTPS ve uygun erişim denetimi sağlayan bir ters vekil kullanın.

MCP istemci ayarı

mcpServers yapılandırmasını destekleyen istemciler için:

{
  "mcpServers": {
    "kap": {
      "command": "kapmcp",
      "env": { "KAP_API_KEY": "MKK_API_ANAHTARINIZ" }
    }
  }
}

İstemci komutu bulamazsa command alanında sanal ortamınızdaki çalıştırılabilir dosyanın tam yolunu kullanın.

Neler yapabilir?

Alan

Araçlar

Durum ve kodlar

kap_status, get_reference_codes

Şirket bilgileri

search_companies, get_company

Bildirimler

search_disclosures, get_disclosure, search_disclosure_data, get_blocked_disclosures

Ek belgeler

get_disclosure_documents, get_document_text, search_documents

Finansallar

get_financials, get_metric_history, get_financial_ratios, get_growth, compare_financials

Hak kullanımları ve haberler

get_corporate_actions, get_company_news

Piyasa verileri

get_quote, get_price_history, get_market_overview, get_price_reaction, get_analyst_estimates

Zaman çizelgesi ve fonlar

get_company_timeline, search_funds

Örnek istekler: “THYAO'nun son bildirimlerini getir”, “ASELS'in sözleşme açıklamalarını bul”, “THYAO ve PGSUS gelirlerini karşılaştır”, “Bu bildirimin ekindeki kapasite bilgisini ara”.

Yapılandırma

Değişken

Açıklama / varsayılan

KAP_API_KEY

MKK API anahtarı; yalnızca KAP araçları için zorunlu

KAP_API_SECRET

MKK test geçidi için

KAP_TEST_MODE

1: test geçidini kullan

KAP_TIMEOUT

30 saniye

KAP_CACHE_TTL

600 saniye

KAP_MAX_CONCURRENCY

4 eşzamanlı KAP isteği

KAP_MAX_SCAN_PAGES

Çağrı başına en fazla 400 indeks penceresi

KAP_MAX_RESULT_CHARS

Araç sonucu için 60000 karakter sınırı

YAHOO_TIMEOUT

45 saniye

KAP_LOG_LEVEL

Günlük seviyesi; günlükler stderr'e yazılır

Sınırlar

KAP liste API'si indeks pencereleriyle çalışır. Tarih ve metin aramaları çok sayıda sayfa tarayabilir; scan_complete ve next_cursor alanlarıyla sonucun tamamlanıp tamamlanmadığını kontrol edin. Bildirim içeriğinde arama için query_scope="content" kullanılır.

Yahoo verilerinde eksik dönemler veya farklı raporlama para birimleri olabilir. Resmî KAP finansalları disclosure_id ile tek rapordan okunabilir; bankalar ve sigorta şirketleri için alan eşlemesi kısmi olabilir. Taranmış PDF'ler OCR olmadan metne dönüştürülemez. KAP hak kullanım tutarları bildirim gövdesinden ayrıştırılmaz; ilgili bildirimin bağlantısı döndürülür.

Geliştirme ve lisans

pip install -e ".[dev]"
pytest

MIT lisansı. Geliştirici: Çağrı Güngör. Kaynak kod.


Barındırılan sunucu ve Claude plugin

Kurulum gerektirmeyen uç nokta: https://kapmcp.cagrigungor.com/mcp (Streamable HTTP, anahtar gerekmez). Kendi MKK anahtarınızla kullanmak için: claude.ai / ChatGPT gibi OAuth destekleyen istemcilerde https://kapmcp.cagrigungor.com/mcp/auth adresini ekleyin — açılan onay sayfasına anahtarınızı girersiniz (MKK'da doğrulanır, şifreli saklanır); Claude Code plugin'i ve header destekleyen istemcilerde X-KAP-API-KEY / X-KAP-API-SECRET / X-KAP-TEST-MODE header'ları yeterlidir.

claude mcp add --transport http kap https://kapmcp.cagrigungor.com/mcp
# veya Claude Code plugin olarak (araçlar + kullanım rehberi skill'i):
/plugin marketplace add hasancagrigungor/kapmcp
/plugin install kap@kap-mcp

Related MCP server: FinImpulse MCP Server

English

Unofficial. Unofficial, independent project: built on the official KAP/MKK data-distribution API and Yahoo Finance data, but not affiliated with, endorsed by or operated by KAP, MKK (Merkezi Kayıt Kuruluşu), Borsa İstanbul or Yahoo.

MCP server for Borsa İstanbul: official KAP disclosures (Kamuyu Aydınlatma Platformu, via the MKK VYK API) plus Yahoo Finance prices, normalised financial statements, ratios, analyst data and news. Works with compatible MCP clients over stdio or Streamable HTTP.

Design principle. The server is a data + deterministic-computation layer: it fetches, normalises, filters, paginates, computes ratios/growth and returns structured JSON with source / source_url on every result. It never interprets, ranks, recommends, forecasts or draws charts — that is the calling agent's job. There are no analyze_* / should_buy / draw_chart tools by design.

Hosted endpoint

https://kapmcp.cagrigungor.com/mcp

Streamable HTTP, no auth, 120 requests/min per IP. The site at https://kapmcp.cagrigungor.com documents every tool from the live registry (/tools/) and shows source health (/status/).

Bring your own KAP key (optional), two ways.

  1. OAuth (claude.ai custom connectors, ChatGPT, any OAuth-capable client): add https://kapmcp.cagrigungor.com/mcp/auth instead of /mcp. The client discovers the authorization server (/.well-known/oauth-authorization-server, dynamic client registration, PKCE), opens a consent page where you type your MKK key, which is validated against MKK and stored encrypted; every request with the issued token then runs with your key. Revoke by removing the connector.

  2. Headers (Claude Code plugin, Cursor, own code): send X-KAP-API-KEY (plus X-KAP-API-SECRET and X-KAP-TEST-MODE: 1 for the MKK test gateway) and the request is served with your MKK credentials instead of the shared server key. The Claude Code plugin asks for these at install time (userConfig) and forwards them as headers; other clients can set headers in their MCP config:

{ "mcpServers": { "kap": { "type": "http", "url": "https://kapmcp.cagrigungor.com/mcp",
  "headers": { "X-KAP-API-KEY": "…", "X-KAP-API-SECRET": "…", "X-KAP-TEST-MODE": "1" } } } }
claude mcp add --transport http kap https://kapmcp.cagrigungor.com/mcp

Claude Code plugin (remote server + a usage skill that tells the model which tool to reach for):

/plugin marketplace add hasancagrigungor/kapmcp
/plugin install kap@kap-mcp

Install

pip install kap-mcp-server
kap-mcp                      # stdio
kap-mcp --transport streamable-http --port 8000 --stateless   # remote: http://host:8000/mcp

Python 3.10+. Yahoo tools work with no configuration. KAP tools need an MKK API key:

Variable

Description

KAP_API_KEY

API key issued by MKK (required for KAP tools; also whitelist your IP with MKK)

KAP_API_SECRET

Only for the MKK test gateway

KAP_TEST_MODE

1 → apigwdev.mkk.com.tr

KAP_TIMEOUT / KAP_CACHE_TTL / KAP_MAX_CONCURRENCY

30 s / 600 s / 4

KAP_MAX_SCAN_PAGES

Hard cap on 50-item index windows one call may scan (default 400)

KAP_MAX_RESULT_CHARS

Hard cap on a single tool result (default 60000; lists are truncated with a note)

YAHOO_TIMEOUT

45 s

KAP_LOG_LEVEL

Logs go to stderr only

Example stdio configuration for clients supporting mcpServers:

{ "mcpServers": { "kap": { "command": "/path/to/.venv/bin/kap-mcp", "env": { "KAP_API_KEY": "…" } } } }

ChatGPT / remote clients: run with --transport streamable-http behind HTTPS and add https://host/mcp.

Tools (25)

All tools are read-only (readOnlyHint), have titles, typed input schemas with enums, and output schemas.

Tool

What it returns

Reference

kap_status

Config + connectivity (KAP reachable? Yahoo reachable? limits)

get_reference_codes

Code tables: disclosure/member/fund types, action types, field & ratio names, MKK fault codes (also resource kap://reference/codes)

Companies (KAP)

search_companies

Ticker or name (Turkish-insensitive) → company_id, tickers, member type, KAP URL

get_company

Profile from KAP: sector, market (e.g. YILDIZ PAZAR), index memberships (BIST 30/100/…), paid-in capital & registered ceiling, ISINs, direct/indirect shareholders with %, free float, board, executives, subsidiaries, auditor, registry/tax ids, website. Empty KAP fields are null + not_available. Optional Yahoo profile/holders.

Disclosures (KAP)

search_disclosures

One search tool: tickers / company_id / keywords / type / class / date range / since_id / cursor / order / include_details. query_scope="metadata" matches sender name + KAP template name (e.g. New Business Relation, Valuation Report); "content" also matches subject/summary via detail calls. Reports scan_complete, next_cursor, scanned index range.

get_disclosure

Normalised metadata + body as plain text + structured data flattened to path: value (format: summary / text / full)

search_disclosure_data

Find fields inside a filing's structured data; for financial statements returns XBRL facts by Turkish label (hasılat → Revenue with CURR/PREV/CURR3/PREV3 values)

get_blocked_disclosures

Withdrawn disclosures and reasons

Documents (KAP attachments, in memory only)

get_disclosure_documents

Attachment metadata (attachment_id, name, source_url)

get_document_text

PDF/HTML/text extraction with page selection; binary/scanned → text: null + reason

search_documents

Snippets with page numbers for a query across a disclosure's attachments

Financials (Yahoo, normalised; deterministic maths)

get_financials

One schema for income / balance / cash flow (revenue, gross_profit, operating_profit, ebitda, net_income, total_assets, current_assets, cash, total_liabilities, current_liabilities, financial_debt, equity, cash-flow lines …) with source line per field and reporting currency. ticker → Yahoo time series; disclosure_id → the official KAP filing parsed from its XBRL data (current quarter, YTD and prior-year comparatives, source: kap)

get_metric_history

Chart-ready series, oldest first: {series:[{period:"2025Q1", revenue:…}]}

get_financial_ratios

Margins, current/cash ratio, D/E, financial D/E, net debt(/EBITDA), interest coverage, ROA, ROE (TTM), asset turnover, equity ratio — formula stated per item; missing input → value: null, reason

get_growth

YoY / QoQ rows: current/previous period & value, absolute and percentage change (ticker series or a KAP disclosure_id)

compare_financials

Metrics and ratios for several tickers in one call, same order as requested, no ranking

Corporate actions

get_corporate_actions

Yahoo ex-dates/amounts + KAP CA disclosures classified by a fixed title keyword table; optional KAP process statuses

News (Yahoo)

get_company_news

Ticker or keyword; title, publisher, published_at, url, summary — no sentiment

Market data (Yahoo)

get_quote

Batch quotes; bad symbols return an error entry

get_price_history

OHLCV + summary (return, drawdown, volatility) + optional SMA/EMA/RSI/MACD/Bollinger/ATR

get_market_overview

BIST 100/30, banks, USD/TRY, EUR/TRY, gold, Brent, S&P, DAX, VIX

get_price_reaction

Returns/volume around a date or a disclosure_id, excess return vs BIST 100

get_analyst_estimates

Third-party consensus as published (counts, targets, earnings date)

Timeline

get_company_timeline

KAP disclosures (typed by KAP metadata) + corporate actions + news, newest first, each with source_url

Funds (KAP registry)

search_funds

Filter/search funds or fetch one by fund_id

Example flows

  • "THYAO'nun son 3 aylık açıklamaları" → search_disclosures(tickers=["THYAO"], start_date="2026-06-21", include_details=true)

  • "ASELS'in sözleşme açıklamaları" → search_disclosures(tickers=["ASELS"], query="sözleşme", query_scope="content")

  • "Bedelsiz sermaye artırımı açıklamaları" → search_disclosures(query="bedelsiz", disclosure_type="CA")

  • "2026Q2 net kâr, YoY" → get_growth(ticker="THYAO", metric="net_income", periods=1)

  • "THYAO vs PGSUS" → compare_financials(tickers=["THYAO","PGSUS"], metrics=["revenue","net_margin","roe"])

  • "Rapor ekinde kapasite ne diyor?" → get_disclosure_documents(id) → search_documents(disclosure_id=id, query="kapasite")

  • Monitoring → store last_disclosure_id, poll search_disclosures(since_id=…, order="asc")

Honest limitations

  • KAP list API pages by index only (50 per call, no date/keyword filter). Date and keyword queries scan index windows; every response reports scan_complete, pages_scanned and next_cursor. Long company histories need either many pages or an archive (planned, see docs/ROADMAP.md).

  • The list service's title is the sender's name, not the subject. Cheap keyword search therefore matches the company name and KAP's template codes (sub_report_ids, e.g. oda-12000_New-Business-Relation); subject/summary matching needs query_scope="content" (one detail call per scanned item).

  • Financial time series come from Yahoo Finance (may be USD for some BIST names — currency is always returned; small caps can be missing). The official KAP filing is parsed exactly from its XBRL data for one report at a time (get_financials(disclosure_id=…)); building a multi-year series from KAP alone means locating each FR id by scanning, which the archive planned in docs/ROADMAP.md will make cheap. Banks/insurers use other templates and map partially.

  • The MKK gateway answers empty filtered windows and unknown ids with HTTP 400 + ER005 "Bildirim bulunamadı"; the server treats these as empty/not-found, not as authentication failures. Attachments arrive as a Java-serialised byte[] and are unwrapped transparently.

  • Corporate-action amounts inside KAP bodies are not parsed; the tool returns the disclosure id/URL to read.

  • Yahoo news is English-centric. No semantic search in v1 (title keyword + document snippet search instead).

Security

Designed for remote deployment: no file-system writes, no shell, no arbitrary URL fetching. Attachments are fetched only by KAP-issued id through the authenticated client, size-capped (40 MB) and processed in memory. User input never builds URL paths unchecked. Every result is size-bounded; every scan is page-bounded.

Web site + hosted MCP (Django)

web/ is a tiny Django project (no database) that renders the tool catalogue from the MCP server's own registry and serves the MCP endpoint in the same ASGI process (web/kapweb/asgi.py: Starlette → /mcp with an in-process per-IP rate limit, everything else → Django). Run locally:

uv pip install -e ".[web]"
cd web && DJANGO_ALLOWED_HOSTS=localhost uvicorn kapweb.asgi:application --port 8000

Deployment (no Docker): deploy/deploy.sh rsyncs the source to a CloudPanel Python site, builds a venv, collects static files and installs deploy/kapmcp.service (uvicorn on 127.0.0.1:8194 behind the panel's nginx vhost). Configuration lives in the site's .env (never in the repo).

Development

uv pip install -e ".[dev]"
pytest          # 37 tests: pure computations, KAP client (respx), end-to-end tools via in-process MCP client

MIT

Available Tools

25 tools
compare_financialsCompare financialsA
Read-onlyIdempotent

Side-by-side values of metrics and ratios for several companies in one call. Rows are returned in the order given, with currency per company — no ranking or judgement.

Inputs: metrics (required), tickers (required), period, frequency. Returns: object

get_analyst_estimatesAnalyst estimatesA
Read-onlyIdempotent

Third-party analyst consensus as published on Yahoo Finance: buy/hold/sell counts, mean/ high/low targets, next earnings date, recent rating changes. Reported as data; the server issues no target or recommendation of its own.

Inputs: ticker (required). Returns: object

get_blocked_disclosuresBlocked disclosuresA
Read-onlyIdempotent

Disclosures KAP has withdrawn from public access (e.g. under KVKK) with the stated reason. Explains 'not found' results for specific ids.

Inputs: no named parameters. Returns: object

get_companyCompany profileA
Read-onlyIdempotent

Company profile from KAP: name, tickers, member type, paid-in/registered capital, ISINs, plus shareholders / board / subsidiaries / sector / market / indices when KAP's memberDetail payload contains them (sections KAP does not provide are returned as null with a not_available note, never invented). Optionally adds Yahoo profile and holders.

Inputs: ticker, company_id, include_market_profile. Returns: object

get_company_newsCompany newsA
Read-onlyIdempotent

News from Yahoo Finance's news module for a ticker or keyword: title, publisher, published_at, url, summary, source. No sentiment or interpretation is added. Coverage is mostly English wire/press; for Turkish primary sources use search_disclosures.

Inputs: tab, limit, query, ticker, +2 more. Returns: object

get_company_timelineCompany timelineA
Read-onlyIdempotent

Chronological events for a company (newest first): KAP disclosures typed by KAP's own metadata (disclosure_type/class, subject), corporate actions (Yahoo ex-dates/splits) and Yahoo news. Each event has date, type, title, ids and source_url. No classification or summarisation beyond KAP's fields.

Inputs: ticker (required), limit, end_date, max_pages, +3 more. Returns: object

get_corporate_actionsCorporate actionsA
Read-onlyIdempotent

Dividends, bonus/rights issues, capital changes, buybacks and general meetings for a company. Yahoo supplies exact ex-dates and per-share cash amounts; KAP supplies the disclosures, classified by a fixed title keyword table (type 'other' when unmatched). Amounts inside KAP bodies are not parsed — read the referenced disclosure. Optionally returns KAP process statuses for given reference ids.

Inputs: ticker (required), limit, types, end_date, +4 more. Returns: object

get_disclosureGet disclosureA
Read-onlyIdempotent

One disclosure with normalised metadata (company, ticker, published_at, subject, summary, fiscal period, related tickers, attachments with ids, source_url) and, by default, the body as plain text plus structured data flattened to 'path: value' lines.

Inputs: disclosure_id (required), format, max_chars, sub_report_list. Returns: object

get_disclosure_documentsDisclosure documentsA
Read-onlyIdempotent

List a disclosure's attachments (PDF/XLSX/…) with attachment_id, name and source_url. Pass an id to get_document_text or search_documents to read it.

Inputs: disclosure_id (required). Returns: object

get_document_textDocument textA
Read-onlyIdempotent

Extract text from a PDF/HTML/text attachment (in memory; nothing is stored). Binary formats (xlsx, zip) and scanned PDFs return text: null with a reason. Prefer search_documents to pull only the relevant part of long reports.

Inputs: attachment_id (required), pages, max_chars. Returns: object

get_financial_ratiosFinancial ratiosA
Read-onlyIdempotent

Deterministic ratios with the formula stated per item: margins, current/cash ratio, debt-to-equity, financial debt-to-equity, net debt (/EBITDA), interest coverage, ROA, ROE, asset turnover, equity ratio. Flow-based ratios on quarterly data use trailing-12-month sums. A ratio whose inputs are missing returns value null with a reason — never a guess.

Inputs: period, ratios, ticker, frequency, +2 more. Returns: object

get_financialsFinancial statements (normalised)A
Read-onlyIdempotent

Income statement, balance sheet and cash flow in one normalised schema (revenue, gross_profit, operating_profit, ebitda, net_income, total_assets, cash, financial_debt, equity, operating/investing/financing cash flow …) with the source line/taxonomy name per field and the reporting currency. Two sources: ticker → Yahoo Finance time series (several periods); disclosure_id → the official KAP filing (source: kap, exact figures, labels '(3M)' quarter vs '(YTD)' cumulative). Find FR ids with search_disclosures(tickers=[…], disclosure_type='FR').

Inputs: fields, ticker, periods, frequency, +1 more. Returns: object

get_growthGrowth (YoY / QoQ)A
Read-onlyIdempotent

Period-over-period change of one metric: current/previous period and value, absolute and percentage change (relative to |previous|, so loss→profit swings are signed correctly). Computed here, not by the model.

Inputs: metric (required), ticker, periods, frequency, +2 more. Returns: object

get_market_overviewMarket overviewA
Read-onlyIdempotent

Snapshot of BIST 100/30, bank index, USD/TRY, EUR/TRY, gold, Brent, S&P 500, DAX and VIX (last, change %, 52-week range). Source: Yahoo Finance.

Inputs: no named parameters. Returns: object

get_metric_historyMetric history (chart-ready)A
Read-onlyIdempotent

Time series of normalised financial metrics, oldest first, ready for tables and charts: {series: [{period: '2025Q1', revenue: …, net_income: …}]}. No charts are produced here.

Inputs: ticker (required), metrics (required), periods, frequency. Returns: object

get_price_historyPrice historyA
Read-onlyIdempotent

OHLCV candles with a computed summary (return, high/low, max drawdown, annualised volatility, average volume) and optional standard technical indicators — all numeric, chart-ready, no interpretation.

Inputs: symbol (required), end, start, period, +3 more. Returns: object

get_price_reactionPrice reaction around an eventA
Read-onlyIdempotent

Daily closes, returns and volume around an event date, plus excess return versus BIST 100. Pure arithmetic on price data; whether the move was 'caused' by the event is not asserted.

Inputs: symbol, days_after, event_date, days_before, +1 more. Returns: object

get_quoteQuotesA
Read-onlyIdempotent

Latest price data per symbol: last, previous close, change %, day and 52-week range, volume vs 3-month average, market cap, currency. Bad symbols return an error entry without failing the batch. Source: Yahoo Finance (delayed for BIST).

Inputs: symbols (required). Returns: object

get_reference_codesReference codesA
Read-onlyIdempotent

Code tables used across tools: disclosure types/classes, member types, fund states/types, corporate-action types/statuses, normalised financial field names, ratio names, gateway fault codes. No network call.

Inputs: no named parameters. Returns: object

kap_statusServer statusA
Read-onlyIdempotent

Configuration and connectivity check. Call first when other tools fail to tell a configuration problem (missing key, IP whitelist) from a data problem.

Inputs: no named parameters. Returns: object

search_companiesSearch companiesA
Read-onlyIdempotent

Find KAP members (companies, funds' founders, brokers…) by ticker or name and get their company_id, which other KAP tools take. Exact ticker matches rank first. Use when the user names a company; use get_company for the full profile.

Inputs: limit, query, offset, member_type. Returns: object

search_disclosure_dataSearch disclosure data fieldsA
Read-onlyIdempotent

Find matching fields inside a disclosure's structured data (financial statement line items, form fields) and return path/value pairs. Turkish-insensitive. Use to pull single figures from an official KAP financial report or form without reading the whole body.

Inputs: query (required), disclosure_id (required), limit, sub_report_list. Returns: object

search_disclosuresSearch disclosuresA
Read-onlyIdempotent

Search KAP disclosures by company, keywords, type/template and date range, newest first, with cursor paging. Covers: latest disclosures, a company's disclosures over a period, everything since an id (monitoring), topic hunts like 'sözleşme' or 'bedelsiz' across companies (use query_scope='content' for subject/summary matching). The KAP API only pages by index, so wide ranges scan many windows: check scan_complete; if false, continue with cursor or raise max_pages. Items carry disclosure_id, templates (KAP's topic template codes), ticker, company name and source_url.

Inputs: limit, order, query, cursor, +10 more. Returns: object

search_documentsSearch documentsA
Read-onlyIdempotent

Find passages inside disclosure attachments and return short snippets with page numbers and source_url instead of whole documents. Use for 'what does the report say about X'.

Inputs: query (required), max_results, attachment_id, context_chars, +1 more. Returns: object

search_fundsSearch fundsA
Read-onlyIdempotent

Investment funds registered on KAP (identity, type, class, state, founder, KAP URL), or one fund's full detail when fund_id is given. Prices/returns are not in KAP — this is the registry.

Inputs: limit, query, offset, fund_id, +3 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 25 tools

    Disambiguation4/5

    Each tool has a clearly described output, and the disclosure/document/financial families are carefully separated by function. However, tools like get_financials, get_metric_history, and get_growth are close enough that an agent may need to read descriptions carefully before choosing.

    Naming Consistency4/5

    Nearly every tool follows a clean get_ or search_ verb_noun pattern, making the API predictable. The only real outlier is kap_status, which breaks the verb_noun convention and prevents a perfect score.

    Tool Count4/5

    25 tools is at the high end, but the server covers KAP disclosures, companies, funds, financials, corporate actions, price data, news, and analyst estimates, so most tools earn their place. It is a large surface, but not bloated for the breadth of the domain.

    Completeness4/5

    The read-only KAP and market-data domain is very well covered: disclosures, attachments, structured fields, financial statements, ratios, growth, price history, corporate actions, news, timeline, funds, and reference data are all present. Minor gaps remain around binary attachments and fund performance data, but these are documented and usually workaroundable.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive MCP server that provides seamless access to Yahoo Finance stock market data, enabling retrieval of real-time quotes, historical data, charts, financial summaries, and market searches.
      26 npm
      ISC
    • A
      license
      A
      quality
      C
      maintenance
      Provides structured financial market data (stocks, ETFs, mutual funds, fundamentals, market indicators) to AI systems via MCP, enabling natural language access to financial datasets with both hosted and local deployment options.
      31
      249 npm
      2
      ISC
    • A
      license
      B
      quality
      B
      maintenance
      MCP server that syncs and queries comprehensive stock data (quotes, financials, dividends, analyst forecasts, options, news) from Yahoo Finance and Investing.com into an external MySQL database.
      27
      160 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time quotes, historical OHLCV data, options chains, news, and multi-ticker comparisons to any MCP client via Yahoo Finance.
      MIT