Data Tools
Overview
Data tools allow the AI agent to look up and browse Dataverse entity records at runtime. These tools are useful when you need to resolve a record's GUID from its display name, or when you need to enumerate records in an entity to find a specific one before referencing it in a logic definition.
lookup_entity_record_by_displayname
Lookup entity record by display name.
| Parameter | Type | Required | Description |
|---|---|---|---|
entityLogicalName | string | ✓ | The logical name of the entity. |
displayName | string | ✓ | The display name of the entity to look up. |
Returns: An entity reference containing the record ID, logical name, and display name of the matching record.
Error cases:
| Condition | Error |
|---|---|
| No matching record found | McpException: no record found matching the display name |
Use when: You know the display name of a record and need its GUID to use as a lookup value in a logic block or flow parameter.
list_entity_records
List entity records with pagination support. Returns a collection of entity references.
| Parameter | Type | Required | Description |
|---|---|---|---|
entityLogicalName | string | ✓ | The logical name of the entity to query. |
pageNumber | int | The page number to retrieve (1-based). Defaults to 1. |
Returns: A collection of entity references, each containing the record ID, logical name, and display name. Returns an empty collection if no records are found on the requested page.
Use when: You need to browse all records in an entity to locate a specific one, or to present the agent with available options for a given entity type.