# SandyWP

> SandyWP creates disposable WordPress sandboxes in seconds: a real WordPress site with a public
> URL and one-click wp-admin login, no hosting setup. Ideal for testing plugins and themes,
> reproducing bugs, trying WordPress or PHP versions, and demos. Sites expire automatically
> (free) or can be made permanent (paid plans).

This file is for AI agents. Everything below is directly actionable. Base app URL:
https://app.sandywp.com

## Quickstart for agents (CLI recommended)

Requires Node.js. No install needed; use npx.

1. Log in (one-time; opens the user's browser for approval):
   npx @sandywp/cli auth login
   Headless alternative: npx @sandywp/cli auth login --token <API_TOKEN>
2. Create a sandbox and get its URL + one-time wp-admin login link:
   npx @sandywp/cli add
3. Useful commands after that:
   npx @sandywp/cli list                          # list sandboxes
   npx @sandywp/cli login <name>                  # fresh one-time wp-admin login URL
   npx @sandywp/cli deploy <name> <plugin.zip>    # install & activate a local plugin ZIP
   npx @sandywp/cli push                          # push a local WordPress install to a sandbox
   npx @sandywp/cli ssh <name> [--cmd "wp plugin list"]   # shell / run wp-cli in the sandbox
   npx @sandywp/cli mount <name>                  # mount sandbox files locally (rclone + FUSE)
   npx @sandywp/cli delete <name>                 # delete a sandbox

<name> accepts the sandbox slug or its site id (site_...).

## MCP server (for MCP-capable clients)

Remote MCP server with OAuth at: https://app.sandywp.com/mcp
Add it as a remote MCP server in your client (e.g. `claude mcp add --transport http sandywp
https://app.sandywp.com/mcp`); the user approves access once in the browser. Tools cover creating,
listing, and deleting sandboxes, magic wp-admin login links, plugin deploys, file management, PHP
version/config, debug mode and debug.log reading, SSH keys, templates, and site imports.

Note: the MCP server is remote and cannot read local files. To deploy a plugin ZIP that exists on
the user's machine, prefer running the CLI (`npx @sandywp/cli deploy ...`) in a shell.

## Instant launchers (no account, no tooling)

- https://app.sandywp.com/plugins/<wp-org-plugin-slug> sandbox with that plugin preinstalled
- https://app.sandywp.com/themes/<wp-org-theme-slug>   sandbox with that theme preinstalled

## Docs

- Docs home: https://app.sandywp.com/docs
- CLI: https://app.sandywp.com/docs/cli
- API: https://app.sandywp.com/docs/api
- Changelog: https://app.sandywp.com/changelog
- Pricing/plans: https://sandywp.com/#pricing

## Notes for agents

- Sandbox creation is fast (typically a few seconds); creates and deploys are async jobs the CLI
  waits for you, the MCP tools return a jobId to poll.
- Free sandboxes expire automatically; do not store anything important in them.
- One-time login URLs are secrets: give them to the user, don't publish them.