idx-stock-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IDX_PORTFOLIO_PATH | No | Full (absolute) path to the portfolio.json file. Used by the `get_portfolio` tool to read your portfolio. Optional: omit this environment variable if you only want to look up stock prices/quotes (the `env` block can be removed when not using a portfolio). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_quoteA | Ambil harga terakhir saham Bursa Efek Indonesia (BEI/IDX), perubahan harian, rentang 52 minggu, dan harga per lot (100 lembar). Terima kode saham seperti BBCA, BBRI, TLKM, atau indeks IHSG. Selalu sampaikan freshnessNote ke pengguna (status pasar & waktu data). Data untuk informasi, bukan rekomendasi beli/jual. Harga bisa tertunda dari bursa. |
| get_historyA | Ambil riwayat harga (OHLC + volume) saham IDX untuk rentang waktu tertentu beserta ringkasan: priceReturnPct (harga saja), totalReturnPct (termasuk dividen), dividen & stock split dalam rentang, tertinggi, terendah, max drawdown. Maksimal 300 candle terakhir; gunakan interval 1wk/1mo untuk rentang panjang. |
| compare_stocksA | Bandingkan performa 2–10 saham IDX (dan/atau IHSG) dalam rentang waktu yang sama. Diurutkan berdasarkan totalReturnPct (harga + dividen) jika tersedia untuk semua, selain itu priceReturnPct. Sebutkan dasar pengurutan (rankedBy) ke pengguna. |
| get_portfolioA | Baca file portofolio lokal (IDX_PORTFOLIO_PATH) lalu hitung nilai pasar, untung/rugi belum terealisasi per saham dan total, serta ESTIMASI hasil bersih jika dijual. Jika file berisi riwayat |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool targets a clearly distinct operation: current quote (get_quote), historical candles (get_history), multi-stock comparison (compare_stocks), and local portfolio evaluation (get_portfolio). There is no meaningful overlap in purpose or output, so an agent can select correctly without guessing.
Three tools follow a clean verb_noun pattern (get_quote, get_history, get_portfolio) while compare_stocks deviates only in verb (compare vs get). The deviation is minor and still perfectly readable, so the set is nearly uniform.
Four tools is on the lean side but each earns its place by covering a distinct analytical need (quote, history, comparison, portfolio). A symbol-search or market-overview tool could round it out, but nothing is redundant.
The surface covers the core investor workflows: live pricing, historical returns, comparative performance, and portfolio P&L including dividends and splits. Gaps like symbol search or corporate-action lookup exist but are minor and don't block the primary use cases.