Skip to content
PerSQL PerSQL PerSQL

Introduction

PerSQL is SQLite as a service, running on Cloudflare’s fast global network. Each database lives in its own isolated instance, walled off from every other customer’s. You can reach it from:

  • The web console (console.persql.com) — sign in, click around, run SQL.
  • The REST API (/v1/*) — Authorization: Bearer psql_live_….
  • The TypeScript SDK (@persql/sdk) — same shape as the REST API.
  • MCP (mcp.persql.com) — SQL tools your AI editor (Claude, Cursor) can call, for any Model Context Protocol client.
  • Public endpoints (/p/:ns/:db/:slug) — saved SQL exposed as a public web address, optionally on your own domain.
  • The in-product agent — a Kimi K2.5–powered assistant inside the console that can list databases, run queries, draft tables, invite teammates, and more.

Two-minute tour

Section titled “Two-minute tour”

  1. Sign in at console.persql.com. PerSQL auto-creates a workspace (named after your handle) and a database called main, and lands you directly on it. Free credit is applied to your balance — no card needed to start.

  2. Copy your API token. The first time you land on a database, the Connect panel shows a psql_live_… token in a banner — copy it now, it’s shown only once. (Lost it? Create a new one at API tokens → New token.)

  3. Run your first query — either click Run in the Query tab, or from your terminal:

    Terminal window
    curl -X POST https://api.persql.com/v1/db/<your-handle>/main/query \
      -H "Authorization: Bearer psql_live_xxxxxxxxxxxx" \
      -H "Content-Type: application/json" \
      -d '{"sql":"SELECT 1 AS ok"}'

  4. Pick how to keep going:

    • Wire up an agent — MCP for Claude Desktop / Cursor, or the SDK’s db.asTool().
    • Browse the recipes — per-agent sandbox, sub-agent handoff, PR-preview DB, cost-aware loop.
    • Publish a public endpoint.
    • Read the concept primer if any of the above terms feel unfamiliar.

You can create additional workspaces or databases at any time from the console; the auto-created ones aren’t special.

What’s next

Section titled “What’s next”