Initiative Read
initiative_readRead current initiative state without changing turn order or advancing combat. Use it for safe status checks; timeouts return stale state, not proof combat is inactive.
Instructions
Read initiative state without changing turn order or advancing combat. Use initiative_manage to modify combat and events_poll for broadcast history. Campaign members may read. By default, request a new WS state and wait up to two seconds; timeout returns state=null/stale=true, not proof that combat is inactive. refresh=false reads the current connection's cache and marks it stale. Repeated requests do not change initiative; WS authentication is still required. State is recipient-filtered and only current-generation data is treated as fresh. Returns {ok:true,data} on success; tool-body failures return {ok:false,error} with optional diagnostic data. Argument-schema errors are MCP errors.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| refresh | No | True requests and waits for fresh state; false uses cached state, which may be absent or stale. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||