ZV-2026-2006 · 2026-10-09 · mcp.easyterritory.ai
mcp.easyterritory.ai: Field guidance_handle was removed from account_build input; consumers still sending it may be rejected or silently ignored.
breaking
What changed
Field guidance_handle was removed from account_build input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from analyze input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from analyze_routes input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from auto_build input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from calculate_route input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from cluster_points input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from configure_map input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from create_territory_from_parts input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from delete_route input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from delete_tal input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from delete_territory input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from direct_build input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from ensure_map_viewer input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from export_geojson input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from extract_tal_branch input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from ezt input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from geocode_address input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from get_map_selection input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from get_map_visualization input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from get_part_selection input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from import_geojson input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from ingest_accounts input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from isochrone_build input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from load_analysis_panel input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from query_parts input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from realign input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from reintegrate_branch input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from request_account_upload input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from request_assignment_upload input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from request_part_selection input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from schedule_visits input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from seed_build input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from set_map_state input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from show_map_overlay input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from territory_merge input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from territory_rebalance input; consumers still sending it may be rejected or silently ignored. Field guidance_handle was removed from territory_split input; consumers still sending it may be rejected or silently ignored.
What to do
If your agents call mcp.easyterritory.ai, pin the new snapshot, patch the affected call sites, and let a green contract check confirm the fix. If you don't use the changed tools, nothing is required, but the rest of the ecosystem just learned about it at the same moment you did.
The redline
− guidance_handle Field guidance_handle was removed from account_build input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from analyze input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from analyze_routes input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from auto_build input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from calculate_route input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from cluster_points input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from configure_map input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from create_territory_from_parts input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from delete_route input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from delete_tal input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from delete_territory input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from direct_build input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from ensure_map_viewer input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from export_geojson input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from extract_tal_branch input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from ezt input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from geocode_address input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from get_map_selection input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from get_map_visualization input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from get_part_selection input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from import_geojson input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from ingest_accounts input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from isochrone_build input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from load_analysis_panel input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from query_parts input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from realign input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from reintegrate_branch input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from request_account_upload input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from request_assignment_upload input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from request_part_selection input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from schedule_visits input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from seed_build input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from set_map_state input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from show_map_overlay input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from territory_merge input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from territory_rebalance input; consumers still sending it may be rejected or silently ignored. − guidance_handle Field guidance_handle was removed from territory_split input; consumers still sending it may be rejected or silently ignored. − [Tier 1 — Attribute Grouping Builder] When: territories should mirror an account attribute… + Builds territories that follow an account column, such as rep name or territory code from … account_build − [Tier 1 — Analysis] When: balance diagnostics, cross-TAL comparison, or post-mutation fact… + Computes territory statistics for one or more alignments, i.e. how balanced the territorie… analyze − [Tier 2 — Route Facts] When: you need per-route numbers for routes calculate_route already… + Returns the total hours for each of the routes calculate_route has drawn: drive hours, dwe… analyze_routes − [Tier 1 — Balanced Territory Builder] When: partition account points into N balanced terri… + Partitions ingested account points into balanced sales territories with equal workload, me… auto_build − [Tier 1 — Routing] When: drive a list of stops in the best sequence — a windshield itinera… + Sequences and drives a set of stops, e.g. a technician from home to the depot, then the da… calculate_route − [Tier 1 — Balanced Point Grouping] Partition one ingested point layer directly into balanc… + Groups the points of one ingested layer into balanced clusters directly, with no ZIP or pa… cluster_points − [Tier 2 — Durable Map Config] When: set or update project_name (the durable TS short name … + Updates durable map settings on the Territory Solution and refreshes the live map: project… configure_map − [Tier 2 — Territory From Parts] When: create or update one leaf territory from committed p… + Creates one leaf territory from a list of part_ids (e.g. a committed map selection), in a … create_territory_from_parts − [Tier 2 — Delete Route] When: drop a whole route from the map and the TS (e.g. 'delete the… + Route delete: removes one whole route from the Territory Solution and the open map, in one… delete_route − [Tier 1 — Delete TAL] When: wipe one whole Territory Alignment Layer (user language: terri… + Deletes one whole territory alignment (TAL: 'the territory layer', 'all territories') from… delete_tal − [Tier 1 — Delete Territory] When: delete one leaf territory from an existing TAL (e.g. 'de… + Deletes one leaf territory from an alignment; its parts become unassigned. Needs tal_id, t… delete_territory − [Tier 1 — Known Assignments Builder] When: user has explicit part-to-territory assignments… + Builds territories from known part-to-territory assignments (a ZIP-to-territory sheet or f… direct_build − [Tier 1 — Router] Deterministic entry point for ambiguous or open-ended territory requests… + Maps a free-text territory request to a workflow. Read-only keyword routing; no compute. R… discover_intent − [Tier 1 — MC-First Gate] When: after get_map_visualization returns map_url and before any … + Reports whether the person has the map open (viewer_status.connected) for a map_session_id… ensure_map_viewer − [Knowledge Retrieval] List EMEP topics grouped by type (concept, workflow, interface, trou… + Lists EMEP topics grouped by type (concept, workflow, interface, troubleshooting, decision… ep_list_topics − [Knowledge Retrieval] Semantic search over the EZT MCP Expert Pack (EMEP) for targeted wor… + Semantic search over the EZT MCP Expert Pack (EMEP): workflow guidance, concepts, interfac… ep_search − [Tier 2 — Project save] The only Territory Solution export. Materialize the working GeoJSO… + Exports the territory solution as one GeoJSON file to share, archive, or open in EasyTerri… export_geojson − [Tier 1 — Delegation Extract] When: senior planner sends a regional subtree to a delegate … + Extracts one regional branch of a hierarchical alignment (by branch_rollup_territory_id or… extract_tal_branch − [Tier 1 — Plain-language orchestrator] Use when the exact granular tool is unclear or when… + Plain-language orchestrator: takes request (the goal) and runs the matching workflow in on… ezt − [Tier 1 — Geocode Only] When: geocode addresses without full account ingest, or headless b… + Geocodes a list of customer addresses to coordinates with match confidence, without loadin… geocode_address − [Tier 1 — Startup Guide + Handle] CALL THIS FIRST. Read-only. When: session start, after b… + Returns the EZT MCP operating guide: the cross-tool workflow order and shared rules (resul… get_guidance − [Tier 2 — MC Selection Poll] When: read the latest committed MC session selection — especi… + Returns the most recent committed selection on an open map session (map_session_id): part_… get_map_selection − [Tier 1 — MC-First Entry] FIRST step of non-headless territory work (invariant I-1). When:… + Opens the interactive territory map (Map Component) and returns map_url and map_session_id… get_map_visualization − [Tier 2 — Selection Poll] When: poll or retrieve committed part IDs after request_part_sel… + Returns the state of a map selection task (selection_task_id from request_part_selection, … get_part_selection − [Tier 2 — Project reopen] Import a GeoJSON FeatureCollection (standard points or an export… + Opens a GeoJSON FeatureCollection (plain points, or a territory file this server produced,… import_geojson − [Tier 1 — Data Intake] When: load/add account/location rows or account CSV point data into… + Account ingest: loads account or location rows (CRM records, a CSV, a spreadsheet) as poin… ingest_accounts − [Tier 1 — Isochrone Build] When: draw the area reachable by DRIVING from one or more origi… + Draws the area reachable by driving from one or more origins within a time or distance bud… isochrone_build − [Tier 2 — Analysis Panel Display] When: show Analyze JSON in the MC bottom dock (single or… + Shows a completed analyze result in the open map's analysis dock (single or compare). Need… load_analysis_panel − [Tier 2 — Part Metadata] When: enrich or filter parts before build, or inspect attributes … + Returns attributes (no geometry) for parts of a part layer listed at ezt://part-layers. Ta… query_parts − [Tier 1 — Realign] When: move parts between leaf territories within ONE TAL. Prerequisites… + Moves ZIPs or other parts (typed ids or ones selected on the map) from one territory into … realign − [Tier 1 — Delegation Reintegrate] When: merge an approved proposal TS into master. Prerequ… + Merges an edited branch (proposal Territory Solution from extract_tal_branch) back into th… reintegrate_branch − [Tier 2 — Data Intake helper] When: you have account/location rows or an account CSV that … + Stages account rows for ingest_accounts and returns upload_handle, csv_headers, and sugges… request_account_upload − [Tier 2 — Direct Build intake] When: you have part-to-territory assignment rows or a legac… + Stages part-to-territory assignment rows (e.g. a ZIP-to-territory spreadsheet with Postal … request_assignment_upload − [Tier 2 — Human Spatial Input] When: Monica selects parts on the map for realign, manual t… + Lets the person adjust boundaries by picking parts (e.g. ZIPs) on the map: puts the open m… request_part_selection − [Tier 1 — Periodic Scheduling] When: accounts carry a recurring cadence (every 7 days, twi… + Schedules recurring visits: expands each account's cadence (e.g. every 7 days, twice a mon… schedule_visits − [Tier 1 — Seed Build] When: grow ONE territory outward from a seed location until it holds… + Grows one territory outward from a seed {longitude, latitude} over a part layer until it h… seed_build − [Tier 2 — Low-Level MC State] When: switch MC mode, active TAL, or pending job ref, or jum… + Changes the open map's session state: mode, active alignment (active_tal_id), pending job … set_map_state − [Tier 1 — Map Overlay] When: customer wants something on the map — US ZIP codes, counties,… + Shows or hides something on the open map from a plain request ('add US zip codes', 'hide t… show_map_overlay − [Tier 2 — Quality Feedback] When: workflow blocked, partial, workaround required, confusin… + Sends product feedback to EasyTerritory: a blocked or partial workflow, a workaround, a co… submit_feedback − [Tier 2 — MCP Tasks mirror] Tool-only client equivalent of native tasks/cancel. Use only w… + Tool equivalent of the native MCP tasks/cancel, listed for clients without the Tasks capab… tasks_cancel − [Tier 2 — MCP Tasks mirror] Tool-only client equivalent of native tasks/get. Use only when… + Tool equivalent of the native MCP tasks/get, listed for clients without the Tasks capabili… tasks_get − [Tier 2 — MCP Tasks mirror] Tool-only client equivalent of native tasks/result. Call exact… + Tool equivalent of the native MCP tasks/result, listed for clients without the Tasks capab… tasks_result − [Tier 1 — Minimal-Disruption Merge] When: merge two adjacent territories and rebalance wit… + Merges a pair of adjacent territories and rebalances the rest of the alignment with minima… territory_merge − [Tier 1 — Minimal-Disruption Rebalance] When: underlying account data changed but alignmen… + Rebalances an existing alignment after the account data changed, keeping it as close to th… territory_rebalance − [Tier 1 — Minimal-Disruption Split] When: split one oversized territory with minimal disru… + Territory split: divides one territory (e.g. an oversized one) into two while changing the… territory_split − [Tier 1 — Workflow Advisor] Deterministic read-only next-action advisor for multi-step wor… + Returns the next tool call for a multi-step workflow, given where the workflow stands. Rea… workflow_advisor − [Knowledge Retrieval] Traverse the EMEP knowledge graph from a topic file (e.g. 'workflows… + Traverses the EMEP knowledge graph from a topic file (e.g. 'workflows/realign-by-selection… ep_graph_traverse