Search external parties
search-external-partiesSearch the account's external parties (people and businesses that appear on documents) by name.
External parties are the counterparties on documents — the entities on the OTHER side of an agreement, which do not belong to the account. They are distinct from account parties, which are the account's own entities (the company the user belongs to and its subsidiaries / group companies). Phrasing like "our", "we", "us", "my company" or "our subsidiary" refers to an account party, not an external party — in that case use list-account-parties instead.
Use this tool when:
You need a party's name to filter list-documents by external party
You want to find parties matching a search term
Matches the party's name (entity_name). Results are capped and de-duplicated by name, so narrow the query if you don't find who you're looking for. If you are looking for a named entity and it does not appear here, it may be an account party (the account's own side) instead — try list-account-parties before concluding it does not exist.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search-external-parties"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of external parties to return (default and max: 25) | |
| query | Yes | Search term matched against external party names (case-insensitive, min 3 characters) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| external_parties | No |