Skip to content

Raycast

PerSQL puts SQLite at your keyboard. Spin up one-off scratch databases from Raycast and query them inline — scratch-<name>, gone when you’re done. No app to open, no server to run.

  1. Create a PerSQL bearer token in the console and point the Raycast extension at it.

  2. From a Raycast command, create a scratch database named scratch-<name> on the fly, run SQL, and read the results without leaving Raycast.

Point an agent at the Raycast MCP:

https://raycast.persql.com/mcp

Authenticate with a PerSQL bearer token. scratch_recipe returns the snippet that spins up a one-off scratch database; scratch_list shows the ones already in your workspace. Or address one directly with the SDK:

import { PerSQL } from "@persql/sdk";
const db = new PerSQL({ token: process.env.PERSQL_TOKEN })
.database("<namespace>/scratch-notes");
await db.query("SELECT 1 AS ok");