Added hints support to the landing + some minor fixes

Author: vadim2404

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 - Feat: `list_shared_projects` tool to fetch projects that user has permissions to collaborate on
 - Feat: `reset_from_parent` tool to reset a branch from its parent's current state
+- Feat: `compare_database_schema` tool to compare the schema from the child branch and its parent
 
 # [0.6.4] 2025-08-22
 

README.md

@@ -198,6 +198,7 @@ The Neon MCP Server provides the following actions, which are exposed as "tools"
 - **`list_branch_computes`**: Lists compute endpoints for a project or specific branch, including compute ID, type, size, and autoscaling information.
 - **`list_organizations`**: Lists all organizations that the current user has access to. Optionally filter by organization name or ID using the search parameter.
 - **`reset_from_parent`**: Resets the current branch to its parent's state, discarding local changes. Automatically preserves to backup if branch has children, or optionally preserve on request with a custom name.
+- **`compare_database_schema`**: Shows the schema diff between the child branch and its parent
 
 **SQL Query Execution:**
 

landing/components/DescriptionItem.tsx

@@ -13,6 +13,8 @@ import {
 import {
   Terminal,
   CircleAlert,
+  Lightbulb,
+  BadgeInfo,
   Workflow,
   SquareArrowRight,
   Component,
@@ -30,6 +32,8 @@ const ALERT_VARIANT_PER_DESCRIPTION_TYPE: Record<
   next_steps: { variant: 'default', icon: SquareArrowRight },
   important_notes: { variant: 'important', icon: CircleAlert },
   workflow: { variant: 'default', icon: Workflow },
+  hints: { variant: 'default', icon: BadgeInfo },
+  hint: { variant: 'default', icon: Lightbulb },
   instructions: { variant: 'default', icon: Terminal },
   response_instructions: { variant: 'default', icon: Terminal },
   example: { variant: 'default', icon: Terminal },

landing/lib/description.ts

@@ -10,6 +10,8 @@ const POSSIBLE_TYPES = [
   'example',
   'do_not_include',
   'error_handling',
+  'hint',
+  'hints',
 ] as const;
 
 export type DescriptionItemType = (typeof POSSIBLE_TYPES)[number];
@@ -134,7 +136,7 @@ export function parseDescription(description: string): DescriptionItem[] {
 
   while (rest.length > 0) {
     const match = rest.match(
-      /<(use_case|workflow|important_notes|next_steps|response_instructions|instructions|example|do_not_include|error_handling)>(.*?)<\/\1>/s,
+      /<(use_case|workflow|important_notes|next_steps|response_instructions|instructions|example|do_not_include|error_handling|hints?)>(.*?)<\/\1>/s,
     );
 
     if (!match) {

src/tools/definitions.ts

@@ -703,6 +703,8 @@ export const NEON_TOOLS = [
           \`\`\`
         </example>
 
+        There is an example of a case where the function is not deterministic and will have locks:
+
         <example>
           \`\`\`sql
           -- Table rewrite, potentially longer lock time
@@ -712,9 +714,10 @@ export const NEON_TOOLS = [
           The fix for this is next:
 
           \`\`\`sql
-          -- Table rewrite, potentially longer lock time
+          -- Adding a nullable column first
           ALTER TABLE users ADD COLUMN created_at timestamptz;
 
+          -- Setting the default value because the rows are updated
           UPDATE users SET created_at = now();
           \`\`\`
         </example>
@@ -730,9 +733,9 @@ export const NEON_TOOLS = [
           ALTER TABLE users ADD CONSTRAINT users_age_positive
             CHECK (age > 0) NOT VALID;
 
-        -- Step 2: Validate existing data (can take time but doesn't block writes)
-        -- Uses SHARE UPDATE EXCLUSIVE lock - allows reads/writes
-        ALTER TABLE users VALIDATE CONSTRAINT users_age_positive;
+          -- Step 2: Validate existing data (can take time but doesn't block writes)
+          -- Uses SHARE UPDATE EXCLUSIVE lock - allows reads/writes
+          ALTER TABLE users VALIDATE CONSTRAINT users_age_positive;
           \`\`\`
         </example>
 
@@ -812,7 +815,6 @@ export const NEON_TOOLS = [
         </example>
 
         For PostgreSQL v18+
-        <example>
         <example>
           \`\`\`sql
           -- Step 1: Adding a nullable column first
@@ -831,7 +833,6 @@ export const NEON_TOOLS = [
           ALTER TABLE users ALTER COLUMN created_at SET DEFAULT now();
           \`\`\`
         </example>
-        </example>
       </hint>
 
       <hint>