MCP Script Rules
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__toolNamedon't have the plugin yet? install it then click "run inline in claude" again.