kapmcp
kapmcp is a read-only MCP server for Borsa Istanbul data: it exposes 25 tools that fetch and deterministically compute KAP disclosures, company profiles, financial statements, ratios, growth, market data, news, corporate actions, funds and document text, returning structured JSON with sources.
Search and profile companies: find KAP members by ticker/name, get full profiles (sector, market, indices, capital, shareholders, board).
Query KAP disclosures: search by company, keyword, type/class, date range, or since an id; fetch full disclosure bodies, structured data fields, and blocked/withdrawn disclosures.
Read disclosure attachments: list documents, extract PDF/HTML/text, and search inside attachments for keywords with page-level snippets.
Get financial statements and metrics: normalised income/balance/cash-flow from Yahoo or official KAP XBRL filings; chart-ready metric histories.
Compute financial ratios and growth: margins, liquidity, leverage, ROA/ROE, YoY/QoQ changes with formulas stated; compare multiple companies side-by-side.
Market data: quotes, OHLCV price history with technical indicators, BIST/macro market overview, price reaction around events, analyst estimates.
Corporate actions and news: dividends/splits/buybacks/general meetings with KAP disclosures, and Yahoo news feeds.
Timeline and funds: chronological company timeline of disclosures/actions/news, plus KAP fund registry search and details.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kapmcp THYAO'nun güncel fiyatını ve son bildirimlerini getir"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
kapmcpkap-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"
kapmcpUzak bağlantı için:
kapmcp --transport streamable-http --port 8000 --statelessYerel 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 |
|
Şirket bilgileri |
|
Bildirimler |
|
Ek belgeler |
|
Finansallar |
|
Hak kullanımları ve haberler |
|
Piyasa verileri |
|
Zaman çizelgesi ve fonlar |
|
Ö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 |
| MKK API anahtarı; yalnızca KAP araçları için zorunlu |
| MKK test geçidi için |
|
|
| 30 saniye |
| 600 saniye |
| 4 eşzamanlı KAP isteği |
| Çağrı başına en fazla 400 indeks penceresi |
| Araç sonucu için 60000 karakter sınırı |
| 45 saniye |
| 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]"
pytestMIT 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-mcpRelated 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/mcpStreamable 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.
OAuth (claude.ai custom connectors, ChatGPT, any OAuth-capable client): add
https://kapmcp.cagrigungor.com/mcp/authinstead 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.Headers (Claude Code plugin, Cursor, own code): send
X-KAP-API-KEY(plusX-KAP-API-SECRETandX-KAP-TEST-MODE: 1for 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/mcpClaude 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-mcpInstall
pip install kap-mcp-server
kap-mcp # stdio
kap-mcp --transport streamable-http --port 8000 --stateless # remote: http://host:8000/mcpPython 3.10+. Yahoo tools work with no configuration. KAP tools need an MKK API key:
Variable | Description |
| API key issued by MKK (required for KAP tools; also whitelist your IP with MKK) |
| Only for the MKK test gateway |
|
|
| 30 s / 600 s / 4 |
| Hard cap on 50-item index windows one call may scan (default 400) |
| Hard cap on a single tool result (default 60000; lists are truncated with a note) |
| 45 s |
| 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 | |
| Config + connectivity (KAP reachable? Yahoo reachable? limits) |
| Code tables: disclosure/member/fund types, action types, field & ratio names, MKK fault codes (also resource |
Companies (KAP) | |
| Ticker or name (Turkish-insensitive) → |
| 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 |
Disclosures (KAP) | |
| One search tool: tickers / company_id / keywords / type / class / date range / |
| Normalised metadata + body as plain text + structured data flattened to |
| Find fields inside a filing's structured data; for financial statements returns XBRL facts by Turkish label ( |
| Withdrawn disclosures and reasons |
Documents (KAP attachments, in memory only) | |
| Attachment metadata ( |
| PDF/HTML/text extraction with page selection; binary/scanned → |
| Snippets with page numbers for a query across a disclosure's attachments |
Financials (Yahoo, normalised; deterministic maths) | |
| One schema for income / balance / cash flow ( |
| Chart-ready series, oldest first: |
| 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 → |
| YoY / QoQ rows: current/previous period & value, absolute and percentage change ( |
| Metrics and ratios for several tickers in one call, same order as requested, no ranking |
Corporate actions | |
| Yahoo ex-dates/amounts + KAP CA disclosures classified by a fixed title keyword table; optional KAP process statuses |
News (Yahoo) | |
| Ticker or keyword; title, publisher, published_at, url, summary — no sentiment |
Market data (Yahoo) | |
| Batch quotes; bad symbols return an error entry |
| OHLCV + summary (return, drawdown, volatility) + optional SMA/EMA/RSI/MACD/Bollinger/ATR |
| BIST 100/30, banks, USD/TRY, EUR/TRY, gold, Brent, S&P, DAX, VIX |
| Returns/volume around a date or a |
| Third-party consensus as published (counts, targets, earnings date) |
Timeline | |
| KAP disclosures (typed by KAP metadata) + corporate actions + news, newest first, each with |
Funds (KAP registry) | |
| Filter/search funds or fetch one by |
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, pollsearch_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_scannedandnext_cursor. Long company histories need either many pages or an archive (planned, seedocs/ROADMAP.md).The list service's
titleis 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 needsquery_scope="content"(one detail call per scanned item).Financial time series come from Yahoo Finance (may be USD for some BIST names —
currencyis 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 indocs/ROADMAP.mdwill 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-serialisedbyte[]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 8000Deployment (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 clientMIT
Available Tools
25 toolscompare_financialsCompare financialsARead-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 estimatesARead-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 disclosuresARead-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 profileARead-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 newsARead-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 timelineARead-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 actionsARead-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 disclosureARead-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 documentsARead-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 textARead-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 ratiosARead-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)ARead-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)ARead-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 overviewARead-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)ARead-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 historyARead-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 eventARead-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_quoteQuotesARead-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 codesARead-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 statusARead-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 companiesARead-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 fieldsARead-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 disclosuresARead-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 documentsARead-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 fundsARead-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
Scored across 25 tools
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.
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.
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.
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
Financial data and analysis tools for Turkish BIST and international markets via MCP.
Licensed Borsa Istanbul (BIST) data for AI assistants: live or 15-minute delayed prices, OHLCV bars from 1 minute to monthly, financial statements, ratios, KAP disclosures, indices and sectors, indicator backtests and portfolio tracking for 600+ Turkish stocks. OAuth sign-in with an istfin subscription. Never places orders.
Financial data and research MCP for US/CN/JP equities: filings, statements, ownership, signals.
One MCP and REST API giving AI agents sourced figures on economics, markets, companies and calendars
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA 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 npmISC
- AlicenseAqualityCmaintenanceProvides 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.31249 npm2ISC
- AlicenseBqualityBmaintenanceMCP 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.27160 npmMIT
- AlicenseNot gradedqualityDmaintenanceProvides real-time quotes, historical OHLCV data, options chains, news, and multi-ticker comparisons to any MCP client via Yahoo Finance.MIT