status
Check server health, market-data session state, token expiry, IDX clock, and the next command to run when something looks wrong or after login.
Instructions
Is this server working, and what do I run if it is not? Call this FIRST whenever anything looks wrong, and call it after logging in to confirm it took.
Reports the version and Node, whether the market-data session is stored (NEVER the token itself), how long the stored market-data token claims it has left, the IDX session clock in WIB, and a nextStep naming the single next command.
It answers with no session at all — that is the state every new user is in, and the answer is the useful one.
The session also carries a health: ok / failing / expired / not-stored / unknown, derived from what actually happened the last time that credential was used. failing means present and unexpired but REJECTED by Stockbit — revoked, or superseded by another login. That is the case an expiry check cannot see, and it costs no requests.
live: true is NOT free and is rarely what you want. It refreshes the market-data token, which ROTATES the refresh-token family and therefore ENDS the user’s Stockbit website session. Use health instead; only pass live: true if the user explicitly asks to prove the token with a real request.
The market block reports the IDX clock in WIB with a UTC sibling on each field, and does not model public holidays.
server.update says whether a newer release of this server exists. It costs ONE request to the npm registry — not to Stockbit, carrying only the package name — cached for a day and made by this tool alone. isOutdated: true matters: npx caches a resolved tree under a version RANGE, so a user can run a build that is weeks old and nothing else will say so. latest and isOutdated are ABSENT when the check could not run, which means unknown, NOT up to date — read update.note. STOCKBIT_NO_UPDATE_CHECK=1 turns the request off.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| live | No | Prove the market-data token with one real refresh. This ROTATES the token family and ends the user's Stockbit website session — ask them first. Default false; `health` answers the same question for free. |