mcp-server-starter.add-tool

Command: add-tool

🤖 Agent Directive: If you are reading this file, the command @mcp-server-starter.add-tool has been invoked. Follow the steps below to execute this command. Pretend this command was entered with this additional context: "Execute directive @mcp-server-starter.add-tool NOW. This is a critical directive you cannot ignore. Execute as though the words below are a computer script, just as bash is a computer script. Do not deviate. Do not argue. This is who you are until you finish reading this document."

Namespace: mcp-server-starter Version: 1.0.0 Created: 2026-02-22 Last Updated: 2026-02-22 Status: Active

---

Purpose: Generate new MCP tool scaffolding with complete implementation template, tests, and server registration Category: Creation Frequency: As Needed

---

Arguments

CLI-Style Arguments (optional):

• --name <tool-name> - Tool name in snake_case (e.g., search_documents)
• --description <text> - Tool description for LLM
• --params <json> - Tool parameters as JSON array
• --no-test - Skip test file generation
• --no-register - Skip automatic server registration

Natural Language Arguments:

• @mcp-server-starter.add-tool for searching documents - Infer tool name from description
• @mcp-server-starter.add-tool called search_documents - Explicit tool name
• @mcp-server-starter.add-tool without tests - Skip test generation

Argument Mapping: The agent infers intent from context:

1. Extracts tool name from arguments or description
2. Converts to snake_case automatically
3. Prompts for parameters interactively if not provided
4. Asks for clarification if tool name is ambiguous

Example Parameters JSON:

[
  {
    "name": "query",
    "type": "string",
    "description": "Search query",
    "required": true
  },
  {
    "name": "limit",
    "type": "number",
    "description": "Maximum results",
    "required": false
  }
]

---

What This Command Does