Skip to content
LogoLogo

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.

ToolUse it to
find_sitesRun a ready-made site-selection scenario over a region
search_parcelsShortlist parcels by size, grid, road, zoning and constraints
analyzeCount and measure the parcels of an area, grouped
resolve_parcelTurn an id, coordinates, a parcel number or an address into one parcel
parcel_reportGet the full due-diligence picture of one parcel
list_layersSee what data exists and how fresh it is
list_projectsList the user's projects
get_projectRead a project's parcels
create_projectStart a new parcel shortlist
update_projectRename a project or change its description
add_parcelsSave parcels to a project
remove_parcelsTake 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.

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.

InputTypeDescription
scenariostring, requiredsolar_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
regionstringVoivodeship, powiat or gmina name (diacritics optional) or TERYT code. Omit to search all of Poland, which is slow
paramsobjectOverride scenario parameters, e.g. { "substation_km": 5 }
weightsobjectRe-weight ranking signals 0–100, e.g. { "grid_capacity_mw": 80 }; 0 switches one off
limitinteger1–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.

InputTypeDescription
regionstringGmina, powiat or voivodeship name or TERYT code
lat, lon, radius_kmnumberInstead of region: a circle of 0.1–30 km
min_area_sqmnumberDefault 5,000, min 100
max_area_sqmnumber
max_substation_mnumberMax distance to a 110 kV+ substation, up to 30,000
max_mv_line_mnumberMax distance to a 15 kV (SN) line, up to 5,000
max_road_mnumberMax distance to a public road (gminna and up), up to 2,000; 0 = adjoins one
min_grid_capacity_mwnumberPublished available connection capacity of at least this much…
grid_capacity_within_mnumber…within this distance, default 10,000
zoningstring[]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_sharenumber0–1, default 0.1
vacantbooleanOnly parcels with no building on them
exclude_protectedbooleanDefault true: drop parcels touching a national or landscape park, reserve, Natura 2000, ecological site or nature-landscape complex
sort_bystringsubstation (default), mv_line, road (nearest first), grid_capacity, area (largest first)
limitinteger1–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"]).

InputTypeDescription
region or lat, lon, radius_kmAs 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, vacantAs in search_parcels; min_area_sqm defaults to 0
exclude_protectedbooleanDefault false
group_bystring[]Up to two of gmina, obreb, use_class, vacant, protected, or a measure: area_sqm, substation_m, mv_line_m, road_m
bucketsobjectBucket 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
metricsstring[]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:

InputTypeDescription
egib_idstringe.g. 141903_2.0004.99; an unpadded obręb like 141903_2.4.99 is accepted
lat, lonnumberWGS84; the parcel containing the point
teryt or gmina, plus obreb and numer_dzialkistringGmina TERYT (1419032, 141903 or 141903_2) or name; obręb name or number; parcel number, e.g. 25/2
addressstring"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.

InputTypeDescription
egib_idstring, requiredFrom resolve_parcel
radius_minteger50–5,000. Overrides the search radius for nearby constraints, protected areas, heritage and permits (defaults 2 km; heritage 1 km; permits 5 km)
sectionsstring[]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.

InputTypeDescription
project_idstring, requiredFrom 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.

InputTypeDescription
namestring, requiredUp to 200 characters
descriptionstringWhat 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.

InputTypeDescription
project_idstring, required
namestringNew name, up to 200 characters
descriptionstring or nullnull 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.

InputTypeDescription
project_idstring, required
egib_idsstring[], required1–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.

InputTypeDescription
project_idstring, required
egib_idsstring[], required1–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." }] }