MCP tool contract

This is the early v0 surface. Names and argument shapes may still change before publishing to npm.

create_database

Creates an isolated database and login role. Returns the database id, database name, role name, expiry, and connection string.

delete_database

Deletes a database and role created by this MCP. Destructive operations are scoped to tracked sandbox resources.

get_connection_string

Returns the connection string for a created sandbox database plus expiry metadata.

run_sql

Runs SQL against an experiment database with optional readonly mode and capped row limits.

describe_schema

Returns tables, columns, indexes, and extensions for an experiment database.

list_databases

Lists active experiment databases, optionally filtered by owner, without exposing full secrets.

cleanup_expired

Deletes expired resources, with dry-run support for audit-friendly cleanup.