CLI Commands Quick Reference

Fresh

WP-CLI MainWP Commands

Sites

Command	Description
wp mainwp sites list	List all sites
wp mainwp sites get --site-id=ID	Get site details
wp mainwp sites sync --site-id=ID	Sync one site
wp mainwp sites sync --all	Sync all sites
wp mainwp sites add --url=URL --admin=USER	Add a site
wp mainwp sites remove --site-id=ID	Remove a site

Updates

Command	Description
wp mainwp updates list	List all available updates
wp mainwp updates list --site-id=ID	List updates for one site
wp mainwp updates plugins --site-id=ID	Update all plugins on site
wp mainwp updates themes --site-id=ID	Update all themes on site
wp mainwp updates core --site-id=ID	Update WordPress core on site
wp mainwp updates all	Update everything everywhere

Clients

Command	Description
wp mainwp clients list	List all clients
wp mainwp clients add --name=NAME	Add a client
wp mainwp clients suspend --client-id=ID	Suspend client

Extensions

Command	Description
wp mainwp extensions list	List extensions
wp mainwp extensions activate --slug=SLUG	Activate extension
wp mainwp extensions deactivate --slug=SLUG	Deactivate extension

Output Formats

Flag	Format
--format=table	ASCII table (default)
--format=json	JSON output
--format=csv	CSV output
--format=yaml	YAML output
--format=count	Count only

MCP Server CLI

# Install globally
npm install -g @mainwp/mcp

# Run with npx (no install)
npx -y @mainwp/mcp

# Add to Claude Code
claude mcp add --transport stdio mainwp \
  --env MAINWP_URL=https://dashboard.com \
  --env MAINWP_USER=admin \
  --env MAINWP_APP_PASSWORD="xxxx xxxx" \
  -- npx -y @mainwp/mcp

cURL Quick Reference

REST API v2

# Auth header
-H "Authorization: Bearer YOUR_API_KEY"

# List sites
curl -H "Authorization: Bearer KEY" https://dashboard.com/wp-json/mainwp/v2/sites

# Get site
curl -H "Authorization: Bearer KEY" https://dashboard.com/wp-json/mainwp/v2/sites/123

# Create site
curl -X POST -H "Authorization: Bearer KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://site.com","admin":"admin"}' \
  https://dashboard.com/wp-json/mainwp/v2/sites

Abilities API

# Auth (Basic)
-u "username:app-password"

# List abilities
curl -u "admin:xxxx" \
  https://dashboard.com/wp-json/wp-abilities/v1/abilities

# Execute ability
curl -X POST -u "admin:xxxx" \
  -H "Content-Type: application/json" \
  -d '{"input":{...}}' \
  https://dashboard.com/wp-json/wp-abilities/v1/abilities/mainwp/ABILITY-SLUG/run