docs: align MCP category lists with the hosted server

[andrelandgraf]

Problem

The setup configurator, Available tools table, and CLI reference listed eight tool categories. The hosted MCP server advertises twelve.

Selecting a subset adds a category allowlist to the generated URL. Since endpoints, snapshots, functions, and storage had no configurator option, narrowing access also hid those tools with no way to include them.

Diagnosis

The hosted server advertises this list:

[
  "projects",
  "branches",
  "endpoints",
  "snapshots",
  "schema",
  "querying",
  "neon_auth",
  "data_api",
  "observability",
  "docs",
  "functions",
  "storage"
]

The configurator, Available tools table, and CLI reference each keep a copy of that list. The existing sync check covered the first two copies but not the CLI reference.

The configurator omits the category query parameter for both an empty selection and a full selection. A partial selection adds the chosen categories.

User-facing interface

The configurator now offers all twelve categories and explains the default:

All tools are available by default; select categories to narrow the agent's access through the category query param.

An empty or full selection generates:

https://mcp.neon.tech/mcp

A subset generates an allowlist:

https://mcp.neon.tech/mcp?category=endpoints

The CLI --category list is the same twelve. CLI behavior is unchanged:

neon mcp --category querying --category schema

Auth setup copy now names the live tools:

provision_neon_auth
add_auth_oauth_provider, add_auth_trusted_domain, update_auth_config
get_neon_auth_config

Links point at #available-tools.

Also in here

• Expands the Available tools table with current descriptions for all twelve categories.
• Adds the CLI reference to the pull request and scheduled category sync checks.
• Updates related MCP links that pointed at #supported-actions-tools.
• Refreshes the generated LLM markdown snapshot.

Verification

• npx vitest run scripts/check-mcp-categories-sync.test.js
• npx vitest run src/scripts/process-md-for-llms.test.js
• npm run check:mcp-categories
• npm run check:mcp-categories:live
• Preview: all twelve toggles; helper copy as above; Clear all leaves https://mcp.neon.tech/mcp with every checkbox off; selecting Endpoints only emits ?category=endpoints.

For your attention

• Clearing every checkbox still exposes all tools, because an empty selection omits category. The helper copy now states the default.
• scripts/data/mcp-tool-definitions.json still describes the previous MCP catalog. Regenerating it is a separate change.
• content/docs/introduction/roadmap.md still names configure_neon_auth as a shipped-feature bullet. Left as history.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
neon-next	Ready	Preview	Aug 27, 2026 9:37pm

[philip]

Approved.

But while not specific to this PR, selecting none (clear all) showing all as selected is slightly confusing.

Consider changing the "Tool Categories" description to clarify that all are available by default. Something like "All tools are available by default; select categories to narrow the agent's access through the category query param."