Skip to main content
Glama

Sync new or changed records

get_projects_sync
Read-onlyIdempotent

Projects that are new to this account or changed since the last delivery. limit is required. The cursor from the previous page continues the walk; omitting it starts a full walk, last-updated ascending. sort, order, and offset are not accepted. Unchanged owned records do not add a charge. 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 new or changed record. get_credit_balance returns the remaining balance. Walks private leads by default. leadTypes (for example ["private","public"]) widens it, and changing that value starts a new walk.

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": {
      "limit": "<limit>"
    },
    "name": "get_projects_sync"
  }
}

Input Schema

NameRequiredDescriptionDefault
qNoSame as the Boardwalk map search box. Project name, developer, or words from the filing — e.g. "Ivory apartments Salt Lake". Combine with Region, Type, Acres, and Date Range.
idsNoAlias of projectIds.
bboxNoBounding box as {north,south,east,west} or west,south,east,north.
cityNoAlias of cities.
sortNomeetingDate, dateAdded, lastUpdated, dataRichness, totalUnitCount, acreage — or product aliases meeting_date_newest, created_at_newest, units_highest, acres_highest. "Recently added" is dateAdded (newest first by default). Do not send suggested (map-only).
typeNoAlias of propertyTypes.
limitYesRequired. Number of records to return, 1-25. Each new or changed record counts toward 100,000 export records a month. An unchanged record already delivered does not.
orderNo
stateNoAlias of states.
boundsNoAlias of bbox.
circleNoRadius search {lat, lng, radiusMeters}. radiusMeters is 100–500000 (meters, not miles).
citiesNoRegion: city ids or names. Narrows states the same way counties do.
cityIdNo
countyNoAlias of counties.
cursorNoOpaque cursor from the previous sync page. Omit to start a full walk.
dateToNo
inSfhaNoAlias of inFemaFloodZone.
offsetNo
searchNoAlias of q.
statesNoRegion: state ids, names, or abbreviations. Resolve names via list_locations if unsure.
statusNoEntitlement status, whoever gave it. Tokens from get_reference facet=statuses. To ask who gave it as well, use entitlementStatus.
cityIdsNo
includeNoPass "contacts" with projectIds to read stored contacts after enrichment. get_projects uses cachedOnly=true; it never starts a live lookup. Use create_enrichment to find new contact info.
polygonNoGeoJSON ring [[lng,lat],…].
stateIdNo
subtypeNoAlias of propertySubtypes.
countiesNoRegion: county ids or names. When using names, send states separately (e.g. states:["UT"], counties:["Davis"]). Do not put "County, ST" in one value. Ambiguous names are refused even on a single-state plan. Naming a county or city narrows the search to it: states sent with it are not searched in full, and the response warns geography_narrowed_to_smallest_scope.
countyIdNo
dateFromNoDate Range lower bound, YYYY-MM or YYYY-MM-DD
stateIdsNoAlias of states.
countyIdsNo
dateRangeNoDate Range chip. Defaults to last_1_year. Pass "all" for the whole corpus.
leadTypesNoLead 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.
acreageMaxNoAcres maximum.
acreageMinNoAcres minimum. “Projects over 2 acres” → acreageMin=2.
assetClassNoAlias of assetClasses.
lotSizeMaxNoAlias — prefer acreageMax when they said acres.
lotSizeMinNoAlias — prefer acreageMin when they said acres.
projectIdsNoExact record ids to re-read, at most 100. Owned unchanged records are free. On count_projects this must be the only filter.
projectNameNo
assetClassesNoBuilding type class (3rd level: Gas Stations, Apartment Building, …).
deliveryModeNoSync returns all matching records and their delivery state. For never-delivered records only, use get_projects with deliveryMode=new.
excludeSavedNoWhen true, hide projects already on a saved list this account can see.
projectSizesNoProject Size: large, medium, or small. “Large projects” → large.
requestTypesNoApplication type, what they asked for. Early: annexation, general_plan_amendment, rezone, planned_unit_development, concept_plan, project_plan. Middle: conditional_use_permit, special_use_permit, variance, development_agreement, preliminary_plat, subdivision_plat. Late: site_plan_approval, design_review, final_plat. Early types are the first sign of a project; late ones mean it is close to building.
unitCountMaxNoAlias of totalUnitCountMax.
unitCountMinNoAlias of totalUnitCountMin.
civicSubtypesNoAlias of governmentDecisionSubtypes.
decisionTypesNo
developerNameNo
lastUpdatedToNo
meetingDateToNo
propertyTypesNoBuilding type from get_project_types (Commercial, Residential, …). Alias: type.
excludeAlertIdNoSubtract every project any delivery of this alert (alr_…) has ever materialised.
excludeSubtypeNoAlias of excludePropertySubtypes.
lotSizeSqftMaxNoAlias of lotSizeMax.
lotSizeSqftMinNoAlias of lotSizeMin.
showAllRecordsNoAlias of includeGovernmentDecisions.
inFemaFloodZoneNoFEMA flood zone overlay.
lastUpdatedFromNo
meetingDateFromNo
applicationTypesNoAlias of requestTypes.
parkingSpacesMaxNo
parkingSpacesMinNo
propertySubtypesNoMore-specific building type (2nd level).
squareFootageMaxNoBuilding square footage maximum.
squareFootageMinNoBuilding square footage minimum.
civicAssetClassesNoAlias of governmentDecisionAssetClasses.
constructionTypesNoConstruction type: new_building, renovation, addition, infrastructure. "Renovation or addition" is renovation plus addition, so send both.
entitlementStatusNoEntitlement status by who gave it, as "<bodyGroup>:<status>" pairs, e.g. ["council:approved","planning:recommended_for_approval"]. A pair matches the project's newest decision. Body groups: council (city council or county board), planning (planning commission), boards (appeals and review boards), staff (planning staff), other (another body). Statuses: approved, denied, recommended_for_approval, recommended_for_denial, continued, pending, withdrawn. "Approved by the planning commission" → ["planning:approved"]. get_reference facet=entitlementStatus lists both halves.
excludeAssetClassNoAlias of excludeAssetClasses.
excludeProjectIdsNoSubtract these ids from search/count (at most 100).
inOpportunityZoneNo2027 Opportunity Zone overlay (effective January 1, 2027).
taxonomyMatchModeNoHow a Building type filter matches. Default primary_or_secondary. Rarely needed.
totalUnitCountMaxNoResidential Units maximum.
totalUnitCountMinNoResidential Units minimum.
buildingStoriesMaxNo
buildingStoriesMinNo
excludeAssetClassesNoBuilding type classes to leave out.
constructionLeadOnlyNoAlias of constructionLeadsOnly.
constructionLeadsOnlyNo
constructionMagnitudesNoAlias of projectSizes.
hasConstructionDetailsNo
excludePropertySubtypesNoBuilding types to leave out (2nd level).
governmentDecisionSubtypesNoGovernment decision types. Requires includeGovernmentDecisions=true.
includeGovernmentDecisionsNoInclude non-real-estate government decisions (ordinances, budgets). Default false. Pass true only when they ask for them. Deprecated: still accepted, but leadTypes is how the served set is widened now — prefer leadTypes: ["private","public"] for public-sector work.
governmentDecisionAssetClassesNoGovernment decision classes. Requires includeGovernmentDecisions=true.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed15 schema fields changed
    • changedInput schema / properties / constructionTypes / description
      Previous value: -"Construction Type: new_building, infrastructure, renovation, site_work, demolition_only."New value: +"Construction type: new_building, renovation, addition, infrastructure. \"Renovation or addition\" is renovation plus addition, so send both."
    • removedInput schema / properties / decisionBodies
      Removed value: -{
      -  "$ref": "#/properties/states",
      -  "description": "Hearing body from get_reference (Planning Commission, City Council, …)."
      -}
    • addedInput schema / properties / entitlementStatus
      Added value: +{
      +  "$ref": "#/properties/states",
      +  "description": "Entitlement status by who gave it, as \"<bodyGroup>:<status>\" pairs, e.g. [\"council:approved\",\"planning:recommended_for_approval\"]. A pair matches the project's newest decision. Body groups: council (city council or county board), planning (planning commission), boards (appeals and review boards), staff (planning staff), other (another body). Statuses: approved, denied, recommended_for_approval, recommended_for_denial, continued, pending, withdrawn. \"Approved by the planning commission\" → [\"planning:approved\"]. get_reference facet=entitlementStatus lists both halves."
      +}
    • changedInput schema / properties / governmentDecisionAssetClasses / description
      Previous value: -"Govt. Decision classes. Requires includeGovernmentDecisions=true."New value: +"Government decision classes. Requires includeGovernmentDecisions=true."
    • changedInput schema / properties / governmentDecisionSubtypes / description
      Previous value: -"Govt. Decision types. Requires includeGovernmentDecisions=true."New value: +"Government decision types. Requires includeGovernmentDecisions=true."
    • changedInput schema / properties / includeGovernmentDecisions / description
      Previous value: -"Show Non-Real Estate Govt. Decisions. Default false, same as the map. Pass true only when they ask for Govt. Decisions. Deprecated: still accepted, but leadTypes is how the served set is widened now — prefer leadTypes: [\"private\",\"public\"] for public-sector work."New value: +"Include non-real-estate government decisions (ordinances, budgets). Default false. Pass true only when they ask for them. Deprecated: still accepted, but leadTypes is how the served set is widened now — prefer leadTypes: [\"private\",\"public\"] for public-sector work."
    • changedInput schema / properties / leadTypes / description
      Previous value: -"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. 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."New value: +"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."
    • changedInput schema / properties / requestTypes / description
      Previous value: -"Application Type — what they asked for (rezone, site plan, …)."New value: +"Application type, what they asked for. Early: annexation, general_plan_amendment, rezone, planned_unit_development, concept_plan, project_plan. Middle: conditional_use_permit, special_use_permit, variance, development_agreement, preliminary_plat, subdivision_plat. Late: site_plan_approval, design_review, final_plat. Early types are the first sign of a project; late ones mean it is close to building."
    • removedInput schema / properties / requiresZoningChange
      Removed value: -{
      -  "description": "Requires Zoning Change — map More toggle.",
      -  "type": "boolean"
      -}
    • changedInput schema / properties / sort / description
      Previous value: -"meetingDate, lastUpdated, dataRichness, totalUnitCount, acreage — or product aliases meeting_date_newest, units_highest, acres_highest. Do not send suggested (map-only)."New value: +"meetingDate, dateAdded, lastUpdated, dataRichness, totalUnitCount, acreage — or product aliases meeting_date_newest, created_at_newest, units_highest, acres_highest. \"Recently added\" is dateAdded (newest first by default). Do not send suggested (map-only)."
    • changedInput schema / properties / squareFootageMax / description
      Previous value: -"Commercial Square Footage maximum."New value: +"Building square footage maximum."
    • changedInput schema / properties / squareFootageMin / description
      Previous value: -"Commercial Square Footage minimum."New value: +"Building square footage minimum."
    • changedInput schema / properties / status / description
      Previous value: -"Entitlement Status tokens from get_reference facet=statuses."New value: +"Entitlement status, whoever gave it. Tokens from get_reference facet=statuses. To ask who gave it as well, use entitlementStatus."
    • removedInput schema / properties / statusCombos
      Removed value: -{
      -  "$ref": "#/properties/states",
      -  "description": "Entitlement Status as \"City Council|approved\". Prefer this over inventing tokens."
      -}
    • removedInput schema / properties / statusSelection
      Removed value: -{
      -  "$ref": "#/properties/states",
      -  "description": "Alias of status."
      -}
  2. First observed

TDQS

A3.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Well beyond the annotations, it discloses billing semantics (100,000 export records/month on County/State/National plans, 1 credit per new/changed record on API Only and trial, unchanged records free), that sort/order/offset are rejected, and that changing leadTypes restarts the walk. It stops short of describing pagination termination (how an agent knows the walk is finished) or the response envelope, and there is no output schema to compensate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is front-loaded with purpose and walk mechanics, but the billing paragraph is dense and repetitive ("Unchanged owned records do not add a charge" / "An unchanged record already delivered does not"), and plan-tier billing detail is arguably excessive relative to the core sync instruction.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 87-parameter, cursor-based delta tool with no output schema, the definition covers the essential walk and cost model but leaves gaps: no description of the returned record shape, no guidance on end-of-walk detection, and no mention of the geography_narrowed behavior the schema warns about.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 76%, so the baseline is a 3. The description does add real value the schema lacks — declaring sort, order, and offset unsupported despite being present in the schema, and explaining the leadTypes default plus that altering it starts a new walk — but with 87 parameters the majority of filtering semantics remain schema-only.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific resource and scope: "Projects that are new to this account or changed since the last delivery," which pins down delta-sync semantics rather than a generic list. It does not explicitly contrast itself with get_projects or get_permits_sync by name, so the differentiation from siblings is left implicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives operational guidance on how to walk (cursor continues, omitting starts a full walk, last-updated ascending) and calls out get_credit_balance for balance checks, which is genuine routing help. However, it never states when an agent should choose this tool over get_projects or count_projects; that comparison only appears buried in the schema's deliveryMode text.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources