Skip to content
PerSQL PerSQL PerSQL

Install for Codex

Terminal window
codex mcp add persql --url https://mcp.persql.com

Or add the block to ~/.codex/config.toml:

[mcp_servers.persql]
url = "https://mcp.persql.com"

Codex connects over streamable HTTP and runs the OAuth flow on the first tool call — sign in, pick a workspace, and the token is stored automatically. No header to paste.

If your Codex build needs it for remote servers, enable the client at the top level of config.toml:

experimental_use_rmcp_client = true
# Optional: pin the OAuth callback port.
mcp_oauth_callback_port = 1456

Bearer fallback

Section titled “Bearer fallback”

For a static token instead of OAuth, create a psql_live_… token under console.persql.com → API tokens and bridge through mcp-remote — see Other clients for the stdio [mcp_servers.persql] block.

Verify

Section titled “Verify”

Confirm persql is registered with codex mcp list, or check the [mcp_servers.persql] block in ~/.codex/config.toml. Tools become available on the next tool-using turn.

What you get

Section titled “What you get”

About sixty SQL-shaped tools: query, batch, describe_database, claim_branch, create_database, topup_balance, and more — the full list is in the MCP reference.