docs(tools): update math_manage and combat_action descriptions

- math_manage: Add combat redirect warning at top, specify it's for
  non-combat dice rolls only (skill checks, stat gen, loot tables)
- combat_action: Emphasize self-contained nature - rolls dice,
  calculates stats, applies damage, syncs HP all in one call
- Both tools now clearly direct GM to use combat_action for combat

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: Mnehmos

src/server/consolidated/combat-action.ts

@@ -296,9 +296,22 @@ export const CombatActionTool = {
     name: 'combat_action',
     description: `Execute combat actions during an encounter. Actions: ${ACTIONS.join(', ')}.
 
-⚔️ OFFENSIVE:
-- attack - Make an attack roll against a target
-- cast_spell - Cast a spell (single target or AoE)
+🎯 SELF-CONTAINED - This tool handles EVERYTHING for combat:
+- Rolls dice internally (d20 for attacks, damage dice, saves)
+- Auto-calculates attack bonus from character stats if not provided
+- Auto-calculates damage from character stats if not provided
+- Applies damage/healing and syncs HP to character database
+- Tracks action economy (action/bonus/reaction)
+
+DO NOT use math_manage for combat rolls - use this tool instead!
+
+⚔️ ATTACK (minimal call):
+{ action: "attack", encounterId, actorId, targetId }
+Everything else auto-calculated. Returns: roll result, damage dealt, HP change.
+
+🔮 CAST_SPELL (minimal call):
+{ action: "cast_spell", encounterId, actorId, spellName, targetId }
+Validates spell, rolls damage, applies effects, handles saves - all automatic.
 
 💚 SUPPORT:
 - heal - Restore HP to a target
@@ -313,10 +326,7 @@ export const CombatActionTool = {
 - dodge - Disadvantage on attacks against you, advantage on DEX saves
 - ready - Prepare an action with a trigger
 
-Aliases: hit/strike→attack, cast/spell→cast_spell, sprint→dash, evade→dodge.
-
-Use combat_manage for encounter lifecycle (create, end, advance).
-Use combat_map for terrain and visualization.`,
+Aliases: hit/strike→attack, cast/spell→cast_spell, sprint→dash, evade→dodge.`,
     inputSchema: z.object({
         action: z.string().describe(`Action: ${ACTIONS.join(', ')}`),
         encounterId: z.string().describe('Encounter ID'),

src/server/consolidated/math-manage.ts

@@ -297,7 +297,19 @@ export const MathManageTool = {
     name: 'math_manage',
     description: `Mathematical operations for RPG mechanics.
 
-🎲 DICE ROLLING (roll):
+⚠️ COMBAT REDIRECT - DO NOT USE FOR:
+- Attack rolls → Use combat_action { action: "attack" } instead
+- Spell damage → Use combat_action { action: "cast_spell" } instead
+- Saving throws in combat → combat_action handles these automatically
+The combat_action tool rolls dice, calculates damage, and applies HP changes in one call.
+
+🎲 DICE ROLLING (roll) - For NON-COMBAT situations:
+- Skill checks outside combat
+- Stat generation (4d6dl1)
+- Random tables/loot
+- NPC behavior rolls
+- Exploration/navigation
+
 Standard notation plus special modifiers:
 - 2d6+3: Basic roll with modifier
 - 4d6dl1: Drop lowest 1 (stat generation)
@@ -321,11 +333,6 @@ Calculate ranged attack trajectories:
 - height: Initial height (ft)
 - gravity: Default 32.2 ft/s²
 
-💡 WHEN TO USE:
-- Use roll for all dice-based mechanics
-- Use probability to analyze player options
-- Use projectile for siege weapons, falling objects
-
 Actions: roll, probability, solve, simplify, projectile`,
     inputSchema: z.object({
         action: z.string().describe(`Action: ${ACTIONS.join(', ')}`),

tmpclaude-2eaa-cwd

@@ -0,0 +1 @@
+/f/Github/mnehmos.rpg.mcp

tmpclaude-c517-cwd

@@ -0,0 +1 @@
+/f/Github/mnehmos.rpg.mcp