Skip to content

fix: correct PostgreSQL write tool documentation #154

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rishikesh-major merged 5 commits into from
Sep 9, 2026
Merged

fix: correct PostgreSQL write tool documentation #154

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
979f58f
fix: correct PostgreSQL write tool documentation
rishikesh-major Sep 8, 2026
2b4e1a7
docs: keep PostgreSQL write guidance focused
rishikesh-major Sep 8, 2026
6960b1e
docs: distinguish PostgreSQL writes from migrations
rishikesh-major Sep 8, 2026
f8c7f80
docs: avoid hosted MCP server prefix
rishikesh-major Sep 8, 2026
71a13fd
docs: clarify managed migration guidance
rishikesh-major Sep 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions plugins/shared/skills/resources_postgresql/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,8 @@ description: Implements PostgreSQL connections, SQL queries, and migration patte
## MCP Tools

- `mcp__resources__postgresql_psql` — Execute read-only SQL queries and psql backslash commands (`\dt`, `\d`, `\di`, `\df`, etc.). Args: `resourceId`, `command`, `timeoutMs?`
- `mcp__resources__postgresql_run_migration` — Run DDL/DML migrations on **managed databases only** (`isManaged=true`). Runs in a transaction; rolls back on failure. Args: `resourceId`, `migration`, `description?`
- `mcp__resources__postgresql_invoke` — Execute write SQL against managed or external PostgreSQL resources. Args: `resourceId`, `sql`, `params?`, `timeoutMs?`, `description`
- `run_migration` on the platform MCP server — Run tracked migrations on an application's managed database in app-building/orchestrator sessions. Args: `applicationId`, `migration`, `description`

## TypeScript Client

Expand All @@ -48,7 +49,8 @@ if (result.ok) {
## Tips

- Use parameterized queries (`$1`, `$2`, ...) — never interpolate values into SQL strings
- `psql` tool is read-only; use `run_migration` for writes (managed DBs) or the TypeScript client for writes (external DBs)
- `psql` is read-only; use `postgresql_invoke` for data modifications against managed or external PostgreSQL resources
- Use `run_migration` for tracked schema migrations on an application's managed database
- The TypeScript client supports full read/write operations regardless of managed status
- Use `psql` exclusively for read-only tasks. Never use invoke for read only.

Expand Down
Loading