PlanetScale Emulator
Stateful PlanetScale emulator: the Doorkeeper OAuth authorization server with Dynamic Client Registration, PKCE, and literal HTTP Basic client authentication, plus the hosted MCP server at /mcp/planetscale with read-only organization, database, and branch tools over seeded state.
Create an instance
Each instance is isolated, stateful, and addressable at its own host. The server generates an unguessable name; an optional {"instance":"<prefix>"} body adds a readable prefix.
curl -s -X POST https://planetscale.emulators.dev/_emulate/instances
Hosted deployments create instances lazily when the returned URL is first used. The instance URL is a capability: anyone who has it can read and modify the instance, so save the returned URLs. Never store real secrets in an emulator.
Sample instance host: https://planetscale.your-instance.emulators.dev
Surfaces
| Surface | Status | Path |
|---|---|---|
| PlanetScale OAuth (Doorkeeper) | partial | /oauth |
| PlanetScale MCP server | partial | /mcp/planetscale |
| OAuth consent page | supported | /oauth/authorize |
Control API
manifest | quickstart | specs | coverage | connections