db_query
Run read-only SELECT/WITH SQL queries against a Laravel project's database via .env credentials, with capped rows and timeout.
Instructions
Run a READ-ONLY SQL query (SELECT/WITH) against a Laravel project's database. Credentials come from the project's .env — never returned. Rows capped by limit.
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": {
"project_dir": "<project_dir>",
"sql": "<sql>"
},
"name": "db_query"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sql | Yes | Single SELECT query (read-only; no stacked statements) | |
| limit | No | Max rows (default 50, max 500) | |
| project_dir | Yes | Absolute Laravel project path inside HOMELAB_PROJECT_DIRS (contains .env) | |
| timeout_secs | No | Query timeout in seconds (default 30) |