search_fields
Find Salesforce field API names by searching field labels, API names, and help text. Returns ranked matches across objects or within a specific object.
Instructions
Find the field(s) that carry a concept, when you know what you want to query but not the API name. Searches every scored field on the discovered objects — not just the promoted ones — across API names, labels, and help text, ranked by match strength. Searches the core objects by default; pass objectName to scope to one, which discovers it on demand. Set includeValues to get the value set for matched picklists, so you can write the WHERE clause without a second lookup. The match is lexical, not semantic: it finds fields whose name, label or help text contains the term, so a concept this org names differently will not surface, and an object that has not been discovered is not searched. Read salesforce://field-catalog/{objectName}/all to browse everything on an object.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| term | Yes | What to look for, matched against field API names, labels, and help text (e.g. "ai", "renewal date", "region") | |
| limit | No | Maximum matches to return (default: 25, max: 100) | |
| objectName | No | Restrict the search to one object (e.g. Opportunity). Omit to search all discovered core objects. | |
| includeValues | No | Include the active value set for matched picklist fields (default: false). Free — the values come from metadata already discovered. | |
| minPopulationPct | No | Drop fields populated on fewer than this percent of records (0-100). Omit to include sparsely-populated fields, which is often where custom flags live. |