Indonesia Financial Data MCP
This citation-first MCP server gives official Indonesian financial data from IDX, BPS, and KSEI, returning provenance/warnings/meta envelopes.
List IDX issuers and fetch company profiles, management, and disclosed shareholder snapshots.
Search IDX announcements and retrieve direct attachment URLs with citations.
Find official IDX financial-report attachments (XLSX, PDF, XBRL ZIP, inline-XBRL ZIP).
Browse BPS subjects/variables and query BPS dynamic-table data; BPS tools require
BPS_API_KEY.Retrieve KSEI SID growth and investor demographics by month and dimension.
Check source availability and BPS credential readiness with
source_health.The README also describes raw XBRL filing facts and optional non-official delayed market tools, but the supplied schema does not include them.
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., "@Indonesia Financial Data MCP get company profile for BBCA"
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.
Indonesia Financial Data MCP
Citation-first MCP server for official Indonesian financial data. The official
tools below do not use Yahoo Finance or yfinance. Optional market-data tools
(labelled market_* / ownership_holders) are provided separately through the
MIT-licensed fzn0x/idx CLI and are always
labelled official: false — see "Market data (optional, non-official)".
Official sources
Provider | Coverage | Access |
IDX | Issuer directory, detailed company profile, management/shareholders, announcements, financial-report attachments (XLSX/PDF/XBRL) | Public web endpoints; session cookie initialized automatically |
BPS | Subjects, variables, dynamic statistical tables | Official WebAPI; requires free |
KSEI | SID growth and investor demographics | Public JSON endpoints |
Every successful response has:
{
"data": {},
"provenance": [
{
"provider": "IDX",
"source_url": "https://www.idx.co.id/...",
"retrieved_at": "2026-07-16T00:00:00+00:00",
"official": true,
"source_format": "json"
}
],
"warnings": [],
"meta": {}
}Credential values are redacted from provenance URLs.
Related MCP server: bps-webapi-mcp
Tools
idx_list_companiesidx_company_profileidx_company_announcementsidx_financial_reportsidx_filing_factsbps_list_subjectsbps_list_variablesbps_get_dataksei_sid_growthksei_investor_demographicssource_health
See docs/SOURCES.md for source contracts and boundaries,
and docs/HERMES.md for Hermes registration and live checks.
Market data (optional, non-official) — via fzn0x/idx
Official IDX market prices are a licensed product, so the official tools above
carry none. For delayed prices and screening, this server can delegate to the
fzn0x/idx CLI (ihsg-cli, MIT License, Copyright (c) 2026 Midori Research
and idx contributors — full text in THIRD_PARTY_NOTICES.md):
npm install -g ihsg-cli # or: cargo install --locked ihsg-cli
# optional: export IDX_CLI_PATH=/path/to/idxNo upstream code is copied into this repository; the server invokes the idx
binary as a subprocess (idx -o json ...) and wraps its output in the same
provenance envelope, with official: false and a note that the data is delayed
Yahoo Finance / MSN Money aggregation subject to those providers' terms.
Additional tools when the binary is present:
market_quote— delayed quotes for one or more tickersmarket_history— OHLCV candlesmarket_fundamental— ratios + upstream rule-based verdict (not a recommendation)market_technical— RSI/MACD/MA/Bollinger/ATRmarket_screen— screen ~950 IDX tickers by preset or filter expressionmarket_foreign— foreign buy/sell per session (idx.co.id summaries)market_overview,market_indices— IHSG and all IDX indicesownership_holders— KSEI >1% holders (needs a prioridx ownership syncon the host)
source_health reports the backend as fzn_idx_market.
Install
python3 -m venv .venv
.venv/bin/pip install -e '.[dev]'Optional BPS setup:
Create a key at https://webapi.bps.go.id/developer/.
Export it as
BPS_API_KEYor configure it in the MCP client's scoped environment.
Run over stdio:
.venv/bin/python -m indonesia_data_mcp.serverHermes registration (run from the repository root):
hermes mcp add indonesia-official \
--command "$PWD/.venv/bin/python" \
--args -m indonesia_data_mcp.serverIf BPS is enabled, add BPS_API_KEY to Hermes's secret environment rather than Markdown or command history.
IDX Research Desk dashboard
Run the responsive evidence-first dashboard on the LAN:
.venv/bin/pip install -e '.[dashboard]'
.venv/bin/python -m dashboard --host 0.0.0.0 --port 8010Open http://localhost:8010. Official issuer, announcement, and filing data is
kept separate from clearly labelled in-memory demo workflow state. The dashboard
does not display unlicensed market prices or investment recommendations.
Development
.venv/bin/pytest -qLive tests are separate so upstream availability cannot make the deterministic suite flaky.
Query official XBRL facts
idx_filing_facts resolves the requested IDX filing, downloads its official
instance.zip, verifies the ZIP, calculates SHA-256, and exposes its raw XBRL
facts with context periods, dimensions, units, decimals, and citations. Use the
optional concept substring to keep responses small—for example, Assets,
ProfitLoss, or InterestIncome.
The tool deliberately preserves the filing's taxonomy and raw values. It does not claim canonical cross-company normalization: concept names can vary by issuer profile and taxonomy version.
Scope and limitations
IDX's public endpoints are protected by Cloudflare. The client establishes a normal IDX session and uses conservative pacing. If ordinary HTTP TLS is rejected, it retries with browser-compatible TLS via
curl_cffi; it does not solve or bypass CAPTCHAs.This MCP returns official source records and attachments. It can query raw
instance.zipXBRL facts, but canonical cross-company line-item normalization remains a separate future layer.OJK's public data portal and Bank Indonesia sources were investigated. Their browser-facing services require additional contract discovery and reliability work, so they are not falsely advertised as production-ready tools in v0.1.
Official market-price data is not included: official IDX real-time/delayed market data is a licensed data product. Delayed, non-official prices are available only through the optional fzn0x/idx backend described above, and are labelled
official: false.
License
MIT
Available Tools
10 toolsbps_get_dataB
Read an official BPS dynamic-table series by variable and period IDs.
Inputs: period_ids (required), variable_id (required), domain, language, +3 more.
bps_list_subjectsB
List official BPS statistical subjects. Requires BPS_API_KEY from the BPS developer portal.
Inputs: page, domain, language, subject_category.
bps_list_variablesC
List official BPS variables for a subject and domain.
Inputs: subject_id (required), page, domain, language.
idx_company_announcementsC
Search official IDX issuer announcements and return direct attachment URLs with citations.
Inputs: limit, offset, ticker, date_to, +2 more.
idx_company_profileC
Get an official IDX issuer profile, management, and disclosed shareholder snapshot.
Inputs: ticker (required), language.
idx_financial_reportsC
Find official IDX financial-report attachments (XLSX, PDF, XBRL ZIP, inline-XBRL ZIP).
Inputs: year (required), ticker (required), limit, offset, +1 more.
idx_list_companiesC
List IDX issuers from the official IDX endpoint with sector, industry, listing date, and source citation.
Inputs: limit, offset.
ksei_investor_demographicsC
Get official KSEI investor demographics by month and dimension.
Inputs: dimension (required), month_year (required).
ksei_sid_growthC
Get official KSEI investor-count growth series by month and metric.
Inputs: metric (required), month_year (required).
source_healthB
Check first-party source availability and BPS credential readiness.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool is clearly scoped to a specific data source (bps_, idx_, ksei_) and a distinct operation (e.g., get_data vs list_subjects). No two tools overlap in purpose; even similar operations like 'list' targets different entities across sources.
All tool names follow a consistent snake_case format with a source prefix (bps_, idx_, ksei_) and a descriptive verb_noun pattern. The naming is predictable and unambiguous.
With 10 tools covering three distinct data sources plus a health check, the count is well-balanced. It covers core operations without being overwhelming or too sparse.
The tool set covers the main workflows for each data source: listing entities, retrieving details, and fetching data. The BPS tools lack an explicit period listing (implied by get_data parameters), and IDX lacks trading data, but the coverage is reasonable for the stated domain.
Maintenance
Related MCP Connectors
One API and MCP server for financial and economic data: markets, economics, companies and more.
Indonesia Stock Exchange data: listed companies, shareholders, boards and daily trading.
A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com
BPS — Badan Pusat Statistik (Statistics Indonesia) WebAPI MCP.
Related MCP Servers
AlicenseBqualityDmaintenanceMCP server for accessing Indonesian BPS statistics data via natural language queries.58MIT- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to access official Indonesian statistical data (BPS) through MCP, providing tools for dynamic data queries, foreign trade, publications, and more.2-
- FlicenseNot gradedqualityDmaintenanceMCP server exposing Indonesia Stock Exchange (IDX) market data as tools — fundamentals, broker flow, company profiles, and technical analysis via TA-Lib.2-
- AlicenseAqualityCmaintenanceA local MCP server that lets AI agents research Indonesian equities through your own signed-in Stockbit session using read-only tools for company data, financials, price history, analyst consensus, screening, and more.31Apache 2.0