diff --git a/trustgraph-cli/scripts/tg-set-tool b/trustgraph-cli/scripts/tg-set-tool
index 479a4315..6578ba06 100755
--- a/trustgraph-cli/scripts/tg-set-tool
+++ b/trustgraph-cli/scripts/tg-set-tool
@@ -1,7 +1,10 @@
 #!/usr/bin/env python3
 
 """
-Sets a prompt template.
+Configures and registers tools in the TrustGraph system.
+Allows defining tool metadata including ID, name, description, type,
+and argument specifications. Tools are stored in the agent configuration
+and indexed for discovery and execution.
 """
 
 from typing import List
@@ -93,6 +96,28 @@ def main():
     parser = argparse.ArgumentParser(
         prog='tg-set-tool',
         description=__doc__,
+        epilog=textwrap.dedent('''
+            Valid tool types:
+              knowledge-query    - Query knowledge bases
+              text-completion    - Text completion/generation
+              mcp-tool          - Model Control Protocol tool
+            
+            Valid argument types:
+              string            - String/text parameter
+              number            - Numeric parameter
+            
+            Examples:
+              %(prog)s --id weather --name "Weather lookup" \\
+                       --type knowledge-query \\
+                       --description "Get weather information" \\
+                       --argument location:string:"Location to query" \\
+                       --argument units:string:"Temperature units (C/F)"
+              
+              %(prog)s --id calculator --name "Calculator" --type mcp-tool \\
+                       --description "Perform calculations" \\
+                       --argument expression:string:"Mathematical expression"
+        ''').strip(),
+        formatter_class=argparse.RawDescriptionHelpFormatter
     )
 
     parser.add_argument(