stpr — Stepper Skills CLI

Skill Sets are a Stepper feature that let you bundle integration actions into curated, authenticated toolkits — and expose them to AI agents, CLIs, and any MCP-compatible client.

stpr is a command-line interface for interacting with Stepper Skill Sets. Discover, inspect, and execute integration actions directly from your terminal. This is perfect for OpenClaw or agents that can interact with a CLI, or for developers who want to use skills in their own scripts.

If you prefer, you can directly use the Stepper MCP server at https://mcp.stepper.io/skill-sets/mcpinstead of the CLI.

Installation

npm install -g stpr

Authentication

The CLI supports three authentication methods:

OAuth Login (recommended)

stpr login

Opens your browser to authenticate and select a Skill Set. Credentials are saved to ~/.config/stepper-skillsets/config.json and automatically refreshed when they expire.

Static Token

Generate a token from Stepper and pass it directly:

stpr --token sst_your_token_here list

Environment Variable

export STEPPER_SKILL_TOKEN=sst_your_token_here
stpr list

Commands

Profile Management

stpr login                # Authenticate via OAuth (opens browser)
stpr logout [name]        # Remove a saved profile, or all profiles if no name given
stpr profiles             # List all saved profiles
stpr use <name>           # Switch the active profile
stpr whoami               # Show active profile and server info

Discovering Skills

stpr list                 # List all available skills, grouped by service
stpr list --verbose       # Include full input schemas
stpr list <service>       # List skills for a specific service
stpr <service>            # Shorthand for listing a service's skills

Inspecting Parameters

Many skills have dynamic parameters — fields that change based on the values of other fields. Calling a skill without --call returns its current parameter schema.

# See what fields are needed for add_row, given a spreadsheet
stpr google-sheets add_row -i '{"spreadsheet_id": "abc123"}'

Some parameters have dynamic dropdown options. Fetch them with --options:

stpr google-sheets add_row --options worksheet_id \
  -i '{"spreadsheet_id": "abc123"}' \
  --search "Sheet" \
  --cursor "next_page"

Calling Skills

Use the --call flag to execute an action:

stpr google-sheets create_sheet --call \
  -i '{"name": "Q1 Report", "columns": "Name, Email, Phone"}'

Polling Async Results

Component library tools run asynchronously. Poll for results with:

stpr status <statusId>

Input

Pass JSON input via the -i / --input flag or pipe it through stdin:

# Flag
stpr slack send_message --call -i '{"channel": "#general", "text": "Hello!"}'

# Stdin
echo '{"channel": "#general", "text": "Hello!"}' | stpr slack send_message --call

Options Reference

| Flag | Description | | -------------------- | --------------------------------------------------------------- | | --token <token> | Auth token (overrides saved profiles and STEPPER_SKILL_TOKEN) | | --base-url <url> | Override MCP server URL (default: https://mcp.stepper.io) | | --skillset <name> | Use a specific saved profile instead of the active one | | --call | Execute the skill (default behavior is parameter inspection) | | --verbose | Include full inputSchema when listing skills | | -i, --input <json> | JSON input for calls, parameter fetches, or option queries | | --options <param> | Fetch dynamic dropdown options for a parameter | | --search <query> | Filter dropdown options by search term | | --cursor <cursor> | Pagination cursor for dropdown options | | -h, --help | Show help | | -v, --version | Show version |

Environment Variables

| Variable | Description | | --------------------- | ------------------------------------------------------------- | | STEPPER_SKILL_TOKEN | Auth token (used when no --token flag and no saved profile) | | STEPPER_URL | Override the MCP server base URL |

Examples

# Authenticate
stpr login

# List everything available
stpr list

# Explore a service
stpr google-sheets

# Inspect dynamic parameters step by step
stpr google-sheets add_row -i '{}'
stpr google-sheets add_row -i '{"spreadsheet_id": "abc123"}'

# Fetch dropdown options
stpr google-sheets add_row --options worksheet_id -i '{"spreadsheet_id": "abc123"}'

# Execute
stpr google-sheets add_row --call -i '{"spreadsheet_id": "abc123", "worksheet_id": "Sheet1", "values": {"Name": "Alice"}}'

# Switch between skill sets
stpr profiles
stpr use "Production Tools"
stpr list