Read database status
databaseStatusRead the managed database Tofu records for one owned project, as its Database page shows it: state and region, what Tofu could see of the app’s own schemas (schema: counts and table names, never a row), what an archive could not copy (archive), an archive warning (inactivity), a stored archive (storedArchive) and a restore’s progress (restore). The answer’s own message and nextSteps, and those in schema, archive, inactivity and restore, say what the state means, the next step and who takes it. schema.state empty means the app has no table of its own yet. archive.reentry names sign-in secrets a restore would need again: this tool neither takes nor returns their values. It never returns a password, connection string or key, and writes nothing. An unavailable read is unavailable, never an empty schema.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "databaseStatus"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | Yes | ||
| exit | Yes | ||
| state | Yes | ||
| region | Yes | ||
| schema | Yes | ||
| archive | Yes | ||
| enabled | Yes | ||
| message | Yes | ||
| restore | No | ||
| provider | Yes | ||
| nextSteps | Yes | ||
| inactivity | No | ||
| agentPrompt | Yes | ||
| lifecycleMode | No | ||
| storedArchive | No | ||
| environmentKeys | Yes | ||
| lifecycleFailure | Yes | ||
| requiresDeployment | Yes | ||
| manualRetentionSince | No |