Token Hp Update
token_hp_updateApply a signed HP delta to a campaign character sheet, healing positive values and damaging negative values; use character IDs, not map token IDs.
Instructions
Apply a signed HP delta to a character sheet through WS, not to a token ID. Use character_get to inspect HP or character_update for an absolute sheet patch. Upstream requires character ownership or DM authority and campaign assignment; its system-specific HP rules determine the result. Positive delta heals, negative delta damages. v1.5.0 permits the owner or DM, never a spectator. Repeating applies the delta again and is not idempotent. Returns sent:true,confirmed:false,status:"pending" inside data: dispatch is not a business ACK. Read events_poll for results/system.error and inspect state before further action; never blindly resend. Returns {ok:true,data} on success; tool-body failures return {ok:false,error} with optional diagnostic data. Argument-schema errors are MCP errors.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"character_id": "<character_id>",
"delta": "<delta>"
},
"name": "token_hp_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| delta | Yes | Signed integer HP adjustment: positive heals, negative damages, zero requests no numerical change. Upstream applies system limits. | |
| character_id | Yes | Campaign-assigned character ID whose sheet HP is changed; do not pass a map token ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||