Polygres Troubleshooting

Use read-only checks first. Resolve context, preserve evidence, classify the failure boundary, and recommend the smallest safe correction. Do not mutate while diagnosing.

When Polygres MCP tools are available, read references/mcp-tool-contract.md, call whoami, and use the discovered read catalog before CLI or SDK fallback. Treat the connection URL restrictions, OAuth installation, current scopes, project boundary, project mode, and catalog version as separate diagnostic layers.

Workflow