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 workspace and the token is stored automatically.

Bearer fallback

Section titled “Bearer fallback”

If your Claude Code build doesn’t yet support MCP OAuth, create 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 forty-five SQL-shaped tools: query, batch, describe_database, search_schema, schema_doctor, claim_branch, create_database, topup_balance, and more. The full list is in the MCP reference.