Skip to main content

​
Quick Reference

CommandPurpose
mcp-t quickstartComplete onboarding experience for first-time users
mcp-t generateAutomatically generate test suites using AI
mcp-t run <suite-id> <server-id>Execute test suite against MCP server
mcp-t create serverCreate MCP server configuration
mcp-t create suiteCreate test suite with type selection
mcp-t list [type]List available configurations
mcp-t show <type> <id>Show detailed configuration
mcp-t report issueReport bugs or issues
mcp-t --versionShow version information
mcp-t --helpShow help for any command

​
Commands by Category

​
Setup & Onboarding

​
mcp-t quickstart

Complete onboarding experience for first-time users with streamlined workflow.

​
Syntax

mcp-t quickstart

​
Test Execution

Commands for running tests against MCP servers.

​
mcp-t run

Execute test suites against MCP servers with comprehensive reporting.

​
Syntax

mcp-t run <suite-id> <server-id> [options]

​
Arguments

  • suite-id - ID of the test suite to execute (supports tab completion)
  • server-id - ID of the MCP server to test against (supports tab completion)

​
Options

  • --verbose, -v - Show detailed test execution output
  • --global - Save results to global directory instead of local ./test_results/

​
Examples

# Basic test execution
mcp-t run basic-tests dev-server

# Verbose output with detailed conversation logs
mcp-t run user-workflows prod-server --verbose

# Save results to global directory
mcp-t run compliance-suite staging-server --global

​
Configuration Management

​
mcp-t create

Interactive configuration creation with templates and guided setup.

​
Syntax

mcp-t create <type> [options]

​
Subcommands

  • mcp-t create server - Create MCP server configuration
  • mcp-t create suite - Create test suite with type selection

​
mcp-t create server

Create MCP server configuration with guided setup.

​
Syntax

mcp-t create server [options]

​
Options

  • --global - Save configuration globally (~/.config/mcp-t/) instead of locally (./configs/)
  • --id <server-id> - Specify server ID (if not provided, will prompt)

​
Examples

# Interactive server creation
mcp-t create server

# Create server with specific ID
mcp-t create server --id prod-server-1

# Save to global configuration directory
mcp-t create server --global --id shared-dev-server

​
mcp-t create suite

Create test suite with interactive type selection and templates.

​
Syntax

mcp-t create suite [options]

​
Options

  • --global - Save configuration globally instead of locally
  • --id <suite-id> - Specify suite ID (if not provided, will prompt)

​
Examples

# Full interactive suite creation with type selection
mcp-t create suite

# Create suite with specific ID
mcp-t create suite --id my-integration-tests

​
mcp-t list

View existing configurations and their details.

​
Syntax

mcp-t list [type] [options]

​
Subcommands

  • mcp-t list - Show all configurations (servers and suites)
  • mcp-t list servers - Show only server configurations
  • mcp-t list suites - Show only test suite configurations

​
Examples

# List all configurations
mcp-t list

# List only servers
mcp-t list servers

# List only test suites
mcp-t list suites

​
mcp-t show

Display detailed configuration information for servers or test suites.

​
Syntax

mcp-t show <type> <id>

​
Subcommands

  • mcp-t show server <server-id> - Display server configuration details
  • mcp-t show suite <suite-id> - Display test suite configuration details

​
Examples

# Show server details
mcp-t show server prod-server

# Show suite details
mcp-t show suite user-workflows

​
Test Generation

​
mcp-t generate

Starts a wizard to automatically generate comprehensive test suites for MCP servers using AI-powered research and test creation. For detailed information, see the Automatic Test Generation guide.

​
Syntax

mcp-t generate [options]

​
Options

  • --global - Save generated test suite globally (~/.config/mcp-t/) instead of locally (./configs/)

​
Reporting

​
mcp-t report issue

Report bugs or issues with the MCP Testing Framework.

​
Syntax

mcp-t report issue [options]

​
Options

  • --category - Issue category selection
  • --title - Brief issue title
  • --description - Detailed issue description
  • --no-diagnostics - Exclude system diagnostic information
  • --no-history - Exclude recent command history
  • --dry-run - Preview report without submitting

​
Description

Opens an interactive bug report form to collect information about issues and submit them to the development team.

​
Examples

# Interactive bug report
mcp-t report issue

# Report with specific details
mcp-t report issue --category bug --title "CLI crashes on startup"

# Preview report without submitting
mcp-t report issue --dry-run

​
Configuration Reference

​
Storage Locations

​
Configuration Files

Local Configurations (Project-specific): 
./configs/
├── servers/          # MCP server configurations
│   ├── dev-server.json
│   └── prod-server.json
└── suites/           # Test suite configurations
    ├── basic-tests.json
    └── user-workflows.json
Global Configurations (System-wide): 
~/.config/mcp-t/
├── servers/          # Shared server configurations
│   └── shared-prod.json
└── suites/           # Shared test suites
    ├── compliance-suite.json
    └── security-suite.json

​
Test Results

Local Results (default): 
./test_results/
└── runs/
    ├── 2025-01-15_14-30-45_basic-tests_dev-server/
    └── 2025-01-15_15-22-10_compliance_prod-server/
Global Results (with --global flag): 
~/.local/share/mcp-t/
├── results/
│   └── runs/
│       ├── 2025-01-15_14-30-45_basic-tests_dev-server/
│       └── 2025-01-15_15-22-10_compliance_prod-server/
└── cache/

​
Configuration Precedence

  1. Local configurations (./configs/) - Highest priority
  2. Global configurations (~/.config/mcp-t/) - Fallback
  3. Built-in templates - Default templates for creation

​
Shell Completion

Automatic tab completion for commands, server IDs, suite IDs, and options.

​
Setup

# Automatic during quickstart
mcp-t quickstart

​
Supported Shells

  • Bash - Full tab completion support
  • Zsh - Full tab completion support

​
Tab Completion Features

  • Commands: mcp-t [TAB] shows all available commands
  • Server IDs: mcp-t run my-suite [TAB] shows configured servers
  • Suite IDs: mcp-t run [TAB] shows available test suites
For additional help and troubleshooting resources, see the FAQ.
⌘I