Can I use PlanetScale as a CLI?

Yes. KosmoKrator exposes a PlanetScale CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose PlanetScale through MCP?

Yes. The KosmoKrator MCP gateway can expose selected PlanetScale tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are PlanetScale credentials stored?

PlanetScale credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for PlanetScale MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

data

PlanetScale CLI for Headless Automation

Use the PlanetScale CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 6 read 1 write Bearer token auth

Submit PlanetScale feedback View package source

PlanetScale CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The PlanetScale CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# PlanetScale CLI for Headless Automation
kosmokrator integrations:configure planetscale --set access_token="$PLANETSCALE_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call planetscale.planetscale_list_databases '{"organization":"example_organization","page":1,"limit":1}' --json

Discovery Before Execution

Agents and scripts can inspect PlanetScale docs and schemas before choosing a function.

kosmo integrations:docs planetscale --json
kosmo integrations:docs planetscale.planetscale_list_databases --json
kosmo integrations:schema planetscale.planetscale_list_databases --json
kosmo integrations:search "PlanetScale" --json
kosmo integrations:list --json

Useful PlanetScale CLI Functions

Function	Type	Parameters	Description
`planetscale.planetscale_list_databases`	Read	organization, page, limit	List databases in a PlanetScale organization. Returns a paginated list of databases with their names, regions, and states.
`planetscale.planetscale_get_database`	Read	organization, database	Get details of a specific PlanetScale database, including its state, region, and branch count.
`planetscale.planetscale_create_database`	Write	organization, name, region, notes	Create a new database in a PlanetScale organization. Specify the database name and optionally a region and notes.
`planetscale.planetscale_list_branches`	Read	organization, database, page, limit	List branches of a PlanetScale database. Returns a paginated list of branches with their names, roles, and states.
`planetscale.planetscale_get_branch`	Read	organization, database, branch	Get details of a specific branch of a PlanetScale database, including its role, region, and readiness.
`planetscale.planetscale_list_organizations`	Read	none	List organizations the authenticated user belongs to. Useful for discovering organization names needed by other PlanetScale tools.
`planetscale.planetscale_get_current_user`	Read	none	Get the profile of the currently authenticated PlanetScale user. Useful for verifying API credentials and retrieving account information.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related PlanetScale CLI Pages

CI PlanetScale CLI for CI. Cron Jobs PlanetScale CLI for cron jobs. Shell Scripts PlanetScale CLI for shell scripts. Coding Agents PlanetScale CLI for coding agents.