MCP Script Rules

When working with files in scripts/:

DO

• Use CLI arguments for all parameters (argparse)
• Include USAGE docstring at top of file
• Use call_mcp_tool("server__tool", params) pattern
• Handle errors gracefully with informative messages
• Print results to stdout for Claude to process

DON'T

• Hardcode parameters in the script
• Edit scripts to change parameters (use CLI args instead)
• Import from servers/ directly (use runtime.mcp_client)

Tool Naming

Tool IDs use double underscore: serverName__toolName