Skip to content

[cli-consistency] Missing documentation for gh aw mcp list-tools subcommand #3710

@github-actions

Description

@github-actions

Issue Description

Command: gh aw mcp list-tools
Type: Missing documentation
Priority: Medium

Current State

The mcp list-tools subcommand exists in the source code but is not documented in docs/src/content/docs/setup/cli.md.

Source Code Reference: pkg/cli/mcp_list_tools.go

Use:   "list-tools (mcp_server) [workflow-file]",
Short: "List available tools for a specific MCP server",

Documentation Location: docs/src/content/docs/setup/cli.md lines 304-308

Current Documentation

The MCP command section currently shows:

gh aw mcp list                             # List all MCP servers
gh aw mcp list workflow-name               # List servers for specific workflow
gh aw mcp inspect workflow-name            # Inspect and test servers
gh aw mcp add                              # Add servers from registry

Issue

The mcp list-tools subcommand is completely missing from the documentation, even though it's a functional command in the CLI.

Suggested Fix

Add the mcp list-tools subcommand to the documentation:

gh aw mcp list                             # List all MCP servers
gh aw mcp list workflow-name               # List servers for specific workflow
gh aw mcp list-tools (mcp-server)          # List tools for specific MCP server
gh aw mcp list-tools (mcp-server) workflow # List tools in specific workflow
gh aw mcp inspect workflow-name            # Inspect and test servers
gh aw mcp add                              # Add servers from registry

Impact

Users may not discover this useful command since it's not documented. This could lead to:

  • Reduced discoverability of MCP functionality
  • Users not knowing how to list available tools for MCP servers
  • Inconsistent documentation coverage

Additional Context

This command appears to be a core part of the MCP functionality and should be documented alongside the other MCP subcommands.

AI generated by CLI Consistency Checker

Metadata

Metadata

Assignees

Labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions