ShipEasy Docs

MCP tools for AI agents — same surface as the CLI, callable from Claude Code / Cursor / Copilot.

The ShipEasy MCP server exposes the same gate / config / experiment / killswitch / universe verbs as the CLI, but as MCP tools your AI agent can call directly. Wire it up once and your agent can create experiments, flip flags, and configure killswitches without you copy-pasting CLI commands.

Install

The MCP server ships inside the @shipeasy/cli package as the mcp subcommand. Install the CLI, then point your agent at it.

npm install -g @shipeasy/cli
shipeasy mcp install     # writes config to ~/.claude/settings.json + ~/.cursor/mcp.json

Or wire it manually:

{
  "mcpServers": {
    "shipeasy": {
      "command": "shipeasy",
      "args": ["mcp"]
    }
  }
}

Tools

All tools are namespaced mcp__shipeasy__*.

Gates

Tool	What it does
`exp_create_gate`	Create a new gate
`exp_update_gate`	Update name, rules, rollout, enabled
`exp_delete_gate`	Delete a gate

Configs

Tool	What it does
`exp_create_config`	Create a new config (with JSON schema)
`exp_update_config`	Update config schema or values
`exp_delete_config`	Delete a config

Killswitches

Tool	What it does
`exp_create_killswitch`	Create a killswitch
`exp_update_killswitch`	Update default value, switches map, description
`exp_delete_killswitch`	Delete a killswitch
`exp_set_killswitch_switch`	Flip a switch entry to a value (per env)
`exp_unset_killswitch_switch`	Remove a switch entry from one env

Experiments

Tool	What it does
`exp_create_experiment`	Create a new experiment
`exp_update_experiment`	Update name, variants, allocation, metrics
`exp_delete_experiment`	Delete an experiment
`exp_start_experiment`	Start an experiment (status `draft` → `running`)
`exp_stop_experiment`	Stop a running experiment
`exp_experiment_status`	Status + latest results + p-values

Universes

Tool	What it does
`exp_create_universe`	Create an experiment universe
`exp_update_universe`	Update holdout range / allocation
`exp_delete_universe`	Delete a universe

Discovery & auth

Tool	What it does
`auth_check`	Check current credentials
`auth_login`	Trigger PKCE device login
`auth_logout`	Clear stored credentials
`detect_project`	Inspect repo: language, framework, SDK state
`get_resource`	Fetch a single resource by id/name
`list_resources`	List resources of a given type
`get_sdk_snippet`	Generate a language-specific SDK snippet
`projects_upsert`	Create or update a project

Example agent prompt

"Create a gate called checkout-v2, only for country=US, ramp at 5%."

The agent calls exp_create_gate with the appropriate rule + rollout, returns the gate id, then emits the SDK snippet for your framework via get_sdk_snippet.

MCP reference