Indonesia Financial Data MCP

Citation-first MCP server for official Indonesian financial data. It does not use Yahoo Finance or yfinance.

Official sources

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 MCP Server

Tools

• idx_list_companies

• idx_company_profile

• idx_company_announcements

• idx_financial_reports

• idx_filing_facts

• bps_list_subjects

• bps_list_variables

• bps_get_data

• ksei_sid_growth

• ksei_investor_demographics

• source_health

See docs/SOURCES.md for source contracts and boundaries, and docs/HERMES.md for Hermes registration and live checks.

Install

python3 -m venv .venv
.venv/bin/pip install -e '.[dev]'

Optional BPS setup:

1. Create a key at https://webapi.bps.go.id/developer/.

2. Export it as BPS_API_KEY or configure it in the MCP client's scoped environment.

Run over stdio:

.venv/bin/python -m indonesia_data_mcp.server

Hermes registration (run from the repository root):

hermes mcp add indonesia-official \
  --command "$PWD/.venv/bin/python" \
  --args -m indonesia_data_mcp.server

If 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 8010

Open 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 -q

Live 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.zip XBRL 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.

• Market-price data is not included: official IDX real-time/delayed market data is a licensed data product.

License

MIT