sp-neon

Guides Neon Postgres provisioning and API operations using APP credentials.

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/PhongCT1105/okta_stripe_hack --skill sp-neon-phongct1105
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sp-neon
Source: https://github.com/PhongCT1105/okta_stripe_hack/tree/main/.agents/skills/sp-neon
Command: npx skills add https://github.com/PhongCT1105/okta_stripe_hack --skill sp-neon-phongct1105

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents working with the Agentic Provisioning Protocol (APP) need clear guidance on where Neon credentials come from and how to use the returned API key for Neon API operations like managing projects, branches, and connection strings. ## Core Features & Use Cases - APP Credential Handling: Explains how the orchestrator obtains a user-scoped API key from the account request response and how to send it as a Bearer token on every Neon API call. - Neon API Operations: Covers listing projects, creating branches with compute endpoints, and provisioning resources via the Neon REST API at console.neon.tech/api/v2. - Documentation Navigation: Provides a topic-indexed map of Neon docs (branching, autoscaling, connection pooling, Neon Auth, SDKs) with Markdown-fetchable links. - Use Case: When Stripe Projects provisions a Neon database for your app, use this Skill to authenticate with the returned access token, create a development branch, and retrieve the connection string. ## Quick Start Ask the agent to use the Neon API key from the APP account request to list your Neon projects and create a new branch with a read-write endpoint.

Frequently Asked Questions about sp-neon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I authenticate Neon API requests with an APP access token?

Send the access_token from the APP account request response as an Authorization: Bearer header on every request to https://console.neon.tech/api/v2/. The same user-scoped API key works for projects, branches, connection strings, and provisioning calls.

How do I create a branch in Neon using the API?

Send a POST request to /projects/{project_id}/branches with your Bearer token. The body can include branch.parent_id (omit for the default branch) and an endpoints array such as [{"type": "read_write"}] to attach compute.

Where do Neon APP credentials come from?

The orchestrator (e.g. Stripe) calls POST <provider_base_url>/provisioning/account_requests, and the success response returns credentials.access_token (the API key) and credentials.account.id (the user identifier) for all subsequent Neon operations.

Does Neon support connection pooling for serverless apps?

Yes, Neon provides pooled connections by adding -pooler to endpoint hostnames, which uses PgBouncer. This is important in serverless environments where many concurrent connections would otherwise exhaust database limits.

How can I fetch Neon documentation as Markdown?

Append .md to any Neon docs URL or send an Accept: text/markdown header on the standard URL. The full docs index is available at https://neon.com/docs/llms.txt for topic discovery.