# entities_search Search GLEIF Level-1 legal entities by identity or name. | Field | Value | | --- | --- | | Category | Legal Entities (`entities`) | | Exposure | public | | MCP tool | `entities_search` | | Documentation | https://www.agentdatasets.com/docs/tools/entities_search | ## Description Search GLEIF Level-1 legal entities by identity or name. The shared envelope returns echoed filters and ranked `data.matches`. Every match includes the LEI join key, legal name, jurisdiction, status, match reason, `source`, and `as_of`. Results are bounded to 1-50 and use `pagination.next_cursor`. Use this for discovery, then call `entities_get` for the profile or `entities_get_ownership` for Level-2 relationships. Example: `query="Apple Computer"`, `country="US"`. `bad_parameter` reports blank input, invalid country, limit, or cursor; `unknown_entity` means no held entity matched. GLEIF data is CC0. ## Parameters Input schema advertised to MCP clients and mirrored by the REST query string. | Parameter | In | Type | Required | Default | Constraints | Description | | --- | --- | --- | --- | --- | --- | --- | | query | input | `string` | yes | — | — | Case-insensitive legal name, alias, previous name, or exact 20-character LEI. Choose a returned LEI for entities_get or entities_get_ownership. | | country | input | `string \| null` | no | null | — | Optional 2-letter ISO country code for the GLEIF legal address, such as US or GB. | | status | input | `"ACTIVE" \| "INACTIVE" \| null` | no | null | — | Optional current GLEIF entity status: ACTIVE or INACTIVE. | | limit | input | `integer` | no | 10 | min 1, max 50 | Ranked matches per page (1-50). | | cursor | input | `string \| null` | no | null | — | Opaque cursor from pagination.next_cursor. Keep query, country, and status unchanged while paging; omit for the first page. | ## Provenance - `gleif` — Global Legal Entity Identifier Foundation, GLEIF golden copy Level-1 legal-entity identifiers, names, jurisdiction, status, registration authority, and address regions (Creative Commons CC0 1.0 Universal (cc0-1.0)). See https://www.agentdatasets.com/docs/attribution.md Dataset registry: `entities_gleif_level_one`.