Skip to content
PerSQL PerSQL PerSQL

Install for Claude Code

Terminal window
claude mcp add persql --transport http https://mcp.persql.com

The server is available in the current Claude Code session immediately — no restart. The first tool call opens the browser for OAuth consent; pick a namespace and the token is stored automatically.

Bearer fallback

Section titled “Bearer fallback”

If your Claude Code build doesn’t yet support MCP OAuth, mint a psql_live_… token under console.persql.com → API tokens and pass it as a header:

Terminal window
claude mcp add persql \
  --transport http https://mcp.persql.com \
  --header "Authorization: Bearer psql_live_…"

Verify

Section titled “Verify”
Terminal window
claude mcp list

You should see persql listed. Tools become available the next time Claude Code starts a tool-using turn.

Remove

Section titled “Remove”
Terminal window
claude mcp remove persql

What you get

Section titled “What you get”

About sixty SQL-shaped tools: query, batch, describe_database, search_schema, schema_doctor, wait_for_changes, claim_branch, create_database, create_schedule, create_webhook, topup_balance, and more. The full list is in the MCP reference.