Skip to main content
Glama
zenith-sb-mcp

zenith-sb-mcp

README.md
> [!WARNING]
> **Personal project — not official.** This is a personal project created for
> educational purposes. It is NOT official software of Stockbit or IDX, and the
> creator is NOT affiliated with Stockbit or IDX in any way. Do NOT enter your
> Stockbit credentials into any website, app, or build you do not fully trust.
> This server never asks for your password on any page of its own — sign-in
> happens only through Stockbit's official login, and passwords are never
> stored.

# zenith-sb-mcp

Unofficial, **read-only** MCP server for IDX market data via Stockbit.
Bring your own Stockbit login — this server never stores your password,
never places orders, and does not redistribute data: every install runs
against its own account.

> Status: **v0.1** — the read-only surface below, verified offline. See `DESIGN.md`.

## Tools (v0.1)

`status` · `quote` · `orderbook` · `intraday_prices` · `chart_series` ·
`trade_book` · `running_trade` · `broker_summary` · `keystats` · `ratios` ·
`technicals` · `seasonality` · `company_profile` · `peer_comparison` ·
`analyst_ratings` · `insider_transactions` · `corporate_actions`

Realtime running-trade streaming is planned for v1.0 (`running_trade_live`).

The full mapped market-data API surface — every endpoint this server calls,
plus the read-only endpoints known but not yet wrapped as tools — is
documented in [`docs/ENDPOINTS.md`](docs/ENDPOINTS.md).

New here? [`API.md`](API.md) is the full reference: install, authentication,
MCP client setup, every tool's parameters and output shapes, the batch CLI,
and troubleshooting.

## Lineage

Derived from [INo-xious/stockbit-mcp](https://github.com/INo-xious/stockbit-mcp)
(MIT) — see `NOTICE` and `UPSTREAM.md`. This project narrows that surface to
read-only market data and adds a realtime tape module.

Not affiliated with Stockbit or IDX. Market data belongs to its respective
owners; use at your own risk and within the terms of your own account.

TDQS

A3.5/5.0

Scored across 17 tools

Disambiguation3/5

The price-data cluster (quote, intraday_prices, chart_series, technicals, orderbook) overlaps heavily, and an agent must read long prose to know which one to reach for; the descriptions do cross-reference each other, which helps somewhat. Worse, several descriptions instruct the agent to prefer or fall back to tools that do not exist here (price_chart, price_bands, price_market, market_movers, market_session, broker_flow_intraday, the `bars` family), which actively muddies selection. broker_summary vs insider_transactions vs running_trade vs trade_book are more cleanly separated by the text.

Naming Consistency4/5

Names are uniformly snake_case with no camelCase intrusions and no mixed casing, following a consistent noun-phrase convention (company_profile, analyst_ratings, running_trade, corporate_actions). A handful of bare single nouns (status, quote, technicals, keystats, ratios, orderbook) deviate from the descriptor pattern, but the style is predictable overall.

Tool Count4/5

17 tools is at the upper end but each maps to a genuinely distinct market-data endpoint (quotes, series, depth, broker flow, insiders, fundamentals, corporate actions, diagnostics), so none is obviously filler. The count only feels heavy because several descriptions are extremely long rather than because the surface is padded.

Completeness2/5

The set reads as a partial slice of a larger server: descriptions repeatedly depend on market_session, price_chart, price_bands, price_market, market_movers, shareholding, insider_ownership, dividend_calendar and broker_flow_intraday, none of which are present. There is also no symbol/issuer search or resolution tool despite tickers being the entry point for nearly every other call, and no financial-statement endpoint except an opt-in inside company_profile. An agent following the documented workflows will hit dead ends.