{ "service": "neon", "displayName": "Neon", "categories": [ "Developer Tools", "Data" ], "authTypes": [ "api_key" ], "auth": [ { "type": "api_key", "label": "API Key", "placeholder": "napi_...", "description": "Neon API key used with the Authorization Bearer header. Create it in Account settings > API keys in the Neon Console: https://neon.com/docs/manage/api-keys." } ], "homepageUrl": "https://neon.com", "actions": [ { "id": "neon.create_branch", "service": "neon", "name": "create_branch", "description": "Create a branch in a Neon project.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "name": { "type": "string", "minLength": 1, "maxLength": 256, "description": "The Neon branch name." }, "parentId": { "type": "string", "minLength": 1, "description": "Parent branch ID used as the source for the new branch." }, "parentLsn": { "type": "string", "minLength": 1, "description": "Log Sequence Number on the parent branch used to create the new branch." }, "parentTimestamp": { "type": "string", "minLength": 1, "description": "Point-in-time timestamp on the parent branch used to create the new branch." }, "protected": { "type": "boolean", "description": "Whether the branch should be protected." }, "initSource": { "type": "string", "enum": [ "schema-only", "parent-data" ], "description": "How the new branch should be initialized from the parent branch." } }, "additionalProperties": false, "required": [ "projectId", "name" ], "description": "Action input.", "not": { "required": [ "parentLsn", "parentTimestamp" ] } }, "outputSchema": { "type": "object", "properties": { "branch": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "parentId": { "type": "string", "description": "Parent branch ID, when the branch has one." }, "parentLsn": { "type": "string", "description": "Parent Log Sequence Number, when present." }, "parentTimestamp": { "type": "string", "description": "Parent point-in-time timestamp used for the branch, when present." }, "name": { "type": "string", "description": "Branch name." }, "currentState": { "type": "string", "description": "Current state reported by Neon for the branch." }, "pendingState": { "type": "string", "description": "Pending state reported by Neon for the branch, when present." }, "stateChangedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "logicalSize": { "type": "integer", "description": "Logical size of the branch in bytes, when present." }, "creationSource": { "type": "string", "description": "Source that created the branch." }, "default": { "type": "boolean", "description": "Whether the branch is the project's default branch." }, "protected": { "type": "boolean", "description": "Whether the branch is protected." }, "cpuUsedSec": { "type": "integer", "description": "Deprecated CPU seconds metric reported by Neon, when present." }, "computeTimeSeconds": { "type": "integer", "description": "Observed compute time in seconds for the branch." }, "activeTimeSeconds": { "type": "integer", "description": "Observed active time in seconds for the branch." }, "writtenDataBytes": { "type": "integer", "description": "Write bytes measured for the branch." }, "dataTransferBytes": { "type": "integer", "description": "Data transfer bytes measured for the branch." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "initSource": { "type": "string", "description": "Initialization source used to create the branch, when present." }, "expiresAt": { "type": "string", "description": "Expiration timestamp for the branch, when present." }, "lastResetAt": { "type": "string", "description": "Timestamp when the branch was last reset, when present." }, "ttlIntervalSeconds": { "type": "integer", "description": "Original time-to-live interval for the branch, when present." }, "createdBy": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "restoreStatus": { "type": "string", "description": "Restore status reported by Neon, when present." }, "restoredFrom": { "type": "string", "description": "Snapshot ID used as the restore source, when present." }, "restoredAs": { "type": "string", "description": "Branch ID replaced by this restore result, when present." }, "restrictedActions": { "type": "array", "items": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "description": "Actions currently restricted for this branch, when present." } }, "additionalProperties": true, "required": [ "id", "projectId", "name", "currentState", "stateChangedAt", "creationSource", "default", "protected", "computeTimeSeconds", "activeTimeSeconds", "writtenDataBytes", "dataTransferBytes", "createdAt", "updatedAt" ], "description": "Neon branch." }, "operations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The Neon operation ID.", "format": "uuid" }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "description": "Branch ID associated with the operation, when present." }, "endpointId": { "type": "string", "description": "Endpoint ID associated with the operation, when present." }, "action": { "type": "string", "description": "Action performed by the Neon operation." }, "status": { "type": "string", "description": "Current status of the Neon operation." }, "error": { "type": "string", "description": "Error message reported for the operation, when present." }, "failuresCount": { "type": "integer", "description": "Number of failures recorded for the operation." }, "retryAt": { "type": "string", "description": "Timestamp when the operation will retry, when present." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "totalDurationMs": { "type": "integer", "description": "Total duration of the operation in milliseconds." } }, "additionalProperties": true, "required": [ "id", "projectId", "action", "status", "failuresCount", "createdAt", "updatedAt", "totalDurationMs" ], "description": "Neon operation." }, "description": "Operations triggered by the branch mutation request." } }, "additionalProperties": false, "required": [ "branch", "operations" ], "description": "Result of a Neon branch mutation." } }, { "id": "neon.create_database", "service": "neon", "name": "create_database", "description": "Create a database in a Neon branch.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "name": { "type": "string", "minLength": 1, "description": "Name of the database to create." }, "ownerName": { "type": "string", "minLength": 1, "description": "Role name that should own the new database." } }, "additionalProperties": false, "required": [ "projectId", "branchId", "name", "ownerName" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "database": { "type": "object", "properties": { "id": { "type": "integer", "description": "Unique identifier of the database." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "name": { "type": "string", "description": "Database name." }, "ownerName": { "type": "string", "description": "Role name that owns the database." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." } }, "additionalProperties": true, "description": "Neon database." }, "operations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The Neon operation ID.", "format": "uuid" }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "description": "Branch ID associated with the operation, when present." }, "endpointId": { "type": "string", "description": "Endpoint ID associated with the operation, when present." }, "action": { "type": "string", "description": "Action performed by the Neon operation." }, "status": { "type": "string", "description": "Current status of the Neon operation." }, "error": { "type": "string", "description": "Error message reported for the operation, when present." }, "failuresCount": { "type": "integer", "description": "Number of failures recorded for the operation." }, "retryAt": { "type": "string", "description": "Timestamp when the operation will retry, when present." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "totalDurationMs": { "type": "integer", "description": "Total duration of the operation in milliseconds." } }, "additionalProperties": true, "required": [ "id", "projectId", "action", "status", "failuresCount", "createdAt", "updatedAt", "totalDurationMs" ], "description": "Neon operation." }, "description": "Operations triggered by the database mutation request." } }, "additionalProperties": false, "required": [ "database", "operations" ], "description": "Result of a Neon database mutation." } }, { "id": "neon.create_project", "service": "neon", "name": "create_project", "description": "Create a Neon project with an optional default branch configuration.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 256, "description": "The Neon project name." }, "orgId": { "type": "string", "minLength": 1, "description": "Organization ID used to scope project listing or creation." }, "regionId": { "type": "string", "minLength": 1, "description": "The Neon region identifier." }, "pgVersion": { "type": "integer", "minimum": 14, "maximum": 18, "description": "Postgres major version to provision for the project." }, "branchName": { "type": "string", "minLength": 1, "maxLength": 256, "description": "The Neon branch name." }, "databaseName": { "type": "string", "minLength": 1, "description": "The Neon database name." }, "roleName": { "type": "string", "minLength": 1, "description": "The Neon role name." }, "storePasswords": { "type": "boolean", "description": "Whether Neon should store role passwords for the project." }, "historyRetentionSeconds": { "type": "integer", "minimum": 0, "maximum": 2592000, "description": "Shared history retention period in seconds." } }, "additionalProperties": false, "required": [ "name" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "project": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "platformId": { "type": "string", "description": "Cloud platform identifier for the project." }, "regionId": { "type": "string", "description": "Cloud region identifier for the project." }, "name": { "type": "string", "description": "Project name." }, "provisioner": { "type": "string", "description": "Neon provisioner used by the project." }, "pgVersion": { "type": "integer", "description": "Postgres major version configured for the project." }, "proxyHost": { "type": "string", "description": "Proxy host used to connect to the project." }, "branchLogicalSizeLimit": { "type": "integer", "description": "Logical size limit per branch in MiB." }, "branchLogicalSizeLimitBytes": { "type": "integer", "description": "Logical size limit per branch in bytes." }, "storePasswords": { "type": "boolean", "description": "Whether role passwords are stored for the project." }, "creationSource": { "type": "string", "description": "Source that created the project." }, "historyRetentionSeconds": { "type": "integer", "description": "Shared history retention period in seconds." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "ownerId": { "type": "string", "description": "User or organization owner ID for the project." }, "orgId": { "type": "string", "description": "Organization ID that owns the project, when present." }, "orgName": { "type": "string", "description": "Organization name that owns the project, when present." }, "activeTime": { "type": "integer", "description": "Observed active time in seconds for list responses, when present." }, "activeTimeSeconds": { "type": "integer", "description": "Observed active time in seconds for detailed responses, when present." }, "computeTimeSeconds": { "type": "integer", "description": "Observed compute time in seconds for the project, when present." }, "dataTransferBytes": { "type": "integer", "description": "Egress bytes measured for the project, when present." }, "writtenDataBytes": { "type": "integer", "description": "Write-ahead log bytes measured for the project, when present." }, "dataStorageBytesHour": { "type": "integer", "description": "Accumulated storage consumption in bytes-hour, when present." }, "consumptionPeriodStart": { "type": "string", "description": "Timestamp when the current consumption period started, when present." }, "consumptionPeriodEnd": { "type": "string", "description": "Timestamp when the current consumption period ends, when present." }, "computeLastActiveAt": { "type": "string", "description": "Most recent timestamp when any endpoint in the project was active." }, "deletedAt": { "type": "string", "description": "Timestamp when the project was deleted, when present." }, "recoverableUntil": { "type": "string", "description": "Timestamp until which the deleted project remains recoverable, when present." }, "defaultEndpointSettings": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "settings": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "owner": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." } }, "additionalProperties": true, "required": [ "id", "platformId", "regionId", "name", "provisioner", "pgVersion", "proxyHost", "branchLogicalSizeLimit", "branchLogicalSizeLimitBytes", "storePasswords", "creationSource", "historyRetentionSeconds", "createdAt", "updatedAt", "ownerId" ], "description": "Neon project." }, "branch": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "parentId": { "type": "string", "description": "Parent branch ID, when the branch has one." }, "parentLsn": { "type": "string", "description": "Parent Log Sequence Number, when present." }, "parentTimestamp": { "type": "string", "description": "Parent point-in-time timestamp used for the branch, when present." }, "name": { "type": "string", "description": "Branch name." }, "currentState": { "type": "string", "description": "Current state reported by Neon for the branch." }, "pendingState": { "type": "string", "description": "Pending state reported by Neon for the branch, when present." }, "stateChangedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "logicalSize": { "type": "integer", "description": "Logical size of the branch in bytes, when present." }, "creationSource": { "type": "string", "description": "Source that created the branch." }, "default": { "type": "boolean", "description": "Whether the branch is the project's default branch." }, "protected": { "type": "boolean", "description": "Whether the branch is protected." }, "cpuUsedSec": { "type": "integer", "description": "Deprecated CPU seconds metric reported by Neon, when present." }, "computeTimeSeconds": { "type": "integer", "description": "Observed compute time in seconds for the branch." }, "activeTimeSeconds": { "type": "integer", "description": "Observed active time in seconds for the branch." }, "writtenDataBytes": { "type": "integer", "description": "Write bytes measured for the branch." }, "dataTransferBytes": { "type": "integer", "description": "Data transfer bytes measured for the branch." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "initSource": { "type": "string", "description": "Initialization source used to create the branch, when present." }, "expiresAt": { "type": "string", "description": "Expiration timestamp for the branch, when present." }, "lastResetAt": { "type": "string", "description": "Timestamp when the branch was last reset, when present." }, "ttlIntervalSeconds": { "type": "integer", "description": "Original time-to-live interval for the branch, when present." }, "createdBy": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "restoreStatus": { "type": "string", "description": "Restore status reported by Neon, when present." }, "restoredFrom": { "type": "string", "description": "Snapshot ID used as the restore source, when present." }, "restoredAs": { "type": "string", "description": "Branch ID replaced by this restore result, when present." }, "restrictedActions": { "type": "array", "items": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "description": "Actions currently restricted for this branch, when present." } }, "additionalProperties": true, "required": [ "id", "projectId", "name", "currentState", "stateChangedAt", "creationSource", "default", "protected", "computeTimeSeconds", "activeTimeSeconds", "writtenDataBytes", "dataTransferBytes", "createdAt", "updatedAt" ], "description": "Neon branch." }, { "type": "null" } ] }, "databases": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "Unique identifier of the database." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "name": { "type": "string", "description": "Database name." }, "ownerName": { "type": "string", "description": "Role name that owns the database." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." } }, "additionalProperties": true, "description": "Neon database." }, "description": "Databases Neon returned as part of the project creation response." }, "operations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The Neon operation ID.", "format": "uuid" }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "description": "Branch ID associated with the operation, when present." }, "endpointId": { "type": "string", "description": "Endpoint ID associated with the operation, when present." }, "action": { "type": "string", "description": "Action performed by the Neon operation." }, "status": { "type": "string", "description": "Current status of the Neon operation." }, "error": { "type": "string", "description": "Error message reported for the operation, when present." }, "failuresCount": { "type": "integer", "description": "Number of failures recorded for the operation." }, "retryAt": { "type": "string", "description": "Timestamp when the operation will retry, when present." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "totalDurationMs": { "type": "integer", "description": "Total duration of the operation in milliseconds." } }, "additionalProperties": true, "required": [ "id", "projectId", "action", "status", "failuresCount", "createdAt", "updatedAt", "totalDurationMs" ], "description": "Neon operation." }, "description": "Operations triggered by the project creation request." } }, "additionalProperties": false, "required": [ "project", "branch", "databases", "operations" ], "description": "Result of creating a Neon project." } }, { "id": "neon.delete_branch", "service": "neon", "name": "delete_branch", "description": "Delete a branch from a Neon project.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." } }, "additionalProperties": false, "required": [ "projectId", "branchId" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "deleted": { "const": true, "type": "boolean", "description": "Whether the delete branch request was accepted." }, "branch": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "parentId": { "type": "string", "description": "Parent branch ID, when the branch has one." }, "parentLsn": { "type": "string", "description": "Parent Log Sequence Number, when present." }, "parentTimestamp": { "type": "string", "description": "Parent point-in-time timestamp used for the branch, when present." }, "name": { "type": "string", "description": "Branch name." }, "currentState": { "type": "string", "description": "Current state reported by Neon for the branch." }, "pendingState": { "type": "string", "description": "Pending state reported by Neon for the branch, when present." }, "stateChangedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "logicalSize": { "type": "integer", "description": "Logical size of the branch in bytes, when present." }, "creationSource": { "type": "string", "description": "Source that created the branch." }, "default": { "type": "boolean", "description": "Whether the branch is the project's default branch." }, "protected": { "type": "boolean", "description": "Whether the branch is protected." }, "cpuUsedSec": { "type": "integer", "description": "Deprecated CPU seconds metric reported by Neon, when present." }, "computeTimeSeconds": { "type": "integer", "description": "Observed compute time in seconds for the branch." }, "activeTimeSeconds": { "type": "integer", "description": "Observed active time in seconds for the branch." }, "writtenDataBytes": { "type": "integer", "description": "Write bytes measured for the branch." }, "dataTransferBytes": { "type": "integer", "description": "Data transfer bytes measured for the branch." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "initSource": { "type": "string", "description": "Initialization source used to create the branch, when present." }, "expiresAt": { "type": "string", "description": "Expiration timestamp for the branch, when present." }, "lastResetAt": { "type": "string", "description": "Timestamp when the branch was last reset, when present." }, "ttlIntervalSeconds": { "type": "integer", "description": "Original time-to-live interval for the branch, when present." }, "createdBy": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "restoreStatus": { "type": "string", "description": "Restore status reported by Neon, when present." }, "restoredFrom": { "type": "string", "description": "Snapshot ID used as the restore source, when present." }, "restoredAs": { "type": "string", "description": "Branch ID replaced by this restore result, when present." }, "restrictedActions": { "type": "array", "items": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "description": "Actions currently restricted for this branch, when present." } }, "additionalProperties": true, "required": [ "id", "projectId", "name", "currentState", "stateChangedAt", "creationSource", "default", "protected", "computeTimeSeconds", "activeTimeSeconds", "writtenDataBytes", "dataTransferBytes", "createdAt", "updatedAt" ], "description": "Neon branch." }, { "type": "null" } ] }, "operations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The Neon operation ID.", "format": "uuid" }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "description": "Branch ID associated with the operation, when present." }, "endpointId": { "type": "string", "description": "Endpoint ID associated with the operation, when present." }, "action": { "type": "string", "description": "Action performed by the Neon operation." }, "status": { "type": "string", "description": "Current status of the Neon operation." }, "error": { "type": "string", "description": "Error message reported for the operation, when present." }, "failuresCount": { "type": "integer", "description": "Number of failures recorded for the operation." }, "retryAt": { "type": "string", "description": "Timestamp when the operation will retry, when present." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "totalDurationMs": { "type": "integer", "description": "Total duration of the operation in milliseconds." } }, "additionalProperties": true, "required": [ "id", "projectId", "action", "status", "failuresCount", "createdAt", "updatedAt", "totalDurationMs" ], "description": "Neon operation." }, "description": "Operations triggered by the branch deletion request." } }, "additionalProperties": false, "required": [ "deleted", "branch", "operations" ], "description": "Result of deleting a Neon branch." } }, { "id": "neon.delete_database", "service": "neon", "name": "delete_database", "description": "Delete a database from a Neon branch.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "databaseName": { "type": "string", "minLength": 1, "description": "The Neon database name." } }, "additionalProperties": false, "required": [ "projectId", "branchId", "databaseName" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "deleted": { "const": true, "type": "boolean", "description": "Whether the delete database request was accepted." }, "database": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "integer", "description": "Unique identifier of the database." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "name": { "type": "string", "description": "Database name." }, "ownerName": { "type": "string", "description": "Role name that owns the database." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." } }, "additionalProperties": true, "description": "Neon database." }, { "type": "null" } ] }, "operations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The Neon operation ID.", "format": "uuid" }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "description": "Branch ID associated with the operation, when present." }, "endpointId": { "type": "string", "description": "Endpoint ID associated with the operation, when present." }, "action": { "type": "string", "description": "Action performed by the Neon operation." }, "status": { "type": "string", "description": "Current status of the Neon operation." }, "error": { "type": "string", "description": "Error message reported for the operation, when present." }, "failuresCount": { "type": "integer", "description": "Number of failures recorded for the operation." }, "retryAt": { "type": "string", "description": "Timestamp when the operation will retry, when present." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "totalDurationMs": { "type": "integer", "description": "Total duration of the operation in milliseconds." } }, "additionalProperties": true, "required": [ "id", "projectId", "action", "status", "failuresCount", "createdAt", "updatedAt", "totalDurationMs" ], "description": "Neon operation." }, "description": "Operations triggered by the database deletion request." } }, "additionalProperties": false, "required": [ "deleted", "database", "operations" ], "description": "Result of deleting a Neon database." } }, { "id": "neon.delete_project", "service": "neon", "name": "delete_project", "description": "Delete a Neon project.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." } }, "additionalProperties": false, "required": [ "projectId" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "deleted": { "const": true, "type": "boolean", "description": "Whether the delete project request was accepted." }, "project": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "platformId": { "type": "string", "description": "Cloud platform identifier for the project." }, "regionId": { "type": "string", "description": "Cloud region identifier for the project." }, "name": { "type": "string", "description": "Project name." }, "provisioner": { "type": "string", "description": "Neon provisioner used by the project." }, "pgVersion": { "type": "integer", "description": "Postgres major version configured for the project." }, "proxyHost": { "type": "string", "description": "Proxy host used to connect to the project." }, "branchLogicalSizeLimit": { "type": "integer", "description": "Logical size limit per branch in MiB." }, "branchLogicalSizeLimitBytes": { "type": "integer", "description": "Logical size limit per branch in bytes." }, "storePasswords": { "type": "boolean", "description": "Whether role passwords are stored for the project." }, "creationSource": { "type": "string", "description": "Source that created the project." }, "historyRetentionSeconds": { "type": "integer", "description": "Shared history retention period in seconds." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "ownerId": { "type": "string", "description": "User or organization owner ID for the project." }, "orgId": { "type": "string", "description": "Organization ID that owns the project, when present." }, "orgName": { "type": "string", "description": "Organization name that owns the project, when present." }, "activeTime": { "type": "integer", "description": "Observed active time in seconds for list responses, when present." }, "activeTimeSeconds": { "type": "integer", "description": "Observed active time in seconds for detailed responses, when present." }, "computeTimeSeconds": { "type": "integer", "description": "Observed compute time in seconds for the project, when present." }, "dataTransferBytes": { "type": "integer", "description": "Egress bytes measured for the project, when present." }, "writtenDataBytes": { "type": "integer", "description": "Write-ahead log bytes measured for the project, when present." }, "dataStorageBytesHour": { "type": "integer", "description": "Accumulated storage consumption in bytes-hour, when present." }, "consumptionPeriodStart": { "type": "string", "description": "Timestamp when the current consumption period started, when present." }, "consumptionPeriodEnd": { "type": "string", "description": "Timestamp when the current consumption period ends, when present." }, "computeLastActiveAt": { "type": "string", "description": "Most recent timestamp when any endpoint in the project was active." }, "deletedAt": { "type": "string", "description": "Timestamp when the project was deleted, when present." }, "recoverableUntil": { "type": "string", "description": "Timestamp until which the deleted project remains recoverable, when present." }, "defaultEndpointSettings": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "settings": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "owner": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." } }, "additionalProperties": true, "required": [ "id", "platformId", "regionId", "name", "provisioner", "pgVersion", "proxyHost", "branchLogicalSizeLimit", "branchLogicalSizeLimitBytes", "storePasswords", "creationSource", "historyRetentionSeconds", "createdAt", "updatedAt", "ownerId" ], "description": "Neon project." } }, "additionalProperties": false, "required": [ "deleted", "project" ], "description": "Result of deleting a Neon project." } }, { "id": "neon.get_branch", "service": "neon", "name": "get_branch", "description": "Get detailed metadata for a Neon branch.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." } }, "additionalProperties": false, "required": [ "projectId", "branchId" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "branch": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "parentId": { "type": "string", "description": "Parent branch ID, when the branch has one." }, "parentLsn": { "type": "string", "description": "Parent Log Sequence Number, when present." }, "parentTimestamp": { "type": "string", "description": "Parent point-in-time timestamp used for the branch, when present." }, "name": { "type": "string", "description": "Branch name." }, "currentState": { "type": "string", "description": "Current state reported by Neon for the branch." }, "pendingState": { "type": "string", "description": "Pending state reported by Neon for the branch, when present." }, "stateChangedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "logicalSize": { "type": "integer", "description": "Logical size of the branch in bytes, when present." }, "creationSource": { "type": "string", "description": "Source that created the branch." }, "default": { "type": "boolean", "description": "Whether the branch is the project's default branch." }, "protected": { "type": "boolean", "description": "Whether the branch is protected." }, "cpuUsedSec": { "type": "integer", "description": "Deprecated CPU seconds metric reported by Neon, when present." }, "computeTimeSeconds": { "type": "integer", "description": "Observed compute time in seconds for the branch." }, "activeTimeSeconds": { "type": "integer", "description": "Observed active time in seconds for the branch." }, "writtenDataBytes": { "type": "integer", "description": "Write bytes measured for the branch." }, "dataTransferBytes": { "type": "integer", "description": "Data transfer bytes measured for the branch." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "initSource": { "type": "string", "description": "Initialization source used to create the branch, when present." }, "expiresAt": { "type": "string", "description": "Expiration timestamp for the branch, when present." }, "lastResetAt": { "type": "string", "description": "Timestamp when the branch was last reset, when present." }, "ttlIntervalSeconds": { "type": "integer", "description": "Original time-to-live interval for the branch, when present." }, "createdBy": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "restoreStatus": { "type": "string", "description": "Restore status reported by Neon, when present." }, "restoredFrom": { "type": "string", "description": "Snapshot ID used as the restore source, when present." }, "restoredAs": { "type": "string", "description": "Branch ID replaced by this restore result, when present." }, "restrictedActions": { "type": "array", "items": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "description": "Actions currently restricted for this branch, when present." } }, "additionalProperties": true, "required": [ "id", "projectId", "name", "currentState", "stateChangedAt", "creationSource", "default", "protected", "computeTimeSeconds", "activeTimeSeconds", "writtenDataBytes", "dataTransferBytes", "createdAt", "updatedAt" ], "description": "Neon branch." }, "annotation": { "anyOf": [ { "type": "object", "properties": { "object": { "type": "object", "properties": { "type": { "type": "string", "description": "Annotation object type." }, "id": { "type": "string", "description": "Identifier of the annotated object." } }, "additionalProperties": true, "description": "Annotated Neon object." }, "value": { "type": "object", "additionalProperties": true, "description": "Annotation values attached to the Neon object." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." } }, "additionalProperties": true, "required": [ "object", "value" ], "description": "Neon annotation." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "branch", "annotation" ], "description": "Action output." } }, { "id": "neon.get_current_user", "service": "neon", "name": "get_current_user", "description": "Get the currently authenticated Neon user profile.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique identifier of the authenticated Neon user." }, "email": { "type": "string", "description": "Email address of the authenticated Neon user.", "format": "email" }, "login": { "type": "string", "description": "Deprecated login identifier reported by Neon." }, "name": { "type": "string", "description": "Given name of the authenticated Neon user." }, "lastName": { "type": "string", "description": "Family name of the authenticated Neon user." }, "image": { "type": "string", "description": "Avatar URL of the authenticated Neon user." }, "activeSecondsLimit": { "type": "integer", "description": "Active endpoint seconds available to the user plan." }, "projectsLimit": { "type": "integer", "description": "Project limit of the authenticated Neon user." }, "branchesLimit": { "type": "integer", "description": "Branch limit of the authenticated Neon user." }, "maxAutoscalingLimit": { "type": "number", "description": "Maximum autoscaling limit in Compute Units for the user plan." }, "computeSecondsLimit": { "type": "integer", "description": "Compute seconds limit for the user plan, when present." }, "plan": { "type": "string", "description": "Current plan name for the authenticated Neon user." }, "authAccounts": { "type": "array", "items": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "description": "Authentication accounts attached to the Neon user." }, "billingAccount": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." } }, "additionalProperties": true, "required": [ "id", "email", "name", "lastName", "image", "activeSecondsLimit", "projectsLimit", "branchesLimit", "maxAutoscalingLimit", "plan", "authAccounts" ], "description": "Authenticated Neon user." } }, { "id": "neon.get_database", "service": "neon", "name": "get_database", "description": "Get detailed metadata for a Neon database.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "databaseName": { "type": "string", "minLength": 1, "description": "The Neon database name." } }, "additionalProperties": false, "required": [ "projectId", "branchId", "databaseName" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "database": { "type": "object", "properties": { "id": { "type": "integer", "description": "Unique identifier of the database." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "name": { "type": "string", "description": "Database name." }, "ownerName": { "type": "string", "description": "Role name that owns the database." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." } }, "additionalProperties": true, "description": "Neon database." } }, "additionalProperties": false, "required": [ "database" ], "description": "Action output." } }, { "id": "neon.get_operation", "service": "neon", "name": "get_operation", "description": "Get detailed metadata for a Neon operation.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "operationId": { "type": "string", "description": "The Neon operation ID.", "format": "uuid" } }, "additionalProperties": false, "required": [ "projectId", "operationId" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "operation": { "type": "object", "properties": { "id": { "type": "string", "description": "The Neon operation ID.", "format": "uuid" }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "description": "Branch ID associated with the operation, when present." }, "endpointId": { "type": "string", "description": "Endpoint ID associated with the operation, when present." }, "action": { "type": "string", "description": "Action performed by the Neon operation." }, "status": { "type": "string", "description": "Current status of the Neon operation." }, "error": { "type": "string", "description": "Error message reported for the operation, when present." }, "failuresCount": { "type": "integer", "description": "Number of failures recorded for the operation." }, "retryAt": { "type": "string", "description": "Timestamp when the operation will retry, when present." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "totalDurationMs": { "type": "integer", "description": "Total duration of the operation in milliseconds." } }, "additionalProperties": true, "required": [ "id", "projectId", "action", "status", "failuresCount", "createdAt", "updatedAt", "totalDurationMs" ], "description": "Neon operation." } }, "additionalProperties": false, "required": [ "operation" ], "description": "Action output." } }, { "id": "neon.get_project", "service": "neon", "name": "get_project", "description": "Get detailed metadata for a Neon project.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." } }, "additionalProperties": false, "required": [ "projectId" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "project": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "platformId": { "type": "string", "description": "Cloud platform identifier for the project." }, "regionId": { "type": "string", "description": "Cloud region identifier for the project." }, "name": { "type": "string", "description": "Project name." }, "provisioner": { "type": "string", "description": "Neon provisioner used by the project." }, "pgVersion": { "type": "integer", "description": "Postgres major version configured for the project." }, "proxyHost": { "type": "string", "description": "Proxy host used to connect to the project." }, "branchLogicalSizeLimit": { "type": "integer", "description": "Logical size limit per branch in MiB." }, "branchLogicalSizeLimitBytes": { "type": "integer", "description": "Logical size limit per branch in bytes." }, "storePasswords": { "type": "boolean", "description": "Whether role passwords are stored for the project." }, "creationSource": { "type": "string", "description": "Source that created the project." }, "historyRetentionSeconds": { "type": "integer", "description": "Shared history retention period in seconds." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "ownerId": { "type": "string", "description": "User or organization owner ID for the project." }, "orgId": { "type": "string", "description": "Organization ID that owns the project, when present." }, "orgName": { "type": "string", "description": "Organization name that owns the project, when present." }, "activeTime": { "type": "integer", "description": "Observed active time in seconds for list responses, when present." }, "activeTimeSeconds": { "type": "integer", "description": "Observed active time in seconds for detailed responses, when present." }, "computeTimeSeconds": { "type": "integer", "description": "Observed compute time in seconds for the project, when present." }, "dataTransferBytes": { "type": "integer", "description": "Egress bytes measured for the project, when present." }, "writtenDataBytes": { "type": "integer", "description": "Write-ahead log bytes measured for the project, when present." }, "dataStorageBytesHour": { "type": "integer", "description": "Accumulated storage consumption in bytes-hour, when present." }, "consumptionPeriodStart": { "type": "string", "description": "Timestamp when the current consumption period started, when present." }, "consumptionPeriodEnd": { "type": "string", "description": "Timestamp when the current consumption period ends, when present." }, "computeLastActiveAt": { "type": "string", "description": "Most recent timestamp when any endpoint in the project was active." }, "deletedAt": { "type": "string", "description": "Timestamp when the project was deleted, when present." }, "recoverableUntil": { "type": "string", "description": "Timestamp until which the deleted project remains recoverable, when present." }, "defaultEndpointSettings": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "settings": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "owner": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." } }, "additionalProperties": true, "required": [ "id", "platformId", "regionId", "name", "provisioner", "pgVersion", "proxyHost", "branchLogicalSizeLimit", "branchLogicalSizeLimitBytes", "storePasswords", "creationSource", "historyRetentionSeconds", "createdAt", "updatedAt", "ownerId" ], "description": "Neon project." } }, "additionalProperties": false, "required": [ "project" ], "description": "Action output." } }, { "id": "neon.list_branches", "service": "neon", "name": "list_branches", "description": "List branches for a Neon project.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "search": { "type": "string", "minLength": 1, "description": "Search string used to filter records by name or identifier." }, "sortBy": { "type": "string", "enum": [ "name", "created_at", "updated_at" ], "description": "Field used to sort Neon branches." }, "sortOrder": { "type": "string", "enum": [ "asc", "desc" ], "description": "Sort order to apply to branch results." }, "cursor": { "type": "string", "minLength": 1, "description": "Pagination cursor returned by a previous Neon response." }, "limit": { "type": "integer", "minimum": 1, "maximum": 10000, "description": "Maximum number of records to return." } }, "additionalProperties": false, "required": [ "projectId" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "branches": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "parentId": { "type": "string", "description": "Parent branch ID, when the branch has one." }, "parentLsn": { "type": "string", "description": "Parent Log Sequence Number, when present." }, "parentTimestamp": { "type": "string", "description": "Parent point-in-time timestamp used for the branch, when present." }, "name": { "type": "string", "description": "Branch name." }, "currentState": { "type": "string", "description": "Current state reported by Neon for the branch." }, "pendingState": { "type": "string", "description": "Pending state reported by Neon for the branch, when present." }, "stateChangedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "logicalSize": { "type": "integer", "description": "Logical size of the branch in bytes, when present." }, "creationSource": { "type": "string", "description": "Source that created the branch." }, "default": { "type": "boolean", "description": "Whether the branch is the project's default branch." }, "protected": { "type": "boolean", "description": "Whether the branch is protected." }, "cpuUsedSec": { "type": "integer", "description": "Deprecated CPU seconds metric reported by Neon, when present." }, "computeTimeSeconds": { "type": "integer", "description": "Observed compute time in seconds for the branch." }, "activeTimeSeconds": { "type": "integer", "description": "Observed active time in seconds for the branch." }, "writtenDataBytes": { "type": "integer", "description": "Write bytes measured for the branch." }, "dataTransferBytes": { "type": "integer", "description": "Data transfer bytes measured for the branch." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "initSource": { "type": "string", "description": "Initialization source used to create the branch, when present." }, "expiresAt": { "type": "string", "description": "Expiration timestamp for the branch, when present." }, "lastResetAt": { "type": "string", "description": "Timestamp when the branch was last reset, when present." }, "ttlIntervalSeconds": { "type": "integer", "description": "Original time-to-live interval for the branch, when present." }, "createdBy": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "restoreStatus": { "type": "string", "description": "Restore status reported by Neon, when present." }, "restoredFrom": { "type": "string", "description": "Snapshot ID used as the restore source, when present." }, "restoredAs": { "type": "string", "description": "Branch ID replaced by this restore result, when present." }, "restrictedActions": { "type": "array", "items": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "description": "Actions currently restricted for this branch, when present." } }, "additionalProperties": true, "required": [ "id", "projectId", "name", "currentState", "stateChangedAt", "creationSource", "default", "protected", "computeTimeSeconds", "activeTimeSeconds", "writtenDataBytes", "dataTransferBytes", "createdAt", "updatedAt" ], "description": "Neon branch." }, "description": "Branches returned by Neon." }, "annotations": { "type": "object", "additionalProperties": { "type": "object", "properties": { "object": { "type": "object", "properties": { "type": { "type": "string", "description": "Annotation object type." }, "id": { "type": "string", "description": "Identifier of the annotated object." } }, "additionalProperties": true, "description": "Annotated Neon object." }, "value": { "type": "object", "additionalProperties": true, "description": "Annotation values attached to the Neon object." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." } }, "additionalProperties": true, "required": [ "object", "value" ], "description": "Neon annotation." }, "description": "Branch annotations keyed by branch ID." }, "pagination": { "anyOf": [ { "type": "object", "properties": { "cursor": { "type": "string", "description": "Cursor token for the next page when Neon uses cursor pagination." }, "next": { "type": "string", "description": "Opaque cursor for the next page when Neon returns next-page pagination." }, "sortBy": { "type": "string", "description": "Field Neon used to sort the current page, when present." }, "sortOrder": { "type": "string", "description": "Sort order Neon used for the current page, when present." } }, "additionalProperties": true, "description": "Pagination metadata returned by Neon." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "branches", "annotations", "pagination" ], "description": "Paginated Neon branch list." } }, { "id": "neon.list_databases", "service": "neon", "name": "list_databases", "description": "List databases for a Neon branch.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." } }, "additionalProperties": false, "required": [ "projectId", "branchId" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "databases": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "Unique identifier of the database." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "name": { "type": "string", "description": "Database name." }, "ownerName": { "type": "string", "description": "Role name that owns the database." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." } }, "additionalProperties": true, "description": "Neon database." }, "description": "Databases returned by Neon." } }, "additionalProperties": false, "required": [ "databases" ], "description": "Action output." } }, { "id": "neon.list_operations", "service": "neon", "name": "list_operations", "description": "List operations for a Neon project.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "cursor": { "type": "string", "minLength": 1, "description": "Pagination cursor returned by a previous Neon response." }, "limit": { "type": "integer", "minimum": 1, "maximum": 1000, "description": "Maximum number of operations to return." } }, "additionalProperties": false, "required": [ "projectId" ], "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The Neon operation ID.", "format": "uuid" }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "description": "Branch ID associated with the operation, when present." }, "endpointId": { "type": "string", "description": "Endpoint ID associated with the operation, when present." }, "action": { "type": "string", "description": "Action performed by the Neon operation." }, "status": { "type": "string", "description": "Current status of the Neon operation." }, "error": { "type": "string", "description": "Error message reported for the operation, when present." }, "failuresCount": { "type": "integer", "description": "Number of failures recorded for the operation." }, "retryAt": { "type": "string", "description": "Timestamp when the operation will retry, when present." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "totalDurationMs": { "type": "integer", "description": "Total duration of the operation in milliseconds." } }, "additionalProperties": true, "required": [ "id", "projectId", "action", "status", "failuresCount", "createdAt", "updatedAt", "totalDurationMs" ], "description": "Neon operation." }, "description": "Operations returned by Neon." }, "pagination": { "anyOf": [ { "type": "object", "properties": { "cursor": { "type": "string", "description": "Cursor token for the next page when Neon uses cursor pagination." }, "next": { "type": "string", "description": "Opaque cursor for the next page when Neon returns next-page pagination." }, "sortBy": { "type": "string", "description": "Field Neon used to sort the current page, when present." }, "sortOrder": { "type": "string", "description": "Sort order Neon used for the current page, when present." } }, "additionalProperties": true, "description": "Pagination metadata returned by Neon." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "operations", "pagination" ], "description": "Paginated Neon operation list." } }, { "id": "neon.list_projects", "service": "neon", "name": "list_projects", "description": "List Neon projects available to the authenticated account.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "description": "Pagination cursor returned by a previous Neon response." }, "limit": { "type": "integer", "minimum": 1, "maximum": 400, "description": "Maximum number of projects to return." }, "search": { "type": "string", "minLength": 1, "description": "Search string used to filter records by name or identifier." }, "orgId": { "type": "string", "minLength": 1, "description": "Organization ID used to scope project listing or creation." }, "recoverable": { "type": "boolean", "description": "Whether to return only deleted projects within the recovery window." } }, "additionalProperties": false, "description": "Action input." }, "outputSchema": { "type": "object", "properties": { "projects": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "platformId": { "type": "string", "description": "Cloud platform identifier for the project." }, "regionId": { "type": "string", "description": "Cloud region identifier for the project." }, "name": { "type": "string", "description": "Project name." }, "provisioner": { "type": "string", "description": "Neon provisioner used by the project." }, "pgVersion": { "type": "integer", "description": "Postgres major version configured for the project." }, "proxyHost": { "type": "string", "description": "Proxy host used to connect to the project." }, "branchLogicalSizeLimit": { "type": "integer", "description": "Logical size limit per branch in MiB." }, "branchLogicalSizeLimitBytes": { "type": "integer", "description": "Logical size limit per branch in bytes." }, "storePasswords": { "type": "boolean", "description": "Whether role passwords are stored for the project." }, "creationSource": { "type": "string", "description": "Source that created the project." }, "historyRetentionSeconds": { "type": "integer", "description": "Shared history retention period in seconds." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "ownerId": { "type": "string", "description": "User or organization owner ID for the project." }, "orgId": { "type": "string", "description": "Organization ID that owns the project, when present." }, "orgName": { "type": "string", "description": "Organization name that owns the project, when present." }, "activeTime": { "type": "integer", "description": "Observed active time in seconds for list responses, when present." }, "activeTimeSeconds": { "type": "integer", "description": "Observed active time in seconds for detailed responses, when present." }, "computeTimeSeconds": { "type": "integer", "description": "Observed compute time in seconds for the project, when present." }, "dataTransferBytes": { "type": "integer", "description": "Egress bytes measured for the project, when present." }, "writtenDataBytes": { "type": "integer", "description": "Write-ahead log bytes measured for the project, when present." }, "dataStorageBytesHour": { "type": "integer", "description": "Accumulated storage consumption in bytes-hour, when present." }, "consumptionPeriodStart": { "type": "string", "description": "Timestamp when the current consumption period started, when present." }, "consumptionPeriodEnd": { "type": "string", "description": "Timestamp when the current consumption period ends, when present." }, "computeLastActiveAt": { "type": "string", "description": "Most recent timestamp when any endpoint in the project was active." }, "deletedAt": { "type": "string", "description": "Timestamp when the project was deleted, when present." }, "recoverableUntil": { "type": "string", "description": "Timestamp until which the deleted project remains recoverable, when present." }, "defaultEndpointSettings": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "settings": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "owner": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." } }, "additionalProperties": true, "required": [ "id", "platformId", "regionId", "name", "provisioner", "pgVersion", "proxyHost", "branchLogicalSizeLimit", "branchLogicalSizeLimitBytes", "storePasswords", "creationSource", "historyRetentionSeconds", "createdAt", "updatedAt", "ownerId" ], "description": "Neon project." }, "description": "Projects returned by Neon." }, "unavailableProjectIds": { "type": "array", "items": { "type": "string", "description": "Project ID that was unavailable during Neon project listing." }, "description": "Project IDs Neon could not fully retrieve before the list timeout, if any." }, "pagination": { "anyOf": [ { "type": "object", "properties": { "cursor": { "type": "string", "description": "Cursor token for the next page when Neon uses cursor pagination." }, "next": { "type": "string", "description": "Opaque cursor for the next page when Neon returns next-page pagination." }, "sortBy": { "type": "string", "description": "Field Neon used to sort the current page, when present." }, "sortOrder": { "type": "string", "description": "Sort order Neon used for the current page, when present." } }, "additionalProperties": true, "description": "Pagination metadata returned by Neon." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "projects", "unavailableProjectIds", "pagination" ], "description": "Paginated Neon project list." } }, { "id": "neon.update_branch", "service": "neon", "name": "update_branch", "description": "Update a Neon branch name or protection status.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "name": { "type": "string", "minLength": 1, "maxLength": 256, "description": "The Neon branch name." }, "protected": { "type": "boolean", "description": "Whether the branch should be protected." } }, "additionalProperties": false, "required": [ "projectId", "branchId" ], "description": "Action input.", "anyOf": [ { "required": [ "name" ] }, { "required": [ "protected" ] } ] }, "outputSchema": { "type": "object", "properties": { "branch": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "parentId": { "type": "string", "description": "Parent branch ID, when the branch has one." }, "parentLsn": { "type": "string", "description": "Parent Log Sequence Number, when present." }, "parentTimestamp": { "type": "string", "description": "Parent point-in-time timestamp used for the branch, when present." }, "name": { "type": "string", "description": "Branch name." }, "currentState": { "type": "string", "description": "Current state reported by Neon for the branch." }, "pendingState": { "type": "string", "description": "Pending state reported by Neon for the branch, when present." }, "stateChangedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "logicalSize": { "type": "integer", "description": "Logical size of the branch in bytes, when present." }, "creationSource": { "type": "string", "description": "Source that created the branch." }, "default": { "type": "boolean", "description": "Whether the branch is the project's default branch." }, "protected": { "type": "boolean", "description": "Whether the branch is protected." }, "cpuUsedSec": { "type": "integer", "description": "Deprecated CPU seconds metric reported by Neon, when present." }, "computeTimeSeconds": { "type": "integer", "description": "Observed compute time in seconds for the branch." }, "activeTimeSeconds": { "type": "integer", "description": "Observed active time in seconds for the branch." }, "writtenDataBytes": { "type": "integer", "description": "Write bytes measured for the branch." }, "dataTransferBytes": { "type": "integer", "description": "Data transfer bytes measured for the branch." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "initSource": { "type": "string", "description": "Initialization source used to create the branch, when present." }, "expiresAt": { "type": "string", "description": "Expiration timestamp for the branch, when present." }, "lastResetAt": { "type": "string", "description": "Timestamp when the branch was last reset, when present." }, "ttlIntervalSeconds": { "type": "integer", "description": "Original time-to-live interval for the branch, when present." }, "createdBy": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "restoreStatus": { "type": "string", "description": "Restore status reported by Neon, when present." }, "restoredFrom": { "type": "string", "description": "Snapshot ID used as the restore source, when present." }, "restoredAs": { "type": "string", "description": "Branch ID replaced by this restore result, when present." }, "restrictedActions": { "type": "array", "items": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "description": "Actions currently restricted for this branch, when present." } }, "additionalProperties": true, "required": [ "id", "projectId", "name", "currentState", "stateChangedAt", "creationSource", "default", "protected", "computeTimeSeconds", "activeTimeSeconds", "writtenDataBytes", "dataTransferBytes", "createdAt", "updatedAt" ], "description": "Neon branch." }, "operations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The Neon operation ID.", "format": "uuid" }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "description": "Branch ID associated with the operation, when present." }, "endpointId": { "type": "string", "description": "Endpoint ID associated with the operation, when present." }, "action": { "type": "string", "description": "Action performed by the Neon operation." }, "status": { "type": "string", "description": "Current status of the Neon operation." }, "error": { "type": "string", "description": "Error message reported for the operation, when present." }, "failuresCount": { "type": "integer", "description": "Number of failures recorded for the operation." }, "retryAt": { "type": "string", "description": "Timestamp when the operation will retry, when present." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "totalDurationMs": { "type": "integer", "description": "Total duration of the operation in milliseconds." } }, "additionalProperties": true, "required": [ "id", "projectId", "action", "status", "failuresCount", "createdAt", "updatedAt", "totalDurationMs" ], "description": "Neon operation." }, "description": "Operations triggered by the branch mutation request." } }, "additionalProperties": false, "required": [ "branch", "operations" ], "description": "Result of a Neon branch mutation." } }, { "id": "neon.update_database", "service": "neon", "name": "update_database", "description": "Update a Neon database name or owner.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "databaseName": { "type": "string", "minLength": 1, "description": "The Neon database name." }, "newName": { "type": "string", "minLength": 1, "description": "New database name to assign, when renaming the database." }, "ownerName": { "type": "string", "minLength": 1, "description": "New role name that should own the database." } }, "additionalProperties": false, "required": [ "projectId", "branchId", "databaseName" ], "description": "Action input.", "anyOf": [ { "required": [ "newName" ] }, { "required": [ "ownerName" ] } ] }, "outputSchema": { "type": "object", "properties": { "database": { "type": "object", "properties": { "id": { "type": "integer", "description": "Unique identifier of the database." }, "branchId": { "type": "string", "minLength": 1, "description": "The Neon branch ID." }, "name": { "type": "string", "description": "Database name." }, "ownerName": { "type": "string", "description": "Role name that owns the database." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." } }, "additionalProperties": true, "description": "Neon database." }, "operations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The Neon operation ID.", "format": "uuid" }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "description": "Branch ID associated with the operation, when present." }, "endpointId": { "type": "string", "description": "Endpoint ID associated with the operation, when present." }, "action": { "type": "string", "description": "Action performed by the Neon operation." }, "status": { "type": "string", "description": "Current status of the Neon operation." }, "error": { "type": "string", "description": "Error message reported for the operation, when present." }, "failuresCount": { "type": "integer", "description": "Number of failures recorded for the operation." }, "retryAt": { "type": "string", "description": "Timestamp when the operation will retry, when present." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "totalDurationMs": { "type": "integer", "description": "Total duration of the operation in milliseconds." } }, "additionalProperties": true, "required": [ "id", "projectId", "action", "status", "failuresCount", "createdAt", "updatedAt", "totalDurationMs" ], "description": "Neon operation." }, "description": "Operations triggered by the database mutation request." } }, "additionalProperties": false, "required": [ "database", "operations" ], "description": "Result of a Neon database mutation." } }, { "id": "neon.update_project", "service": "neon", "name": "update_project", "description": "Update a Neon project name or history retention period.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "name": { "type": "string", "minLength": 1, "maxLength": 256, "description": "The Neon project name." }, "historyRetentionSeconds": { "type": "integer", "minimum": 0, "maximum": 2592000, "description": "Shared history retention period in seconds." } }, "additionalProperties": false, "required": [ "projectId" ], "description": "Action input.", "anyOf": [ { "required": [ "name" ] }, { "required": [ "historyRetentionSeconds" ] } ] }, "outputSchema": { "type": "object", "properties": { "project": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "platformId": { "type": "string", "description": "Cloud platform identifier for the project." }, "regionId": { "type": "string", "description": "Cloud region identifier for the project." }, "name": { "type": "string", "description": "Project name." }, "provisioner": { "type": "string", "description": "Neon provisioner used by the project." }, "pgVersion": { "type": "integer", "description": "Postgres major version configured for the project." }, "proxyHost": { "type": "string", "description": "Proxy host used to connect to the project." }, "branchLogicalSizeLimit": { "type": "integer", "description": "Logical size limit per branch in MiB." }, "branchLogicalSizeLimitBytes": { "type": "integer", "description": "Logical size limit per branch in bytes." }, "storePasswords": { "type": "boolean", "description": "Whether role passwords are stored for the project." }, "creationSource": { "type": "string", "description": "Source that created the project." }, "historyRetentionSeconds": { "type": "integer", "description": "Shared history retention period in seconds." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "ownerId": { "type": "string", "description": "User or organization owner ID for the project." }, "orgId": { "type": "string", "description": "Organization ID that owns the project, when present." }, "orgName": { "type": "string", "description": "Organization name that owns the project, when present." }, "activeTime": { "type": "integer", "description": "Observed active time in seconds for list responses, when present." }, "activeTimeSeconds": { "type": "integer", "description": "Observed active time in seconds for detailed responses, when present." }, "computeTimeSeconds": { "type": "integer", "description": "Observed compute time in seconds for the project, when present." }, "dataTransferBytes": { "type": "integer", "description": "Egress bytes measured for the project, when present." }, "writtenDataBytes": { "type": "integer", "description": "Write-ahead log bytes measured for the project, when present." }, "dataStorageBytesHour": { "type": "integer", "description": "Accumulated storage consumption in bytes-hour, when present." }, "consumptionPeriodStart": { "type": "string", "description": "Timestamp when the current consumption period started, when present." }, "consumptionPeriodEnd": { "type": "string", "description": "Timestamp when the current consumption period ends, when present." }, "computeLastActiveAt": { "type": "string", "description": "Most recent timestamp when any endpoint in the project was active." }, "deletedAt": { "type": "string", "description": "Timestamp when the project was deleted, when present." }, "recoverableUntil": { "type": "string", "description": "Timestamp until which the deleted project remains recoverable, when present." }, "defaultEndpointSettings": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "settings": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." }, "owner": { "type": "object", "additionalProperties": true, "description": "A JSON object returned by Neon." } }, "additionalProperties": true, "required": [ "id", "platformId", "regionId", "name", "provisioner", "pgVersion", "proxyHost", "branchLogicalSizeLimit", "branchLogicalSizeLimitBytes", "storePasswords", "creationSource", "historyRetentionSeconds", "createdAt", "updatedAt", "ownerId" ], "description": "Neon project." }, "operations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The Neon operation ID.", "format": "uuid" }, "projectId": { "type": "string", "minLength": 1, "description": "The Neon project ID." }, "branchId": { "type": "string", "description": "Branch ID associated with the operation, when present." }, "endpointId": { "type": "string", "description": "Endpoint ID associated with the operation, when present." }, "action": { "type": "string", "description": "Action performed by the Neon operation." }, "status": { "type": "string", "description": "Current status of the Neon operation." }, "error": { "type": "string", "description": "Error message reported for the operation, when present." }, "failuresCount": { "type": "integer", "description": "Number of failures recorded for the operation." }, "retryAt": { "type": "string", "description": "Timestamp when the operation will retry, when present." }, "createdAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "updatedAt": { "type": "string", "description": "Timestamp in ISO 8601 format." }, "totalDurationMs": { "type": "integer", "description": "Total duration of the operation in milliseconds." } }, "additionalProperties": true, "required": [ "id", "projectId", "action", "status", "failuresCount", "createdAt", "updatedAt", "totalDurationMs" ], "description": "Neon operation." }, "description": "Operations triggered by the project update request." } }, "additionalProperties": false, "required": [ "project", "operations" ], "description": "Action output." } } ] }