Skip to content

CLI Commands

Complete reference for the mcp-template command-line interface.

Global Options

--version          Show version information
--help            Show help message
--verbose, -v     Enable verbose output
--quiet, -q       Suppress output

Commands

list

List available templates.

mcpt list [OPTIONS]

Options: - --format TEXT: Output format (table, json, yaml) - --filter TEXT: Filter templates by name or tag

Examples: 

mcpt list
mcpt list --format json
mcpt list --filter database

deploy

Deploy a template (HTTP transport only).

mcpt deploy TEMPLATE [OPTIONS]

Arguments: - TEMPLATE: Template name to deploy

Options: - --port INTEGER: Port to bind (default: template default) - --env TEXT: Environment variable (KEY=value) - --local: Deploy locally without Docker - --docker: Force Docker deployment - --name TEXT: Custom deployment name

Examples: 

mcpt deploy demo
mcpt deploy demo --port 8080
mcpt deploy demo --env DEBUG=true --env LOG_LEVEL=debug

Note: Only HTTP transport templates can be deployed. Stdio transport templates will show an error with guidance to use run-tool instead.

run-tool

Run a specific tool from a stdio MCP template.

mcpt run-tool TEMPLATE TOOL_NAME [OPTIONS]

Arguments: - TEMPLATE: Template name - TOOL_NAME: Name of the tool to execute

Options: - --args TEXT: JSON arguments to pass to the tool - --config TEXT: Configuration values (KEY=VALUE) - --env TEXT: Environment variables (KEY=VALUE)

Examples: 

# Basic tool execution
mcpt run-tool github search_repositories --args '{"query": "mcp"}'

# With authentication
mcpt run-tool github create_issue \
  --args '{"owner": "user", "repo": "test", "title": "Bug"}' \
  --env GITHUB_PERSONAL_ACCESS_TOKEN=token

# With configuration
mcpt run-tool filesystem read_file \
  --args '{"path": "/data/file.txt"}' \
  --config allowed_directories='["/data"]' \
  --config read_only=true

tools

List available tools for a template or discover tools from a Docker image.

mcpt> tools [TEMPLATE] [OPTIONS]

Arguments: - TEMPLATE: Template name (optional if using --image)

Options: - --image TEXT: Docker image name to discover tools from - --no-cache: Ignore cached results - --refresh: Force refresh cached results - --config TEXT: Configuration values for dynamic discovery (KEY=VALUE)

Examples: 

# List tools for a template
mcpt> tools github
mcpt> tools filesystem

# Discover tools from Docker image
mcpt> tools --image mcp/github:latest

# List tools with configuration
mcpt> tools github --config github_token=your_token

# Force refresh tool discovery
mcpt> tools github --refresh

stop

Stop a running deployment.

mcpt stop NAME [OPTIONS]

Arguments: - NAME: Deployment name

Options: - --force: Force stop without graceful shutdown

remove

Remove a deployment.

mcpt remove NAME [OPTIONS]

Arguments: - NAME: Deployment name

Options: - --force: Remove without confirmation

logs

View deployment logs.

mcpt logs NAME [OPTIONS]

Arguments: - NAME: Deployment name

Options: - --follow, -f: Follow log output - --tail INTEGER: Number of lines to show - --since TEXT: Show logs since timestamp

status

Check deployment status.

mcpt status [NAME] [OPTIONS]

Arguments: - NAME: Deployment name (optional, shows all if omitted)

create

Create a new template.

mcpt create NAME [OPTIONS]

Arguments: - NAME: Template name

Options: - --author TEXT: Template author - --description TEXT: Template description - --port INTEGER: Default port