mcp-scripts
Guidelines for writing, testing, and formatting internal MCP scripts.
Install
mkdir -p .claude/skills/mcp-scripts && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/1560" && unzip -o skill.zip -d .claude/skills/mcp-scripts && rm skill.zipInstalls to .claude/skills/mcp-scripts
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
MCP Script RulesKey capabilities
- →Enforce CLI argument parsing using argparse
- →Standardize tool naming with double underscores
- →Implement runtime error handling
- →Execute script tests via harness
How it works
The skill mandates a specific structure for scripts in the scripts/ directory, requiring CLI argument parsing and the use of a runtime harness for testing.
Inputs & outputs
When to use mcp-scripts
- →Standardize internal script development
- →Format MCP tool output
- →Implement argparse in scripts
- →Run script tests via harness
About this skill
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
Examples:
morph__warpgrep_codebase_searchast-grep__ast_grepperplexity__perplexity_ask
Testing
Test with: uv run python -m runtime.harness scripts/<script>.py --help
When not to use it
- →Hardcoding parameters in scripts
- →Importing directly from servers directory
Prerequisites
Limitations
- →Requires scripts to be placed in the scripts/ directory
How it compares
It replaces ad-hoc script development with a strict convention for tool naming and parameter handling.
Compared to similar skills
mcp-scripts side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| mcp-scripts (this skill) | 4 | 7mo | No flags | Beginner |
| openspec-onboard | 10 | 6mo | Review | Beginner |
| workflow-orchestration-patterns | 10 | 2mo | No flags | Advanced |
| meta-automation-architect | 7 | 8mo | Review | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by parcadei
View all by parcadei →You might also like
openspec-onboard
studyzy
Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
workflow-orchestration-patterns
wshobson
Design durable workflows with Temporal for distributed systems. Covers workflow vs activity separation, saga patterns, state management, and determinism constraints. Use when building long-running processes, distributed transactions, or microservice orchestration.
meta-automation-architect
comzine
Use when user wants to set up comprehensive automation for their project. Generates custom subagents, skills, commands, and hooks tailored to project needs. Creates a multi-agent system with robust communication protocol.
hive-mind-advanced
ruvnet
Advanced Hive Mind collective intelligence system for queen-led multi-agent coordination with consensus mechanisms and persistent memory
openspec-new-change
studyzy
使用实验性的产出物工作流启动一个新的 OpenSpec 变更。当用户想要通过结构化的分步方法创建新功能、修复或修改时使用。
router-first-architecture
parcadei
Router-First Architecture