From 7172a4587e6bb01f59d3926379b74181778aacb8 Mon Sep 17 00:00:00 2001
From: Socialpranker <273312799+Socialpranker@users.noreply.github.com>
Date: Wed, 23 Sep 2026 09:05:45 +0200
Subject: [PATCH] =?UTF-8?q?docs(mcp):=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0?=
 =?UTF-8?q?=D0=BD=D0=B8=D1=8F=20=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BC?=
 =?UTF-8?q?=D0=B5=D0=BD=D1=82=D0=BE=D0=B2=20=E2=80=94=20=D0=B2=D1=81=D0=B5?=
 =?UTF-8?q?=206=20=D0=B0=D0=B4=D0=B0=D0=BF=D1=82=D0=B5=D1=80=D0=BE=D0=B2,?=
 =?UTF-8?q?=20burn=5Fcard,=20=D0=B1=D0=B5=D0=B7=20=D1=87=D0=B8=D1=81=D0=BB?=
 =?UTF-8?q?=D0=BE=D0=B2=D0=BE=D0=B3=D0=BE=20=D0=BF=D0=BE=D1=82=D0=BE=D0=BB?=
 =?UTF-8?q?=D0=BA=D0=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 agentburn/mcp.py         | 8 ++++++--
 skill/agentburn/SKILL.md | 4 ++--
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/agentburn/mcp.py b/agentburn/mcp.py
index e4d2bc5..08065b7 100644
--- a/agentburn/mcp.py
+++ b/agentburn/mcp.py
@@ -28,7 +28,7 @@
     "properties": {
         "agent": {
             "type": "string",
-            "description": "hermes | openclaw | claude-code (default: first detected)",
+            "description": "hermes | openclaw | claude-code | codex | gemini | opencode (default: first detected on this machine)",
         },
         "days": {"type": "integer", "description": "window in days (default 30, 0 = all time)"},
         "source": {
@@ -87,7 +87,11 @@
     },
     {
         "name": "burn_card",
-        "description": "Anonymized shareable burn summary (plain text, safe to post).",
+        "description": (
+            "Anonymized shareable burn summary as plain text: categories and counters only, "
+            "no session titles or file paths, safe to post publicly. Use it when the user wants "
+            "to share their numbers; for analysis use burn_report or burn_why instead."
+        ),
         "inputSchema": WINDOW,
     },
 ]
diff --git a/skill/agentburn/SKILL.md b/skill/agentburn/SKILL.md
index 2004e5e..22b49dc 100644
--- a/skill/agentburn/SKILL.md
+++ b/skill/agentburn/SKILL.md
@@ -45,8 +45,8 @@ database read-only. Use it instead of guessing about costs.
 5. For one channel ("what did you do in telegram?"):
    add `--source telegram` (or cron / heartbeat / subagent / cli).
 6. Answer in the user's language, lead with the verdict
-   (pace + dominant source), quote at most 3 numbers, then the single
-   highest-impact change. Mark estimated costs with "~".
+   (pace + dominant source), cite only the numbers the verdict rests on,
+   then the single highest-impact change. Mark estimated costs with "~".
 
 ## Fixing things