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
Examples:
morph__warpgrep_codebase_search
ast-grep__ast_grep
perplexity__perplexity_ask
Testing
Test with: uv run python -m runtime.harness scripts/<script>.py --help
1---2name: mcp-scripts3description: MCP Script Rules4---56# MCP Script Rules78When working with files in `scripts/`:910## DO11- Use CLI arguments for all parameters (argparse)12- Include USAGE docstring at top of file13- Use `call_mcp_tool("server__tool", params)` pattern14- Handle errors gracefully with informative messages15- Print results to stdout for Claude to process1617## DON'T18- Hardcode parameters in the script19- Edit scripts to change parameters (use CLI args instead)20- Import from servers/ directly (use runtime.mcp_client)2122## Tool Naming23Tool IDs use double underscore: `serverName__toolName`2425Examples:26- `morph__warpgrep_codebase_search`27- `ast-grep__ast_grep`28- `perplexity__perplexity_ask`2930## Testing31Test with: `uv run python -m runtime.harness scripts/<script>.py --help`
Run npx skillmds@latest add vibeeval/mcp-scripts in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
MCP Script Rules It is listed under AI & ML on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
vibeeval (@vibeeval) published this skill. Their other Agent Skills are listed on their SkillMD profile.
vibeeval