Search projects in natural language
ai_search_projectsSubmits a natural-language search job and returns the job id. get_ai_search_result returns project records when the job finishes. limit is how many records to find (max 25) and is the spend. get_projects with q covers map-style filters (place, type, acres, dates). This tool applies when the question depends on wording inside the minutes. Each new or changed record counts toward 100,000 export records a month on County, State, and National plans. An unchanged record already delivered does not. Find Contact Info does not use credits on this call. On API Only and the trial, costs 1 credit per requested record. count_projects returns the structured count without records. notify.email=false skips the settlement email. Searches private leads by default. leadTypes (for example ["private","public"]) widens that set.
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>",
"limit": "<limit>"
},
"name": "ai_search_projects"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Alias of query. | |
| city | No | City integer ids from list_locations. | |
| type | No | Project types from get_project_types. | |
| limit | Yes | Required. Maximum records the job may deliver, 1-25. Credits are reserved for this many at submission and trued up to what actually delivers. | |
| query | Yes | The question in natural language — use this when they need evidence from the minutes, not for ordinary map-style filters. | |
| state | No | ||
| cityId | No | ||
| county | No | County integer ids from list_locations. | |
| dateTo | No | ||
| notify | No | ||
| offset | No | ||
| states | No | State ids, names, or abbreviations — same as get_projects. | |
| cityIds | No | ||
| stateId | No | ||
| subtype | No | ||
| countyId | No | ||
| dateFrom | No | ||
| stateIds | No | Alias of states. | |
| countyIds | No | ||
| leadTypes | No | Lead types to include. Default ["private"] — private development only, same as the map. Widen it when they ask: ["private","public"] adds public-sector projects (schools, roads, utilities, civic facilities); ["private","private_minor"] adds small private jobs (single lots, tenant improvements, small additions); "public_minor" adds small public jobs. Infrastructure and Institutional/Public projects are mostly government-owned, so add "public" whenever you filter for them (propertyTypes Infrastructure or Institutional/Public, or constructionTypes infrastructure). Always keep "private" in the list — the API adds it back if you drop it. Standard and full records carry leadType and stage; compact omits them. |