# idx

> Indonesian stock market (IDX / IHSG) analysis for people and AI agents: one open-source binary with a CLI that prints tables, a JSON mode for scripts (`idx -o json`) and an MCP server for agents (`idx mcp`), built on free public data with no API keys.

Version 0.8.2; these pages follow the main branch of https://github.com/fzn0x/idx (`idx version` prints the installed one).

- Tickers are IDX codes (`BBCA`, `TLKM`); the `.JK` suffix is optional and `^JKSE` is the IHSG composite.
- `idx -o json <command>` prints one envelope on stdout: `schema`, `provider`, `fetched_at`, `cached`, `stale`, `warnings`, `data`. Errors go to stderr as `{"error":{"code":...,"message":...},"exit_code":N}`.
- Exit codes, each with its `error.code` values: 0 ok; 1 `internal`, `io`; 2 `usage`; 3 `network`, `provider`, `blocked`; 4 `not_found`; 5 `offline_miss`; 6 `config`, `unsupported`. [Errors](https://ihsg.midoriresearch.com/docs/json-output.md#errors) says when each occurs.
- `idx mcp` serves the commands as typed MCP tools over stdio (`idx mcp --http 127.0.0.1:8765` for URL-only clients); `idx mcp setup <client>` prints the registration for each agent.
- A value the source does not publish is `null`; nothing is estimated. Verdicts and signals are labelled rule-based heuristics, not investment advice.
- Every page below is Markdown; the same page as HTML drops the `.md` (`/docs/mcp`).

## Docs

- [Overview](https://ihsg.midoriresearch.com/docs/index.md): What idx is, how to install it, every command, output for scripts, the MCP server in brief, bandarmology and the data sources.
- [Using idx from an agent](https://ihsg.midoriresearch.com/docs/agent-guide.md): How an AI agent should call idx (MCP or the CLI), the JSON contract and exit codes in one place, recipes, and an agent-led install.
- [MCP server](https://ihsg.midoriresearch.com/docs/mcp.md): Registering idx with each agent, idx mcp setup, the HTTP transport, and every MCP tool with its arguments.
- [JSON output](https://ihsg.midoriresearch.com/docs/json-output.md): The envelope, every payload schema field by field, errors, exit codes and the compatibility promise.
- [Configuration](https://ihsg.midoriresearch.com/docs/configuration.md): Config file, IDX_* environment variables, cache location and lifetimes.
- [Ownership data](https://ihsg.midoriresearch.com/docs/ownership.md): The KSEI register of holders above 1 %: source files, the GitHub mirror, the local database and its queries.
- [Stockbit realtime (opt-in)](https://ihsg.midoriresearch.com/docs/stockbit.md): The opt-in Stockbit provider: logging in, the order book, corporate actions, the calendar and holder movements, the MCP tools and where the session lives.

## Optional

- [All pages in one file](https://ihsg.midoriresearch.com/llms-full.txt): the pages above, concatenated
- [Web terminal](https://ihsg.midoriresearch.com/terminal): the same commands in a browser, no install
- [Source code](https://github.com/fzn0x/idx): Rust, MIT licence; AGENTS.md describes the architecture
- [Changelog](https://github.com/fzn0x/idx/blob/main/CHANGELOG.md): what changed in each release