Repository navigation
feat(neon-postgres): add Neon Data API section - #3
Merged
Merged
Conversation
The `neon-postgres` skill enumerates most Neon product surfaces as
dedicated sections (Neon Auth, Branching, Autoscaling, Read Replicas,
Connection Pooling, Logical Replication, etc.) but the Neon Data API
is only referenced in passing inside the JS SDK paragraph (line 132).
This adds a focused `## Neon Data API` section that:
- Explains when to choose the Data API over a Postgres driver
(browser/mobile clients, JWT-scoped row-level access).
- Surfaces the MCP provisioning path (`p
817C
rovision_neon_data_api`) so
agents pick the deterministic tool instead of routing the user
through the Console.
- Documents the three authentication options (none, Neon Auth, external
JWKS) without inventing API shapes — each maps directly to a real
configuration mode in `mcp-server-neon`'s `data_api` scope.
- Links to the canonical Data API get-started page.
Also updates the frontmatter `description` to add Data API triggers
("Neon Data API", "PostgREST", "REST API for Postgres", "HTTP queries
from the browser") so agents activate this skill on those prompts.
Follows the same shape as the existing `## Neon Auth` section and
mirrors the pattern used in PR neondatabase#24 (the "Branching in CI/CD section"
addition to `neon-postgres-branches`) — extending an existing skill
with a new focused section rather than carving out a whole new skill.
Documentation impact: the public mirror of this skill at
https://neon.com/docs/ai/skills/neon-postgres/SKILL.md (referenced from
this same skill on line 199) needs the matching new section. The Agent
Skills overview page at https://neon.com/docs/ai/agent-skills should
also reflect that the `neon-postgres` skill now covers the Data API.
Validated with `npm run validate:skills`.
Co-authored-by: Cursor <cursoragent@cursor.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.