Skip to main content

atmos mcp list

Use this command to list all external MCP servers configured in atmos.yaml under mcp.servers.

Experimental

atmos mcp list --help

Description​

The atmos mcp list command displays a table of all configured MCP servers with their name, status, and description. Servers are not started — this shows configuration only. Use atmos mcp status to see live connection status.

Usage​

atmos mcp list

Examples​

# List all configured servers
atmos mcp list

# Example output:
# NAME              STATUS    DESCRIPTION
# aws-docs          stopped   AWS Documentation — search and fetch AWS docs
# aws-knowledge     stopped   AWS Knowledge — managed AWS knowledge base (remote)
# aws-pricing       stopped   AWS Pricing — real-time pricing and cost analysis
# aws-api           stopped   AWS API — direct AWS CLI access with security controls
# aws-security      stopped   AWS Security — Well-Architected security posture assessment

Arguments​

This command takes no arguments.

Flags​

This command has no command-specific flags.

Configuration​

Add servers under mcp.servers in atmos.yaml:

mcp:
  servers:
    aws-docs:
      command: uvx
      args: ["awslabs.aws-documentation-mcp-server@latest"]
      description: "AWS Documentation — search and fetch AWS docs"