CtrlK
BlogDocsLog inGet started
Tessl Logo

finkel/mcp-tool-naming

Guidelines for naming MCP tools, describing parameters, and documenting tools in a language- and framework-agnostic manner

97

1.02x
Quality

Pending

Does it follow best practices?

Impact

97%

1.02x

Average score across 5 eval scenarios

SecuritybySnyk

Pending

The risk profile of this skill

Overview
Eval results
Files

task.mdevals/scenario-2/

File System Tool Parameter Documentation

Problem/Feature Description

SecureFile Systems is developing an MCP tool for secure file operations. They need comprehensive parameter documentation for their secure_file_operations tool that handles:

  1. File encryption/decryption - Encrypt or decrypt files with various algorithms
  2. Secure deletion - Overwrite files multiple times before deletion
  3. File integrity checking - Verify file hasn't been tampered with using checksums
  4. Batch operations - Process multiple files with consistent settings
  5. Access logging - Track who accessed files and when

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.

Output Specification

Create a JSON file file_tool_parameters.json documenting the parameters for the secure_file_operations tool. The file should contain:

  1. A complete parameter list for the tool with at least 8 parameters covering the features above
  2. For each parameter:
    • name - Parameter identifier
    • type - Data type
    • description - Clear explanation of what the parameter does
    • required - true/false
    • Additional fields as appropriate (examples, constraints, default values, units, etc.)

Focus on creating parameter documentation that:

  • Uses appropriate type names that work across programming languages
  • Clearly documents constraints and validation rules
  • Includes examples for complex parameters
  • Specifies units where relevant (e.g., size in bytes, time in milliseconds)
  • Documents default values for optional parameters

The documentation should enable an AI agent to correctly use the tool without guessing about parameter formats or constraints.

tile.json