# AI use cases for Idx (fzn0x/idx)

Repo: [fzn0x/idx](https://github.com/fzn0x/idx) | Use cases: 5 | Page: https://dedupedai.com/use-cases/fzn0x-idx/

A Rust command-line tool and MCP server that gives delayed quotes, fundamentals, screening, news, ownership and broker data for Indonesian stocks (IDX/IHSG) without API keys.

This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL.

- Check delayed IHSG quotes and valuation from a terminal: https://dedupedai.com/use-cases/fzn0x-idx/check-ihsg-quotes-from-terminal/
- Screen about 950 IDX stocks by valuation and sector: https://dedupedai.com/use-cases/fzn0x-idx/screen-idx-stocks-by-valuation/
- Let an AI agent pull IDX stock briefs over MCP: https://dedupedai.com/use-cases/fzn0x-idx/ask-agent-for-idx-stock-brief/
- Find who holds more than 1% of an IDX stock: https://dedupedai.com/use-cases/fzn0x-idx/find-who-owns-idx-stock/
- Trace top broker buying and selling in an IDX stock: https://dedupedai.com/use-cases/fzn0x-idx/trace-broker-flow-in-idx-stock/

## How to check delayed IHSG quotes and valuation from a terminal with Idx

Repo: [fzn0x/idx](https://github.com/fzn0x/idx) | Difficulty: Intermediate | Time: 15 minutes | Basis: From the README

Install Idx and pull delayed prices, P/E and dividend yield for several IDX tickers in one command.

**Who it is for:** A retail investor in Indonesia who wants a fast look at a few IDX stocks before a trade and does not want to open a broker app.

**The problem:** Checking several Indonesian stocks one by one on broker or news sites takes time, and the figures are scattered across pages.

**The outcome:** A table of price, change, volume, market cap, P/E and dividend yield for the tickers you name, plus the time of the last trade.

### Steps

1. Run `npm install -g github:fzn0x/idx` or `cargo install ihsg-cli` to install the Idx command.
2. Run `idx stocks quote BBCA,BBRI,TLKM` to see a table for three tickers.
3. Read the footer line for the last trade time and whether the market is open, since the data is delayed.
4. Run `idx -o json stocks quote BBCA | jq '.data[0] | {price, change_pct, pe_trailing, dividend_yield_pct}'` to pull only the fields you need into a script.

### Prompt to paste into your agent

```text
Use the idx command from the fzn0x/idx repo to fetch quotes for <tickers such as BBCA,BBRI,TLKM> by running `idx -o json stocks quote <tickers>`. Return price, change percent, P/E and dividend yield for each ticker as a short list. Verify that the response includes a last trade timestamp and state that the data is delayed.
```

### Caveat

Quotes are delayed and come from Yahoo Finance and MSN Money, so confirm the timestamp before acting on any price.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/fzn0x-idx/check-ihsg-quotes-from-terminal/

## How to screen about 950 IDX stocks by valuation and sector with Idx

Repo: [fzn0x/idx](https://github.com/fzn0x/idx) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README

Filter the IDX universe with one expression, for example low P/E financial stocks.

**Who it is for:** An analyst or investor building a shortlist of Indonesian stocks that match a valuation rule and a sector.

**The problem:** Finding stocks that meet a P/E limit and a sector label means checking hundreds of tickers by hand.

**The outcome:** A ranked list of matching IDX tickers with their key valuation figures, produced from one filter string.

### Steps

1. Install Idx with `npm install -g github:fzn0x/idx` or `cargo install ihsg-cli`.
2. Run `idx stocks screen -f "pe 15,sector=financial"` to get stocks with P/E under 15 in the financial sector. (inferred, check the README)
3. Add `-o json` before `stocks` to save the result for a spreadsheet or script, for example `idx -o json stocks screen -f "pe 15,sector=financial"`. (inferred, check the README)
4. Run `idx stocks fundamental <TICKER>` on one of the results to read the rules behind its verdict. (inferred, check the README)

### Prompt to paste into your agent

```text
Use the idx tool from the fzn0x/idx repo to run `idx -o json stocks screen -f "<filter>"` where <filter> is a rule such as pe 15,sector=financial. Return the matching tickers with their P/E and sector as a table. Verify that the count of results matches the length of the returned data array.
```

### Caveat

The screener caps per-company fundamentals at a set number of tickers, largest first, so smaller stocks may not be checked.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/fzn0x-idx/screen-idx-stocks-by-valuation/

## How to let an AI agent pull IDX stock briefs over MCP with Idx

Repo: [fzn0x/idx](https://github.com/fzn0x/idx) | Difficulty: Advanced | Time: 30 minutes | Basis: From the README

Expose Idx as MCP tools so an agent can answer questions about IHSG stocks with live tool calls.

**Who it is for:** A developer or analyst who uses an AI agent daily and wants it to answer Indonesian stock questions from real data rather than memory.

**The problem:** General AI models do not have current IDX prices, fundamentals or news, so their answers about a stock can be out of date.

**The outcome:** An agent that calls Idx tools such as idx_brief and idx_fundamental and answers with figures and the source timestamp.

### Steps

1. Install Idx with `npm install -g github:fzn0x/idx` or `cargo install ihsg-cli`.
2. Run `idx mcp setup` to get the registration recipe for your agent harness. (inferred, check the README)
3. Start the server with `idx mcp` over stdio, or with `idx mcp --http ADDR --token T` for streamable HTTP. (inferred, check the README)
4. Ask the agent for a stock brief, for example for BBCA, and check that it calls idx_brief.

### Prompt to paste into your agent

```text
Connect to the idx MCP server from the fzn0x/idx repo and call idx_brief for <ticker such as BBCA>. Summarise the quote, verdict, returns against IHSG, top holders and headlines in plain language. Verify that the answer quotes the last trade time from the tool result and says the data is delayed.
```

### Caveat

The README lists 36 MCP tools and registration recipes for 25 agent harnesses, but it does not name each agent, so check the setup output for your own harness.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/fzn0x-idx/ask-agent-for-idx-stock-brief/

## How to find who holds more than 1% of an IDX stock with Idx

Repo: [fzn0x/idx](https://github.com/fzn0x/idx) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README

Import KSEI's monthly holder register and list every holder above 1% for one ticker.

**Who it is for:** An investor or researcher who wants to see the major shareholders of a specific Indonesian company, such as BBCA.

**The problem:** KSEI publishes ownership data in monthly XLSX or PDF files that are hard to search across months.

**The outcome:** A list of holders above 1% of the chosen ticker, stored in local SQLite and queryable by date.

### Steps

1. Install Idx with `npm install -g github:fzn0x/idx` or `cargo install ihsg-cli`.
2. Run `idx ownership import --latest` to load the most recent KSEI monthly register into local SQLite. (inferred, check the README)
3. Run `idx ownership ticker BBCA` to list holders above 1% of BBCA. (inferred, check the README)
4. Run `idx ownership releases` to see which months are imported before comparing dates. (inferred, check the README)

### Prompt to paste into your agent

```text
Use the idx tool from the fzn0x/idx repo to run `idx ownership import --latest`, then `idx ownership ticker <ticker>` for <ticker such as BBCA>. Return the holders above 1% with their stake. Verify that the output names the month the register covers.
```

### Caveat

Holder data is monthly and covers only holders above 1%, so it will not show smaller positions or intra-month changes.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/fzn0x-idx/find-who-owns-idx-stock/

## How to trace top broker buying and selling in an IDX stock with Idx

Repo: [fzn0x/idx](https://github.com/fzn0x/idx) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README

See which brokers lead buying and selling in one ticker and whether a bandar phase is showing.

**Who it is for:** A trader who reads broker flow on IDX and wants a quick view of the top buyers and sellers for one ticker.

**The problem:** Broker-level buying and selling is not shown on the standard quote pages, so the top movers are hard to see.

**The outcome:** The top 10 buyers and sellers of a ticker by lots, with broker class, value and average price, plus an accumulation or distribution read.

### Steps

1. Install Idx with `npm install -g github:fzn0x/idx` or `cargo install ihsg-cli`.
2. Run `idx broker BBCA` to see the top 10 buyers and sellers for the latest session with trades. (inferred, check the README)
3. Run `idx bandar detect BBCA --period 1w` to check whether the top brokers are accumulating or distributing over a week. (inferred, check the README)
4. Run `idx -o csv broker BBCA` if you want one row per broker for a spreadsheet, using the csv output option the README describes. (inferred, check the README)

### Prompt to paste into your agent

```text
Use the idx tool from the fzn0x/idx repo to run `idx broker <ticker>` and `idx bandar detect <ticker> --period 1w` for <ticker such as BBCA>. Return the top buyers, top sellers and the accumulation or distribution read. Verify that the output reports the session date and states whether the phase is accumulation or distribution.
```

### Caveat

Bandarmology is a reading of broker flow, not a forecast, and the README does not claim it predicts price moves.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/fzn0x-idx/trace-broker-flow-in-idx-stock/