From 0d34b17a8c66d85b5634ad397d0786fe2eba004b Mon Sep 17 00:00:00 2001
From: Brad Harris <bmharris@gmail.com>
Date: Mon, 3 Aug 2026 22:04:32 -0600
Subject: [PATCH] Docs: cover the personality management MCP tools from #873

Adds the six new agent-scoped tools (list/create/update/delete_personality,
set/clear_active_personality) to the docs-pane built-in tools list and the
README interactive-agents table, and notes in the Personalities section that
agents can manage personalities on your behalf.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 README.md                                                 | 6 ++++++
 .../src/components/app/docs-sections/personalities.tsx    | 8 ++++++++
 apps/web/src/components/app/docs-sections/tools.tsx       | 7 +++++++
 3 files changed, 21 insertions(+)

diff --git a/README.md b/README.md
index c726dbcb..859396f7 100644
--- a/README.md
+++ b/README.md
@@ -206,6 +206,12 @@ Every agent launched by Dispatch gets access to MCP tools via an agent-scoped en
 | `create_template`               | Create a new reusable agent launch template                                |
 | `update_template`               | Update an existing template                                                |
 | `delete_template`               | Delete a template                                                          |
+| `list_personalities`            | List saved personalities and the active personality ID                     |
+| `create_personality`            | Create a saved personality                                                 |
+| `update_personality`            | Update a saved personality's name or prompt                                |
+| `delete_personality`            | Delete a saved personality (clears it if it was active)                    |
+| `set_active_personality`        | Set the active personality for subsequently launched agents                |
+| `clear_active_personality`      | Clear the active personality                                               |
 
 ### Persona agents
 
diff --git a/apps/web/src/components/app/docs-sections/personalities.tsx b/apps/web/src/components/app/docs-sections/personalities.tsx
index 873c0aab..19328de5 100644
--- a/apps/web/src/components/app/docs-sections/personalities.tsx
+++ b/apps/web/src/components/app/docs-sections/personalities.tsx
@@ -36,6 +36,14 @@ export function PersonalitiesContent() {
           prompt it was launched with — edits are picked up the next time an
           agent launches, or when a paused agent resumes.
         </P>
+        <P>
+          Agents can manage personalities too: standard agents get{" "}
+          <Code>list_personalities</Code>, <Code>create_personality</Code>,{" "}
+          <Code>update_personality</Code>, <Code>delete_personality</Code>,{" "}
+          <Code>set_active_personality</Code>, and{" "}
+          <Code>clear_active_personality</Code> MCP tools, so you can ask an
+          agent to draft, tweak, or switch the active personality for you.
+        </P>
       </Section>
 
       <Section>
diff --git a/apps/web/src/components/app/docs-sections/tools.tsx b/apps/web/src/components/app/docs-sections/tools.tsx
index 726f8d58..ed370a91 100644
--- a/apps/web/src/components/app/docs-sections/tools.tsx
+++ b/apps/web/src/components/app/docs-sections/tools.tsx
@@ -235,6 +235,13 @@ export function ToolsContent() {
             <Code>delete_template</Code> — manage reusable agent launch
             templates
           </li>
+          <li>
+            <Code>list_personalities</Code>, <Code>create_personality</Code>,{" "}
+            <Code>update_personality</Code>, <Code>delete_personality</Code>,{" "}
+            <Code>set_active_personality</Code>,{" "}
+            <Code>clear_active_personality</Code> — manage saved personalities
+            and which one is active (see the Personalities section)
+          </li>
         </ul>
         <P>
           By default, <Code>list_agents</Code> and{" "}