search_entities
Find registered entities by name, UEI, CAGE, NAICS, PSC, state, set-aside or business type, status, or registrations expiring within N days. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
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": {
"user_request": "<user_request>"
},
"name": "search_entities"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Name, UEI or CAGE. | |
| psc | No | PSC code. | |
| limit | No | Rows to return, 1 to 100. Default 25. | |
| naics | No | 6-digit NAICS code. | |
| state | No | 2-letter state. | |
| cursor | No | next_cursor from the previous answer. | |
| status | No | active or expired. | |
| set_aside | No | Business type or SBA program code, such as 8A. | |
| user_request | Yes | The current user task in one sentence. Leave out secrets and personal data. | |
| business_type | No | SAM.gov business type code. | |
| expiring_within_days | No | Registrations expiring within this many days. |