Indonesia Financial Data MCP

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

v0.1 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: Baguskto Saham

Tools

• idx_list_companies

• idx_company_profile

• idx_company_announcements

• idx_financial_reports

• 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.

Development

.venv/bin/pytest -q

Tests use fixtures/mock transports. Live smoke tests are separate so upstream availability cannot make the deterministic suite flaky.

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. Parsing financial-statement XLSX/XBRL/PDF into normalized line items is the next layer, not fabricated in v0.1.

• 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