Describe WhisperGraph Label
describe_labelConfirm a graph label exists, get its node count, and list its property keys to prevent silent full-label scans when filtering on specific properties.
Instructions
Describe a single label: confirm it exists, get its node count, and enumerate the property keys observed on that label.
Use this BEFORE writing a query that filters on a specific property. If you write WHERE h.fqdn = "..." but describe_label("HOSTNAME") returns properties = ["name", "threatScore", ...], your query will silently scan the entire label. Verify first.
Argument: label (string, required) - uppercase letters, digits, and underscores only.
Returns: {name, exists, count, properties[], edgesDoc}. Cached 5 minutes.
Tip: edge types are NOT in the response - see the whisper://schema/relationships resource for which edges connect this label to others.
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": {
"label": "<label>"
},
"name": "describe_label"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | Yes | Label name. Uppercase letters, digits, underscores. Examples: HOSTNAME, IPV4, ASN. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| count | No | ||
| error | No | ||
| exists | Yes | ||
| edgesDoc | No | ||
| properties | No | ||
| suggestion | No | ||
| propertiesError | No |