Guidelines for naming MCP tools, describing parameters, and documenting tools in a language- and framework-agnostic manner
97
Pending
Does it follow best practices?
Impact
97%
1.02xAverage score across 5 eval scenarios
Pending
The risk profile of this skill
SecureFile Systems is developing an MCP tool for secure file operations. They need comprehensive parameter documentation for their secure_file_operations tool that handles:
The tool has complex parameters that need clear documentation so AI agents can use it correctly. Parameters include encryption algorithms, key sizes, overwrite patterns, checksum types, batch sizes, and log formats.
The development team has implemented the functionality but needs help documenting the parameters in a way that's clear, complete, and follows MCP best practices.
Create a JSON file file_tool_parameters.json documenting the parameters for the secure_file_operations tool. The file should contain:
name - Parameter identifiertype - Data typedescription - Clear explanation of what the parameter doesrequired - true/falseFocus on creating parameter documentation that:
The documentation should enable an AI agent to correctly use the tool without guessing about parameter formats or constraints.