search
Read-only
Search Dynamics 365 Finance and Operations objects by name or keyword across pre-indexed metadata. Supports single, batch, and extension-scoped searches to locate classes, tables, forms, and more.
Instructions
Search pre-indexed D365FO objects by name or keyword. Three modes in ONE tool:
• single (default) → pass query; returns name, type, model.
• batch → pass queries[] (max 10) to run searches in parallel (3× faster, with dedup + cross-reference).
• extensions → set scope:"extensions" to restrict to custom/ISV models only (filters out Microsoft standard code). Model names in those results are SOURCE models — never use them as create/modify targets.
Use get_object_info(objectType, name) when you already know the exact name and need full details.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | [single] Filter by object type ("all" = no filter). | all |
| limit | No | [single|extensions] Maximum results to return | |
| query | No | [single|extensions] Search query (class name, method name, table name, etc.). REQUIRED unless using batch `queries[]`. | |
| scope | No | [single] Search the whole index ("all", default) or only custom/ISV models ("extensions"). Ignored when `queries[]` is provided. | all |
| prefix | No | [extensions] Extension prefix filter (e.g., ISV_, Custom_). | |
| queries | No | [batch] Array of search queries to execute in parallel (max 10). When provided, runs in batch mode and `scope`/`query` are ignored. | |
| verbose | No | [single] Include related-searches/patterns/tips sections (off by default to keep responses compact). | |
| deduplicate | No | [batch] When true, symbols appearing in multiple query results are collapsed. Later occurrences are replaced with a reference to the query where they first appeared. | |
| workspacePath | No | [single] Optional workspace path to search local project files in addition to external metadata | |
| crossReference | No | [batch] Append a cross-reference summary at the end listing symbols that appeared in multiple queries. Useful for identifying the most relevant / commonly matched objects across all searches. | |
| globalTypeFilter | No | [batch] Default type filter for queries without an explicit per-query type. E.g. ["class"] restricts all untyped queries to classes. Multiple values fan out each untyped query into one search per type. Values: same as the top-level `type`, except "all" (which means "no filter" — omit this instead). | |
| includeWorkspace | No | [single] Whether to include workspace files in search results (workspace-aware search) |