Skip to main content
Glama
YawLabs

SSH MCP Server

by YawLabs

Server Quality Checklist

67%
Profile completionA complete profile improves this server's visibility in search results.
  • Latest release: v0.11.7

  • Disambiguation5/5

    Each tool has a distinct and clearly defined purpose. For example, ssh_exec, ssh_multi_exec, ssh_test, and ssh_diagnose are all different operations (single command, parallel execution, quick check, deep diagnostics). File operations like ssh_read_file, ssh_download, and ssh_delete are well-separated. No two tools overlap in functionality.

    Naming Consistency5/5

    All tools follow the consistent pattern of `ssh_` prefix followed by a descriptive verb or verb_noun phrase (e.g., ssh_exec, ssh_key_list, ssh_known_hosts_fix). Naming is uniform in snake_case and logical, making it easy to predict tool names.

    Tool Count5/5

    21 tools is well-scoped for an SSH server covering connectivity, file transfer, command execution, key management, diagnostics, and service checks. Each tool addresses a specific need without bloat or redundancy.

    Completeness4/5

    The tool set covers a comprehensive range of SSH operations including file manipulation, command execution, diagnostics, key/agent management, and git auth testing. A notable omission is port forwarding/tunneling support, which is a common SSH use case. Aside from that, the surface is very complete.

  • Average 3.9/5 across 21 of 21 tools scored. Lowest: 3.2/5.

    See the Tool Scores section below for per-tool breakdowns.

    • No community issues in the last 6 months
    • 49 commits in the last 12 weeks
    • Last stable release on
    • No critical vulnerability alerts
    • No high-severity vulnerability alerts
    • No code scanning findings
    • CI status not available
  • This repository is licensed under MIT License.

  • This repository includes a README.md file.

  • No tool usage detected in the last 30 days. Usage tracking helps demonstrate server value.

    Tip: use the "Try in Browser" feature on the server page to seed initial usage.

  • Add a glama.json file to provide metadata about your server.

  • If you are the author, simply .

    If the server belongs to an organization, first add glama.json to the root of your repository:

    {
      "$schema": "https://glama.ai/mcp/schemas/server.json",
      "maintainers": [
        "your-github-username"
      ]
    }

    Then . Browse examples.

  • Add related servers to improve discoverability.

How to sync the server with GitHub?

Servers are automatically synced at least once per day, but you can also sync manually at any time to instantly update the server profile.

To manually sync the server, click the "Sync Server" button in the MCP server admin interface.

How is the quality score calculated?

The overall quality score combines two components: Tool Definition Quality (70%) and Server Coherence (30%).

Tool Definition Quality measures how well each tool describes itself to AI agents. Every tool is scored 1–5 across six dimensions: Purpose Clarity (25%), Usage Guidelines (20%), Behavioral Transparency (20%), Parameter Semantics (15%), Conciseness & Structure (10%), and Contextual Completeness (10%). The server-level definition quality score is calculated as 60% mean TDQS + 40% minimum TDQS, so a single poorly described tool pulls the score down.

Server Coherence evaluates how well the tools work together as a set, scoring four dimensions equally: Disambiguation (can agents tell tools apart?), Naming Consistency, Tool Count Appropriateness, and Completeness (are there gaps in the tool surface?).

Tiers are derived from the overall score: A (≥3.5), B (≥3.0), C (≥2.0), D (≥1.0), F (<1.0). B and above is considered passing.

Tool Scores

  • Behavior2/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    With no annotations, the description bears full responsibility for behavioral disclosure. It only states the protocol (SFTP) but fails to mention authentication requirements, potential errors (e.g., directory not found, permission denied), or whether the output is a flat list or includes metadata. This is insufficient for a tool that interacts with remote systems.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, well-formed sentence that conveys the core functionality without extraneous words. It is front-loaded and immediately understandable, making it easy for an AI agent to parse.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The tool is relatively simple, but the description omits important context: no output schema is provided, so the agent does not know the format of the listing (e.g., just names or with details). Also, no information about error handling or edge cases (e.g., nonexistent path) is given. This leaves the agent underinformed for invocation.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    All 6 parameters have schema descriptions (100% coverage), so the schema already provides meaning. The description adds no further detail beyond what is in the schema, such as the fact that 'password' is discouraged. The baseline of 3 is appropriate as the description does not compensate for any missing information.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description 'List files in a directory on a remote host via SFTP' is a specific verb+resource combination. It clearly states the action (list files), the target (a directory on a remote host), and the protocol (SFTP). This distinguishes it from siblings like ssh_read_file or ssh_exec.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description provides no guidance on when to use this tool versus the many sibling tools (e.g., ssh_stat, ssh_find). There is no mention of prerequisites, authentication methods, or when not to use it. This omission reduces its usefulness for an AI agent deciding among alternatives.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior2/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states the basic action without detailing authentication requirements, error handling, file size limits, or whether it returns raw content or requires a session. For a tool establishing an SFTP connection, much behavioral context is missing.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single sentence that conveys the core purpose efficiently without any fluff or redundant information. Every word serves a purpose, making it appropriately concise.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Despite having 6 parameters and no output schema or annotations, the description is minimal. It does not explain return values, error behavior, required authentication setup (e.g., SSH keys), or how the file content is presented. The schema covers parameters but not runtime behavior, leaving the agent underinformed.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The schema covers all 6 parameters with descriptions (100% coverage), so the baseline is 3. The tool description does not add extra semantics beyond what the schema already provides, but it also does not repeat information, so it meets the baseline.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the verb 'Read', the resource 'file from a remote host', and the protocol 'SFTP', making the tool's purpose unambiguous. It contrasts with siblings like ssh_write_file (write) and ssh_download (download), though ssh_download might overlap; however, the verb 'read' implies returning file contents, which is clear.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    No guidance is provided on when to use this tool versus alternatives like ssh_download or ssh_exec with cat. With many sibling tools, explicit context on usage scenarios or exclusions would greatly help an AI agent choose correctly.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior2/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    With no annotations, the description must fully disclose behavior but only states 'write content' and 'creates or overwrites'. Missing details: authentication method, required permissions, error handling, connection retry, handling of binary content, and whether the directory must exist. The password warning in the schema is not echoed in the description.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single concise sentence that clearly conveys the core function. No redundant words; every part serves a purpose. Front-loads the verb and resource.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Despite 7 parameters, no annotations, and no output schema, the description is extremely brief. It fails to explain return values, error cases, or important context like security considerations (password warning from schema). The tool is more complex than the description suggests.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema coverage is 100%, so the schema already documents parameters. The description adds no extra meaning beyond the schema. Baseline 3 is appropriate as the description does not compensate for any gaps.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the verb 'write content to a file' and the resource 'on a remote host via SFTP', which distinguishes it from siblings like ssh_read_file (read), ssh_delete (delete), or ssh_exec (execute commands). The phrase 'Creates or overwrites the file' further clarifies the operation's effect.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    No guidance is provided on when to use this tool vs. alternatives (e.g., ssh_upload for uploading files, ssh_exec for command execution). There is no discussion of prerequisites (e.g., directory existence, SFTP availability) or when not to use it (e.g., for large files or sensitive data).

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior2/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    No annotations are present, so the description must carry the full behavioral burden. It only states basic functionality. Missing details: overwrite behavior, error handling, authentication requirements, and any side effects. The password security warning is in the schema, not the description.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, well-structured sentence that immediately conveys action and method. No superfluous words; front-loaded with the key verb and resource.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    With 7 parameters, 100% schema coverage, and no output schema, the description is minimal. It does not explain return values, progress indication, cancellation, or error handling. For a simple file download, the core behavior is implied but not fully explicit.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema description coverage is 100%, with each parameter having a description (e.g., port, privateKeyPath, password warning). The tool description adds no further parameter meaning beyond what the schema already provides, meeting the baseline expectation.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action (Download a file), resource (from remote host to local filesystem), and method (via SFTP). It distinguishes this tool from siblings like ssh_upload, ssh_exec, and ssh_read_file by specifying the direction and protocol.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    No guidance is provided on when to use this tool versus alternatives. It does not mention prerequisites (e.g., SSH connectivity, key-based auth), nor does it advise against using it for directories or large files.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior2/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states the tool wraps find but omits side effects (e.g., resource intensity), return format, error handling, or security considerations (though password warning is in schema, not description).

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Two concise sentences front-load the purpose with no wasted words. Every sentence earns its place.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the complexity (13 parameters, no output schema), the description is too sparse. It does not explain return values, error behavior, or how results are presented. More context about the tool's behavior is needed.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema description coverage is 100%, so baseline is 3. The description adds no extra meaning beyond the overall purpose; it does not augment understanding of individual parameters.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the verb 'Search for files' and resource 'on a remote host', distinguishing it from sibling tools by mentioning it wraps the find command, which is unique among the listed tools.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description does not explicitly state when to use this tool versus alternatives. It implies usage for complex searches via find but lacks guidance on when not to use it (e.g., for simple listing, use ssh_ls). The parameter schema provides implicit context but description alone is insufficient.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior2/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    No annotations exist, so the description carries the full burden. It fails to disclose behavioral traits like authentication methods (key vs password), file overwrite behavior, error handling, or network requirements beyond the schema.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is a single, efficient sentence that conveys the core purpose without waste. It earns its place and is front-loaded with the key action.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    With 7 parameters, no output schema, and no annotations, the description is too brief. It omits crucial context like what the tool returns (success/failure), file size limits, and authentication flow, leaving agents underinformed.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema coverage is 100% with descriptions for all 7 parameters. The description adds no extra meaning beyond what the schema provides, so it meets the baseline of 3.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action ('Upload a local file to a remote host via SFTP'), using a specific verb and resource. It distinguishes from sibling tools like ssh_download and ssh_write_file by specifying the direction and method.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines3/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description implies usage for uploading files, but does not provide explicit guidance on when to use this tool over alternatives (e.g., ssh_write_file for content-based writing) or prerequisites (e.g., SSH access). No when-not-to-use conditions are mentioned.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior4/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    Discloses key behaviors: shell interpretation of metacharacters, returns stdout/stderr/exit code, env injection method, and policy checks. With no annotations, the description carries full burden and covers essential behavioral traits adequately.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Three sentences: first defines purpose, second explains shell behavior and returns, third covers env usage and policy. Front-loaded, no redundant information, every sentence earns its place.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Covers core behavior, env, and policy but lacks details on timeout behavior, error handling, or structured return format. Since no output schema exists, the description should provide more on the response shape. Adequate but with gaps.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema descriptions cover all 8 parameters (100%). The description adds no new parameter-level meaning beyond what the schema already provides (e.g., env injection is detailed in schema). Baseline score of 3 is appropriate.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    Clearly states 'Execute a command on a remote host via SSH'. Identifies the resource (remote host) and action (execute command), and differentiates from siblings like ssh_read_file or ssh_download by focusing on arbitrary command execution.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines2/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    No explicit when-to-use or when-not-to-use guidance. Does not compare to sibling tools like ssh_multi_exec or ssh_read_file, leaving the agent to infer usage context. Only mentions policy restrictions but not alternative scenarios.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior3/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    No annotations provided, so description carries burden. Describes checks but does not disclose whether the tool modifies any state (e.g., known_hosts) or if the test connection is read-only. Lacks explicit safety info.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Two sentences efficiently cover purpose, actions, and usage context. No redundancy.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness2/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    No output schema, yet description does not mention what the tool returns (e.g., summary or detailed report). An agent lacks info on output format, making it incomplete for a diagnostic tool.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema coverage is 100%; both host and port have descriptions. The description adds no further meaning beyond what the schema already provides.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the tool diagnoses SSH connectivity issues, listing specific checks (ssh-agent, keys, known_hosts, config, test connection). It distinguishes from many sibling tools that perform specific operations like exec, download, or upload.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    Explicitly states when to use: before SSH operations if connectivity issues are suspected, or after a failed SSH operation. This provides clear context, though it does not explicitly name alternative sibling tools like ssh_test.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior3/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    With no annotations, the description must reveal behavioral traits. It implies a read-only operation ('Read the last N lines') but does not state it explicitly. It lacks details on error handling, permissions, or return format.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Two concise sentences, front-loaded with the core purpose. No wasted words. Every sentence adds value.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    For a simple read-tail tool with no output schema, the description is adequate but incomplete. It does not describe the return value, error scenarios, or edge cases (e.g., file not found, permission denied).

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema description coverage is 100%, so baseline is 3. The description adds little beyond the schema: it mentions 'lines' and 'grep' but without expanding on their syntax or constraints.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the tool's purpose: 'Read the last N lines of a file on a remote host, optionally filtering by a grep pattern.' It uses a specific verb ('Read') and resource ('file on a remote host'), and differentiates from a sibling ('Use this for reading log files instead of ssh_exec with manual tail/grep commands').

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    Explicitly recommends use for log files over ssh_exec, providing a clear alternative. However, it does not discuss other contexts like reading large files or when not to use this tool.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior3/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    No annotations are provided, so the description must disclose behavior. It indicates a read-only operation by stating it 'shows' configuration, but does not mention permissions, side effects, or what happens if the host is not found. It adds some value beyond the schema but lacks full transparency.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is two sentences, front-loaded with the main purpose, and includes a clear user instruction. Every sentence is essential and there is no fluff.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness4/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    For a simple tool with one parameter and no output schema, the description adequately explains the function and output. It lacks details about edge cases (e.g., missing config) but is mostly complete given the simplicity.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    The input schema has 100% coverage with a description for 'host' ('SSH hostname or IP address'). The description confirms the parameter's role but adds no extra semantics beyond the schema.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the tool resolves effective SSH configuration for a host and lists specific items it shows (hostname, user, port, etc.). It distinguishes from sibling tools like ssh_exec or ssh_diagnose by focusing on configuration lookup.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description says 'Use this to understand how SSH will connect to a host,' which provides clear context. However, it does not explicitly mention when not to use it or alternatives among siblings.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior3/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    No annotations provided, so description carries the burden. It states 'Ensures the agent is running first', implying a possible side effect, but does not detail failure modes, persistence, or behavior if key already loaded.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Two sentences, front-loaded with the main action, no wasted words. Every sentence adds value.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness4/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Adequate for a simple tool with one parameter. Covers purpose, prerequisite, and usage timing. Lacks mention of return values or error handling, but no output schema exists.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema coverage is 100%, with the schema already describing keyPath. The description adds no new semantics beyond 'Load an SSH private key', which is redundant with the parameter's purpose.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action ('Load an SSH private key') and the resource ('into the running agent'). It distinguishes from siblings like ssh_key_list and ssh_agent_ensure.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    Explicitly says to use after ssh_key_list shows an unloaded key, providing clear context. It mentions ensuring the agent is running first but does not explicitly list alternatives or when not to use.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior3/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    No annotations provided, so description must disclose behavior. States it tests connectivity and reports timing and error details, but lacks detail on side effects (e.g., modifying known_hosts) or authentication requirements.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Two sentences, no wasted words. Front-loaded with purpose and outcome, includes comparative guidance efficiently.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness4/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    No output schema, but description hints at output format (success/failure, timing, error details). Differentiates from sibling and covers key usage context; could mention authentication but not critical.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema covers both parameters with descriptions (host, port with default). Description adds no extra parameter detail, but conciseness is acceptable given full schema coverage.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    Clearly states tool does a quick SSH connectivity test returning success/failure with timing and error details. Distinguishes from sibling ssh_diagnose as lighter and faster.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    Explicitly says use for quick check before operations and contrasts with ssh_diagnose. Does not explicitly list when not to use, but implication is clear.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior4/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    Despite no annotations, description clearly indicates this is a read-only diagnostic test verifying SSH key registration; no side effects mentioned but implied non-destructive.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Two concise sentences with front-loaded purpose and immediate usage scenario; zero wasted words.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness3/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Adequate for a simple diagnostic tool, but lacks description of output format or return values, which is especially needed since no output schema is provided.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema coverage is 100% with parameter descriptions; description only adds default host value, not enhancing meaning beyond schema.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    Description clearly specifies 'Test Git-over-SSH authentication' with explicit hosting examples, distinguishing it from sibling SSH tools that are more general.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    States 'Use this when git clone/pull/push fails with SSH errors', providing clear context; lacks explicit 'when not to use' but strong positive guidance.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior3/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    With no annotations, the description carries the full burden of behavioral disclosure. It explicitly states the directory and output fields, which is adequate for a simple listing tool. However, it does not mention error handling (e.g., if ~/.ssh/ does not exist) or limitations (e.g., handling of subdirectories).

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Two concise sentences: the first states the tool's purpose, the second gives usage guidance. No redundant information, and the key points are front-loaded.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness4/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given no parameters, no output schema, and no annotations, the description effectively covers the tool's purpose, scope, and use case. It does not detail the return format, but that is predictable for a listing tool. Slightly more on error scenarios could improve completeness.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters4/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    There are no parameters, so the schema coverage is 100% by default. The description provides useful context about what is listed (keys in ~/.ssh/ with specific attributes), adding value beyond the schema.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the tool lists SSH private keys in a specific directory (~/.ssh/) and specifies the output fields (type, fingerprint, loaded status). It effectively distinguishes from sibling tools like ssh_key_load.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description includes a clear use case: 'find which keys are available and which ones need to be loaded.' It implicitly suggests when to use this tool over alternatives like ssh_key_load, but does not explicitly mention when not to use it.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior4/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    Discloses the main behavioral trait: it removes a stale key and re-scans to add the current key. No annotations provided, so description carries the burden; it adequately describes the side effect on known_hosts without extra details on permissions or errors.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Two sentences, no wasted words. First sentence explains the action, second provides usage context. Highly efficient and easy to parse.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness4/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given two simple parameters, no output schema, and clear description, the tool is sufficiently described. It covers purpose, trigger, and behavior. Minor omission: could mention that it modifies the known_hosts file, but it's implied by 'remove from known_hosts'.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema coverage is 100%, so the description does not need to add parameter details. The description does not enhance understanding of the host or port parameters beyond what the schema provides, leading to a baseline score of 3.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the tool's action: remove a stale host key and re-scan the host. It specifies the resource (known_hosts) and the verb (fix). It distinguishes from sibling tools by targeting a specific SSH issue, 'Host key verification failed'.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    Provides explicit guidance on when to use the tool: when 'Host key verification failed' errors occur, typically after server reprovisioning. No explicit when-not or alternatives, but the context is clear and sufficient for selection among siblings.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior4/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    No annotations are provided, so the description carries the full burden. It details the exact metadata returned (e.g., permissions in octal, type flags) and mentions SFTP protocol. It does not disclose potential behaviors like symlink following or error handling, but for a straightforward stat operation this is acceptable.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description consists of two sentences that are front-loaded with the action and key details. Every sentence adds value, with no redundancy or irrelevant information.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness5/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given the absence of an output schema, the description thoroughly explains the return values, listing all relevant fields. It is complete for a metadata retrieval tool with no complex behavior.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema coverage is 100% with descriptions for all parameters. The description does not add meaning beyond the schema; it mentions no additional parameter details. Baseline score of 3 is appropriate since the schema already documents parameters well.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the action ('get metadata'), the resource ('file or directory on a remote host via SFTP'), and lists the specific return fields (size, permissions, uid/gid, mtime/atime, type flags). It distinguishes from parsing `ls -la` output, making the purpose unambiguous.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description explicitly advises to use this tool instead of parsing `ls -la` output, providing a clear usage scenario. However, it does not explicitly state when not to use it or compare it to sibling tools like ssh_ls, which could be a common alternative.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior4/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    No annotations exist, so the description carries full burden. It discloses key behaviors: auto-detection of path type, unsupported recursive delete, and the underlying SFTP ops used. However, it does not mention what happens when trying to delete a non-empty directory or what the return value looks like.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Two sentences, no wasted words. First sentence defines purpose and behavior, second sentence states limitation and alternative. Information is front-loaded.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness4/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    No output schema, so return values are not explained. The description covers core behavior, limitations, and alternatives well. Lacks details on error handling and authentication flow, but these are partially covered by the input schema.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema coverage is 100%, so each parameter has a description. The description adds contextual value for the 'path' parameter by noting auto-detection but does not elaborate on other parameters beyond the schema.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states that the tool deletes a file or empty directory on a remote host via SFTP, specifying the specific resources (files/symlinks and empty dirs) and action. It also differentiates itself from sibling tool ssh_exec by noting that recursive delete is intentionally unsupported.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines5/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    Explicitly tells when to use (delete files/empty dirs) and when not to (recursive delete). Provides a clear alternative: use ssh_exec with `rm -rf` for recursive deletion, with rationale about traceability.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior4/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    No annotations provided, so description carries burden. Explains recursive creation, tolerance of existing parent dirs, and error on existing leaf. Lacks authentication details but implies SFTP use.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Two concise sentences with front-loaded action. Every sentence earns its place with specific behavior.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness4/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Given no output schema and full parameter coverage, description explains recursive behavior and error handling effectively. Could mention permission assumptions.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters4/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Adds value beyond schema: explains recursive like mkdir -p, notes absolute path requirement, and highlights password security. Schema already covers 100% of parameters.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    Clearly states action and method: 'Create a directory on a remote host via SFTP.' Distinguishes from sibling tools like ssh_delete, ssh_ls, etc.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    Provides guidance on recursive flag behavior and error conditions. Could explicitly recommend against using ssh_exec for mkdir, but for a dedicated tool, context is adequate.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior4/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    The description indicates the tool performs a read-only status check via systemctl, which implies no destructive side effects. It discloses the returned data but does not detail authentication requirements or potential error conditions. However, for a simple status tool, the transparency is adequate.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    The description is two sentences, front-loading the core function and then providing guidance. Every sentence adds value with no redundancy.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness4/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    For a simple status-check tool, the description adequately covers purpose, output, and usage context. The absence of an output schema is compensated by listing the returned fields. Minor gaps (e.g., error handling) are acceptable given the tool's simplicity.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters3/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    With 100% schema description coverage, the schema already documents all parameters. The description adds no new semantic information about parameters beyond the schema, but it reinforces that the tool uses systemctl for service status. Baseline 3 is appropriate.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the tool's purpose: checking the status of a systemd service on a remote host, and lists the returned information (active status, PID, uptime, description). It uses a specific verb ('Check') and resource ('systemd service on a remote host'), distinguishing it from sibling tools like ssh_exec.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines5/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    The description explicitly advises to 'Use this instead of ssh_exec with systemctl', providing clear guidance on when to use this tool versus the sibling ssh_exec tool. This effectively differentiates the tool and gives context for selection.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior4/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    Discloses key behaviors: starts a new agent if needed and sets environment variables. However, it omits potential side effects (e.g., overwriting existing SSH_AUTH_SOCK or SSH_AGENT_PID). With no annotations, the description carries the full transparency burden, and it is mostly clear.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Two sentences, both essential: first explains what the tool does, second gives usage context. No redundant or extraneous text. Structure is front-loaded with the purpose.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness5/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    The tool is simple (no parameters, no output schema) and the description fully covers its purpose, behavior, and when to use it. It is complete for an environment setup tool.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters4/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    No parameters exist; schema coverage is 100% (empty). Per guidelines, baseline score for 0 parameters is 4. The description adds no parameter info, which is appropriate since none are needed.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description clearly states the verb 'Ensure' with resource 'ssh-agent' and specifies outcomes: running, reachable, sets environment variables. It distinguishes from sibling tools (e.g., ssh_exec, ssh_download) by focusing on agent management rather than file operations or execution.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines4/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    Explicit guidance: 'Use this FIRST when SSH operations fail with agent-related errors.' This tells when to use the tool but does not explicitly mention when not to use it (e.g., if agent is already functional). The 'FIRST' strongly implies it is a prerequisite step.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

  • Behavior4/5

    Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

    Discloses parallel execution, per-host result return, and policy check before fan-out. With no annotations, this adds useful behavioral context. However, lacks details on partial failures or error handling, preventing a top score.

    Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

    Conciseness5/5

    Is the description appropriately sized, front-loaded, and free of redundancy?

    Three sentences with no wasted words. Front-loaded with purpose, then usage guidance, then behavioral note. Every sentence earns its place.

    Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

    Completeness4/5

    Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

    Covers key aspects for a parallel execution tool (parallelism, policy, alternative to single exec). Missing explicit description of output format (e.g., how results per host are structured) and no output schema, leaving a minor gap.

    Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

    Parameters4/5

    Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

    Schema covers 100% of parameters with descriptions. The tool description does not add much beyond schema (e.g., no elaboration on hosts/command format). Since schema is comprehensive, the description's contribution is minimal, earning a 4.

    Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

    Purpose5/5

    Does the description clearly state what the tool does and how it differs from similar tools?

    The description uses specific verbs and resources: 'Execute a command on multiple remote hosts in parallel'. It clearly distinguishes itself from the sibling ssh_exec by explicitly stating 'Use this instead of calling ssh_exec multiple times'.

    Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

    Usage Guidelines5/5

    Does the description explain when to use this tool, when not to, or what alternatives exist?

    Explicit guidance on when to use ('Use this instead of calling ssh_exec multiple times — it's faster and shows results side by side') and mentions policy constraints (whitelist/blacklist). No explicit when-not, but the directive is clear and sufficient.

    Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

GitHub Badge

Glama performs regular codebase and documentation scans to:

  • Confirm that the MCP server is working as expected.
  • Confirm that there are no obvious security issues.
  • Evaluate tool definition quality.

Our badge communicates server capabilities, safety, and installation instructions.

Card Badge

ssh-mcp MCP server

Copy to your README.md:

Score Badge

ssh-mcp MCP server

Copy to your README.md:

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/YawLabs/ssh-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server