findLabels
Retrieve available record types (labels) and their counts, using record-scoped filters to count only matching records.
Instructions
List or filter available record types (labels) and their counts. IMPORTANT: getSchemaMarkdown already returns ALL label names in STEP 0 — do NOT call findLabels as a substitute for it. Only call findLabels when you need label counts after applying record-scoped predicates, or getSchemaMarkdown was not called yet. Call with no arguments to list all labels. where is applied to Records, not label metadata; use getSchemaMarkdown to search label names. Returns objects with name (case-sensitive — use exact casing in all subsequent calls) and count (number of matching records). Pick the best matching label by: exact match > starts-with > substring > semantic similarity, preferring higher count on ties. State your label assumption briefly ("using DEAL for 'deals'") and proceed without asking.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "findLabels"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| skip | No | Number of labels to skip | |
| limit | No | Maximum number of labels to return | |
| where | No | Record-scoped filter conditions applied before label counts are returned. | |
| orderBy | No | Sorting configuration: key = field, value = asc|desc |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| labels | Yes |