Tools
The Zonio MCP server exposes 12 tools. Each quoted description is the one the model sees, followed by its inputs and an abbreviated example result. All tools are read-only except the project tools that change a project.
| Tool | Use it to |
|---|---|
find_sites | Run a ready-made site-selection scenario over a region |
search_parcels | Shortlist parcels by size, grid, road, zoning and constraints |
analyze | Count and measure the parcels of an area, grouped |
resolve_parcel | Turn an id, coordinates, a parcel number or an address into one parcel |
parcel_report | Get the full due-diligence picture of one parcel |
list_layers | See what data exists and how fresh it is |
list_projects | List the user's projects |
get_project | Read a project's parcels |
create_project | Start a new parcel shortlist |
update_project | Rename a project or change its description |
add_parcels | Save parcels to a project |
remove_parcels | Take parcels out of a project |
The agent reads the user's request and fills these inputs itself; no tool takes free text to interpret. Every parcel in a result carries zonio_url, which opens it on the map in the Zonio app.
Search
find_sites
Run one of Zonio's ready-made site-selection scenarios over a region of Poland. Prefer this over search_parcels when the user's goal matches a scenario: each one encodes the legal and technical criteria for its asset type. Returns a ranked shortlist with the signals behind each score, and a coverage list. Criteria marked missing were not checked in that region; always tell the user.
The model also sees every scenario with its adjustable parameters (default and range) and ranking signals. See Scenarios.
| Input | Type | Description |
|---|---|---|
scenario | string, required | solar_farm_site, wind_farm_site, bess_storage, agrivoltaics_site, biogas_plant, data_center_site, logistics_warehouse, housing_estate_site, urban_residential_development, retail_park_site, brownfield_redevelopment or public_land_opportunity |
region | string | Voivodeship, powiat or gmina name (diacritics optional) or TERYT code. Omit to search all of Poland, which is slow |
params | object | Override scenario parameters, e.g. { "substation_km": 5 } |
weights | object | Re-weight ranking signals 0–100, e.g. { "grid_capacity_mw": 80 }; 0 switches one off |
limit | integer | 1–50, default 10 |
{
"region": { "teryt": "1219043", "name": "Niepołomice", "unit_type": "gmina", "parent": "powiat wielicki" },
"blocked": false,
"count": 1,
"results": [
{
"parcel_id": "121904_5.0010.1/106",
"zonio_url": "https://app.zonio.tech/egib/121904_5.0010.1/106",
"area_sqm": 265136.83,
"gmina": "Niepołomice",
"score": 100,
"why": ["gridCapacity: 20 MW", "gridDistance: 2.63 km", "area: 265136.83 m²"]
}
],
"coverage": [
{ "filter": "no_blocking_zone", "mode": "screens", "status": "ok" },
{ "filter": "grid_capacity_available", "mode": "requires", "status": "ok" },
{ "filter": "near_substation", "mode": "requires", "status": "ok" },
{ "filter": "no_env_risk_nearby", "mode": "screens", "status": "ok" }
],
"note": []
}An ambiguous region name comes back as an error listing the candidates with their TERYT codes.
search_parcels
Shortlist parcels in one area by size, grid, road, zoning and land constraints, ranked, with the key facts per parcel. Use it for area-wide searches, and find_sites when the goal matches one of its scenarios.
| Input | Type | Description |
|---|---|---|
region | string | Gmina, powiat or voivodeship name or TERYT code |
lat, lon, radius_km | number | Instead of region: a circle of 0.1–30 km |
min_area_sqm | number | Default 5,000, min 100 |
max_area_sqm | number | |
max_substation_m | number | Max distance to a 110 kV+ substation, up to 30,000 |
max_mv_line_m | number | Max distance to a 15 kV (SN) line, up to 5,000 |
max_road_m | number | Max distance to a public road (gminna and up), up to 2,000; 0 = adjoins one |
min_grid_capacity_mw | number | Published available connection capacity of at least this much… |
grid_capacity_within_m | number | …within this distance, default 10,000 |
zoning | string[] | Use classes of the parcel's largest MPZP zone, e.g. industrial, energy; buildable = any built-up use. Parcels without an MPZP are dropped |
max_forest_share | number | 0–1, default 0.1 |
vacant | boolean | Only parcels with no building on them |
exclude_protected | boolean | Default true: drop parcels touching a national or landscape park, reserve, Natura 2000, ecological site or nature-landscape complex |
sort_by | string | substation (default), mv_line, road (nearest first), grid_capacity, area (largest first) |
limit | integer | 1–50, default 20 |
Distances are metres to the parcel edge. At most 2,000 candidates are checked; truncated: true means narrow the area or tighten a filter.
{
"area": "Niepołomice (gmina, 1219043)",
"candidates_checked": 137,
"truncated": false,
"matched": 111,
"results": [
{
"egib_id": "121904_4.0001.4389/1",
"zonio_url": "https://app.zonio.tech/egib/121904_4.0001.4389/1",
"gmina": "Niepołomice",
"area_sqm": 36728,
"centroid_wgs84": { "lat": 50.035713, "lon": 20.191439 },
"substation_110kv": { "name": "Stacja elektroenergetyczna 110/15 kV „GPZ Niepołomice 2 MAN”", "voltage_kv": 110, "distance_m": 0 },
"mv_line_m": 0,
"public_road": { "category": "gminna", "distance_m": 3 },
"grid_capacity": { "name": "Kraków 1", "operator": "tauron", "available_mw": 20, "distance_m": 0 },
"forest_share": 0,
"mpzp": null
}
],
"notes": ["Shortlist only: confirm a parcel with parcel_report before presenting it as suitable."]
}analyze
Aggregate statistics over the parcels of one area: counts, sums, averages and percentiles, optionally grouped. Area and filters work as in search_parcels. Returns aggregates only, never individual parcels: use search_parcels for a shortlist.
Use it for questions like "how many parcels over 2 ha lie within 2 km of a substation, per gmina?" or "median distance to a 15 kV line by zoning class". The example below counts parcels of 2 ha or more in powiat wielicki per gmina (min_area_sqm: 20000, group_by: ["gmina"], metrics: ["count", "median:substation_m"]).
| Input | Type | Description |
|---|---|---|
region or lat, lon, radius_km | As in search_parcels; the radius is 0.5–30 km | |
min_area_sqm, max_area_sqm, max_substation_m, max_mv_line_m, max_road_m, min_grid_capacity_mw, grid_capacity_within_m, zoning, vacant | As in search_parcels; min_area_sqm defaults to 0 | |
exclude_protected | boolean | Default false |
group_by | string[] | Up to two of gmina, obreb, use_class, vacant, protected, or a measure: area_sqm, substation_m, mv_line_m, road_m |
buckets | object | Bucket edges for measures in group_by, e.g. { "substation_m": [500, 2000] }. Defaults: area 1,000 / 5,000 / 10,000 / 50,000 m²; substation 1 / 2 / 5 / 10 km; 15 kV line 100 / 250 / 500 / 1,000 m; road 0.5 / 50 / 200 / 1,000 m |
metrics | string[] | count (default), or sum, avg, min, max, median, p10 or p90 of a measure, e.g. median:substation_m; up to 8 |
{
"area": "powiat wielicki (powiat, 1219)",
"count": 1419,
"total": { "median:substation_m": 4807 },
"groups": [
{ "key": { "gmina": "Gdów" }, "count": 464, "median:substation_m": 7728 },
{ "key": { "gmina": "Niepołomice" }, "count": 338, "median:substation_m": 3275 },
{ "key": { "gmina": "Kłaj" }, "count": 267, "median:substation_m": 2957 },
{ "key": { "gmina": "Wieliczka" }, "count": 267, "median:substation_m": 3969 },
{ "key": { "gmina": "Biskupice" }, "count": 83, "median:substation_m": 5652 }
],
"suppressed": 0,
"notes": ["Aggregates only; use search_parcels for individual parcels."]
}Groups of fewer than 5 parcels, and groups past the largest 100, merge into other; if other would hold fewer than 5 they are left out of groups and counted in suppressed. A result of fewer than 5 parcels returns only the count. One call covers up to 200,000 parcels when it needs no distances, zoning, vacancy or protection, and 25,000 when it does; above that it asks to narrow the area.
Parcels
resolve_parcel
Turn what the user has into one canonical Polish cadastral parcel (EGiB). Returns the parcel's identity (ids, area, centroid). If several parcels match it returns candidates: ask the user which one. If none match, the error says why and may suggest nearby parcels or subdivisions. Use the egib_id it returns for parcel_report.
Pass exactly one of:
| Input | Type | Description |
|---|---|---|
egib_id | string | e.g. 141903_2.0004.99; an unpadded obręb like 141903_2.4.99 is accepted |
lat, lon | number | WGS84; the parcel containing the point |
teryt or gmina, plus obreb and numer_dzialki | string | Gmina TERYT (1419032, 141903 or 141903_2) or name; obręb name or number; parcel number, e.g. 25/2 |
address | string | "city, street number", geocoded by GUGiK |
include_geometry: true adds the parcel outline as WGS84 GeoJSON.
{
"egib_id": "141903_2.0004.99",
"zonio_url": "https://app.zonio.tech/egib/141903_2.0004.99",
"teryt": "1419032",
"gmina": "Brudzeń Duży",
"voivodeship": "mazowieckie",
"county": "powiat płocki",
"obreb": "BĄDKOWO RUMUNKI",
"obreb_code": "141903_2.0004",
"numer_dzialki": "99",
"area_sqm": 26048.7,
"pole_ewidencyjne": null,
"centroid_wgs84": { "lat": 52.67372, "lon": 19.451341 },
"source_updated_at": "2026-09-16T21:37:00+00:00"
}parcel_report
Due-diligence picture of one parcel in a single call, from the same data as Zonio's paid report: identity; MPZP / plan ogólny / studium zoning with each zone's share; land cover, EGiB klasoużytki, soil classes and terrain; environmental, flood, groundwater (GZWP), bird-area, RED III sensitivity, landslide, mining, contamination and heritage constraints; buildings, permits and what surrounds the parcel; roads, utilities, grid, DSO, connection queue and renewables; public transport, EV charging, aviation limits and airspace; and land-sale comparables with an indicative valuation.
| Input | Type | Description |
|---|---|---|
egib_id | string, required | From resolve_parcel |
radius_m | integer | 50–5,000. Overrides the search radius for nearby constraints, protected areas, heritage and permits (defaults 2 km; heritage 1 km; permits 5 km) |
sections | string[] | Only these of identity, zoning_mpzp, zoning_plan_ogolny, zoning_studium, land, constraints, buildings_and_permits, infrastructure, access, market; default all |
The result has one object per section, plus radii_m (the radii used), data_gaps and summary_flags. Every section and layer has a status: ok (found something), no_data (the layer covers this area and has nothing here), not_covered (the layer is not loaded here, so absence proves nothing) or error. data_gaps lists the not_covered and failed layers; summary_flags holds true / false answers, and null where the data cannot answer.
Data
list_layers
List the data layers Zonio holds and when each ETL topic last loaded successfully. Use it to answer "do you have data on X?" and to explain coverage gaps. A topic whose last run failed, or that never succeeded, may be stale or empty.
No inputs. Returns map_layers (id, name, source) and etl_topics (topic, last_success, last_status, successful_runs). Every layer has a page in the zonio.tech layer atlas.
Projects
A project is a named parcel shortlist in the Zonio app. These tools act as the signed-in user and only see that user's projects; they appear only when the client is signed in. Every result carries project_url, which opens the project in the app.
list_projects
List the signed-in user's Zonio projects (named parcel shortlists), newest first, with parcel counts.
No inputs.
get_project
One of the user's projects with its parcels: egib_id, zonio_url, gmina, obręb, number and area.
| Input | Type | Description |
|---|---|---|
project_id | string, required | From list_projects or create_project |
create_project
Create a project for the user. Check list_projects first so you don't create a duplicate name.
| Input | Type | Description |
|---|---|---|
name | string, required | Up to 200 characters |
description | string | What the shortlist is for, up to 2,000 characters |
update_project
Rename a project and/or set its description (null clears it). Omitted fields stay as they are.
| Input | Type | Description |
|---|---|---|
project_id | string, required | |
name | string | New name, up to 200 characters |
description | string or null | null clears it |
Pass name, description or both.
add_parcels
Add up to 50 parcels to a project. Ids are checked against the cadastre first; unknown ids are reported in not_found and not added: resolve them with resolve_parcel and retry.
| Input | Type | Description |
|---|---|---|
project_id | string, required | |
egib_ids | string[], required | 1–50 EGiB ids |
{
"added": [{ "egib_id": "141903_2.0004.99", "zonio_url": "https://app.zonio.tech/egib/141903_2.0004.99" }],
"already_in_project": [],
"not_found": ["141903_2.0004.1"],
"project_url": "https://app.zonio.tech/projects/21fc12a7-…"
}remove_parcels
Remove up to 50 parcels from a project. Only on the user's explicit request.
| Input | Type | Description |
|---|---|---|
project_id | string, required | |
egib_ids | string[], required | 1–50 EGiB ids |
Returns removed and not_in_project.
Errors
Tool errors are returned as results with isError: true and a message written for the model, e.g.:
{ "isError": true, "content": [{ "type": "text", "text": "No parcel 141903_2.0004.1. Use resolve_parcel to find the canonical egib_id." }] }