ezt-mcp

endpoint

https://mcp.easyterritory.ai/

protocol

http-sse ·2025-06-18

authentication

bearer

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is ezt-mcp live?

Yes — it answered the hub's last check (checked 5m ago). It answered 99% of checks over the last 30 days.

Is ezt-mcp free to use?

Not anonymously — it asks for a key or a login before it will serve. Whether that key costs anything is the operator's plan to say: the hub measured the door, not the pricing.

What tools does ezt-mcp have?

58 tools: ep_graph_traverse, tasks_cancel, list_dataverse_views, extract_tal_branch, territory_merge, analyze_routes, push_to_designer, get_map_visualization, ….

Is ezt-mcp safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• ep_graph_traverse reads auth-required 24d ago

  Traverses the EMEP knowledge graph from a topic file (e.g. 'workflows/realign-by-selection.md') to related guidance, up to `depth` hops. Returns no edges unless the pack ships a _graph.yaml.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233

  {
    "type": "object",
    "title": "ep_graph_traverseArguments",
    "required": [
      "file_path"
    ],
    "properties": {
      "depth": {
        "type": "integer",
        "title": "Depth",
        "default": 1
      },
      "file_path": {
        "type": "string",
        "title": "File Path"
      },
      "edge_kinds": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Edge Kinds",
        "default": null
      }
    }
  }

  arguments 33 lines copy
• tasks_cancel auth-required never probed

  Tool equivalent of the native MCP tasks/cancel, listed for clients without the Tasks capability. Requests cooperative cancellation of a task_id and returns the Task status document. Whether the Territory Solution is unchanged or partially updated follows the originating tool.

  mcp-tool

  1234567891011121314

  {
    "type": "object",
    "title": "tasks_cancelArguments",
    "required": [
      "task_id"
    ],
    "properties": {
      "task_id": {
        "type": "string",
        "title": "Task Id",
        "description": "task_id of the working task to stop."
      }
    }
  }

  arguments 14 lines copy
• list_dataverse_views auth-required 10d ago

  Microsoft Copilot only (Entra sign-in): lists the Dynamics 365 account views the signed-in user can read, so their accounts import without a file. Without environment_url it lists the user's environments; with one environment it goes straight to its views, with several it returns status choose_environment and an ask_user. Views carry view_id, name, kind (system | personal), and is_default; point_readiness samples active accounts for coordinates vs address-only (address rows are geocoded at ingest). Next: import_dataverse_view(environment_url, view_id). Other clients get DATAVERSE_NOT_AVAILABLE: use request_account_upload (a CSV file) or list_designer_projects instead. DATAVERSE_CONSENT_REQUIRED carries admin_consent_url for the user's Microsoft admin.

  mcp-tool

  12345678910111213141516171819

  {
    "type": "object",
    "title": "list_dataverse_viewsArguments",
    "properties": {
      "environment_url": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Environment Url",
        "default": null,
        "description": "Dynamics 365 environment, e.g. https://contoso.crm.dynamics.com; when absent the result lists environments."
      }
    }
  }

  arguments 19 lines copy
• extract_tal_branch changes data auth-required never probed

  Extracts one regional branch of a hierarchical alignment (by branch_rollup_territory_id or branch_territory_path) into its own Territory Solution, so a delegate can edit just that region. Returns the extract plus branch_metadata, which reintegrate_branch needs later. exclude_locked (default true) leaves locked territories out.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109

  {
    "type": "object",
    "title": "extract_tal_branchArguments",
    "required": [
      "tal_id"
    ],
    "properties": {
      "tal_id": {
        "type": "string",
        "title": "Tal Id",
        "description": "Hierarchical TAL (alignment) to branch from."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "delegate_ref": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Delegate Ref",
        "default": null
      },
      "exclude_locked": {
        "type": "boolean",
        "title": "Exclude Locked",
        "default": true
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "expected_revision": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Revision",
        "default": null
      },
      "branch_territory_path": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Branch Territory Path",
        "default": null
      },
      "expected_content_hash": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Content Hash",
        "default": null
      },
      "branch_rollup_territory_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Branch Rollup Territory Id",
        "default": null,
        "description": "Rollup territory whose subtree becomes the branch. Or pass branch_territory_path."
      }
    }
  }

  arguments 109 lines copy
• territory_merge auth-required never probed

  Merges a pair of adjacent territories (N to N-1 territories). By default, territory_id_b is folded into territory_id_a (or renamed to new_territory_label) and the rest of the alignment rebalances with minimal disruption, e.g. when a rep leaves and neighbors absorb the territory. Set preserve_other_territories=true for an exact two-territory union that combines only territory_id_a and territory_id_b (optionally named new_territory_label) and leaves every other territory unchanged with no rebalance. Non-adjacent ids return NON_ADJACENT_TERRITORIES. Needs source_tal_id and the Territory Solution from map_session_id or ts_handle; workload rebalance needs dwell_time (CLARIFICATION_REQUIRED otherwise). Writes a new derived alignment. Returns a task.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263

  {
    "type": "object",
    "title": "territory_mergeArguments",
    "properties": {
      "objective": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "metric": {
                "type": "string",
                "description": "Point metric column name to balance (e.g. 'Revenue', 'Score'). Required when metric_bias > 0. Account count is count_bias, not a column."
              },
              "count_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on account count (locations per territory). Default 0."
              },
              "metric_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on the metric column."
              },
              "workload_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on workload (drive time + dwell)."
              }
            },
            "description": "Balance objective: workload_bias + metric_bias + count_bias = 100, weighting workload (drive + dwell), one metric column, and account count. Workload: {workload_bias: 100}. Metric: {metric: '<column>', workload_bias: 0, metric_bias: 100}. Count: {workload_bias: 0, count_bias: 100}. Three-way: {metric: 'Score', workload_bias: 40, metric_bias: 40, count_bias: 20}. Only one metric column balances; combine several into one score column at ingest. Omitted on restructure tools: inherits the source TAL build_provenance objective.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Objective",
        "default": null
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "dwell_time": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "enum": [
                  "scalar",
                  "field"
                ],
                "type": "string",
                "description": "Dwell source: 'scalar' for a fixed per-visit duration or 'field' for an ingested point column."
              },
              "unit": {
                "enum": [
                  "minutes",
                  "hours"
                ],
                "type": "string",
                "default": "minutes",
                "description": "Time unit for value or field ('minutes' or 'hours')."
              },
              "field": {
                "type": "string",
                "minLength": 1,
                "description": "Point column name holding per-account onsite time when type='field'."
              },
              "value": {
                "type": "number",
                "minimum": 0,
                "description": "Confirmed onsite duration per visit when type='scalar'."
              }
            },
            "description": "Onsite (dwell) time per visit: {type: 'scalar', value: <number>, unit: 'minutes'|'hours'} or {type: 'field', field: '<column>', unit: 'minutes'|'hours'}.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Dwell Time",
        "default": null
      },
      "part_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Layer",
        "default": null,
        "description": "Part layer (e.g. us_zips). Required only when not inferable from the source TAL."
      },
      "point_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Point Layer",
        "default": null,
        "description": "Optional point layer used to compute per-part workload/metric measures. When omitted, a uniform geography-only weighting is used."
      },
      "new_tal_label": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "New Tal Label",
        "default": null,
        "description": "Label for the derived TAL. Defaults to '<source label> (<operation>)'."
      },
      "repair_policy": {
        "enum": [
          "default",
          "strict",
          "report_only"
        ],
        "type": "string",
        "title": "Repair Policy",
        "default": "default",
        "description": "Topology repair for dissolved territories. default fills interior holes in the dissolved geometry (no part is added or reassigned; repair_summary.changed_part_ids lists the territories' own parts). report_only detects holes and changes nothing (warning REPAIR_AVAILABLE). strict fails with REPAIR_REQUIRED when a hole is found."
      },
      "source_tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Source Tal Id",
        "default": null,
        "description": "Source TAL. Optional for form-capable clients that can answer via elicitation."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "territory_id_a": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Territory Id A",
        "default": null,
        "description": "First territory (id or label). The merged territory keeps this identity unless new_territory_label is supplied."
      },
      "territory_id_b": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Territory Id B",
        "default": null,
        "description": "Second territory (id or label). Must be adjacent to territory_id_a."
      },
      "balance_tolerance": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Balance Tolerance",
        "default": null,
        "description": "Accepted for compatibility. The power-diagram rebalance converges on its own internal tolerance, so this value no longer gates per-part moves."
      },
      "disruption_weight": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Disruption Weight",
        "default": null,
        "description": "Incumbency stickiness for the warm-started power-diagram rebalance. 0 is a pure power re-solve (max balance, more churn); higher values keep more of the source alignment by requiring a neighbor territory to inflate further before it can claim a border part."
      },
      "new_territory_label": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "New Territory Label",
        "default": null,
        "description": "Optional display label for the merged territory (defaults to territory_id_a's label)."
      },
      "visit_frequency_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Visit Frequency Field",
        "default": null,
        "description": "Numeric visits-per-cycle column on the point layer. When omitted, inherits from source TAL build_provenance or point-layer metadata."
      },
      "preserve_other_territories": {
        "type": "boolean",
        "title": "Preserve Other Territories",
        "default": false,
        "description": "When true, performs an exact union of territory_id_a and territory_id_b without rebalancing any other territory in the alignment."
      }
    }
  }

  arguments 263 lines copy
• analyze_routes auth-required 24d ago

  Returns the total hours for each of the routes calculate_route has drawn: drive hours, dwell hours, route_workload_hours (provider drive time plus dwell, no visit-frequency multiplier), stop coordinates, centroid, and bbox. Synchronous. Needs map_session_id or ts_handle, and dwell from dwell_time or the dwell recorded on the route; unresolved dwell returns CLARIFICATION_REQUIRED (needs_dwell). A circuit's stop_count includes the return to the start, so that stop's dwell counts twice. Facts only: no capacity, ranking, or overload flags. These hours are a different measure from territory and cluster workload; territory statistics come from analyze.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394

  {
    "type": "object",
    "title": "analyze_routesArguments",
    "properties": {
      "route_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Route Ids",
        "default": null,
        "description": "Routes to report on, in the order returned. Absent means every route in the solution."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "dwell_time": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "enum": [
                  "scalar",
                  "field"
                ],
                "type": "string",
                "description": "Dwell source: 'scalar' for a fixed per-visit duration or 'field' for an ingested point column."
              },
              "unit": {
                "enum": [
                  "minutes",
                  "hours"
                ],
                "type": "string",
                "default": "minutes",
                "description": "Time unit for value or field ('minutes' or 'hours')."
              },
              "field": {
                "type": "string",
                "minLength": 1,
                "description": "Point column name holding per-account onsite time when type='field'."
              },
              "value": {
                "type": "number",
                "minimum": 0,
                "description": "Confirmed onsite duration per visit when type='scalar'."
              }
            },
            "description": "Onsite (dwell) time per visit: {type: 'scalar', value: <number>, unit: 'minutes'|'hours'} or {type: 'field', field: '<column>', unit: 'minutes'|'hours'}.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Dwell Time",
        "default": null
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      }
    }
  }

  arguments 94 lines copy
• push_to_designer auth-required never probed

  Saves a Territory Solution in EasyTerritory Designer from the server. Without project_id it creates a new rolodex project named label (the user's choice; a missing label returns CLARIFICATION_REQUIRED). With project_id it overwrites that project's territories, points, and routes in place. Input: map_session_id, ts_handle, or a completed build job_id. Returns a task; the result has project_id, url, and share_with_user. part_layer_id binds the Designer catalog layer (default: the layer a pulled TAL came from); tal_id picks the alignment; include_points=false sends territories and routes only. Route stops link to point layers by point_id. run_plugin / push_power_bi (default false) run the project's post-save plugin / refresh Power BI. Requires link_designer.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111

  {
    "type": "object",
    "title": "push_to_designerArguments",
    "properties": {
      "label": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Label",
        "default": null
      },
      "job_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Job Id",
        "default": null,
        "description": "task_id (same value as job_id) of a completed build or ingest task; its Territory Solution is the input."
      },
      "tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Id",
        "default": null,
        "description": "Alignment to push; defaults to the active TAL."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Designer project to overwrite in place; omit to create a new project named label."
      },
      "run_plugin": {
        "type": "boolean",
        "title": "Run Plugin",
        "default": false
      },
      "part_layer_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Layer Id",
        "default": null,
        "description": "Designer catalog part layer to bind; defaults to the layer a pulled TAL came from."
      },
      "push_power_bi": {
        "type": "boolean",
        "title": "Push Power Bi",
        "default": false
      },
      "include_points": {
        "type": "boolean",
        "title": "Include Points",
        "default": true
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      }
    }
  }

  arguments 111 lines copy
• get_map_visualization reads auth-required never probed

  Opens the interactive territory map (Map Component) and returns map_url and map_session_id. Opens a blank map, or shows the latest state of an existing Territory Solution (e.g. yesterday's work) from ts_handle or a completed job_id. Idempotent per user_id: a second call returns the same map. new_project=true replaces the open workspace with an empty project. theme: dark | light (basemap and UI style; default dark). presentation.view_name: empty | points_only | review | selection. Apps-capable hosts render the map in chat (ui://easyterritory/map-viewer); other clients open map_url in a browser. Later map tools take map_session_id. ensure_map_viewer reports when the person has the map open.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168

  {
    "type": "object",
    "title": "get_map_visualizationArguments",
    "properties": {
      "mode": {
        "type": "string",
        "title": "Mode",
        "default": "view",
        "description": "view — read-only map review/share/verification, no selection commits. select — allows transient local selection and committed selection events."
      },
      "theme": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Theme",
        "default": null,
        "description": "Map Component basemap and UI theme ('dark' or 'light'; default 'dark')."
      },
      "job_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Job Id",
        "default": null,
        "description": "task_id (same value as job_id) of a completed build or ingest task; its Territory Solution is the input."
      },
      "user_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "User Id",
        "default": null,
        "description": "Stable caller id; a second call with the same user_id returns the same map."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "new_project": {
        "type": "boolean",
        "title": "New Project",
        "default": false,
        "description": "Start a fresh map session (session_exists=false) instead of reusing the caller's open workspace. Without ts, ts_handle, or job_id, opens an empty project; with a TS source, opens that Territory Solution on a new session without carrying over prior routes, overlays, or analysis panels. Omitted empty+view reuses the existing project."
      },
      "presentation": {
        "anyOf": [
          {
            "type": "object",
            "title": "Optional Presentation View/Style Context",
            "properties": {
              "theme": {
                "enum": [
                  "dark",
                  "light"
                ],
                "type": "string",
                "description": "Map Component basemap and UI theme ('dark' or 'light'; default 'dark'). Also accepted at top-level theme or presentation.style_overrides.theme."
              },
              "view_name": {
                "enum": [
                  "empty",
                  "points_only",
                  "review",
                  "selection"
                ],
                "type": "string",
                "description": "Built-in presentation template. Defaults: select mode → selection; empty project → empty; points-only TS → points_only; TAL/review → review. Diagnostics use presentation.debug_panel (or style_overrides.debug_panel), not a separate template."
              },
              "debug_panel": {
                "type": "boolean",
                "description": "Per-request debug modifier. When true, the MC #debug block shows session/mode/TAL/revision/zoom diagnostics and per-row legend meta. It replaces a custom QA template."
              },
              "style_overrides": {
                "type": "object",
                "description": "Optional style hints forwarded to the MC renderer (may include theme: 'dark' | 'light' or debug_panel).",
                "additionalProperties": true
              }
            },
            "additionalProperties": false
          },
          {
            "type": "null"
          }
        ],
        "default": null
      },
      "active_tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Active Tal Id",
        "default": null,
        "description": "Alignment to show as active."
      },
      "expiry_seconds": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expiry Seconds",
        "default": null,
        "description": "Requested session TTL in seconds. Server may cap at policy maximum."
      },
      "interaction_flags": {
        "anyOf": [
          {
            "type": "object",
            "title": "Allowed Interaction Flags for select Mode",
            "properties": {
              "allow_click_select": {
                "type": "boolean",
                "default": true,
                "description": "Enable click-to-toggle part selection. When false and lasso is enabled, select mode starts in lasso."
              },
              "allow_lasso_select": {
                "type": "boolean",
                "default": true,
                "description": "Enable the MC freehand lasso tool in select mode. Lasso adds every visibly overlapping part and preserves the existing selection for click fine-tuning."
              },
              "allow_territory_filter": {
                "type": "boolean",
                "default": false
              }
            },
            "additionalProperties": false
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Only meaningful in select mode."
      }
    }
  }

  arguments 168 lines copy
• get_guidance auth-required 24d ago

  Returns the EZT MCP operating guide: the cross-tool workflow order and shared rules (result.text, same text as the server instructions), result.server_version, and result.seat for the caller's key (plan standard|trial, key_expires_at, and quota_remaining for geocoding, routing, and isochrone requests). Read-only. Useful at the start of a session or for a host that does not show server instructions.

  mcp-tool

  12345

  {
    "type": "object",
    "title": "get_guidanceArguments",
    "properties": {}
  }

  arguments 5 lines copy
• discover_intent reads auth-required 24d ago

  Maps a free-text territory request to a workflow. Read-only keyword routing; no compute. Returns intent_category, the recommended tool order, the main tool (tier1_tool, null when the request is ambiguous) and alternatives, required_inputs, clarifying_questions for missing inputs, and the workflow guide inline as guidance {uri, title, excerpt}. Covers building territories (auto_build, account_build, direct_build, cluster_points, seed_build), editing (realign, split, merge, rebalance), analyze, geocoding and ingest, showing a ZIP or part layer, routes, drive-time areas (isochrone_build), recurring visit schedules (schedule_visits), contractor coverage gaps (analyze_network_coverage), listing points in a territory (points_in_territory), and moving a Territory Solution to or from EasyTerritory Designer.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445

  {
    "type": "object",
    "title": "discover_intentArguments",
    "required": [
      "user_request"
    ],
    "properties": {
      "context": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "has_ts_handle": {
                "type": "boolean"
              },
              "has_point_layer": {
                "type": "boolean"
              },
              "viewer_connected": {
                "type": "boolean"
              },
              "part_layers_loaded": {
                "type": "boolean"
              },
              "has_visit_frequency_field": {
                "type": "boolean",
                "description": "True when the active point layer declares a visit-frequency column. Appends the route-vs-schedule question on route_stops / periodic_scheduling and the use-or-ignore question on build_from_accounts / account_grouping."
              }
            },
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Optional state flags that tailor the recommended workflow."
      },
      "user_request": {
        "type": "string",
        "title": "User Request",
        "description": "The raw natural-language request to classify."
      }
    }
  }

  arguments 45 lines copy
• workflow_advisor auth-required never probed

  Returns the next tool call for a multi-step workflow, given where the workflow stands. Read-only state machine; executes nothing. intent_category: build_from_accounts | account_grouping | known_assignments | realign_existing | restructure | load_part_layer | route_stops | reachable_area | periodic_scheduling | coverage_gap_analysis | points_in_territory. state: viewer_connected, point_layer, part_layer, tal_present, analysis_fresh, plus selection/realign or restructure flags. inputs: the values known so far (part_layer, territory_count, tal_id, operation, route_type, origins, visit_frequency_field, ...); missing_inputs names the keys still needed. Returns next_tool with drafted next_args, missing_inputs (reported, never invented), blocked_by, remaining_steps, and the workflow guide inline as guidance. Order rules applied: map before compute, viewer connected before compute, ingest before build, analyze after an edit when a point layer exists. Calling it after each step with the updated state walks the whole workflow.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242

  {
    "type": "object",
    "title": "workflow_advisorArguments",
    "required": [
      "intent_category"
    ],
    "properties": {
      "state": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "tal_id": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "realign: TAL being edited."
              },
              "user_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "headless": {
                "type": "boolean"
              },
              "ts_handle": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "part_layer": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "point_layer": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "tal_present": {
                "type": "boolean"
              },
              "source_tal_id": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "restructure: source TAL."
              },
              "analysis_fresh": {
                "type": "boolean"
              },
              "map_session_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "realign_applied": {
                "type": "boolean",
                "description": "realign: the realign mutation completed."
              },
              "viewer_connected": {
                "type": "boolean"
              },
              "expected_revision": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "realign: optimistic-concurrency revision."
              },
              "selection_task_id": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "realign: id to poll with get_part_selection."
              },
              "analysis_requested": {
                "type": "boolean",
                "description": "realign: user explicitly requested post-edit analysis; otherwise geography-only realign stops after the live map refresh."
              },
              "selection_committed": {
                "type": "boolean",
                "description": "realign: parts committed on the map."
              },
              "selection_requested": {
                "type": "boolean",
                "description": "realign: a request_part_selection task exists."
              },
              "analysis_panel_loaded": {
                "type": "boolean"
              }
            },
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Agent-supplied workflow state; all keys optional and default to 'not done yet'."
      },
      "inputs": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "moves": {
                "type": "array",
                "description": "realign: explicit [{part_id, to_territory_id}] moves (skips map-selection steps)."
              },
              "in_tal": {
                "type": [
                  "string",
                  "object"
                ],
                "description": "Build scope inside an existing TAL: tal_id (or {tal_id, territory_ids}) whose parts are kept; drafts part_filter.in_tal alongside state_abbr / part_filter."
              },
              "tal_id": {
                "type": "string",
                "description": "realign: TAL to edit."
              },
              "part_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "realign: committed/explicit part ids for realign_operation."
              },
              "operation": {
                "enum": [
                  "split",
                  "merge",
                  "rebalance"
                ],
                "type": "string",
                "description": "restructure: which restructure tool (default rebalance)."
              },
              "tal_label": {
                "type": "string"
              },
              "not_in_tal": {
                "type": [
                  "string",
                  "object"
                ],
                "description": "Build scope white space: tal_id (or {tal_id}) whose parts are subtracted; drafts part_filter.not_in_tal alongside state_abbr / part_filter."
              },
              "part_layer": {
                "type": "string"
              },
              "output_mode": {
                "enum": [
                  "tal",
                  "assignments"
                ],
                "type": "string",
                "description": "For auto_build/account_build: return the default TAL or a downloadable assignments-only artifact."
              },
              "point_layer": {
                "type": "string"
              },
              "new_tal_label": {
                "type": "string"
              },
              "source_tal_id": {
                "type": "string",
                "description": "restructure: source TAL."
              },
              "balance_metric": {
                "type": "string"
              },
              "grouping_field": {
                "type": "string"
              },
              "territory_id_a": {
                "type": "string",
                "description": "restructure merge: first territory."
              },
              "territory_id_b": {
                "type": "string",
                "description": "restructure merge: second territory."
              },
              "target_workload": {
                "type": "number",
                "exclusiveMinimum": 0
              },
              "territory_count": {
                "type": "integer",
                "minimum": 1
              },
              "to_territory_id": {
                "type": "string",
                "description": "realign: destination territory id."
              },
              "realign_operation": {
                "type": "string",
                "description": "realign: preset op (e.g. assign_to_territory, remove_parts)."
              },
              "analysis_requested": {
                "type": "boolean",
                "description": "realign: opt into post-edit Analyze even without a declared point layer (AN-004)."
              },
              "assignments_handle": {
                "type": "string"
              },
              "new_territory_label": {
                "type": "string"
              },
              "target_territory_id": {
                "type": "string",
                "description": "restructure split: territory to split."
              },
              "destination_territory_id": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Optional plan parameters used to draft next_args."
      },
      "intent_category": {
        "type": "string",
        "title": "Intent Category",
        "description": "build_from_accounts | account_grouping | point_clustering | known_assignments | realign_existing | restructure | delete_territory | load_part_layer | reachable_area | seed_growth | coverage_gap_analysis | route_stops | routes_layer | delete_route | delete_point_layer | points_in_territory | periodic_scheduling. Tool names (auto_build, account_build, cluster_points, direct_build, isochrone_build, seed_build, analyze_network_coverage) are aliases; white_space_build / tal_footprint_build are auto_build with inputs.not_in_tal / in_tal; any other value returns the unsupported-category fallback."
      }
    }
  }

  arguments 242 lines copy
• ep_search reads auth-required 24d ago

  Semantic search over the EZT MCP Expert Pack (EMEP): workflow guidance, concepts, interfaces, and common mistakes. Returns ranked markdown chunks with source files; atoms pulled in via `requires` are flagged requires_expanded. Degrades to the ezt://guidance/... resources if retrieval is unavailable. Examples: 'build balanced territories from accounts', 'viewer not connected before compute', 'auto_build vs account_build'.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445

  {
    "type": "object",
    "title": "ep_searchArguments",
    "required": [
      "query"
    ],
    "properties": {
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null
      },
      "type": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Type",
        "default": null
      },
      "query": {
        "type": "string",
        "title": "Query"
      },
      "max_results": {
        "type": "integer",
        "title": "Max Results",
        "default": 6
      }
    }
  }

  arguments 45 lines copy
• ep_list_topics auth-required 24d ago

  Lists EMEP topics grouped by type (concept, workflow, interface, troubleshooting, decision). Optional `type` filter.

  mcp-tool

  123456789101112131415161718

  {
    "type": "object",
    "title": "ep_list_topicsArguments",
    "properties": {
      "type": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Type",
        "default": null
      }
    }
  }

  arguments 18 lines copy
• ensure_map_viewer auth-required 24d ago

  Reports whether the person has the map open (viewer_status.connected) for a map_session_id from get_map_visualization, waiting up to wait_seconds (max 30 s per call; the result reports requested_wait_seconds and max_wait_seconds). Works the same for the in-chat map and the map_url tab. Returns VIEWER_NOT_CONNECTED while the map is still closed; the same call can be repeated while the person opens it. Build, analyze, and selection results paint live once the viewer is connected.

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "type": "object",
    "title": "ensure_map_viewerArguments",
    "required": [
      "map_session_id"
    ],
    "properties": {
      "wait_seconds": {
        "type": "number",
        "title": "Wait Seconds",
        "default": 0,
        "description": "Optional server-side wait window. 0 returns the current snapshot only. Values above 30 are clamped to 30 s per call; on VIEWER_NOT_CONNECTED the error details carry requested_wait_seconds, max_wait_seconds, and next_call (call again)."
      },
      "map_session_id": {
        "type": "string",
        "title": "Map Session Id",
        "description": "Open map session (msess_...) from get_map_visualization."
      },
      "poll_interval_ms": {
        "type": "integer",
        "title": "Poll Interval Ms",
        "default": 500
      }
    }
  }

  arguments 25 lines copy
• submit_feedback auth-required never probed

  Sends product feedback to EasyTerritory: a blocked or partial workflow, a workaround, a confusing response, or a missing capability. Returns an acknowledgement with feedback_id. Secrets, emails, Territory Solution JSON, GeoJSON, and account/CSV tables are stripped before storage; the text is meant for a description of what happened, not data.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195

  {
    "type": "object",
    "$defs": {
      "FeedbackCategoryParam": {
        "enum": [
          "product_gap",
          "mcp_tool_gap",
          "documentation_gap",
          "data_issue",
          "workflow_confusion",
          "bug",
          "suggestion",
          "other"
        ],
        "type": "string"
      },
      "FeedbackSeverityParam": {
        "enum": [
          "low",
          "medium",
          "high",
          "blocking"
        ],
        "type": "string"
      },
      "FeedbackConfidenceParam": {
        "enum": [
          "low",
          "medium",
          "high"
        ],
        "type": "string"
      },
      "FeedbackProductAreaParam": {
        "enum": [
          "territory_planning",
          "alignment",
          "mapping",
          "routing",
          "powerbi",
          "d365",
          "data_import",
          "geocoding",
          "map_component",
          "mcp",
          "other"
        ],
        "type": "string"
      }
    },
    "title": "submit_feedbackArguments",
    "required": [
      "user_goal",
      "what_happened"
    ],
    "properties": {
      "category": {
        "$ref": "#/$defs/FeedbackCategoryParam",
        "default": "other"
      },
      "severity": {
        "$ref": "#/$defs/FeedbackSeverityParam",
        "default": "medium"
      },
      "user_goal": {
        "type": "string",
        "title": "User Goal",
        "description": "What the user was trying to accomplish, sanitized."
      },
      "confidence": {
        "$ref": "#/$defs/FeedbackConfidenceParam",
        "default": "medium"
      },
      "session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Session Id",
        "default": null,
        "description": "Client session id, if the host has one."
      },
      "client_name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Client Name",
        "default": null
      },
      "related_tool": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Related Tool",
        "default": null
      },
      "what_happened": {
        "type": "string",
        "title": "What Happened",
        "description": "Where the agent struggled, failed, found confusing results, or used a workaround."
      },
      "client_version": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Client Version",
        "default": null
      },
      "correlation_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Correlation Id",
        "default": null,
        "description": "task_id, job_id, or request id the feedback is about."
      },
      "context_summary": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Context Summary",
        "default": null,
        "description": "Optional sanitized summary only. Excludes credentials, API keys, raw customer data, private territory assignments, and PII."
      },
      "include_context": {
        "type": "boolean",
        "title": "Include Context",
        "default": false
      },
      "expected_capability": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Capability",
        "default": null
      },
      "related_product_area": {
        "anyOf": [
          {
            "$ref": "#/$defs/FeedbackProductAreaParam"
          },
          {
            "type": "null"
          }
        ],
        "default": null
      },
      "suggested_improvement": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Suggested Improvement",
        "default": null
      }
    }
  }

  arguments 195 lines copy
• list_part_layers auth-required 24d ago

  Returns the available canonical part layers for territory construction (for example us_zips, us_counties, ca_fsa, and active country postal or administrative polygon layers), with the same metadata as ezt://part-layers: part_layer, label, description, country_codes, admin_levels, part_count, id_format, example_part_ids, capabilities, data_version, and updated_at. Optional part_layer returns detailed metadata for one layer (bbox, aliases, supported_admin1, source_name, source_vintage, id_format_notes) or UNKNOWN_PART_LAYER. Optional country_code filters by 2-letter ISO country code. Read-only.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132

  {
    "type": "object",
    "title": "list_part_layersArguments",
    "properties": {
      "part_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Layer",
        "default": null,
        "description": "Optional canonical part layer identifier (for example us_zips, us_counties, ca_fsa, uk_areas, germany_postal) to fetch detailed metadata for one layer."
      },
      "country_code": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Country Code",
        "default": null,
        "description": "Optional 2-letter ISO 3166-1 alpha-2 country code (for example US, CA, GB, DE) to filter the returned part layers."
      }
    }
  }

  arguments 32 lines copy
• direct_build auth-required never probed

  Builds territories from known part-to-territory assignments (a ZIP-to-territory sheet or file, including a three-level region/district/territory hierarchy via territory_path) and adds them to the Territory Solution as a new alignment (TAL). Assignments come only as an assignments_handle (aup_...) from request_assignment_upload (the file, csv_text, or assignment rows). Sheets with Postal Code plus Territory/Region/Division columns are mapped automatically. Duplicate part_ids follow duplicate_part_policy (default keep_first). Returns a task; the result carries tal_id and ts_handle and paints the open map. Location points load with ingest_accounts; balanced partitions come from auto_build; grouping by a column is account_build.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105

  {
    "type": "object",
    "title": "direct_buildArguments",
    "required": [
      "part_layer",
      "tal_label"
    ],
    "properties": {
      "tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Id",
        "default": null,
        "description": "Optional caller-supplied TAL identifier. When omitted, the server derives a stable ID from tal_label. Supplied IDs must not collide with an existing TAL in the input TS."
      },
      "tal_label": {
        "type": "string",
        "title": "Tal Label"
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "part_layer": {
        "type": "string",
        "title": "Part Layer"
      },
      "repair_policy": {
        "enum": [
          "default",
          "strict",
          "report_only"
        ],
        "type": "string",
        "title": "Repair Policy",
        "default": "default",
        "description": "Topology repair for dissolved territories. default fills interior holes in the dissolved geometry (no part is added or reassigned; repair_summary.changed_part_ids lists the territories' own parts). report_only detects holes and changes nothing (warning REPAIR_AVAILABLE). strict fails with REPAIR_REQUIRED when a hole is found."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "expected_revision": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Revision",
        "default": null
      },
      "assignments_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Assignments Handle",
        "default": null,
        "description": "Required. upload_handle (aup_...) from request_assignment_upload. Single-use: the build claims it."
      },
      "missing_part_policy": {
        "type": "string",
        "title": "Missing Part Policy",
        "default": "fail",
        "description": "Controls assigned part IDs that are absent from the selected polygon part layer. fail returns UNKNOWN_PART_ID. drop_with_warning omits them, lists them in invalid_parts, and proceeds with geometry-covered assignments."
      },
      "duplicate_part_policy": {
        "type": "string",
        "title": "Duplicate Part Policy",
        "default": "keep_first",
        "description": "When the same part_id maps to different territory_path values, keep_first (default) keeps the first row and skips the rest with a warning; keep_last keeps the last row; fail aborts with CLARIFICATION_REQUIRED."
      }
    }
  }

  arguments 105 lines copy
• analyze_network_coverage auth-required never probed

  Finds coverage gaps in a contractor (vendor, service provider, technician, repair shop) network: counts the contractors that reach each demand point (customer, claim, store, ZIP center). Reads contractor_layer (ingested with layer_role=contractors) and demand_layer. coverage: {rule: drive_time, max_minutes} (straight-line travel model, no provider calls), {rule: drive_time, source: isochrone_tal, isochrone_tal_id} (isochrone_build areas around the contractors), or {rule: zip_list} (declared service ZIPs). One trade per call ('*' for all). Missing layers, coverage, or trade return CLARIFICATION_REQUIRED with the question. Writes new layers, never the source: <demand>_coverage (contractor_count, single_source, coverage_class red none / amber one / green 2+ / blue saturated, nearest contractor and minutes, capacity_ratio, gap score) and <demand>_gaps; gap_territory=true adds the all-gap ZIPs as one territory. Assigns nothing; dividing work is auto_build. Returns a task; the result has coverage_pct, gap and single-source counts, top_gaps, and per-contractor reach.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257

  {
    "type": "object",
    "title": "analyze_network_coverageArguments",
    "properties": {
      "trade": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Trade",
        "default": null,
        "description": "One trade per call, matched case-insensitively against the comma-separated trade_field values. '*' (or 'all') keeps every contractor. Required when the contractor layer has a trade_field (needs_trade)."
      },
      "coverage": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "rule"
            ],
            "properties": {
              "rule": {
                "enum": [
                  "drive_time",
                  "zip_list"
                ],
                "type": "string"
              },
              "max_km": {
                "type": "number",
                "exclusiveMinimum": 0
              },
              "source": {
                "enum": [
                  "travel_model",
                  "isochrone_tal"
                ],
                "type": "string",
                "default": "travel_model"
              },
              "part_layer": {
                "type": "string",
                "default": "us_zips",
                "minLength": 1,
                "description": "Part layer the demand points are placed in for zip_list and gap_territory."
              },
              "max_minutes": {
                "type": "number",
                "exclusiveMinimum": 0
              },
              "isochrone_tal_id": {
                "type": "string",
                "minLength": 1
              }
            },
            "additionalProperties": false
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "What counts as covered. drive_time with source travel_model (default) needs max_minutes or max_km and uses the calibrated quadkey detour-factor model with CONSTITUTION speed-curve fallback (no provider calls). drive_time with source isochrone_tal needs isochrone_tal_id: a point is covered by a contractor when one of that contractor's isochrone_build polygons contains it (origin_id = contractor id); max_minutes, when given, drops wider time bands. zip_list uses each contractor's service_zip_field."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "tier_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tier Field",
        "default": null,
        "description": "Overrides the contractor layer's tier_field."
      },
      "trade_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Trade Field",
        "default": null,
        "description": "Overrides the contractor layer's trade_field."
      },
      "demand_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Demand Layer",
        "default": null,
        "description": "Point layer of demand (customers, claims, stores, or ZIP centers). Defaults to the only other ingested layer."
      },
      "demand_metric": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Demand Metric",
        "default": null,
        "description": "Numeric demand column (e.g. request count). Defaults to 1 per point; non-numeric cells count as 0 with warning DEMAND_METRIC_MISSING."
      },
      "gap_territory": {
        "type": "boolean",
        "title": "Gap Territory",
        "default": false,
        "description": "Also draw ZIPs whose demand is all uncovered as one territory in a new TAL."
      },
      "capacity_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Capacity Field",
        "default": null,
        "description": "Overrides the contractor layer's capacity_field. Enables capacity_ratio."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "contractor_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Contractor Layer",
        "default": null,
        "description": "Point layer of contractors. Defaults to the only layer ingested with layer_role=contractors; otherwise CLARIFICATION_REQUIRED (needs_contractor_layer)."
      },
      "priority_weights": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": {
              "type": "number"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Priority Weights",
        "default": null,
        "description": "gap_priority weights; defaults demand 0.6, distance 0.4, single_source_factor 0.5. The formula is echoed in result.priority_formula."
      },
      "contractor_filter": {
        "anyOf": [
          {
            "type": "object",
            "minProperties": 1,
            "additionalProperties": {
              "anyOf": [
                {
                  "type": [
                    "string",
                    "number",
                    "boolean"
                  ]
                },
                {
                  "type": "array",
                  "items": {
                    "type": [
                      "string",
                      "number",
                      "boolean"
                    ]
                  },
                  "minItems": 1
                }
              ]
            }
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Column -> value (or list of values), e.g. {\"tier\": \"Preferred\"}. The key tier maps to tier_field when the layer has no literal tier column."
      },
      "service_zip_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Service Zip Field",
        "default": null,
        "description": "Overrides the contractor layer's service_zip_field (required for zip_list)."
      },
      "saturation_threshold": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Saturation Threshold",
        "default": null,
        "description": "Contractor count at which a point is saturated (blue)."
      }
    }
  }

  arguments 257 lines copy
• schedule_visits auth-required never probed

  Schedules recurring visits: expands each cadence (e.g. every 7 days) across a horizon and packs visits into daily buckets under a technician-day cap. Decides which day each visit happens (auto_build and cluster_points divide accounts among people); creates no alignment. Needs point_layer (ingested with cadence declared, else UNDECLARED_FIELD), visit_frequency_field, dwell_time, and daily_capacity ({mode: not_to_exceed, hours: 8}); missing dwell or capacity returns CLARIFICATION_REQUIRED. Omitted max_buckets_per_day means one technician per day; when one does not fit, CLARIFICATION_REQUIRED carries capacity_plan. estimate_only=true returns capacity_plan. contractors (point_layer or list: start, pre_service_stops, route_type, end) anchors buckets; unanchored one-stop days warn SINGLE_STOP_DAYS. frequency_unit: interval_days or visits_per_horizon. bucket_workload_hours (drive plus dwell) is a different measure from territory workload and route_workload_hours. Returns a task. calculate_route on one bucket_id drives that day. Date limits: visit_constraints with horizon_start_date.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780

  {
    "type": "object",
    "$defs": {
      "RepoShape1": {
        "type": "object",
        "required": [
          "point_layer"
        ],
        "properties": {
          "end": {
            "$ref": "#/$defs/RepoShape3"
          },
          "filter": {
            "type": "object",
            "minProperties": 1
          },
          "point_ids": {
            "type": "array",
            "items": {
              "type": [
                "string",
                "integer"
              ]
            },
            "minItems": 1
          },
          "route_type": {
            "enum": [
              "circuit",
              "tour",
              "open_tour"
            ],
            "type": "string",
            "default": "circuit"
          },
          "label_field": {
            "type": "string",
            "minLength": 1
          },
          "point_layer": {
            "type": "string",
            "minLength": 1
          },
          "pre_service_stops": {
            "$ref": "#/$defs/RepoShape2"
          }
        },
        "description": "Expands each matching point in point_layer into one contractor whose start is that point.",
        "additionalProperties": false
      },
      "RepoShape2": {
        "type": "array",
        "items": {
          "$ref": "#/$defs/RepoShape3"
        }
      },
      "RepoShape3": {
        "oneOf": [
          {
            "$ref": "#/$defs/RepoShape6"
          },
          {
            "$ref": "#/$defs/RepoShape4"
          }
        ],
        "description": "Stop location resolved from a point layer in the TS or inline WGS84 coordinates (T-214)."
      },
      "RepoShape4": {
        "type": "object",
        "required": [
          "latitude",
          "longitude"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1
          },
          "name": {
            "type": "string",
            "minLength": 1
          },
          "label": {
            "type": "string",
            "minLength": 1
          },
          "stop_id": {
            "type": "string",
            "minLength": 1
          },
          "latitude": {
            "type": "number",
            "maximum": 90,
            "minimum": -90
          },
          "longitude": {
            "type": "number",
            "maximum": 180,
            "minimum": -180
          },
          "contractor_id": {
            "type": "string",
            "minLength": 1
          },
          "dwell_minutes": {
            "type": "number",
            "minimum": 0
          }
        },
        "additionalProperties": false
      },
      "RepoShape6": {
        "type": "object",
        "required": [
          "point_layer"
        ],
        "properties": {
          "filter": {
            "type": "object",
            "minProperties": 1
          },
          "point_ids": {
            "type": "array",
            "items": {
              "type": [
                "string",
                "integer"
              ]
            },
            "minItems": 1
          },
          "label_field": {
            "type": "string",
            "minLength": 1
          },
          "point_layer": {
            "type": "string",
            "minLength": 1
          },
          "dwell_minutes": {
            "type": "number",
            "minimum": 0
          }
        },
        "additionalProperties": false
      }
    },
    "title": "schedule_visitsArguments",
    "required": [
      "point_layer",
      "visit_frequency_field"
    ],
    "properties": {
      "tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Id",
        "default": null,
        "description": "Optional TAL id when filtering scheduled accounts by territory_id or territory_ids."
      },
      "horizon": {
        "anyOf": [
          {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "mode"
                ],
                "properties": {
                  "mode": {
                    "const": "derived"
                  }
                },
                "additionalProperties": false
              },
              {
                "type": "object",
                "required": [
                  "mode",
                  "days"
                ],
                "properties": {
                  "days": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "mode": {
                    "const": "explicit"
                  }
                },
                "additionalProperties": false
              }
            ]
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Planning horizon. derived takes the longest interval among scheduled accounts; explicit is how a 28- or 42-day rolling cycle is requested when intervals leave a remainder on a shorter horizon."
      },
      "objective": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "balance_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              "compactness_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              }
            },
            "additionalProperties": false
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Biases must sum to 100. Raising balance_bias to 100 lengthens otherwise efficient days to equalize hours, which is rarely what the customer wants."
      },
      "point_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Point Ids",
        "default": null,
        "description": "Optional list of account/point IDs to schedule."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "dwell_time": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "enum": [
                  "scalar",
                  "field"
                ],
                "type": "string",
                "description": "Dwell source: 'scalar' for a fixed per-visit duration or 'field' for an ingested point column."
              },
              "unit": {
                "enum": [
                  "minutes",
                  "hours"
                ],
                "type": "string",
                "default": "minutes",
                "description": "Time unit for value or field ('minutes' or 'hours')."
              },
              "field": {
                "type": "string",
                "minLength": 1,
                "description": "Point column name holding per-account onsite time when type='field'."
              },
              "value": {
                "type": "number",
                "minimum": 0,
                "description": "Confirmed onsite duration per visit when type='scalar'."
              }
            },
            "description": "Onsite (dwell) time per visit: {type: 'scalar', value: <number>, unit: 'minutes'|'hours'} or {type: 'field', field: '<column>', unit: 'minutes'|'hours'}.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Dwell Time",
        "default": null
      },
      "contractors": {
        "anyOf": [
          {
            "oneOf": [
              {
                "$ref": "#/$defs/RepoShape1"
              },
              {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "$ref": "#/$defs/RepoShape1"
                    },
                    {
                      "type": "object",
                      "required": [
                        "start"
                      ],
                      "properties": {
                        "end": {
                          "$ref": "#/$defs/RepoShape3"
                        },
                        "label": {
                          "type": "string",
                          "minLength": 1
                        },
                        "start": {
                          "$ref": "#/$defs/RepoShape3"
                        },
                        "route_type": {
                          "enum": [
                            "circuit",
                            "tour",
                            "open_tour"
                          ],
                          "type": "string",
                          "default": "circuit"
                        },
                        "contractor_id": {
                          "type": "string",
                          "minLength": 1
                        },
                        "pre_service_stops": {
                          "$ref": "#/$defs/RepoShape2"
                        }
                      },
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "required": [
                        "latitude",
                        "longitude"
                      ],
                      "properties": {
                        "end": {
                          "$ref": "#/$defs/RepoShape3"
                        },
                        "label": {
                          "type": "string",
                          "minLength": 1
                        },
                        "latitude": {
                          "type": "number",
                          "maximum": 90,
                          "minimum": -90
                        },
                        "longitude": {
                          "type": "number",
                          "maximum": 180,
                          "minimum": -180
                        },
                        "route_type": {
                          "enum": [
                            "circuit",
                            "tour",
                            "open_tour"
                          ],
                          "type": "string",
                          "default": "circuit"
                        },
                        "contractor_id": {
                          "type": "string",
                          "minLength": 1
                        },
                        "pre_service_stops": {
                          "$ref": "#/$defs/RepoShape2"
                        }
                      },
                      "additionalProperties": false
                    }
                  ]
                },
                "minItems": 1
              }
            ]
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Optional contractor anchoring (T-214). Takes a point-layer source (e.g. {point_layer: 'contractors'}) or a list of contractor entries with start, optional pre_service_stops (e.g. a depot with dwell_minutes), route_type (circuit|tour|open_tour), and optional end."
      },
      "point_layer": {
        "type": "string",
        "title": "Point Layer"
      },
      "point_filter": {
        "anyOf": [
          {
            "type": "object",
            "minProperties": 1,
            "additionalProperties": {
              "anyOf": [
                {
                  "type": [
                    "string",
                    "number",
                    "boolean"
                  ]
                },
                {
                  "type": "array",
                  "items": {
                    "type": [
                      "string",
                      "number",
                      "boolean"
                    ]
                  },
                  "minItems": 1
                }
              ]
            }
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Optional attribute filter (property -> value or list of values) to schedule a subset of point_layer."
      },
      "territory_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Territory Id",
        "default": null,
        "description": "Optional leaf territory id or unique display label to schedule only accounts inside that territory polygon."
      },
      "estimate_only": {
        "type": "boolean",
        "title": "Estimate Only",
        "default": false,
        "description": "When true, runs a fast capacity-planning preflight without mutating the Territory Solution or emitting a visits layer, returning capacity_plan (open_service_days, closed_days, required_daily_hours_avg, peak_day_floor_hours, min_resources_per_day, recommended_resources_per_day, and remedies)."
      },
      "territory_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Territory Ids",
        "default": null,
        "description": "Optional list of leaf territory ids or display labels to schedule only accounts inside those territory polygons."
      },
      "daily_capacity": {
        "anyOf": [
          {
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "mode",
                  "hours"
                ],
                "properties": {
                  "mode": {
                    "const": "not_to_exceed"
                  },
                  "hours": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  }
                },
                "additionalProperties": false
              },
              {
                "type": "object",
                "required": [
                  "mode",
                  "hours"
                ],
                "properties": {
                  "mode": {
                    "const": "target_band"
                  },
                  "hours": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  },
                  "tolerance_pct": {
                    "type": "number",
                    "default": 10,
                    "maximum": 100,
                    "minimum": 0
                  }
                },
                "additionalProperties": false
              }
            ]
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Workload limit for one bucket (one technician-day). not_to_exceed is a hard ceiling the scheduler never breaches; target_band aims for the target and accepts anything inside the tolerance."
      },
      "frequency_unit": {
        "type": "string",
        "title": "Frequency Unit",
        "default": "interval_days",
        "description": "interval_days: the value is the maximum days between visits. visits_per_horizon: the value is how many visits the account gets across the whole horizon."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "schedule_label": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Schedule Label",
        "default": null
      },
      "emit_visit_layer": {
        "type": "boolean",
        "title": "Emit Visit Layer",
        "default": true,
        "description": "Materialize one point per scheduled visit so color-by-day and the calculate_route handoff are single calls."
      },
      "visit_layer_name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Visit Layer Name",
        "default": null,
        "description": "Defaults to <point_layer>_visits. This name is the schedule's identity: re-running with the same name replaces the layer in place, a different name adds a second schedule for comparison."
      },
      "expected_revision": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Revision",
        "default": null
      },
      "visit_constraints": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "kind"
              ],
              "properties": {
                "date": {
                  "type": "string",
                  "format": "date"
                },
                "kind": {
                  "enum": [
                    "blackout",
                    "no_service_window",
                    "fixed",
                    "due",
                    "anchor",
                    "allowed_weekdays"
                  ],
                  "type": "string"
                },
                "dates": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "format": "date"
                  }
                },
                "reason": {
                  "type": "string"
                },
                "source": {
                  "type": "string"
                },
                "weekday": {
                  "enum": [
                    "mon",
                    "tue",
                    "wed",
                    "thu",
                    "fri",
                    "sat",
                    "sun"
                  ],
                  "type": "string"
                },
                "end_date": {
                  "type": "string",
                  "format": "date"
                },
                "hardness": {
                  "enum": [
                    "hard",
                    "penalized"
                  ],
                  "type": "string"
                },
                "weekdays": {
                  "type": "array",
                  "items": {
                    "enum": [
                      "mon",
                      "tue",
                      "wed",
                      "thu",
                      "fri",
                      "sat",
                      "sun"
                    ],
                    "type": "string"
                  },
                  "minItems": 1
                },
                "account_id": {
                  "type": "string",
                  "minLength": 1
                },
                "recurrence": {
                  "enum": [
                    "none",
                    "annual",
                    "weekly"
                  ],
                  "type": "string",
                  "default": "none"
                },
                "start_date": {
                  "type": "string",
                  "format": "date"
                },
                "account_ids": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  },
                  "minItems": 1
                },
                "earliest_date": {
                  "type": "string",
                  "format": "date"
                }
              },
              "description": "One date constraint for an account, account_ids, or all accounts ('*'), resolved against horizon_start_date (T-213). blackout/no_service_window: forbidden dates (date, dates, a range, annual or weekly recurrence), always hard. fixed: a hard appointment that consumes a cadence visit. due: a deadline (optional earliest_date); hardness penalized (reported in constraint_summary.sla_violations) or hard. anchor: a date or weekday fixing the pattern phase. allowed_weekdays: visits land on those weekdays.",
              "additionalProperties": false
            }
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Separate account-keyed date-constraint dataset: blackouts/no-service windows, fixed dates, SLA due dates, anchor days, allowed weekdays. See visitConstraint."
      },
      "horizon_start_date": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Horizon Start Date",
        "default": null,
        "description": "Calendar date of horizon day 1. Required when visit_constraints is non-empty; without it dated constraints return CLARIFICATION_REQUIRED (needs_horizon_start_date). There is no default of today."
      },
      "never_visit_values": {
        "anyOf": [
          {
            "type": "array",
            "items": {}
          },
          {
            "type": "null"
          }
        ],
        "title": "Never Visit Values",
        "default": null,
        "description": "Frequency values that mean the account is left off the schedule. Matching accounts are excluded and reported in excluded_accounts, never silently dropped."
      },
      "max_buckets_per_day": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Max Buckets Per Day",
        "default": null,
        "description": "Cap on concurrent buckets in one day, normally the technician/contractor count (cannot exceed len(contractors) when contractors are supplied). Omitted with no contractors: one bucket per day; when that does not fit, CLARIFICATION_REQUIRED (blocked_by needs_technician_count) returns capacity_plan and asks how many technicians."
      },
      "visit_frequency_field": {
        "type": "string",
        "title": "Visit Frequency Field",
        "description": "Numeric point column declared at ingest. Undeclared columns fail with UNDECLARED_FIELD."
      },
      "cadence_flexibility_pct": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Cadence Flexibility Pct",
        "default": null,
        "description": "Percent of an account's own cadence a single visit may drift so the number of work clusters stays comparable day to day. At the default 15 a 14-day account may slide two days and a 7-day account one; a 3-day account does not move. Set to 0 for strict cadence. A drift past this tolerance happens only to staff a day that would otherwise be short of work — an idle technician costs more than a visit arriving a day early — and every relaxed visit is reported in distribution_summary.cadence_relaxation and the visits layer's cadence_drift_days column."
      }
    }
  }

  arguments 780 lines copy
• realign auth-required never probed

  Moves ZIPs or other parts (typed ids or ones selected on the map) from one territory into another within one alignment (tal_id): a ZIP move. moves=[{part_id, to_territory_id}], or realign_operation with part_ids. The Territory Solution comes from map_session_id (the open map) or ts_handle; expected_revision adds optimistic concurrency (STALE_TS_REVISION when the map changed). to_territory_id is a leaf territory_id or that leaf's exact, unique display name; an unknown or ambiguous value returns UNKNOWN_TERRITORY_ID or AMBIGUOUS_TERRITORY with available_leaf_territories. A committed map selection is read with get_map_selection; request_part_selection lets the person pick parts on the map. remove_empty_territories drops leaves left with no parts. Returns a task; the open map repaints. analyze refreshes statistics when the map has account points.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147

  {
    "type": "object",
    "title": "realignArguments",
    "required": [
      "tal_id"
    ],
    "properties": {
      "moves": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "title": "Directed Part-Move Operation",
              "required": [
                "part_id",
                "to_territory_id"
              ],
              "properties": {
                "part_id": {
                  "type": "string",
                  "minLength": 1
                },
                "to_territory_id": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Target leaf territory ID within the specified tal_id. Unassigned parts may be assigned directly when no from_territory_id is supplied."
                },
                "from_territory_id": {
                  "type": "string",
                  "description": "Optional — provided for optimistic validation. If supplied and the part is not currently in this territory, the operation fails with UNKNOWN_SOURCE_TERRITORY."
                }
              },
              "additionalProperties": false
            },
            "minItems": 1
          },
          {
            "type": "null"
          }
        ],
        "default": null
      },
      "tal_id": {
        "type": "string",
        "title": "Tal Id",
        "description": "Target TAL to realign. Required — ambiguous TAL is an error."
      },
      "part_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Ids",
        "default": null,
        "description": "Required for remove_parts operation."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "part_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Layer",
        "default": null,
        "description": "Part layer name, e.g. us_zips, us_counties. Required when not inferable from the TAL."
      },
      "repair_policy": {
        "enum": [
          "default",
          "strict",
          "report_only"
        ],
        "type": "string",
        "title": "Repair Policy",
        "default": "default",
        "description": "Topology repair for dissolved territories. default fills interior holes in the dissolved geometry (no part is added or reassigned; repair_summary.changed_part_ids lists the territories' own parts). report_only detects holes and changes nothing (warning REPAIR_AVAILABLE). strict fails with REPAIR_REQUIRED when a hole is found."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "expected_revision": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Revision",
        "default": null
      },
      "realign_operation": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Realign Operation",
        "default": null,
        "description": "Realignment operation. Defaults to move_to_territory when moves[] is supplied."
      },
      "remove_empty_territories": {
        "type": "boolean",
        "title": "Remove Empty Territories",
        "default": false,
        "description": "When true with remove_parts, drop leaf territories that become empty."
      }
    }
  }

  arguments 147 lines copy
• delete_tal changes data auth-required never probed

  Deletes one whole territory alignment (TAL: 'the territory layer', 'all territories') from the Territory Solution and the open map, in one synchronous call. Needs tal_id or the TAL's exact unique label, plus map_session_id or ts_handle. Points, part-layer overlays, and routes stay; the map switches to a remaining alignment or to points only. A TAL that is already gone returns ok with already_absent=true; an ambiguous label returns AMBIGUOUS_TAL. One territory is removed with delete_territory instead.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940

  {
    "type": "object",
    "title": "delete_talArguments",
    "required": [
      "tal_id"
    ],
    "properties": {
      "tal_id": {
        "type": "string",
        "title": "Tal Id",
        "description": "Territory layer / alignment to delete: tal_id or an exact unique TAL label. Removes the whole layer in one call (users say territory layer / all territories / alignment more often than TAL). One leaf is removed with delete_territory."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      }
    }
  }

  arguments 40 lines copy
• delete_territory changes data auth-required never probed

  Deletes one leaf territory from an alignment; its parts become unassigned. Needs tal_id, territory_id (the leaf id or its exact unique display name), and the Territory Solution from map_session_id or ts_handle. A territory that is already gone returns ok with already_absent=true and no task; otherwise returns a task and the open map repaints. Related: territory_merge hands a leaving rep's territory to its neighbors; delete_tal removes a whole alignment in one call.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283

  {
    "type": "object",
    "title": "delete_territoryArguments",
    "required": [
      "tal_id",
      "territory_id"
    ],
    "properties": {
      "tal_id": {
        "type": "string",
        "title": "Tal Id",
        "description": "Target TAL containing the leaf to delete."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "part_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Layer",
        "default": null,
        "description": "Part layer name when not inferable from the TAL (e.g. us_zips)."
      },
      "territory_id": {
        "type": "string",
        "title": "Territory Id",
        "description": "Leaf territory_id (e.g. tal-t1-t1) or a unique display name/label alias (e.g. T1)."
      },
      "repair_policy": {
        "enum": [
          "default",
          "strict",
          "report_only"
        ],
        "type": "string",
        "title": "Repair Policy",
        "default": "default",
        "description": "Topology repair for dissolved territories. default fills interior holes in the dissolved geometry (no part is added or reassigned; repair_summary.changed_part_ids lists the territories' own parts). report_only detects holes and changes nothing (warning REPAIR_AVAILABLE). strict fails with REPAIR_REQUIRED when a hole is found."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "expected_revision": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Revision",
        "default": null,
        "description": "Optional optimistic concurrency revision."
      }
    }
  }

  arguments 83 lines copy
• territory_split auth-required never probed

  Territory split: divides one territory (e.g. an oversized one) into two while changing the rest of the alignment as little as possible (N to N+1 territories). Needs source_tal_id and target_territory_id, plus the Territory Solution from map_session_id (the open map) or ts_handle. Workload balance needs dwell_time; a missing id or dwell returns CLARIFICATION_REQUIRED with the question. Writes a new derived alignment; the source stays. Returns a task; the result carries disruption_summary (retention_pct).

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244

  {
    "type": "object",
    "title": "territory_splitArguments",
    "properties": {
      "objective": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "metric": {
                "type": "string",
                "description": "Point metric column name to balance (e.g. 'Revenue', 'Score'). Required when metric_bias > 0. Account count is count_bias, not a column."
              },
              "count_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on account count (locations per territory). Default 0."
              },
              "metric_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on the metric column."
              },
              "workload_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on workload (drive time + dwell)."
              }
            },
            "description": "Balance objective: workload_bias + metric_bias + count_bias = 100, weighting workload (drive + dwell), one metric column, and account count. Workload: {workload_bias: 100}. Metric: {metric: '<column>', workload_bias: 0, metric_bias: 100}. Count: {workload_bias: 0, count_bias: 100}. Three-way: {metric: 'Score', workload_bias: 40, metric_bias: 40, count_bias: 20}. Only one metric column balances; combine several into one score column at ingest. Omitted on restructure tools: inherits the source TAL build_provenance objective.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Objective",
        "default": null
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "dwell_time": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "enum": [
                  "scalar",
                  "field"
                ],
                "type": "string",
                "description": "Dwell source: 'scalar' for a fixed per-visit duration or 'field' for an ingested point column."
              },
              "unit": {
                "enum": [
                  "minutes",
                  "hours"
                ],
                "type": "string",
                "default": "minutes",
                "description": "Time unit for value or field ('minutes' or 'hours')."
              },
              "field": {
                "type": "string",
                "minLength": 1,
                "description": "Point column name holding per-account onsite time when type='field'."
              },
              "value": {
                "type": "number",
                "minimum": 0,
                "description": "Confirmed onsite duration per visit when type='scalar'."
              }
            },
            "description": "Onsite (dwell) time per visit: {type: 'scalar', value: <number>, unit: 'minutes'|'hours'} or {type: 'field', field: '<column>', unit: 'minutes'|'hours'}.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Dwell Time",
        "default": null
      },
      "part_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Layer",
        "default": null,
        "description": "Part layer (e.g. us_zips). Required only when not inferable from the source TAL."
      },
      "point_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Point Layer",
        "default": null,
        "description": "Optional point layer used to compute per-part workload/metric measures. When omitted, a uniform geography-only weighting is used."
      },
      "new_tal_label": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "New Tal Label",
        "default": null,
        "description": "Label for the derived TAL. Defaults to '<source label> (<operation>)'."
      },
      "repair_policy": {
        "enum": [
          "default",
          "strict",
          "report_only"
        ],
        "type": "string",
        "title": "Repair Policy",
        "default": "default",
        "description": "Topology repair for dissolved territories. default fills interior holes in the dissolved geometry (no part is added or reassigned; repair_summary.changed_part_ids lists the territories' own parts). report_only detects holes and changes nothing (warning REPAIR_AVAILABLE). strict fails with REPAIR_REQUIRED when a hole is found."
      },
      "source_tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Source Tal Id",
        "default": null,
        "description": "Source TAL. Optional for form-capable clients that can answer via elicitation."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "balance_tolerance": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Balance Tolerance",
        "default": null,
        "description": "Accepted for compatibility. The power-diagram rebalance converges on its own internal tolerance, so this value no longer gates per-part moves."
      },
      "disruption_weight": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Disruption Weight",
        "default": null,
        "description": "Incumbency stickiness for the warm-started power-diagram rebalance. 0 is a pure power re-solve (max balance, more churn); higher values keep more of the source alignment by requiring a neighbor territory to inflate further before it can claim a border part."
      },
      "new_territory_label": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "New Territory Label",
        "default": null,
        "description": "Label for the second territory created by the split. Defaults to '<target> (split)'."
      },
      "target_territory_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Target Territory Id",
        "default": null,
        "description": "Leaf territory (id or label) to split into two. Optional when elicitation can fill it."
      },
      "visit_frequency_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Visit Frequency Field",
        "default": null,
        "description": "Numeric visits-per-cycle column on the point layer. When omitted, inherits from source TAL build_provenance or point-layer metadata."
      }
    }
  }

  arguments 244 lines copy
• territory_rebalance changes data auth-required never probed

  Rebalances an existing alignment after the account data changed, keeping it as close to the current alignment as possible. Needs source_tal_id and the Territory Solution from map_session_id or ts_handle. point_layer defaults to the alignment's build layer or the only point layer; otherwise CLARIFICATION_REQUIRED (ambiguous_point_layer, with details.point_layers). Workload balance needs dwell_time; zero_workload means no account maps to a part. The current alignment is the baseline: when nothing improves the objective the result is NO_IMPROVING_REBALANCE_FOUND and nothing changes. Writes a new derived alignment. Returns a task with retention_pct and solver_diagnostics.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218

  {
    "type": "object",
    "title": "territory_rebalanceArguments",
    "properties": {
      "objective": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "metric": {
                "type": "string",
                "description": "Point metric column name to balance (e.g. 'Revenue', 'Score'). Required when metric_bias > 0. Account count is count_bias, not a column."
              },
              "count_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on account count (locations per territory). Default 0."
              },
              "metric_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on the metric column."
              },
              "workload_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on workload (drive time + dwell)."
              }
            },
            "description": "Balance objective: workload_bias + metric_bias + count_bias = 100, weighting workload (drive + dwell), one metric column, and account count. Workload: {workload_bias: 100}. Metric: {metric: '<column>', workload_bias: 0, metric_bias: 100}. Count: {workload_bias: 0, count_bias: 100}. Three-way: {metric: 'Score', workload_bias: 40, metric_bias: 40, count_bias: 20}. Only one metric column balances; combine several into one score column at ingest. Omitted on restructure tools: inherits the source TAL build_provenance objective.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Objective",
        "default": null
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "dwell_time": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "enum": [
                  "scalar",
                  "field"
                ],
                "type": "string",
                "description": "Dwell source: 'scalar' for a fixed per-visit duration or 'field' for an ingested point column."
              },
              "unit": {
                "enum": [
                  "minutes",
                  "hours"
                ],
                "type": "string",
                "default": "minutes",
                "description": "Time unit for value or field ('minutes' or 'hours')."
              },
              "field": {
                "type": "string",
                "minLength": 1,
                "description": "Point column name holding per-account onsite time when type='field'."
              },
              "value": {
                "type": "number",
                "minimum": 0,
                "description": "Confirmed onsite duration per visit when type='scalar'."
              }
            },
            "description": "Onsite (dwell) time per visit: {type: 'scalar', value: <number>, unit: 'minutes'|'hours'} or {type: 'field', field: '<column>', unit: 'minutes'|'hours'}.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Dwell Time",
        "default": null
      },
      "part_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Layer",
        "default": null,
        "description": "Part layer (e.g. us_zips). Required only when not inferable from the source TAL."
      },
      "point_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Point Layer",
        "default": null,
        "description": "Optional point layer used to compute per-part workload/metric measures. When omitted, a uniform geography-only weighting is used."
      },
      "new_tal_label": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "New Tal Label",
        "default": null,
        "description": "Label for the derived TAL. Defaults to '<source label> (<operation>)'."
      },
      "repair_policy": {
        "enum": [
          "default",
          "strict",
          "report_only"
        ],
        "type": "string",
        "title": "Repair Policy",
        "default": "default",
        "description": "Topology repair for dissolved territories. default fills interior holes in the dissolved geometry (no part is added or reassigned; repair_summary.changed_part_ids lists the territories' own parts). report_only detects holes and changes nothing (warning REPAIR_AVAILABLE). strict fails with REPAIR_REQUIRED when a hole is found."
      },
      "source_tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Source Tal Id",
        "default": null,
        "description": "Source TAL. Optional for form-capable clients that can answer via elicitation."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "balance_tolerance": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Balance Tolerance",
        "default": null,
        "description": "Accepted for compatibility. The power-diagram rebalance converges on its own internal tolerance, so this value no longer gates per-part moves."
      },
      "disruption_weight": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Disruption Weight",
        "default": null,
        "description": "Incumbency stickiness for the warm-started power-diagram rebalance. 0 is a pure power re-solve (max balance, more churn); higher values keep more of the source alignment by requiring a neighbor territory to inflate further before it can claim a border part."
      },
      "visit_frequency_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Visit Frequency Field",
        "default": null,
        "description": "Numeric visits-per-cycle column on the point layer. When omitted, inherits from source TAL build_provenance or point-layer metadata."
      }
    }
  }

  arguments 218 lines copy
• reintegrate_branch changes data auth-required never probed

  Merges an edited branch (proposal Territory Solution from extract_tal_branch) back into the master. Needs branch_metadata and expected_master_revision; returns STALE_TS_REVISION when the master changed since the extract, in which case a fresh extract is needed. Merges apply one at a time.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180

  {
    "type": "object",
    "title": "reintegrate_branchArguments",
    "required": [
      "expected_master_revision",
      "branch_metadata"
    ],
    "properties": {
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "branch_metadata": {
        "type": "object",
        "anyOf": [
          {
            "required": [
              "branch_part_ids"
            ]
          },
          {
            "required": [
              "branch_part_ids_sha256",
              "branch_part_ids_count"
            ]
          }
        ],
        "oneOf": [
          {
            "required": [
              "branch_rollup_territory_id"
            ]
          },
          {
            "required": [
              "branch_territory_path"
            ]
          }
        ],
        "title": "Branch Extract Metadata",
        "required": [
          "master_ts_id",
          "master_revision",
          "tal_id",
          "extract_ts_id",
          "extract_revision",
          "parent_ts_id",
          "extracted_at",
          "point_layer_scope"
        ],
        "properties": {
          "tal_id": {
            "type": "string",
            "minLength": 1
          },
          "delegate_ref": {
            "type": "string"
          },
          "extracted_at": {
            "type": "string",
            "format": "date-time"
          },
          "master_ts_id": {
            "type": "string",
            "minLength": 1
          },
          "parent_ts_id": {
            "type": "string",
            "minLength": 1
          },
          "extract_ts_id": {
            "type": "string",
            "minLength": 1
          },
          "branch_part_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 1
          },
          "locked_part_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "master_revision": {
            "type": "integer",
            "minimum": 0
          },
          "extract_revision": {
            "type": "integer",
            "minimum": 0
          },
          "point_layer_scope": {
            "type": "string",
            "const": "branch_parts_only"
          },
          "master_content_hash": {
            "type": "string",
            "pattern": "^sha256:[A-Fa-f0-9]{64}$"
          },
          "branch_part_ids_count": {
            "type": "integer",
            "minimum": 1
          },
          "branch_territory_path": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "maxItems": 5,
            "minItems": 1
          },
          "branch_part_ids_sha256": {
            "type": "string",
            "pattern": "^sha256:[A-Fa-f0-9]{64}$"
          },
          "branch_rollup_territory_id": {
            "type": "string",
            "minLength": 1
          }
        },
        "additionalProperties": false
      },
      "master_ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Master Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "proposal_ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Proposal Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "expected_master_revision": {
        "type": "integer",
        "title": "Expected Master Revision"
      },
      "expected_master_content_hash": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Master Content Hash",
        "default": null
      }
    }
  }

  arguments 180 lines copy
• request_part_selection auth-required never probed

  Lets the person adjust boundaries by picking parts (e.g. ZIPs) on the map: puts the open map into select mode on a part_layer, for purpose realign, a new territory, or a plain list. Returns selection_task_id; get_part_selection reports status (awaiting_user_selection, then committed, expired, or cancelled) and the committed part_ids, and its response carries recommended_poll_delay_ms. The commit happens on the map, not in chat. destination_territory_id and realign_operation pre-set a realign. Works on the in-chat map and the map_url tab. map_session_id selects on the open map; ts_handle opens a stored Territory Solution first. initial_part_filter opens with a set pre-selected (e.g. in_tal or white space not_in_tal) for the person to trim; build from the committed set with part_filter {selection_task_id}. A selection the person started from the map legend is read with get_map_selection.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359

  {
    "type": "object",
    "title": "request_part_selectionArguments",
    "required": [
      "part_layer"
    ],
    "properties": {
      "prompt": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Prompt",
        "default": null,
        "description": "Human-facing selection instruction shown by the host/agent or MC."
      },
      "purpose": {
        "type": "string",
        "title": "Purpose",
        "default": "generic"
      },
      "user_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "User Id",
        "default": null,
        "description": "Stable caller id; finds the open map when map_session_id is omitted."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "part_layer": {
        "type": "string",
        "title": "Part Layer"
      },
      "active_tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Active Tal Id",
        "default": null,
        "description": "Alignment shown as active while the person selects."
      },
      "new_territory": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "territory_label"
            ],
            "properties": {
              "territory_id": {
                "type": "string"
              },
              "territory_path": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                },
                "maxItems": 5
              },
              "territory_label": {
                "type": "string",
                "minLength": 1
              }
            },
            "additionalProperties": false
          },
          {
            "type": "null"
          }
        ],
        "default": null
      },
      "expiry_seconds": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expiry Seconds",
        "default": null
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "realign_operation": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Realign Operation",
        "default": null
      },
      "initial_part_filter": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "text": {
                "type": "object",
                "required": [
                  "value"
                ],
                "properties": {
                  "mode": {
                    "enum": [
                      "prefix",
                      "contains",
                      "exact"
                    ],
                    "type": "string",
                    "default": "prefix"
                  },
                  "field": {
                    "type": "string",
                    "description": "Safe text field to search. Defaults to the public part ID column."
                  },
                  "value": {
                    "type": "string",
                    "minLength": 1
                  },
                  "case_sensitive": {
                    "type": "boolean",
                    "default": false
                  }
                },
                "additionalProperties": false
              },
              "in_tal": {
                "type": "object",
                "required": [
                  "tal_id"
                ],
                "properties": {
                  "tal_id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "ts_handle": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: Territory Solution reference (tsh_...) holding the TAL."
                  },
                  "territory_ids": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1
                    },
                    "minItems": 1,
                    "description": "Narrow to these territory_id values (not display labels); a rollup includes every leaf below it. Unknown ids return UNKNOWN_TERRITORY_ID with available_territory_ids."
                  },
                  "map_session_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: open map session whose Territory Solution holds the TAL."
                  }
                },
                "description": "Keep only the parts assigned to a leaf territory of tal_id: the TAL's whole footprint, however many separate regions it has. ANDed with the other predicates (alone it is exactly that footprint). The TAL must use the same part_layer and hold parts. query_parts needs ts_handle or map_session_id here; builds read the TAL from the build's own Territory Solution.",
                "additionalProperties": false
              },
              "spatial": {
                "type": "object",
                "oneOf": [
                  {
                    "required": [
                      "bbox"
                    ]
                  },
                  {
                    "required": [
                      "geometry"
                    ]
                  }
                ],
                "required": [
                  "operator"
                ],
                "properties": {
                  "bbox": {
                    "type": "array",
                    "items": {
                      "type": "number"
                    },
                    "maxItems": 4,
                    "minItems": 4,
                    "description": "[min_lon, min_lat, max_lon, max_lat] in EPSG:4326."
                  },
                  "geometry": {
                    "type": "object",
                    "description": "GeoJSON Polygon or MultiPolygon in EPSG:4326."
                  },
                  "operator": {
                    "enum": [
                      "intersects",
                      "within",
                      "contains"
                    ],
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "not_in_tal": {
                "type": "object",
                "required": [
                  "tal_id"
                ],
                "properties": {
                  "tal_id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "ts_handle": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: Territory Solution reference (tsh_...) holding the TAL."
                  },
                  "map_session_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: open map session whose Territory Solution holds the TAL."
                  }
                },
                "description": "White space: drop every part assigned to a leaf territory of tal_id from whatever the other predicates select (the whole layer when alone). The TAL must use the same part_layer. query_parts needs ts_handle or map_session_id here; builds read the TAL from the build's own Territory Solution.",
                "additionalProperties": false
              },
              "part_layer": {
                "type": "string"
              },
              "population": {
                "oneOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "eq": {
                        "type": "number"
                      },
                      "gt": {
                        "type": "number"
                      },
                      "lt": {
                        "type": "number"
                      },
                      "gte": {
                        "type": "number"
                      },
                      "lte": {
                        "type": "number"
                      },
                      "between": {
                        "type": "array",
                        "items": {
                          "type": "number"
                        },
                        "maxItems": 2,
                        "minItems": 2
                      }
                    },
                    "minProperties": 1,
                    "additionalProperties": false
                  }
                ]
              },
              "state_abbr": {
                "type": [
                  "string",
                  "array"
                ]
              },
              "county_name": {
                "type": [
                  "string",
                  "array"
                ]
              },
              "selection_task_id": {
                "type": "string",
                "minLength": 1,
                "description": "Builds only (auto_build, account_build, seed_build): a committed request_part_selection task (psel_...) whose part_ids become the scope; it is the only key in that part_filter."
              }
            },
            "minProperties": 1,
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Pre-selects the parts this filter matches (same shape as auto_build part_filter, e.g. {in_tal: {tal_id}} or {state_abbr: TX, not_in_tal: {tal_id}}). Resolved server-side, up to 50,000 parts; selection_task_id is rejected here."
      },
      "destination_territory_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Destination Territory Id",
        "default": null,
        "description": "Optional receiver leaf territory when Monica/agent named the destination up front."
      },
      "remove_empty_territories": {
        "type": "boolean",
        "title": "Remove Empty Territories",
        "default": false
      }
    }
  }

  arguments 359 lines copy
• get_part_selection auth-required 24d ago

  Returns the state of a map selection task (selection_task_id from request_part_selection, or active_selection_task_id in ezt://map-sessions/{id}/state): status awaiting_user_selection, committed, expired, or cancelled, and once committed the selected part_ids (with assigned and unassigned part_ids when a TAL is active). While awaiting, the response carries recommended_poll_delay_ms. Committed part_ids feed realign, create_territory_from_parts, or analyze.

  mcp-tool

  1234567891011121314

  {
    "type": "object",
    "title": "get_part_selectionArguments",
    "required": [
      "selection_task_id"
    ],
    "properties": {
      "selection_task_id": {
        "type": "string",
        "title": "Selection Task Id",
        "description": "selection_task_id (psel_...) from request_part_selection."
      }
    }
  }

  arguments 14 lines copy
• create_territory_from_parts changes data auth-required never probed

  Creates one leaf territory from a list of part_ids (e.g. a committed map selection), in a new alignment or an existing one (tal_id). With map_session_id the live map's Territory Solution is updated and repainted; otherwise ts_handle (a new ts_handle is returned). map_session_id wins when both are passed. territory_name is a display label; the result's created_territory.territory_id is the stable id for later edits, plus leaf_territories and selection_summary (duplicate_part_ids). Dwell is optional here and is not inherited from an earlier auto_build; dwell_time is recorded for later analyze. Without it, analyze reports every statistic except workload and returns workload_omitted.ask_user. Returns a task.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152

  {
    "type": "object",
    "title": "create_territory_from_partsArguments",
    "required": [
      "part_layer",
      "part_ids",
      "territory_name"
    ],
    "properties": {
      "tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Id",
        "default": null,
        "description": "Existing TAL to append the new territory to; omit to start a new alignment."
      },
      "part_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "title": "Part Ids",
        "description": "Parts for the new territory, e.g. committed part_ids from get_part_selection."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "dwell_time": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "enum": [
                  "scalar",
                  "field"
                ],
                "type": "string",
                "description": "Dwell source: 'scalar' for a fixed per-visit duration or 'field' for an ingested point column."
              },
              "unit": {
                "enum": [
                  "minutes",
                  "hours"
                ],
                "type": "string",
                "default": "minutes",
                "description": "Time unit for value or field ('minutes' or 'hours')."
              },
              "field": {
                "type": "string",
                "minLength": 1,
                "description": "Point column name holding per-account onsite time when type='field'."
              },
              "value": {
                "type": "number",
                "minimum": 0,
                "description": "Confirmed onsite duration per visit when type='scalar'."
              }
            },
            "description": "Onsite (dwell) time per visit: {type: 'scalar', value: <number>, unit: 'minutes'|'hours'} or {type: 'field', field: '<column>', unit: 'minutes'|'hours'}.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Dwell Time",
        "default": null
      },
      "part_layer": {
        "type": "string",
        "title": "Part Layer"
      },
      "repair_policy": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Repair Policy",
        "default": null,
        "description": "Topology repair policy for dissolved geometry (default, strict, or report_only). Interior holes occupied by existing territories in the TS are never filled."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "territory_name": {
        "type": "string",
        "title": "Territory Name"
      },
      "territory_path": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Territory Path",
        "default": null
      },
      "conflict_policy": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Conflict Policy",
        "default": null
      }
    }
  }

  arguments 152 lines copy
• request_account_upload changes data auth-required never probed

  The one way account or address rows enter the server: stages them for ingest_accounts (accounts_handle) or geocode_address (upload_handle) and returns upload_handle, csv_headers, and suggested_ingest args with a geocode_plan. Ways in: the returned upload_url (no API key; valid up to 1 hour), which the user opens in a browser to drop a CSV or .xlsx (result.share_with_user; the path for a file the client cannot read, e.g. a SharePoint link) or a shell POSTs to (curl_example); csv_file (a host file parameter); csv_text (raw CSV, up to 25 MB per call); or rows chunks appended with upload_handle. A call with only upload_handle polls: upload_status waiting_for_file (sleep recommended_poll_delay_ms) or received, with preview (sample rows, column profile) and upload_warnings whose ask_user goes to the user before ingest. A local path in csv_file returns UNREADABLE_FILE_REFERENCE; an expired URL returns UPLOAD_TOKEN_EXPIRED and a call with upload_handle issues a new one. One handle holds at most 100,000 rows and is single-use, claimed by ingest_accounts, for 1 hour.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394

  {
    "type": "object",
    "title": "request_account_uploadArguments",
    "properties": {
      "rows": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Rows",
        "default": null
      },
      "csv_file": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "string",
                "description": "RFC 2397 data: URI."
              },
              "file_id": {
                "type": "string"
              },
              "file_name": {
                "type": "string"
              },
              "mime_type": {
                "type": "string"
              },
              "download_url": {
                "type": "string",
                "description": "Temporary HTTPS download URL from the host."
              }
            }
          },
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Csv File",
        "default": null,
        "description": "Host file reference: an object with download_url (ChatGPT/OpenAI file param) or data (data: URI), or a URL / data: URI string. Local paths and bare file ids are rejected; for those, send the user to upload_url."
      },
      "csv_text": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Csv Text",
        "default": null
      },
      "ttl_seconds": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ttl Seconds",
        "default": null
      },
      "upload_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Upload Handle",
        "default": null,
        "description": "Existing upload_handle (aup_...) to append this chunk of rows to."
      }
    }
  }

  arguments 94 lines copy
• request_assignment_upload auth-required never probed

  The one way part-to-territory assignment rows (e.g. a ZIP-to-territory spreadsheet with Postal Code plus Territory/Region/Division) enter the server: stages them for direct_build (assignments_handle) and returns upload_handle. Same ways in as request_account_upload: upload_url (no API key; up to 1 hour; the user opens it in a browser to drop a CSV or .xlsx, or a shell POSTs the file), csv_file, csv_text (newlines preserved), or assignment chunks appended with upload_handle; poll with only upload_handle until upload_status is received. Legacy columns map to part_id and territory_path automatically. A file of locations rather than assignments is redirected to request_account_upload. The handle is single-use and expires after 1 hour by default.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394

  {
    "type": "object",
    "title": "request_assignment_uploadArguments",
    "properties": {
      "csv_file": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "string",
                "description": "RFC 2397 data: URI."
              },
              "file_id": {
                "type": "string"
              },
              "file_name": {
                "type": "string"
              },
              "mime_type": {
                "type": "string"
              },
              "download_url": {
                "type": "string",
                "description": "Temporary HTTPS download URL from the host."
              }
            }
          },
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Csv File",
        "default": null,
        "description": "Host file reference: an object with download_url (ChatGPT/OpenAI file param) or data (data: URI), or a URL / data: URI string. Local paths and bare file ids are rejected; for those, send the user to upload_url."
      },
      "csv_text": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Csv Text",
        "default": null
      },
      "assignments": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Assignments",
        "default": null
      },
      "ttl_seconds": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ttl Seconds",
        "default": null
      },
      "upload_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Upload Handle",
        "default": null,
        "description": "Existing upload_handle (aup_...) to append this chunk of rows to."
      }
    }
  }

  arguments 94 lines copy
• calculate_route reads auth-required never probed

  Sequences and drives a set of stops, e.g. a technician from home to the depot, then the day's calls, and back home: returns the order, road distance, drive time, per-leg timings, and geometry from TomTom or Azure Maps, and draws the path with numbered stops on the open map (map_session_id). Creates no territory and changes no assignment. route_type is the user's choice: circuit (returns to start), tour (ends at the required end stop), or open_tour (one way). stop_sets are visited in the order given and no stop moves between sets; order is optimize or as_given; group_by_field adds priority bands. Stops are inline coordinates or point-layer references (e.g. source.filter.territory_id); point_ids and stop_id are point_id values (visits: <account_id>#<n>). A new route_id adds a second route; recalculating an existing route_id replaces it, e.g. to drop a stop. dwell_time is stored for analyze_routes. Route drive time is a different measure from territory workload. No provider key returns ROUTING_NOT_CONFIGURED; past the monthly quota, PROVIDER_QUOTA_EXCEEDED. Returns a task.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379

  {
    "type": "object",
    "$defs": {
      "RepoShape1": {
        "type": "array",
        "items": {
          "$ref": "#/$defs/RepoShape3"
        },
        "description": "Several inline stops in one source."
      },
      "RepoShape2": {
        "type": "object",
        "description": "Property equality filter applied to the point layer, e.g. {\"territory_id\": \"<leaf id>\"} after auto_build or {\"bucket_id\": \"d01-b1\"} on <point_layer>_visits after schedule_visits (which also stamps schedule_day, schedule_date, and contractor_id). A display label such as T1 does not match. A list value matches any member.",
        "additionalProperties": true
      },
      "RepoShape3": {
        "type": "object",
        "required": [
          "latitude",
          "longitude"
        ],
        "properties": {
          "label": {
            "type": "string"
          },
          "stop_id": {
            "type": "string"
          },
          "latitude": {
            "type": "number",
            "maximum": 90,
            "minimum": -90
          },
          "longitude": {
            "type": "number",
            "maximum": 180,
            "minimum": -180
          },
          "properties": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "additionalProperties": true
      }
    },
    "title": "calculate_routeArguments",
    "required": [
      "start",
      "stop_sets"
    ],
    "properties": {
      "end": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "label": {
                "type": "string"
              },
              "stops": {
                "$ref": "#/$defs/RepoShape1"
              },
              "filter": {
                "$ref": "#/$defs/RepoShape2"
              },
              "stop_id": {
                "type": "string",
                "minLength": 1,
                "description": "Id for an inline stop. Point-layer stops always use the point's point_id, so a route pushed to Designer links to the same point."
              },
              "latitude": {
                "type": "number",
                "maximum": 90,
                "minimum": -90
              },
              "longitude": {
                "type": "number",
                "maximum": 180,
                "minimum": -180
              },
              "point_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Specific point_id values from point_layer (a <point_layer>_visits layer uses <account_id>#<visit_index>). An id that is not a point_id selects every point with that account_id. For an as_given set, this array is also the visit order."
              },
              "label_field": {
                "type": "string",
                "minLength": 1,
                "description": "Point property to use as the stop label on the map."
              },
              "point_layer": {
                "type": "string",
                "minLength": 1,
                "description": "Ingested point layer to draw stops from. Resolved against ts / ts_handle / map_session_id."
              }
            },
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Destination. Required for route_type=tour, rejected otherwise."
      },
      "start": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string"
          },
          "stops": {
            "$ref": "#/$defs/RepoShape1"
          },
          "filter": {
            "$ref": "#/$defs/RepoShape2"
          },
          "stop_id": {
            "type": "string",
            "minLength": 1,
            "description": "Id for an inline stop. Point-layer stops always use the point's point_id, so a route pushed to Designer links to the same point."
          },
          "latitude": {
            "type": "number",
            "maximum": 90,
            "minimum": -90
          },
          "longitude": {
            "type": "number",
            "maximum": 180,
            "minimum": -180
          },
          "point_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Specific point_id values from point_layer (a <point_layer>_visits layer uses <account_id>#<visit_index>). An id that is not a point_id selects every point with that account_id. For an as_given set, this array is also the visit order."
          },
          "label_field": {
            "type": "string",
            "minLength": 1,
            "description": "Point property to use as the stop label on the map."
          },
          "point_layer": {
            "type": "string",
            "minLength": 1,
            "description": "Ingested point layer to draw stops from. Resolved against ts / ts_handle / map_session_id."
          }
        },
        "description": "Origin. Must resolve to exactly one stop.",
        "additionalProperties": true
      },
      "route_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Route Id",
        "default": null,
        "description": "Stable identity for the route inside the solution. A new route_id adds a route alongside the existing ones; reusing a route_id replaces that route in place. To add or drop a stop, call again with the SAME route_id and the revised stop list — there is no add-stop tool and delete_route is for dropping the whole route. Defaults to a slug of route_label, else a generated id."
      },
      "depart_at": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Depart At",
        "default": null,
        "description": "RFC 3339 departure time. Drives traffic-aware durations. Defaults to now."
      },
      "stop_sets": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "order": {
              "enum": [
                "as_given",
                "optimize"
              ],
              "type": "string",
              "default": "optimize",
              "description": "as_given keeps the declared order; optimize sequences the set to reduce travel."
            },
            "set_id": {
              "type": "string",
              "minLength": 1,
              "description": "Identifier echoed on each stop in the result. Defaults to set-1, set-2, ..."
            },
            "source": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "stops": {
                  "$ref": "#/$defs/RepoShape1"
                },
                "filter": {
                  "$ref": "#/$defs/RepoShape2"
                },
                "stop_id": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Id for an inline stop. Point-layer stops always use the point's point_id, so a route pushed to Designer links to the same point."
                },
                "latitude": {
                  "type": "number",
                  "maximum": 90,
                  "minimum": -90
                },
                "longitude": {
                  "type": "number",
                  "maximum": 180,
                  "minimum": -180
                },
                "point_ids": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Specific point_id values from point_layer (a <point_layer>_visits layer uses <account_id>#<visit_index>). An id that is not a point_id selects every point with that account_id. For an as_given set, this array is also the visit order."
                },
                "label_field": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Point property to use as the stop label on the map."
                },
                "point_layer": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Ingested point layer to draw stops from. Resolved against ts / ts_handle / map_session_id."
                }
              },
              "description": "Either inline coordinates or a reference to points already in the territory solution.",
              "additionalProperties": true
            },
            "group_by_field": {
              "type": "string",
              "minLength": 1,
              "description": "Point property that splits the set into ordered bands, e.g. route_priority. Every band-1 stop precedes every band-2 stop, and stops are optimized within a band."
            },
            "group_direction": {
              "enum": [
                "asc",
                "desc"
              ],
              "type": "string",
              "default": "asc"
            }
          },
          "description": "One group of stops. Sets are visited in array order and optimization never moves a stop across a set boundary.",
          "additionalProperties": false
        },
        "minItems": 1
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "dwell_time": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "enum": [
                  "scalar",
                  "field"
                ],
                "type": "string",
                "description": "Dwell source: 'scalar' for a fixed per-visit duration or 'field' for an ingested point column."
              },
              "unit": {
                "enum": [
                  "minutes",
                  "hours"
                ],
                "type": "string",
                "default": "minutes",
                "description": "Time unit for value or field ('minutes' or 'hours')."
              },
              "field": {
                "type": "string",
                "minLength": 1,
                "description": "Point column name holding per-account onsite time when type='field'."
              },
              "value": {
                "type": "number",
                "minimum": 0,
                "description": "Confirmed onsite duration per visit when type='scalar'."
              }
            },
            "description": "Onsite (dwell) time per visit: {type: 'scalar', value: <number>, unit: 'minutes'|'hours'} or {type: 'field', field: '<column>', unit: 'minutes'|'hours'}.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Dwell Time",
        "default": null
      },
      "route_type": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Route Type",
        "default": null,
        "description": "circuit returns to start; tour finishes at the declared end (required); open_tour lets the optimizer choose the final stop and never returns to start."
      },
      "route_label": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Route Label",
        "default": null,
        "description": "Display name for the route on the map and in the legend. Seeds route_id when route_id is omitted."
      },
      "travel_mode": {
        "type": "string",
        "title": "Travel Mode",
        "default": "car"
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "include_geometry": {
        "type": "boolean",
        "title": "Include Geometry",
        "default": true,
        "description": "Set false to skip the route polyline when only sequence and timings are needed."
      }
    }
  }

  arguments 379 lines copy
• isochrone_build auth-required never probed

  Draws the area reachable by driving from one or more origins within a time or distance budget (drive-time area, service area, catchment) and adds each area as a territory in a drive-time alignment. origins: inline {latitude, longitude} or a point-layer reference. bands: [{time_budget_seconds} or {distance_budget_meters}], one unit per call (MIXED_BUDGET_TYPES otherwise); one band gives one area per origin, several give nested areas. Limits: 25 origins, 5 bands, 6 hours, 500 km; travel_mode car or truck; depart_at supported. Areas are the provider polygons and may overlap; analyze counts accounts in every area containing them. realign/split/merge/rebalance return ISOCHRONE_TAL_NOT_EDITABLE. A band budget is not territory workload or route time. No provider key returns ISOCHRONE_NOT_CONFIGURED; the full call count is checked against the monthly quota first (PROVIDER_QUOTA_EXCEEDED). Returns a task.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206

  {
    "type": "object",
    "title": "isochrone_buildArguments",
    "required": [
      "origins",
      "bands"
    ],
    "properties": {
      "avoid": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Avoid",
        "default": null,
        "description": "Road classes to keep out of the reachable area. Only values both providers document."
      },
      "bands": {
        "type": "array",
        "items": {
          "type": "object",
          "oneOf": [
            {
              "required": [
                "time_budget_seconds"
              ]
            },
            {
              "required": [
                "distance_budget_meters"
              ]
            }
          ],
          "properties": {
            "label": {
              "type": "string",
              "description": "Display suffix for this band's territories. Defaults to a readable budget, e.g. \"20 min\"."
            },
            "band_id": {
              "type": "string",
              "minLength": 1,
              "description": "Stable identity for the band. Defaults to a slug of the budget, e.g. 20min or 25km."
            },
            "time_budget_seconds": {
              "type": "number",
              "maximum": 21600,
              "description": "Drive-time budget. Capped at 21600s (6h) by the stricter provider.",
              "exclusiveMinimum": 0
            },
            "distance_budget_meters": {
              "type": "number",
              "maximum": 500000,
              "description": "Drive-distance budget. Capped at 500000m by the stricter provider.",
              "exclusiveMinimum": 0
            }
          },
          "description": "One reachable-range budget. Exactly one of time_budget_seconds or distance_budget_meters, and every band in a call must use the same one.",
          "additionalProperties": false
        },
        "minItems": 1,
        "description": "Budgets to draw at each origin. One band gives one leaf per origin; several give a rollup per origin with one leaf per band. Capped (default 5, TOO_MANY_BANDS)."
      },
      "tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Id",
        "default": null,
        "description": "Stable identity for the TAL. Reusing an existing id replaces that TAL. Defaults to a slug of tal_label."
      },
      "origins": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "label": {
              "type": "string",
              "description": "Display name for an inline origin."
            },
            "filter": {
              "type": "object",
              "description": "Property equality filter applied to the point layer, e.g. {\"type\": \"branch\"}. A list value matches any member.",
              "additionalProperties": true
            },
            "latitude": {
              "type": "number",
              "maximum": 90,
              "minimum": -90
            },
            "longitude": {
              "type": "number",
              "maximum": 180,
              "minimum": -180
            },
            "origin_id": {
              "type": "string",
              "minLength": 1,
              "description": "Stable identity for an inline origin. Echoed on every band territory and in the isochrone provenance block. Defaults to origin-1, origin-2, ..."
            },
            "point_ids": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Specific point IDs from point_layer. Each resolved point becomes one origin."
            },
            "label_field": {
              "type": "string",
              "minLength": 1,
              "description": "Point property to use as the origin label, which seeds the territory name."
            },
            "point_layer": {
              "type": "string",
              "minLength": 1,
              "description": "Ingested point layer to draw origins from. Resolved against ts_handle / map_session_id."
            }
          },
          "description": "Either inline coordinates or a reference to points already in the territory solution. Same shape as calculate_route's stopSource, minus the ordering fields.",
          "additionalProperties": true
        },
        "minItems": 1,
        "description": "Centers to measure reachability from. Provider calls are origins x bands, so this is capped (default 25, TOO_MANY_ORIGINS)."
      },
      "traffic": {
        "type": "boolean",
        "title": "Traffic",
        "default": true,
        "description": "Traffic-aware travel times. Ignored for a distance budget."
      },
      "depart_at": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Depart At",
        "default": null,
        "description": "RFC 3339 departure time, which shapes traffic-aware boundaries. There is no arrive_at: reachable range is forward-only."
      },
      "tal_label": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Label",
        "default": null,
        "description": "Display name for the TAL. Defaults to a readable summary, e.g. \"20 min drive time\"."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "route_type": {
        "type": "string",
        "title": "Route Type",
        "default": "fastest"
      },
      "travel_mode": {
        "type": "string",
        "title": "Travel Mode",
        "default": "car",
        "description": "Narrower than calculate_route on purpose: neither provider offers a pedestrian or bicycle reachable range."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      }
    }
  }

  arguments 206 lines copy
• delete_route auth-required never probed

  Route delete: removes one whole route from the Territory Solution and the open map, in one synchronous call. Needs route_id or the route's exact unique label, plus map_session_id or ts_handle. A route that is already gone returns ok with already_absent=true; an ambiguous label returns AMBIGUOUS_ROUTE with matching_route_ids. A single stop is removed by recalculating the same route_id with calculate_route.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940

  {
    "type": "object",
    "title": "delete_routeArguments",
    "required": [
      "route_id"
    ],
    "properties": {
      "route_id": {
        "type": "string",
        "title": "Route Id",
        "description": "Route to delete: the route_id, or an exact unique route label. Removing one stop is a calculate_route with the same route_id and the remaining stops."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      }
    }
  }

  arguments 40 lines copy
• delete_point_layer auth-required never probed

  Point-layer delete: removes one point layer and its account points from the Territory Solution and the open map, in one synchronous call. Needs point_layer (the layer id or its exact unique label), plus map_session_id or ts_handle. Territories, part overlays, and other point layers stay. A layer that is already gone returns ok with already_absent=true; an ambiguous label returns AMBIGUOUS_POINT_LAYER with matching_point_layers. ingest_accounts does not replace an existing layer; delete it here first. A visit layer derived from the deleted layer is reported and kept.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940

  {
    "type": "object",
    "title": "delete_point_layerArguments",
    "required": [
      "point_layer"
    ],
    "properties": {
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "point_layer": {
        "type": "string",
        "title": "Point Layer",
        "description": "Point layer to delete: the point_layer id, or an exact unique layer label."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      }
    }
  }

  arguments 40 lines copy
• points_in_territory auth-required 24d ago

  Lists which account points from one point layer fall inside a territory polygon or a drive-time (isochrone) area. Per territory: point_count, metric_sums (metrics, else the layer's declared metric fields), and a sample of sample_size points (default 25, max 200; 500 across all territories) with label and metric fields, or only the fields you name. Counts and sums cover every inside point. The full list is never inline: it is in points_artifact, via download_url (GET with the API key) or share_with_user (one-hour key-less link for the user). Synchronous, read-only; needs map_session_id or ts_handle. territory_id names one leaf (id or unique display name), territory_ids several; omit both for every leaf in the TAL (tal_id, else the active or sole TAL). point_layer defaults to the sole layer with points; point_filter (e.g. {tier: 'Gold'}) filters before counting. A point counts in every containing polygon; overlaps lists shared points. Unknown ids return UNKNOWN_TAL_ID / UNKNOWN_TERRITORY_ID / UNKNOWN_POINT_LAYER with the available values.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160

  {
    "type": "object",
    "title": "points_in_territoryArguments",
    "properties": {
      "fields": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Fields",
        "default": null,
        "description": "Point properties to keep on sample points and in points_artifact. Omitted: the sample carries label plus the metric fields, and the artifact carries every property."
      },
      "tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Id",
        "default": null,
        "description": "Territory alignment to query. Defaults to the active TAL, or the sole TAL with leaf polygons."
      },
      "metrics": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Metrics",
        "default": null,
        "description": "Numeric point columns to sum per territory. Defaults to the layer's declared metric fields."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "point_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Point Layer",
        "default": null,
        "description": "Point layer id or exact unique label. Optional when the solution has one layer with points."
      },
      "sample_size": {
        "type": "integer",
        "title": "Sample Size",
        "default": 25,
        "description": "Points shown inline per territory; the server lowers it so at most 500 sample points come back across all territories. point_count and metric_sums always cover every inside point; points_artifact lists them all."
      },
      "point_filter": {
        "anyOf": [
          {
            "type": "object",
            "minProperties": 1,
            "additionalProperties": {
              "anyOf": [
                {
                  "type": [
                    "string",
                    "number",
                    "boolean"
                  ]
                },
                {
                  "type": "array",
                  "items": {
                    "type": [
                      "string",
                      "number",
                      "boolean"
                    ]
                  },
                  "minItems": 1
                }
              ]
            }
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Optional attribute filter (column -> value or list of values, matched case-insensitively, e.g. {\"tier\": \"Gold\"}) applied to the point layer before counting and listing."
      },
      "territory_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Territory Id",
        "default": null,
        "description": "One leaf: its stable territory_id or exact unique display name. Mutually exclusive with territory_ids."
      },
      "territory_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Territory Ids",
        "default": null,
        "description": "Several leaves (stable ids or exact unique display names). With neither territory_id nor territory_ids, every leaf in the TAL."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      }
    }
  }

  arguments 160 lines copy
• tasks_get reads auth-required never probed

  Tool equivalent of the native MCP tasks/get, listed for clients without the Tasks capability. Returns the Task status document for a task_id (holding up to wait_ms while the task is working). next_action is sleep_and_poll (wait sleep_ms, then one tasks_get), consume_result (one tasks_result call), or stop_error. status=cancelled means the user stopped it. While queued, _meta carries queue_position, queue_depth, queue_lane, and estimated_start_ms, which is advisory and not a wait time. Polling never starts work.

  mcp-tool

  123456789101112131415161718192021222324252627

  {
    "type": "object",
    "title": "tasks_getArguments",
    "required": [
      "task_id"
    ],
    "properties": {
      "task_id": {
        "type": "string",
        "title": "Task Id",
        "description": "task_id from the submitting tool's result (same value as job_id)."
      },
      "wait_ms": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Wait Ms",
        "default": null,
        "description": "Optional milliseconds to hold on the server while the task is working so completed tasks return consume_result without an extra poll round-trip."
      }
    }
  }

  arguments 27 lines copy
• tasks_result reads auth-required never probed

  Tool equivalent of the native MCP tasks/result, listed for clients without the Tasks capability. Returns the originating tool's terminal result once the task status is completed (consume_result): ts_handle, counts, timings, and map binding, never an inline Territory Solution. A build's ts_handle or task_id (as job_id) is the input analyze takes.

  mcp-tool

  1234567891011121314

  {
    "type": "object",
    "title": "tasks_resultArguments",
    "required": [
      "task_id"
    ],
    "properties": {
      "task_id": {
        "type": "string",
        "title": "Task Id",
        "description": "task_id whose status next_action is consume_result."
      }
    }
  }

  arguments 14 lines copy
• set_map_state changes data auth-required never probed

  Changes the open map's session state: mode, active alignment (active_tal_id), pending job reference, or camera (center [longitude, latitude] and zoom 0-24). Session only: the Territory Solution is not changed (configure_map sets a durable default view). The result's render_ack is read at publish time, so sent_unconfirmed one version behind is normal; render_ack_hint says whether to reread ezt://map-sessions/{map_session_id}/state or resend. camera reports the view in effect and its source (requested, session, map_config, or viewer_current). A set camera stays until changed; switching alignment does not refit.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091

  {
    "type": "object",
    "title": "set_map_stateArguments",
    "required": [
      "map_session_id"
    ],
    "properties": {
      "mode": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Mode",
        "default": null
      },
      "zoom": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Zoom",
        "default": null
      },
      "center": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Center",
        "default": null
      },
      "active_tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Active Tal Id",
        "default": null,
        "description": "Alignment to make active on the open map (session only)."
      },
      "map_session_id": {
        "type": "string",
        "title": "Map Session Id",
        "description": "Open map session (msess_...) from get_map_visualization."
      },
      "pending_job_reference": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "job_id": {
                "type": "string",
                "description": "Same value as task_id."
              },
              "task_id": {
                "type": "string"
              },
              "tool_name": {
                "type": "string"
              }
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Pending Job Reference",
        "default": null,
        "description": "Task reference (task_id from a build submission) the map follows and repaints from when the task completes."
      }
    }
  }

  arguments 91 lines copy
• load_analysis_panel reads auth-required never probed

  Shows a completed analyze result in the open map's analysis dock (single or compare). Needs map_session_id and the analyze task_id/job_id or the full analyze result (with tal_analyses and ts_identity; a partial object returns INVALID_REQUEST). presentation_mode: single, compare, executive, or diagnostic. dismiss=true hides the dock and keeps the statistics on the session. Changes nothing in the Territory Solution. analyze with analysis_panel=single fills the dock in the same call.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127

  {
    "type": "object",
    "title": "load_analysis_panelArguments",
    "required": [
      "map_session_id"
    ],
    "properties": {
      "roles": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Roles",
        "default": null
      },
      "job_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Job Id",
        "default": null,
        "description": "Compatibility alias for task_id."
      },
      "labels": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Labels",
        "default": null
      },
      "dismiss": {
        "type": "boolean",
        "title": "Dismiss",
        "default": false,
        "description": "true hides the whole dock, header bar included, and keeps stored stats. It takes no analyses, task_id, labels, roles, or presentation_mode."
      },
      "task_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Task Id",
        "default": null,
        "description": "Completed analyze task_id. Same string as job_id. Hydrates analyses when analyses is omitted."
      },
      "analyses": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "tal_analyses"
              ],
              "properties": {
                "ts_identity": {
                  "type": "object"
                },
                "tal_analyses": {
                  "type": "array"
                },
                "default_presentation": {
                  "type": "object"
                },
                "territory_metric_grids": {
                  "type": "array"
                },
                "presentation_guidance_uri": {
                  "type": "string"
                }
              },
              "description": "A full Analyze result. Must include tal_analyses plus ts_identity, and territory_metric_grids when metrics exist. A thin {tal_analyses} object is rejected.",
              "additionalProperties": true
            },
            "maxItems": 4,
            "minItems": 1
          },
          {
            "type": "null"
          }
        ],
        "default": null
      },
      "map_session_id": {
        "type": "string",
        "title": "Map Session Id",
        "description": "Open map session (msess_...) from get_map_visualization."
      },
      "presentation_mode": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Presentation Mode",
        "default": null,
        "description": "Panel mode. territory_metric_grid is default_presentation.view inside the Analyze result, not a presentation_mode."
      }
    }
  }

  arguments 127 lines copy
• show_map_overlay reads auth-required never probed

  Shows or hides something on the open map from a plain request ('add US zip codes', 'hide the zips', 'show my accounts') or overlay_kind (part_layer, point_layer, tal, route) with overlay_id. Part layers load at a zoom where they are visible (visibility.camera_action); hiding a part layer leaves territories unchanged. Point layers must already be ingested; a layer in the Territory Solution but missing from the map is re-pushed (status=refreshed, with render_ack). Point layers have no hidden state: hide wording returns HIDE_NOT_SUPPORTED with do_this_next delete_point_layer, which removes the layer; the legend checkbox hides one in a single tab. route re-shows or hides routes calculate_route drew (route_id targets one); with no route yet it returns blocked_by=needs_route. When the user named a camera, do_this_next carries the configure_map call that sets it. Input: map_session_id (preferred) or ts_handle.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119

  {
    "type": "object",
    "title": "show_map_overlayArguments",
    "properties": {
      "route_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Route Id",
        "default": null,
        "description": "With overlay_kind=route, targets one route instead of all of them. Without it, every route is re-pushed or cleared. Only re-shows or clears a route calculate_route already produced — it never routes."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "overlay_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Overlay Id",
        "default": null,
        "description": "Canonical id: us_zips, accounts, tal-current, etc."
      },
      "overlay_kind": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Overlay Kind",
        "default": null
      },
      "user_request": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "User Request",
        "default": null,
        "description": "Natural-language ask, e.g. 'add zips to the map'."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "merge_strategy": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Merge Strategy",
        "default": null
      },
      "expected_revision": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Revision",
        "default": null
      },
      "expected_content_hash": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Content Hash",
        "default": null
      }
    }
  }

  arguments 119 lines copy
• export_geojson auth-required never probed

  Exports the territory solution as one GeoJSON file to share, archive, or open in EasyTerritory Designer: territory polygons with part_ids, points, and routes with numbered stops, each carrying its displayed style. tal_ids, point_layers, and route_layers narrow it; include_points / include_routes omit a family. Input: map_session_id, ts_handle, or a completed build job_id. Returns a task whose result is geojson_artifact, share_url (key-less browser download for one hour; give the user share_with_user), and download_url (GET with the API key), never an inline body. Both serve a plain .geojson file. import_geojson reopens the file.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104

  {
    "type": "object",
    "title": "export_geojsonArguments",
    "properties": {
      "job_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Job Id",
        "default": null,
        "description": "task_id (same value as job_id) of a completed build or ingest task; its Territory Solution is the input."
      },
      "tal_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Ids",
        "default": null,
        "description": "TALs to materialize; omit for all."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "point_layers": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Point Layers",
        "default": null,
        "description": "Point layers to include; omit for all."
      },
      "route_layers": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Route Layers",
        "default": null,
        "description": "route_id values to include; omit for all. Each exported route emits one route_path feature plus one route_stop feature per visit (never coalesced)."
      },
      "include_points": {
        "type": "boolean",
        "title": "Include Points",
        "default": true
      },
      "include_routes": {
        "type": "boolean",
        "title": "Include Routes",
        "default": true,
        "description": "Set false to drop the whole route family regardless of route_layers."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      }
    }
  }

  arguments 104 lines copy
• import_geojson changes data auth-required never probed

  Opens a GeoJSON FeatureCollection (points, or a territory file, plain or gzip/zip) as a Territory Solution; returns ts_handle and a summary. A file of any real size moves by reference, never inline: call with no file argument for an upload_url (give the user share_with_user, or POST it with curl_example), then poll import_geojson(upload_handle) every recommended_poll_delay_ms until upload_status=received. geojson_file takes a host file (download_url). Inline geojson / geojson_text / geojson_gzip take at most 256 KB; a larger one returns INLINE_PAYLOAD_TOO_LARGE with the upload_url call to make. Polygons without part_ids import as polygon areas with tal_kind="polygon" (measured by point-in-polygon), or convert to parts with part_layer + overlay_policy="centroid_within". For a Designer project, use import_designer_project.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152

  {
    "type": "object",
    "title": "import_geojsonArguments",
    "properties": {
      "geojson": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Geojson",
        "default": null,
        "description": "GeoJSON FeatureCollection: point features and/or EZT-exported territory features carrying part_ids. Incoming properties.style (color / opacity / size / shape / weight) on features and point_layers[] / route_layers[] is kept as-is; only missing paint is filled, so a reopened export paints exactly as saved (ts-reference.schema.json#/$defs/style)."
      },
      "tal_kind": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Kind",
        "default": null,
        "description": "Import polygons without part_ids directly as an area layer (tal_kind=polygon), measured by point-in-polygon with no part_layer."
      },
      "tal_label": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Label",
        "default": null,
        "description": "Label for the imported TAL when territory features lack TAL metadata."
      },
      "part_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Layer",
        "default": null,
        "description": "Geography for overlay assignment (e.g. us_zips). Required with overlay_policy."
      },
      "point_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Point Layer",
        "default": null,
        "description": "Name for the imported point layer (default: points)."
      },
      "geojson_file": {
        "anyOf": [
          {
            "oneOf": [
              {
                "type": "string",
                "minLength": 1
              },
              {
                "type": "object",
                "properties": {
                  "file_id": {
                    "type": "string"
                  },
                  "download_url": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              }
            ]
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Host file parameter (openai/fileParams): an object with a temporary https download_url, or that URL as a string."
      },
      "geojson_gzip": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Geojson Gzip",
        "default": null,
        "description": "Base64 gzip or zip bytes of a GeoJSON FeatureCollection."
      },
      "geojson_text": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Geojson Text",
        "default": null
      },
      "upload_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Upload Handle",
        "default": null,
        "description": "Upload link handle from import_geojson() with no file argument; returns its upload_status."
      },
      "overlay_policy": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Overlay Policy",
        "default": null,
        "description": "Explicit opt-in for converting territory polygons without part_ids into a part-based TAL: assigns parts whose centroids fall inside each polygon."
      }
    }
  }

  arguments 152 lines copy
• link_designer auth-required never probed

  Connects the customer's EasyTerritory Designer account so list_designer_projects, import_designer_project, and push_to_designer can call Designer from the server. Returns status linked (designer_origin, designer_user) or waiting_for_user with a link_url and share_with_user. The user pastes their Designer agent token (ezt_pat_...) on that page; the token is never a tool argument and never appears in a result. Repeated calls report the status; recommended_poll_delay_ms is the interval. unlink=true removes the stored link.

  mcp-tool

  1234567891011

  {
    "type": "object",
    "title": "link_designerArguments",
    "properties": {
      "unlink": {
        "type": "boolean",
        "title": "Unlink",
        "default": false
      }
    }
  }

  arguments 11 lines copy
• list_designer_projects auth-required never probed

  Lists the EasyTerritory Designer rolodex projects the linked Designer user can read: project_id, label, description, tags, saved_at, is_mine, and layers (point data present). q filters by text, tag by rolodex tag, mine=true to the user's own. project_id is the input to import_designer_project and push_to_designer. Without a link the error is DESIGNER_NOT_LINKED (see link_designer).

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142

  {
    "type": "object",
    "title": "list_designer_projectsArguments",
    "properties": {
      "q": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Q",
        "default": null
      },
      "tag": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tag",
        "default": null
      },
      "mine": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "title": "Mine",
        "default": null
      }
    }
  }

  arguments 42 lines copy
• import_dataverse_view auth-required never probed

  Microsoft Copilot only (Entra sign-in): reads a Dynamics 365 account view server to server, as the signed-in user, and stages it as an account upload. No rows pass through the agent. view_id (or an exact view_name) comes from list_dataverse_views. The server adds accountid, name, and the address1 location columns to the view; they arrive as latitude, longitude, address, city, state, postal_code, country. Returns a task (follow next_action / sleep_ms, fetch the result once); the result is the same shape as an account upload: upload_handle, row_count, csv_headers, preview, upload_warnings, geocode_plan, and suggested_ingest. Confirm the column roles with the user, then ingest_accounts(**suggested_ingest.args). Limit 100,000 accounts (DATAVERSE_VIEW_TOO_LARGE). Other clients get DATAVERSE_NOT_AVAILABLE: use request_account_upload instead.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859

  {
    "type": "object",
    "title": "import_dataverse_viewArguments",
    "required": [
      "environment_url"
    ],
    "properties": {
      "view_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "View Id",
        "default": null,
        "description": "Account view id from list_dataverse_views (system or personal)."
      },
      "view_name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "View Name",
        "default": null,
        "description": "Exact view name, when view_id is unknown. Ambiguous names return DATAVERSE_VIEW_AMBIGUOUS."
      },
      "point_layer": {
        "type": "string",
        "title": "Point Layer",
        "default": "accounts",
        "description": "Point layer name ingest_accounts will create."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "environment_url": {
        "type": "string",
        "title": "Environment Url",
        "description": "Dynamics 365 environment from list_dataverse_views."
      }
    }
  }

  arguments 59 lines copy
• publish_to_dataverse auth-required never probed

  Microsoft Copilot (Entra sign-in): writes stamped point-layer columns back to Dynamics 365 account records keyed by accountid (1:1 Account PATCH). Needs map_session_id or ts_handle. Point layers carry derived stamps from builds/realign (part_id, territory_id, territory_label), calculate_route (route_id, route_label, stop_sequence), schedule_visits (schedule_id, visit_count, schedule_days, schedule_dates, contractor_id, contractor_label), isochrone_build (isochrone_tal_id, isochrone_ids, isochrone_labels, isochrone_count), and cluster_points (group_id, group_label). A <point_layer>_visits layer resolves to its 1:1 parent account layer and maps schedule_day/date to schedule_days/dates. field_map maps point columns to Dynamics account logical attributes (primitive columns or territoryid / ownerid lookups resolved by name or GUID). With confirm=false (default) or no field_map, runs a read-only preflight returning status=confirmation_required, stamped_columns, candidate_target_attributes, preview_updates, and ask_user. With confirm=true, queues the batch PATCH task.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879

  {
    "type": "object",
    "title": "publish_to_dataverseArguments",
    "properties": {
      "confirm": {
        "type": "boolean",
        "title": "Confirm",
        "default": false,
        "description": "False (default) runs the read-only preflight to preview matched accounts and validate attributes/lookups. True dispatches the batch PATCH job after user confirmation."
      },
      "field_map": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Field Map",
        "default": null,
        "description": "Map of stamped point column -> Dynamics 365 account logical attribute name (e.g. {'territory_label': 'territoryid', 'route_label': 'new_routename'}). When absent, the preflight lists stamped_columns and candidate_target_attributes."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "point_layer": {
        "type": "string",
        "title": "Point Layer",
        "default": "accounts",
        "description": "Source point layer in the Territory Solution (default 'accounts'). A <point_layer>_visits layer resolves to its 1:1 parent account layer."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "environment_url": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Environment Url",
        "default": null,
        "description": "Dynamics 365 environment (e.g. https://contoso.crm.dynamics.com). Defaults to the environment the point layer was imported from, or the user's sole environment."
      },
      "include_unassigned": {
        "type": "boolean",
        "title": "Include Unassigned",
        "default": false,
        "description": "When true, accounts with an empty/unassigned stamp clear the target Dynamics attribute to null. Default false updates accounts with non-empty stamped values."
      }
    }
  }

  arguments 79 lines copy
• ezt auth-required never probed

  Plain-language orchestrator: takes request (the goal) and runs the matching workflow in one call, optionally with csv_file (a host file parameter), accounts_handle, assignments_handle, map_session_id, or ts_handle. An uploaded CSV is parsed, staged, and ingested onto the open map. target_hours / workload_target map to a fixed-workload auto_build. Missing build inputs (part layer, alignment name, sizing, balance, dwell) return CLARIFICATION_REQUIRED with the questions. The granular tools do the same steps individually.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126

  {
    "type": "object",
    "title": "eztArguments",
    "required": [
      "request"
    ],
    "properties": {
      "args": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Args",
        "default": null
      },
      "request": {
        "type": "string",
        "title": "Request"
      },
      "csv_file": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "string",
                "description": "RFC 2397 data: URI."
              },
              "file_id": {
                "type": "string"
              },
              "file_name": {
                "type": "string"
              },
              "mime_type": {
                "type": "string"
              },
              "download_url": {
                "type": "string",
                "description": "Temporary HTTPS download URL from the host."
              }
            }
          },
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Csv File",
        "default": null,
        "description": "Host file reference: an object with download_url (ChatGPT/OpenAI file param) or data (data: URI), or a URL / data: URI string. Local paths and bare file ids are rejected; for those, send the user to upload_url."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "state_facts": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "State Facts",
        "default": null
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "accounts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Accounts Handle",
        "default": null,
        "description": "upload_handle (aup_...) from request_account_upload."
      },
      "assignments_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Assignments Handle",
        "default": null,
        "description": "upload_handle (aup_...) from request_assignment_upload."
      }
    }
  }

  arguments 126 lines copy
• get_map_selection reads auth-required 24d ago

  Returns the most recent committed selection on an open map session (map_session_id): part_layer, part_ids, and selection_task_id when the selection came from request_part_selection. Covers selections the person started from the map legend. realign takes these part_ids as moves with a leaf territory_id.

  mcp-tool

  1234567891011121314

  {
    "type": "object",
    "title": "get_map_selectionArguments",
    "required": [
      "map_session_id"
    ],
    "properties": {
      "map_session_id": {
        "type": "string",
        "title": "Map Session Id",
        "description": "Open map session (msess_...) from get_map_visualization."
      }
    }
  }

  arguments 14 lines copy
• query_parts reads auth-required 24d ago

  Returns attributes (no geometry) for parts of a part layer listed by list_part_layers or ezt://part-layers. Takes exactly one of filter (e.g. {state_abbr: TX}) or part_ids; neither or both returns INVALID_REQUEST. Paged with page_token. TAL membership (each needs map_session_id or ts_handle inside): filter.in_tal {tal_id, territory_ids?} keeps only the parts that TAL assigns (its whole footprint, however many separate regions; territory_ids narrows to those territories and everything under them); filter.not_in_tal {tal_id} drops that TAL's parts (white space), e.g. {state_abbr: TX, not_in_tal: {...}}. Both AND with other predicates. total_count is the set size. Build from it with the same part_filter.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251

  {
    "type": "object",
    "title": "query_partsArguments",
    "required": [
      "part_layer"
    ],
    "properties": {
      "filter": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "text": {
                "type": "object",
                "required": [
                  "value"
                ],
                "properties": {
                  "mode": {
                    "enum": [
                      "prefix",
                      "contains",
                      "exact"
                    ],
                    "type": "string",
                    "default": "prefix"
                  },
                  "field": {
                    "type": "string",
                    "description": "Safe text field to search. Defaults to the public part ID column."
                  },
                  "value": {
                    "type": "string",
                    "minLength": 1
                  },
                  "case_sensitive": {
                    "type": "boolean",
                    "default": false
                  }
                },
                "additionalProperties": false
              },
              "in_tal": {
                "type": "object",
                "required": [
                  "tal_id"
                ],
                "properties": {
                  "tal_id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "ts_handle": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: Territory Solution reference (tsh_...) holding the TAL."
                  },
                  "territory_ids": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1
                    },
                    "minItems": 1,
                    "description": "Narrow to these territory_id values (not display labels); a rollup includes every leaf below it. Unknown ids return UNKNOWN_TERRITORY_ID with available_territory_ids."
                  },
                  "map_session_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: open map session whose Territory Solution holds the TAL."
                  }
                },
                "description": "Keep only the parts assigned to a leaf territory of tal_id: the TAL's whole footprint, however many separate regions it has. ANDed with the other predicates (alone it is exactly that footprint). The TAL must use the same part_layer and hold parts. query_parts needs ts_handle or map_session_id here; builds read the TAL from the build's own Territory Solution.",
                "additionalProperties": false
              },
              "spatial": {
                "type": "object",
                "oneOf": [
                  {
                    "required": [
                      "bbox"
                    ]
                  },
                  {
                    "required": [
                      "geometry"
                    ]
                  }
                ],
                "required": [
                  "operator"
                ],
                "properties": {
                  "bbox": {
                    "type": "array",
                    "items": {
                      "type": "number"
                    },
                    "maxItems": 4,
                    "minItems": 4,
                    "description": "[min_lon, min_lat, max_lon, max_lat] in EPSG:4326."
                  },
                  "geometry": {
                    "type": "object",
                    "description": "GeoJSON Polygon or MultiPolygon in EPSG:4326."
                  },
                  "operator": {
                    "enum": [
                      "intersects",
                      "within",
                      "contains"
                    ],
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "not_in_tal": {
                "type": "object",
                "required": [
                  "tal_id"
                ],
                "properties": {
                  "tal_id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "ts_handle": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: Territory Solution reference (tsh_...) holding the TAL."
                  },
                  "map_session_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: open map session whose Territory Solution holds the TAL."
                  }
                },
                "description": "White space: drop every part assigned to a leaf territory of tal_id from whatever the other predicates select (the whole layer when alone). The TAL must use the same part_layer. query_parts needs ts_handle or map_session_id here; builds read the TAL from the build's own Territory Solution.",
                "additionalProperties": false
              },
              "part_layer": {
                "type": "string"
              },
              "population": {
                "oneOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "eq": {
                        "type": "number"
                      },
                      "gt": {
                        "type": "number"
                      },
                      "lt": {
                        "type": "number"
                      },
                      "gte": {
                        "type": "number"
                      },
                      "lte": {
                        "type": "number"
                      },
                      "between": {
                        "type": "array",
                        "items": {
                          "type": "number"
                        },
                        "maxItems": 2,
                        "minItems": 2
                      }
                    },
                    "minProperties": 1,
                    "additionalProperties": false
                  }
                ]
              },
              "state_abbr": {
                "type": [
                  "string",
                  "array"
                ]
              },
              "county_name": {
                "type": [
                  "string",
                  "array"
                ]
              },
              "selection_task_id": {
                "type": "string",
                "minLength": 1,
                "description": "Builds only (auto_build, account_build, seed_build): a committed request_part_selection task (psel_...) whose part_ids become the scope; it is the only key in that part_filter."
              }
            },
            "minProperties": 1,
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Attribute/text/range/spatial/in_tal/not_in_tal filter. Mutually exclusive with top-level part_ids."
      },
      "part_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Ids",
        "default": null,
        "description": "Explicit list of part IDs. Mutually exclusive with filter. Useful for validation or enrichment."
      },
      "page_token": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Page Token",
        "default": null,
        "description": "Pagination token from a previous response."
      },
      "part_layer": {
        "type": "string",
        "title": "Part Layer",
        "description": "Required part layer identifier, e.g. 'us_zips'."
      },
      "max_results": {
        "type": "integer",
        "title": "Max Results",
        "default": 100,
        "description": "Maximum results per page. Server may enforce lower limits."
      }
    }
  }

  arguments 251 lines copy
• auto_build changes data auth-required never probed

  Partitions ingested account points into balanced sales territories with equal workload, metric, or count over a part layer (e.g. ZIPs) as a new alignment (TAL). Needs the user's choices: build_mode (fixed_territory_count + territory_count, fixed_workload_target + target_workload hours, or scoped_split), objective (workload_bias = drive + dwell, metric_bias = one column such as Revenue, count_bias = account count; sum 100), and dwell_time (a column or a stated scalar). A missing choice returns CLARIFICATION_REQUIRED with ask_user; a visit-frequency column also needs visit_frequency_field or ignore_visit_frequency. seed_point_layer seeds territories from provider points (any count). part_scope: bbox_intersect (default; can be national) or explicit with part_filter, e.g. {state_abbr: TX}; accounts outside stay unassigned (UNASSIGNED_ACCOUNTS). part_filter {in_tal: {tal_id}} keeps a TAL's parts; {not_in_tal: {tal_id}} its white space. With map_session_id the open map is the input. Returns a task; national builds take minutes. The result carries tal_id, ts_handle, and phase_timings_ms.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529

  {
    "type": "object",
    "title": "auto_buildArguments",
    "required": [
      "point_layer",
      "part_layer",
      "tal_label"
    ],
    "properties": {
      "part_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Ids",
        "default": null,
        "description": "Explicit part selection set. Implies part_scope explicit. Mutually exclusive with part_filter."
      },
      "objective": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "metric": {
                "type": "string",
                "description": "Point metric column name to balance (e.g. 'Revenue', 'Score'). Required when metric_bias > 0. Account count is count_bias, not a column."
              },
              "count_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on account count (locations per territory). Default 0."
              },
              "metric_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on the metric column."
              },
              "workload_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on workload (drive time + dwell)."
              }
            },
            "description": "Balance objective: workload_bias + metric_bias + count_bias = 100, weighting workload (drive + dwell), one metric column, and account count. Workload: {workload_bias: 100}. Metric: {metric: '<column>', workload_bias: 0, metric_bias: 100}. Count: {workload_bias: 0, count_bias: 100}. Three-way: {metric: 'Score', workload_bias: 40, metric_bias: 40, count_bias: 20}. Only one metric column balances; combine several into one score column at ingest. Omitted on restructure tools: inherits the source TAL build_provenance objective.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Objective",
        "default": null
      },
      "tal_label": {
        "type": "string",
        "title": "Tal Label"
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "build_mode": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "mode"
            ],
            "properties": {
              "mode": {
                "enum": [
                  "fixed_territory_count",
                  "fixed_workload_target",
                  "scoped_split"
                ],
                "type": "string",
                "description": "Sizing mode for the build."
              },
              "cycle_unit": {
                "enum": [
                  "day",
                  "week",
                  "month",
                  "quarter",
                  "year"
                ],
                "type": "string",
                "description": "Optional schedule cycle unit for fixed_workload_target."
              },
              "source_tal_id": {
                "type": "string",
                "minLength": 1,
                "description": "Source TAL id when mode='scoped_split'."
              },
              "workload_unit": {
                "enum": [
                  "minutes",
                  "hours"
                ],
                "type": "string",
                "default": "hours",
                "description": "Unit for target_workload ('hours' or 'minutes')."
              },
              "target_workload": {
                "type": "number",
                "description": "Target workload per territory when mode='fixed_workload_target'.",
                "exclusiveMinimum": 0
              },
              "territory_count": {
                "type": "integer",
                "minimum": 1,
                "description": "Target number of territories when mode='fixed_territory_count'."
              },
              "source_territory_id": {
                "type": "string",
                "minLength": 1,
                "description": "Source territory id or label to split when mode='scoped_split'."
              },
              "preserve_other_territories": {
                "type": "boolean",
                "default": true,
                "description": "Keep all other territories in source_tal_id unchanged when mode='scoped_split'."
              },
              "replacement_territory_count": {
                "type": "integer",
                "minimum": 2,
                "description": "Number of replacement territories (>=2) when mode='scoped_split'."
              }
            },
            "description": "Sizing mode: {mode: 'fixed_territory_count', territory_count: <int>} or {mode: 'fixed_workload_target', target_workload: <number>, workload_unit: 'hours'|'minutes', optional cycle_unit: 'day'|'week'|'month'|'quarter'|'year'} or {mode: 'scoped_split', source_tal_id: '<tal_id>', source_territory_id: '<territory_id>', replacement_territory_count: <int>=2.., optional preserve_other_territories: true}.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Build Mode",
        "default": null
      },
      "dwell_time": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "enum": [
                  "scalar",
                  "field"
                ],
                "type": "string",
                "description": "Dwell source: 'scalar' for a fixed per-visit duration or 'field' for an ingested point column."
              },
              "unit": {
                "enum": [
                  "minutes",
                  "hours"
                ],
                "type": "string",
                "default": "minutes",
                "description": "Time unit for value or field ('minutes' or 'hours')."
              },
              "field": {
                "type": "string",
                "minLength": 1,
                "description": "Point column name holding per-account onsite time when type='field'."
              },
              "value": {
                "type": "number",
                "minimum": 0,
                "description": "Confirmed onsite duration per visit when type='scalar'."
              }
            },
            "description": "Onsite (dwell) time per visit: {type: 'scalar', value: <number>, unit: 'minutes'|'hours'} or {type: 'field', field: '<column>', unit: 'minutes'|'hours'}.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Dwell Time",
        "default": null
      },
      "part_layer": {
        "type": "string",
        "title": "Part Layer"
      },
      "part_scope": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Scope",
        "default": null,
        "description": "Parts eligible for partition. Default bbox_intersect: all parts intersecting the account-point bounding box. point_matched: only parts containing at least one account; those parts are rarely adjacent, so territories come back as scattered pieces (warning POINT_MATCHED_SPARSE_SCOPE) — use it only when that is the goal. explicit: part_ids or part_filter (e.g. state_abbr TX)."
      },
      "output_mode": {
        "enum": [
          "tal",
          "assignments"
        ],
        "type": "string",
        "title": "Output Mode",
        "default": "tal",
        "description": "tal is the default. assignments returns assignments_artifact plus an authenticated download_url and a key-less share_url; no ts_handle, tal_id, or map_refresh."
      },
      "part_filter": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "text": {
                "type": "object",
                "required": [
                  "value"
                ],
                "properties": {
                  "mode": {
                    "enum": [
                      "prefix",
                      "contains",
                      "exact"
                    ],
                    "type": "string",
                    "default": "prefix"
                  },
                  "field": {
                    "type": "string",
                    "description": "Safe text field to search. Defaults to the public part ID column."
                  },
                  "value": {
                    "type": "string",
                    "minLength": 1
                  },
                  "case_sensitive": {
                    "type": "boolean",
                    "default": false
                  }
                },
                "additionalProperties": false
              },
              "in_tal": {
                "type": "object",
                "required": [
                  "tal_id"
                ],
                "properties": {
                  "tal_id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "ts_handle": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: Territory Solution reference (tsh_...) holding the TAL."
                  },
                  "territory_ids": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1
                    },
                    "minItems": 1,
                    "description": "Narrow to these territory_id values (not display labels); a rollup includes every leaf below it. Unknown ids return UNKNOWN_TERRITORY_ID with available_territory_ids."
                  },
                  "map_session_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: open map session whose Territory Solution holds the TAL."
                  }
                },
                "description": "Keep only the parts assigned to a leaf territory of tal_id: the TAL's whole footprint, however many separate regions it has. ANDed with the other predicates (alone it is exactly that footprint). The TAL must use the same part_layer and hold parts. query_parts needs ts_handle or map_session_id here; builds read the TAL from the build's own Territory Solution.",
                "additionalProperties": false
              },
              "spatial": {
                "type": "object",
                "oneOf": [
                  {
                    "required": [
                      "bbox"
                    ]
                  },
                  {
                    "required": [
                      "geometry"
                    ]
                  }
                ],
                "required": [
                  "operator"
                ],
                "properties": {
                  "bbox": {
                    "type": "array",
                    "items": {
                      "type": "number"
                    },
                    "maxItems": 4,
                    "minItems": 4,
                    "description": "[min_lon, min_lat, max_lon, max_lat] in EPSG:4326."
                  },
                  "geometry": {
                    "type": "object",
                    "description": "GeoJSON Polygon or MultiPolygon in EPSG:4326."
                  },
                  "operator": {
                    "enum": [
                      "intersects",
                      "within",
                      "contains"
                    ],
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "not_in_tal": {
                "type": "object",
                "required": [
                  "tal_id"
                ],
                "properties": {
                  "tal_id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "ts_handle": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: Territory Solution reference (tsh_...) holding the TAL."
                  },
                  "map_session_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: open map session whose Territory Solution holds the TAL."
                  }
                },
                "description": "White space: drop every part assigned to a leaf territory of tal_id from whatever the other predicates select (the whole layer when alone). The TAL must use the same part_layer. query_parts needs ts_handle or map_session_id here; builds read the TAL from the build's own Territory Solution.",
                "additionalProperties": false
              },
              "part_layer": {
                "type": "string"
              },
              "population": {
                "oneOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "eq": {
                        "type": "number"
                      },
                      "gt": {
                        "type": "number"
                      },
                      "lt": {
                        "type": "number"
                      },
                      "gte": {
                        "type": "number"
                      },
                      "lte": {
                        "type": "number"
                      },
                      "between": {
                        "type": "array",
                        "items": {
                          "type": "number"
                        },
                        "maxItems": 2,
                        "minItems": 2
                      }
                    },
                    "minProperties": 1,
                    "additionalProperties": false
                  }
                ]
              },
              "state_abbr": {
                "type": [
                  "string",
                  "array"
                ]
              },
              "county_name": {
                "type": [
                  "string",
                  "array"
                ]
              },
              "selection_task_id": {
                "type": "string",
                "minLength": 1,
                "description": "Builds only (auto_build, account_build, seed_build): a committed request_part_selection task (psel_...) whose part_ids become the scope; it is the only key in that part_filter."
              }
            },
            "minProperties": 1,
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Attribute filter resolved via query_parts (e.g. {\"state_abbr\": \"TX\"}). Implies part_scope explicit. Mutually exclusive with part_ids. An existing TAL's footprint (a new version over the same parts, all its regions): {\"in_tal\": {\"tal_id\": \"tal-1\"}}. White space (parts no TAL covers): add not_in_tal, e.g. {\"state_abbr\": \"TX\", \"not_in_tal\": {\"tal_id\": \"tal-1\"}}; a person-trimmed set is {\"selection_task_id\": \"psel_...\"} after get_part_selection reports committed."
      },
      "point_layer": {
        "type": "string",
        "title": "Point Layer"
      },
      "repair_policy": {
        "enum": [
          "default",
          "strict",
          "report_only"
        ],
        "type": "string",
        "title": "Repair Policy",
        "default": "default",
        "description": "Topology repair for dissolved territories. default fills interior holes in the dissolved geometry (no part is added or reassigned; repair_summary.changed_part_ids lists the territories' own parts). report_only detects holes and changes nothing (warning REPAIR_AVAILABLE). strict fails with REPAIR_REQUIRED when a hole is found."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "seed_attraction": {
        "anyOf": [
          {
            "type": "integer",
            "maximum": 100,
            "minimum": 0
          },
          {
            "type": "null"
          }
        ],
        "title": "Seed Attraction",
        "default": null,
        "description": "0 = providers only pick the start; 100 = each territory stays centered on its provider. Default 70. Needs seed_point_layer."
      },
      "seed_point_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Seed Point Layer",
        "default": null,
        "description": "A second ingested point layer (service providers, offices, rep homes) that seeds the territories; each used provider names its territory."
      },
      "expected_revision": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Revision",
        "default": null
      },
      "visit_frequency_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Visit Frequency Field",
        "default": null,
        "description": "Point column that scales territory workload by visits per cycle. Mutually exclusive with ignore_visit_frequency. Required as use-or-ignore when the point layer declares a visit-frequency column."
      },
      "ignore_visit_frequency": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ignore Visit Frequency",
        "default": null,
        "description": "When true, every account is one visit per cycle. Mutually exclusive with visit_frequency_field. Required as the ignore choice when the point layer declares a visit-frequency column."
      }
    }
  }

  arguments 529 lines copy
• cluster_points auth-required never probed

  Groups the points of one ingested layer into balanced clusters directly, with no ZIP or part layer and no territory alignment. Writes group_field (default group_id) on every point and colors the layer by it, replacing any prior color classification (size and shape channels stay). Needs build_mode (fixed_territory_count or fixed_workload_target), objective, and dwell_time, as in auto_build; a missing one returns CLARIFICATION_REQUIRED with the question. point_filter (e.g. {STATE: FL}) clusters a subset of the layer; unmatched points stay, ungrouped. Max 25,000 points after the filter. seed_point_layer, a second point layer such as technician homes, seeds the groups: with more seeds than groups the best-placed ones are used (seed_summary.unused lists the rest), with fewer the solver adds supplemental seeds in uncovered demand. seed_attraction 0-100 (default 70) is the pull of each seed on its group. Returns a task; the result lists groups with point_count, workload_hours, and point_ids.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324

  {
    "type": "object",
    "title": "cluster_pointsArguments",
    "required": [
      "point_layer"
    ],
    "properties": {
      "objective": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "metric": {
                "type": "string",
                "description": "Point metric column name to balance (e.g. 'Revenue', 'Score'). Required when metric_bias > 0. Account count is count_bias, not a column."
              },
              "count_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on account count (locations per territory). Default 0."
              },
              "metric_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on the metric column."
              },
              "workload_bias": {
                "type": "integer",
                "maximum": 100,
                "minimum": 0,
                "description": "Weight (0..100) on workload (drive time + dwell)."
              }
            },
            "description": "Balance objective: workload_bias + metric_bias + count_bias = 100, weighting workload (drive + dwell), one metric column, and account count. Workload: {workload_bias: 100}. Metric: {metric: '<column>', workload_bias: 0, metric_bias: 100}. Count: {workload_bias: 0, count_bias: 100}. Three-way: {metric: 'Score', workload_bias: 40, metric_bias: 40, count_bias: 20}. Only one metric column balances; combine several into one score column at ingest. Omitted on restructure tools: inherits the source TAL build_provenance objective.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Objective",
        "default": null
      },
      "point_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Point Ids",
        "default": null,
        "description": "Optional point_id / row_id / account_id values to cluster. Unmatched points stay on the layer ungrouped."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "build_mode": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "mode"
            ],
            "properties": {
              "mode": {
                "enum": [
                  "fixed_territory_count",
                  "fixed_workload_target"
                ],
                "type": "string",
                "description": "Sizing mode for clustering."
              },
              "workload_unit": {
                "enum": [
                  "minutes",
                  "hours"
                ],
                "type": "string",
                "default": "hours",
                "description": "Unit for target_workload ('hours' or 'minutes')."
              },
              "target_workload": {
                "type": "number",
                "description": "Target workload per group when mode='fixed_workload_target'.",
                "exclusiveMinimum": 0
              },
              "territory_count": {
                "type": "integer",
                "minimum": 1,
                "description": "Target number of groups when mode='fixed_territory_count'."
              }
            },
            "description": "Sizing mode: {mode: 'fixed_territory_count', territory_count: <int>} or {mode: 'fixed_workload_target', target_workload: <number>, workload_unit: 'hours'|'minutes'}.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Build Mode",
        "default": null
      },
      "dwell_time": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "enum": [
                  "scalar",
                  "field"
                ],
                "type": "string",
                "description": "Dwell source: 'scalar' for a fixed per-visit duration or 'field' for an ingested point column."
              },
              "unit": {
                "enum": [
                  "minutes",
                  "hours"
                ],
                "type": "string",
                "default": "minutes",
                "description": "Time unit for value or field ('minutes' or 'hours')."
              },
              "field": {
                "type": "string",
                "minLength": 1,
                "description": "Point column name holding per-account onsite time when type='field'."
              },
              "value": {
                "type": "number",
                "minimum": 0,
                "description": "Confirmed onsite duration per visit when type='scalar'."
              }
            },
            "description": "Onsite (dwell) time per visit: {type: 'scalar', value: <number>, unit: 'minutes'|'hours'} or {type: 'field', field: '<column>', unit: 'minutes'|'hours'}.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Dwell Time",
        "default": null
      },
      "group_field": {
        "type": "string",
        "title": "Group Field",
        "default": "group_id"
      },
      "point_layer": {
        "type": "string",
        "title": "Point Layer"
      },
      "point_filter": {
        "anyOf": [
          {
            "type": "object",
            "minProperties": 1,
            "additionalProperties": {
              "anyOf": [
                {
                  "type": [
                    "string",
                    "number",
                    "boolean"
                  ]
                },
                {
                  "type": "array",
                  "items": {
                    "type": [
                      "string",
                      "number",
                      "boolean"
                    ]
                  },
                  "minItems": 1
                }
              ]
            }
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Optional property filter on the named point layer. Keys are point properties (equality or IN list). Multiple keys are AND. Example: {\"STATE\": \"FL\"}. Unmatched points stay on the layer ungrouped. part_filter and part_scope are not used here."
      },
      "metric_fields": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "field"
              ],
              "properties": {
                "role": {
                  "type": "string",
                  "description": "Optional semantic role for workload columns. Agents should set visit_frequency or dwell_time when declaring canonical workload inputs."
                },
                "type": {
                  "enum": [
                    "number",
                    "integer",
                    "string",
                    "boolean"
                  ],
                  "type": "string"
                },
                "unit": {
                  "type": "string"
                },
                "field": {
                  "type": "string",
                  "minLength": 1
                },
                "label": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            }
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Metric columns to declare on the point layer (same shape as ingest_accounts metric_fields)."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "seed_attraction": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Seed Attraction",
        "default": null,
        "description": "How hard each group centroid is held at its seed. 100 pins it at the seed; 0 seeds only the starting point and lets the solver drift to the workload centroid. Requires seed_point_layer."
      },
      "seed_point_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Seed Point Layer",
        "default": null,
        "description": "Second ingested point layer whose locations seed the groups (technician homes, depots). Must differ from point_layer. More seeds than groups: the best-placed are used and the rest land in seed_summary.unused. Fewer: the solver adds supplemental seeds in uncovered demand."
      },
      "expected_revision": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Revision",
        "default": null
      },
      "group_label_prefix": {
        "type": "string",
        "title": "Group Label Prefix",
        "default": "Group"
      },
      "visit_frequency_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Visit Frequency Field",
        "default": null
      }
    }
  }

  arguments 324 lines copy
• account_build changes data auth-required never probed

  Builds territories that follow an account column, such as rep name or territory code from CRM: each part goes to the group holding most of its accounts (conflict_policy). Adds a new alignment (TAL). Needs an ingested point_layer, grouping_field, part_layer, and tal_label. Grouping values are labels, not balance metrics. part_scope: bbox_intersect (default; parts near the accounts) or explicit with part_filter, e.g. {state_abbr: TX}; in_tal: {tal_id} keeps only that TAL's parts, not_in_tal: {tal_id} only the parts it leaves uncovered. A declared visit-frequency column needs visit_frequency_field or ignore_visit_frequency (CLARIFICATION_REQUIRED otherwise). With map_session_id the open map is the input. Returns a task; the result carries tal_id and ts_handle. analyze reports the statistics.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372

  {
    "type": "object",
    "title": "account_buildArguments",
    "required": [
      "point_layer"
    ],
    "properties": {
      "part_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Ids",
        "default": null,
        "description": "Explicit part selection set. Implies part_scope explicit. Mutually exclusive with part_filter."
      },
      "tal_label": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Label",
        "default": null
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "part_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Layer",
        "default": null
      },
      "part_scope": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Scope",
        "default": null,
        "description": "Parts eligible for Account Build geography. Default bbox_intersect: all parts intersecting the account-point bounding box. point_matched: only parts containing at least one account (radial seeds only; no FCFS inflate). explicit: part_ids or part_filter (e.g. state_abbr FL). Scope fill uses FCFS adjacency inflate from cluster radial seeds, not national nearest-anchor fill."
      },
      "output_mode": {
        "enum": [
          "tal",
          "assignments"
        ],
        "type": "string",
        "title": "Output Mode",
        "default": "tal",
        "description": "tal is the default. assignments returns assignments_artifact plus an authenticated download_url and a key-less share_url; no ts_handle, tal_id, or map_refresh."
      },
      "part_filter": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "text": {
                "type": "object",
                "required": [
                  "value"
                ],
                "properties": {
                  "mode": {
                    "enum": [
                      "prefix",
                      "contains",
                      "exact"
                    ],
                    "type": "string",
                    "default": "prefix"
                  },
                  "field": {
                    "type": "string",
                    "description": "Safe text field to search. Defaults to the public part ID column."
                  },
                  "value": {
                    "type": "string",
                    "minLength": 1
                  },
                  "case_sensitive": {
                    "type": "boolean",
                    "default": false
                  }
                },
                "additionalProperties": false
              },
              "in_tal": {
                "type": "object",
                "required": [
                  "tal_id"
                ],
                "properties": {
                  "tal_id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "ts_handle": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: Territory Solution reference (tsh_...) holding the TAL."
                  },
                  "territory_ids": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1
                    },
                    "minItems": 1,
                    "description": "Narrow to these territory_id values (not display labels); a rollup includes every leaf below it. Unknown ids return UNKNOWN_TERRITORY_ID with available_territory_ids."
                  },
                  "map_session_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: open map session whose Territory Solution holds the TAL."
                  }
                },
                "description": "Keep only the parts assigned to a leaf territory of tal_id: the TAL's whole footprint, however many separate regions it has. ANDed with the other predicates (alone it is exactly that footprint). The TAL must use the same part_layer and hold parts. query_parts needs ts_handle or map_session_id here; builds read the TAL from the build's own Territory Solution.",
                "additionalProperties": false
              },
              "spatial": {
                "type": "object",
                "oneOf": [
                  {
                    "required": [
                      "bbox"
                    ]
                  },
                  {
                    "required": [
                      "geometry"
                    ]
                  }
                ],
                "required": [
                  "operator"
                ],
                "properties": {
                  "bbox": {
                    "type": "array",
                    "items": {
                      "type": "number"
                    },
                    "maxItems": 4,
                    "minItems": 4,
                    "description": "[min_lon, min_lat, max_lon, max_lat] in EPSG:4326."
                  },
                  "geometry": {
                    "type": "object",
                    "description": "GeoJSON Polygon or MultiPolygon in EPSG:4326."
                  },
                  "operator": {
                    "enum": [
                      "intersects",
                      "within",
                      "contains"
                    ],
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "not_in_tal": {
                "type": "object",
                "required": [
                  "tal_id"
                ],
                "properties": {
                  "tal_id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "ts_handle": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: Territory Solution reference (tsh_...) holding the TAL."
                  },
                  "map_session_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: open map session whose Territory Solution holds the TAL."
                  }
                },
                "description": "White space: drop every part assigned to a leaf territory of tal_id from whatever the other predicates select (the whole layer when alone). The TAL must use the same part_layer. query_parts needs ts_handle or map_session_id here; builds read the TAL from the build's own Territory Solution.",
                "additionalProperties": false
              },
              "part_layer": {
                "type": "string"
              },
              "population": {
                "oneOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "eq": {
                        "type": "number"
                      },
                      "gt": {
                        "type": "number"
                      },
                      "lt": {
                        "type": "number"
                      },
                      "gte": {
                        "type": "number"
                      },
                      "lte": {
                        "type": "number"
                      },
                      "between": {
                        "type": "array",
                        "items": {
                          "type": "number"
                        },
                        "maxItems": 2,
                        "minItems": 2
                      }
                    },
                    "minProperties": 1,
                    "additionalProperties": false
                  }
                ]
              },
              "state_abbr": {
                "type": [
                  "string",
                  "array"
                ]
              },
              "county_name": {
                "type": [
                  "string",
                  "array"
                ]
              },
              "selection_task_id": {
                "type": "string",
                "minLength": 1,
                "description": "Builds only (auto_build, account_build, seed_build): a committed request_part_selection task (psel_...) whose part_ids become the scope; it is the only key in that part_filter."
              }
            },
            "minProperties": 1,
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Attribute filter resolved via query_parts (e.g. {\"state_abbr\": [\"FL\", \"GA\"]}). Implies part_scope explicit. Mutually exclusive with part_ids. An existing TAL's footprint (a new version over the same parts, all its regions): {\"in_tal\": {\"tal_id\": \"tal-1\"}}. White space (parts no TAL covers): add not_in_tal, e.g. {\"state_abbr\": \"TX\", \"not_in_tal\": {\"tal_id\": \"tal-1\"}}; a person-trimmed set is {\"selection_task_id\": \"psel_...\"} after get_part_selection reports committed."
      },
      "point_layer": {
        "type": "string",
        "title": "Point Layer"
      },
      "repair_policy": {
        "enum": [
          "default",
          "strict",
          "report_only"
        ],
        "type": "string",
        "title": "Repair Policy",
        "default": "default",
        "description": "Topology repair for dissolved territories. default fills interior holes in the dissolved geometry (no part is added or reassigned; repair_summary.changed_part_ids lists the territories' own parts). report_only detects holes and changes nothing (warning REPAIR_AVAILABLE). strict fails with REPAIR_REQUIRED when a hole is found."
      },
      "grouping_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Grouping Field",
        "default": null,
        "description": "Point feature property treated as a grouping label even when numeric."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "conflict_policy": {
        "type": "string",
        "title": "Conflict Policy",
        "default": "plurality_account_count",
        "description": "When accounts in one part map to multiple grouping labels, assign the part to the label with the highest account count; ties break by deterministic label sort."
      },
      "expected_revision": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Revision",
        "default": null
      },
      "visit_frequency_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Visit Frequency Field",
        "default": null,
        "description": "Point column that scales territory workload by visits per cycle. Mutually exclusive with ignore_visit_frequency."
      },
      "ignore_visit_frequency": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ignore Visit Frequency",
        "default": null,
        "description": "When true, every account is one visit per cycle. Mutually exclusive with visit_frequency_field."
      }
    }
  }

  arguments 372 lines copy
• analyze reads auth-required never probed

  Computes territory statistics for one or more alignments, i.e. how balanced the territories are and how alignments compare: account counts, declared metric totals (e.g. Revenue), workload hours, balance scores, and cross-TAL comparison; hypothetical_moves previews a realign. Input: map_session_id (the open map as it is now), ts_handle, or a completed build job_id (pass tal_ids when several TALs exist). metrics: omit for every declared column, or name them; workload and account_count are always available. Workload needs dwell (dwell_time, the build's recorded dwell, or the layer's dwell_time_field); without it the result has every other statistic, no workload, and workload_omitted.ask_user to put to the user. analysis_panel=single with map_session_id fills the map dock (analysis_panel.status=pushed). Territory account_count, metric_totals, workload_total (minutes), and the dock grid cover accounts_point_layer (build point_layer), never seed, contractor, or visit layers; point_counts_by_layer counts every layer. Drive-time alignments count accounts inside each polygon. Returns a task.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252

  {
    "type": "object",
    "title": "analyzeArguments",
    "properties": {
      "scope": {
        "anyOf": [
          {
            "type": "object",
            "title": "Optional Scope Constraint",
            "properties": {
              "part_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "minItems": 1,
                "description": "Restrict analysis to these part IDs, e.g. a map selection."
              },
              "territory_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "minItems": 1,
                "description": "Restrict analysis to these territory IDs within each TAL."
              }
            },
            "additionalProperties": false
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Optional — restrict analysis to a subset of parts or territories."
      },
      "job_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Job Id",
        "default": null,
        "description": "task_id (same value as job_id) of a completed build or ingest task; its Territory Solution is the input."
      },
      "metrics": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Metrics",
        "default": null,
        "description": "Data field names to aggregate per territory. If omitted, server returns all available metrics."
      },
      "tal_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Ids",
        "default": null,
        "description": "TAL IDs to analyze. Defaults to the active TAL when unambiguous."
      },
      "max_depth": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Max Depth",
        "default": null,
        "description": "Optional. For hierarchical TALs, return rollup metrics only up to this depth level. Without it, every level is returned."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "dwell_time": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "enum": [
                  "scalar",
                  "field"
                ],
                "type": "string",
                "description": "Dwell source: 'scalar' for a fixed per-visit duration or 'field' for an ingested point column."
              },
              "unit": {
                "enum": [
                  "minutes",
                  "hours"
                ],
                "type": "string",
                "default": "minutes",
                "description": "Time unit for value or field ('minutes' or 'hours')."
              },
              "field": {
                "type": "string",
                "minLength": 1,
                "description": "Point column name holding per-account onsite time when type='field'."
              },
              "value": {
                "type": "number",
                "minimum": 0,
                "description": "Confirmed onsite duration per visit when type='scalar'."
              }
            },
            "description": "Onsite (dwell) time per visit: {type: 'scalar', value: <number>, unit: 'minutes'|'hours'} or {type: 'field', field: '<column>', unit: 'minutes'|'hours'}.",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Dwell Time",
        "default": null
      },
      "part_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Layer",
        "default": null,
        "description": "Part layer name. Required when not inferable from the TAL(s). Not used for a drive-time (isochrone) TAL, which is measured by polygon."
      },
      "compare_tals": {
        "type": "boolean",
        "title": "Compare Tals",
        "default": false,
        "description": "When true and multiple tal_ids supplied, include a cross-TAL comparison section."
      },
      "analysis_panel": {
        "anyOf": [
          {
            "enum": [
              "none",
              "single",
              "comparison_slot"
            ],
            "type": "string",
            "description": "single fills the open map's analysis dock with this result (needs map_session_id). The dock shows one alignment at a time: with several tal_ids each TAL gets its own dock entry and the dock follows the map's active TAL. comparison_slot does the same and also returns cross_tal_comparison. none or omitted pushes nothing."
          },
          {
            "type": "null"
          }
        ],
        "title": "Analysis Panel",
        "default": null
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "hypothetical_moves": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "title": "Hypothetical Part-Move for Impact Analysis",
              "required": [
                "part_id",
                "to_territory_id"
              ],
              "properties": {
                "part_id": {
                  "type": "string",
                  "minLength": 1
                },
                "to_territory_id": {
                  "type": "string",
                  "minLength": 1
                },
                "from_territory_id": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            }
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Optional. Compute impact of these hypothetical part moves without persisting any change."
      },
      "visit_frequency_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Visit Frequency Field",
        "default": null,
        "description": "Optional visit-frequency point column override for workload recompute."
      }
    }
  }

  arguments 252 lines copy
• ingest_accounts auth-required never probed

  Account ingest: loads account rows (CRM records, a CSV, a spreadsheet) as point data on a named point layer of the Territory Solution, to add them to the map, geocoding rows without coordinates. Rows come only as accounts_handle from request_account_upload (a file, csv_text, or rows; 100,000-row cap); its suggested_ingest carries these args. latitude/lat and longitude/lon/lng pass through; other names need latitude_field/longitude_field, and unused coordinate-like columns return CLARIFICATION_REQUIRED (needs_coordinate_fields). id_field is a unique key (default row_id); duplicates return needs_unique_row_id. Only declared columns are kept: metric_fields, workload_fields, dwell_time_field, visit_frequency_field, grouping_fields, display_fields, search_fields; to load a contractor list, layer_role=contractors adds trade_field, tier_field, capacity_field, service_zip_field (analyze_network_coverage). Later use of an undeclared column returns UNDECLARED_FIELD. Over geocode quota fails it whole; a bad address bills once (fix it to retry). Returns a task with failed_rows and map_refresh.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353

  {
    "type": "object",
    "$defs": {
      "RepoShape1": {
        "type": "object",
        "required": [
          "field"
        ],
        "properties": {
          "role": {
            "type": "string",
            "description": "Optional semantic role for workload columns. Agents should set visit_frequency or dwell_time when declaring canonical workload inputs."
          },
          "type": {
            "enum": [
              "number",
              "integer",
              "string",
              "boolean"
            ],
            "type": "string"
          },
          "unit": {
            "type": "string"
          },
          "field": {
            "type": "string",
            "minLength": 1
          },
          "label": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "title": "ingest_accountsArguments",
    "properties": {
      "label": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Label",
        "default": null,
        "description": "Legend name for the point layer. Omitted: the point_layer id in title case (accounts is 'Accounts', schools_conus is 'Schools Conus')."
      },
      "id_field": {
        "type": "string",
        "title": "Id Field",
        "default": "row_id",
        "description": "Unique business key column. Duplicated label/name columns fail with blocked_by=needs_unique_row_id. With the default row_id and no unique column, the server synthesizes row-1, row-2, … when that column is absent."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "use_cache": {
        "type": "boolean",
        "title": "Use Cache",
        "default": true,
        "description": "Admin keys only (debug/testing); a customer key gets ADMIN_REQUIRED. Leave true. False skips both geocode caches and bills a provider lookup for every address."
      },
      "layer_role": {
        "anyOf": [
          {
            "enum": [
              "accounts",
              "contractors"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Layer Role",
        "default": null,
        "description": "contractors marks the supply side of a service network (contractor, vendor, service provider) for analyze_network_coverage."
      },
      "tier_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tier Field",
        "default": null,
        "description": "Contractor column holding the network tier (e.g. Preferred). Retained like a declared column."
      },
      "label_field": {
        "type": "string",
        "title": "Label Field",
        "default": "label"
      },
      "point_layer": {
        "type": "string",
        "title": "Point Layer",
        "default": "accounts"
      },
      "region_hint": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Region Hint",
        "default": null
      },
      "trade_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Trade Field",
        "default": null,
        "description": "Contractor column naming the trade(s) served (e.g. HVAC; comma-separated for several). Retained like a declared column."
      },
      "country_hint": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Country Hint",
        "default": null
      },
      "metric_fields": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "$ref": "#/$defs/RepoShape1"
            },
            "default": []
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Agent-confirmed business metric columns (for example revenue, sales, units) to persist on point-layer metadata for downstream build/analyze tools."
      },
      "search_fields": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Search Fields",
        "default": null,
        "description": "Declared columns searchable in the Map Component. Undeclared columns are discarded at ingest and later operations on them fail with UNDECLARED_FIELD."
      },
      "capacity_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Capacity Field",
        "default": null,
        "description": "Numeric contractor column holding capacity (e.g. jobs per month). Retained like a declared column."
      },
      "display_fields": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Display Fields",
        "default": null,
        "description": "Declared columns shown in Map Component point callouts. Undeclared columns are discarded at ingest and later operations on them fail with UNDECLARED_FIELD."
      },
      "latitude_field": {
        "type": "string",
        "title": "Latitude Field",
        "default": "latitude",
        "description": "Latitude column. Defaults accept case-insensitive GIS aliases latitude/lat (including LAT). Override for non-standard headers (e.g. Address 1: Latitude). Explicit values win over aliases."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "min_confidence": {
        "type": "number",
        "title": "Min Confidence",
        "default": 0
      },
      "accounts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Accounts Handle",
        "default": null,
        "description": "Required. upload_handle (aup_...) from request_account_upload. Single-use: ingest claims it."
      },
      "force_regeocode": {
        "type": "boolean",
        "title": "Force Regeocode",
        "default": false,
        "description": "Admin keys only (debug/testing); a customer key gets ADMIN_REQUIRED. Leave false. True geocodes rows that already have coordinates, billing each one."
      },
      "grouping_fields": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Grouping Fields",
        "default": null,
        "description": "Declared columns used to group accounts (e.g. account_build grouping_field candidates). Declared fields are the retention contract: the compact TS keeps only id, coordinates, label, and declared fields; undeclared columns are discarded at ingest."
      },
      "longitude_field": {
        "type": "string",
        "title": "Longitude Field",
        "default": "longitude",
        "description": "Longitude column. Defaults accept case-insensitive GIS aliases longitude/lon/lng/long (including LON). Override for non-standard headers. Explicit values win over aliases."
      },
      "workload_fields": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "$ref": "#/$defs/RepoShape1"
            },
            "default": []
          },
          {
            "type": "null"
          }
        ],
        "default": null
      },
      "dwell_time_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Dwell Time Field",
        "default": null,
        "description": "Canonical per-account dwell column on point features. Pair with workload_fields unit metadata when values are in hours."
      },
      "replace_existing": {
        "type": "boolean",
        "title": "Replace Existing",
        "default": false,
        "description": "When true, replaces an existing point layer with the same point_layer id in place. Default false returns POINT_LAYER_EXISTS when the layer already exists."
      },
      "service_zip_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Service Zip Field",
        "default": null,
        "description": "Contractor column listing served ZIPs, comma-separated, for coverage.rule=zip_list. Retained like a declared column."
      },
      "retry_bad_geocodes": {
        "type": "boolean",
        "title": "Retry Bad Geocodes",
        "default": false,
        "description": "Admin keys only (debug/testing); a customer key gets ADMIN_REQUIRED. Leave false. True re-asks the provider, billed, for the same address text whose cached verdict is no-match or suboptimal. A corrected address needs no flag: it is a new lookup."
      },
      "visit_frequency_field": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Visit Frequency Field",
        "default": null,
        "description": "Canonical numeric visits-per-cycle column on point features. Agent-resolved; MCP validates presence and persists on point-layer metadata. Without one, MCP defaults each account to one visit per cycle."
      },
      "accept_suboptimal_geocodes": {
        "type": "boolean",
        "title": "Accept Suboptimal Geocodes",
        "default": true,
        "description": "When true (default for ingest), accept provider suboptimal geocodes (e.g. ZIP centroids) so address-only rows become points. Set false to require optimal/point-address matches only."
      }
    }
  }

  arguments 353 lines copy
• geocode_address auth-required never probed

  Geocode-only pass: turns staged customer addresses into coordinates with match confidence, without loading a map layer. The rows are staged with request_account_upload (file, csv_text, or rows; up to 10,000 rows here) and passed as its upload_handle; the handle is not claimed, so ingest_accounts can load the same rows afterward. Accepts address/address_line1/street, city, state, and postal columns (common source headers are mapped). accept_suboptimal_geocodes=true accepts ZIP-centroid matches. Each address is billed once: cached no-match and suboptimal verdicts return free (failed_rows cached_verdict); a corrected address is a new lookup. Billable lookups count against a monthly per-key quota, and past it the result is PROVIDER_QUOTA_EXCEEDED with limit, used, remaining, and period_resets_at. Returns a task; the result has summary, sample_rows (10), failed_rows (first 50), a geocoded_rows_artifact with share_url for every row, and suggested_ingest. ingest_accounts alone also geocodes while it loads the map layer.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980

  {
    "type": "object",
    "title": "geocode_addressArguments",
    "required": [
      "upload_handle"
    ],
    "properties": {
      "use_cache": {
        "type": "boolean",
        "title": "Use Cache",
        "default": true,
        "description": "Admin keys only (debug/testing); a customer key gets ADMIN_REQUIRED. Leave true. False skips both geocode caches and bills a provider lookup for every address."
      },
      "region_hint": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Region Hint",
        "default": null
      },
      "country_hint": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Country Hint",
        "default": null
      },
      "upload_handle": {
        "type": "string",
        "title": "Upload Handle",
        "description": "upload_handle (aup_...) from request_account_upload holding the address rows. Not claimed: ingest_accounts can reuse it."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "min_confidence": {
        "type": "number",
        "title": "Min Confidence",
        "default": 0
      },
      "force_regeocode": {
        "type": "boolean",
        "title": "Force Regeocode",
        "default": false,
        "description": "Admin keys only (debug/testing); a customer key gets ADMIN_REQUIRED. Leave false. True geocodes rows that already have coordinates, billing each one."
      },
      "retry_bad_geocodes": {
        "type": "boolean",
        "title": "Retry Bad Geocodes",
        "default": false,
        "description": "Admin keys only (debug/testing); a customer key gets ADMIN_REQUIRED. Leave false. True re-asks the provider, billed, for the same address text whose cached verdict is no-match or suboptimal. A corrected address needs no flag: it is a new lookup."
      },
      "accept_suboptimal_geocodes": {
        "type": "boolean",
        "title": "Accept Suboptimal Geocodes",
        "default": false,
        "description": "When true, accept suboptimal geocodes (e.g. ZIP centroids). Default false so geocode-only workflows surface NO_OPTIMAL_GEOCODE for human review."
      }
    }
  }

  arguments 80 lines copy
• seed_build auth-required never probed

  Grows one territory outward from a seed {longitude, latitude} over a part layer until it holds a target: {type: location_count, value: N} or {type: metric_sum, field: <declared metric>, value: X}, counted from an ingested point layer. Adds the territory as a leaf of tal_id, or as a new alignment. Fit is closest: target_status is reached, closest_under, closest_over, frontier_exhausted, or max_parts_reached, with SEED_TARGET_UNDERSHOT/OVERSHOT warnings and the difference. Parts already in that alignment are never taken; the territory grows around them (blocked_part_count, seed_offset_km), and a seed inside an assigned part returns SEED_PART_ASSIGNED. part_scope=explicit with part_filter confines growth to an area (not_in_tal: {tal_id} keeps it out of another TAL; in_tal: {tal_id} keeps it inside one, with no tal_id so it starts a new alignment). One seed per call. An undeclared metric field returns UNDECLARED_FIELD. Returns a task with created_territory and ts_handle; the open map repaints with map_session_id.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420

  {
    "type": "object",
    "title": "seed_buildArguments",
    "required": [
      "seed",
      "target"
    ],
    "properties": {
      "seed": {
        "type": "object",
        "required": [
          "longitude",
          "latitude"
        ],
        "properties": {
          "latitude": {
            "type": "number",
            "maximum": 90,
            "minimum": -90
          },
          "longitude": {
            "type": "number",
            "maximum": 180,
            "minimum": -180
          }
        },
        "description": "Where growth starts. For an address or POI, stage it as one row with request_account_upload, then geocode_address(upload_handle); a map click already gives coordinates.",
        "additionalProperties": false
      },
      "tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Id",
        "default": null,
        "description": "Existing TAL to append the new leaf to. Parts already assigned to any leaf of this TAL are never taken (the territory drifts instead). Without it, a new TAL is created."
      },
      "target": {
        "if": {
          "properties": {
            "type": {
              "const": "metric_sum"
            }
          }
        },
        "then": {
          "required": [
            "field"
          ]
        },
        "type": "object",
        "required": [
          "type",
          "value"
        ],
        "properties": {
          "type": {
            "enum": [
              "location_count",
              "metric_sum"
            ],
            "type": "string",
            "description": "location_count counts points in the point layer; metric_sum sums a declared numeric metric column."
          },
          "field": {
            "type": "string",
            "minLength": 1,
            "description": "Required for metric_sum. Must be a column declared in metric_fields (or workload_fields) at ingest; otherwise UNDECLARED_FIELD."
          },
          "value": {
            "type": "number",
            "description": "Target count or target sum.",
            "exclusiveMinimum": 0
          }
        },
        "description": "What the territory grows toward. Fit is closest: |achieved - value| is minimized, so the result may land slightly under or over.",
        "additionalProperties": false
      },
      "user_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "User Id",
        "default": null,
        "description": "Stable per-user label for usage and queue ordering."
      },
      "part_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Ids",
        "default": null,
        "description": "Explicit eligible part set. Implies part_scope explicit. Mutually exclusive with part_filter."
      },
      "max_parts": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Max Parts",
        "default": null,
        "description": "Safety cap on parts in the grown territory. Reaching it stops growth with target_status max_parts_reached."
      },
      "tal_label": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Tal Label",
        "default": null,
        "description": "Display name for the new TAL when tal_id is omitted. Ignored when tal_id is given."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "part_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Layer",
        "default": null,
        "description": "Part layer to grow over, e.g. us_zips (ezt://part-layers). Required unless tal_id names a TAL that already has one; must match that TAL's layer when both are given."
      },
      "part_scope": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Scope",
        "default": null,
        "description": "Growth reads only the seed's neighbourhood (rings outward from the seed part), so this is an allowlist switch, not a performance prerequisite. explicit: confine growth to part_ids or part_filter (e.g. state_abbr TX) when the user wants the territory bounded by that geography. bbox_intersect / point_matched are accepted for compatibility with auto_build and ignored — seed_build never joins the whole point layer to the bbox parts."
      },
      "part_filter": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "text": {
                "type": "object",
                "required": [
                  "value"
                ],
                "properties": {
                  "mode": {
                    "enum": [
                      "prefix",
                      "contains",
                      "exact"
                    ],
                    "type": "string",
                    "default": "prefix"
                  },
                  "field": {
                    "type": "string",
                    "description": "Safe text field to search. Defaults to the public part ID column."
                  },
                  "value": {
                    "type": "string",
                    "minLength": 1
                  },
                  "case_sensitive": {
                    "type": "boolean",
                    "default": false
                  }
                },
                "additionalProperties": false
              },
              "in_tal": {
                "type": "object",
                "required": [
                  "tal_id"
                ],
                "properties": {
                  "tal_id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "ts_handle": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: Territory Solution reference (tsh_...) holding the TAL."
                  },
                  "territory_ids": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1
                    },
                    "minItems": 1,
                    "description": "Narrow to these territory_id values (not display labels); a rollup includes every leaf below it. Unknown ids return UNKNOWN_TERRITORY_ID with available_territory_ids."
                  },
                  "map_session_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: open map session whose Territory Solution holds the TAL."
                  }
                },
                "description": "Keep only the parts assigned to a leaf territory of tal_id: the TAL's whole footprint, however many separate regions it has. ANDed with the other predicates (alone it is exactly that footprint). The TAL must use the same part_layer and hold parts. query_parts needs ts_handle or map_session_id here; builds read the TAL from the build's own Territory Solution.",
                "additionalProperties": false
              },
              "spatial": {
                "type": "object",
                "oneOf": [
                  {
                    "required": [
                      "bbox"
                    ]
                  },
                  {
                    "required": [
                      "geometry"
                    ]
                  }
                ],
                "required": [
                  "operator"
                ],
                "properties": {
                  "bbox": {
                    "type": "array",
                    "items": {
                      "type": "number"
                    },
                    "maxItems": 4,
                    "minItems": 4,
                    "description": "[min_lon, min_lat, max_lon, max_lat] in EPSG:4326."
                  },
                  "geometry": {
                    "type": "object",
                    "description": "GeoJSON Polygon or MultiPolygon in EPSG:4326."
                  },
                  "operator": {
                    "enum": [
                      "intersects",
                      "within",
                      "contains"
                    ],
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "not_in_tal": {
                "type": "object",
                "required": [
                  "tal_id"
                ],
                "properties": {
                  "tal_id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "ts_handle": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: Territory Solution reference (tsh_...) holding the TAL."
                  },
                  "map_session_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "query_parts only: open map session whose Territory Solution holds the TAL."
                  }
                },
                "description": "White space: drop every part assigned to a leaf territory of tal_id from whatever the other predicates select (the whole layer when alone). The TAL must use the same part_layer. query_parts needs ts_handle or map_session_id here; builds read the TAL from the build's own Territory Solution.",
                "additionalProperties": false
              },
              "part_layer": {
                "type": "string"
              },
              "population": {
                "oneOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "eq": {
                        "type": "number"
                      },
                      "gt": {
                        "type": "number"
                      },
                      "lt": {
                        "type": "number"
                      },
                      "gte": {
                        "type": "number"
                      },
                      "lte": {
                        "type": "number"
                      },
                      "between": {
                        "type": "array",
                        "items": {
                          "type": "number"
                        },
                        "maxItems": 2,
                        "minItems": 2
                      }
                    },
                    "minProperties": 1,
                    "additionalProperties": false
                  }
                ]
              },
              "state_abbr": {
                "type": [
                  "string",
                  "array"
                ]
              },
              "county_name": {
                "type": [
                  "string",
                  "array"
                ]
              },
              "selection_task_id": {
                "type": "string",
                "minLength": 1,
                "description": "Builds only (auto_build, account_build, seed_build): a committed request_part_selection task (psel_...) whose part_ids become the scope; it is the only key in that part_filter."
              }
            },
            "minProperties": 1,
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Attribute filter resolved via query_parts (e.g. {\"state_abbr\": \"TX\"}). Implies part_scope explicit. Mutually exclusive with part_ids. Inside an existing TAL's footprint: {\"in_tal\": {\"tal_id\": \"tal-1\"}} with no seed tal_id (in_tal of the seed's own tal_id is INVALID_REQUEST). White space (parts no TAL covers): add not_in_tal, e.g. {\"state_abbr\": \"TX\", \"not_in_tal\": {\"tal_id\": \"tal-1\"}}; a person-trimmed set is {\"selection_task_id\": \"psel_...\"} after get_part_selection reports committed."
      },
      "point_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Point Layer",
        "default": null,
        "description": "Ingested point layer whose locations are counted or summed. Required when the TS has more than one point layer."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "territory_name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Territory Name",
        "default": null,
        "description": "Display name for the new leaf. Defaults to the next free \"Territory N\" in the TAL. Must be unique within the TAL."
      }
    }
  }

  arguments 420 lines copy
• configure_map auth-required never probed

  Updates map settings on the Territory Solution and refreshes the live map: project_name (map heading), theme (dark | light basemap and UI style), loaded_part_layers ([] hides ZIP/part outlines; builds never load them), active_part_layer, active_tal_id, center and zoom (default view; the live map jumps there), and point symbology. point_layer_classifications entries are {point_layer, field, method: quantile | equal_interval | categorical | manual, class_count 2-12, channel: color | size | shape, optional colors/sizes/shapes/style}; the server computes the breaks and returns per-class counts. One classification per channel per layer; clear:true removes one. Shapes cover role icons and all Designer symbols (circle, ring, square, triangle, triangle_down, diamond, star, star4, star6, star8, cross, house, pin, pin_solid, square_pin, flag, hexagon, pentagon, shield, arrow_up, building, tower, person, vehicle, gear, paint_swath, plus *_open variants). classification without point_layer is a project-level setting that does not color points. Input: map_session_id (the live map) or ts_handle.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383

  {
    "type": "object",
    "title": "configure_mapArguments",
    "properties": {
      "zoom": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Zoom",
        "default": null,
        "description": "Default MapLibre zoom (0-24). Persists to map_config.zoom. An open MC jumps when this request includes center and/or zoom."
      },
      "theme": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Theme",
        "default": null,
        "description": "Map Component basemap and UI theme ('dark' or 'light'; default 'dark'). Persists to ts.properties.map_config.theme and repaints the open map session live."
      },
      "center": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Center",
        "default": null,
        "description": "Default camera center as GeoJSON/MapLibre [longitude, latitude]. Persists to map_config.center. An open MC jumps when this request includes center and/or zoom; later config_changed events without those fields leave the camera where it is."
      },
      "ts_handle": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ts Handle",
        "default": null,
        "description": "Territory Solution reference (tsh_...) from a build, ingest_accounts, import_geojson, import_designer_project, or get_map_visualization; Territory Solutions are not accepted inline."
      },
      "presentation": {
        "anyOf": [
          {
            "type": "object",
            "title": "Optional Presentation View/Style Context",
            "properties": {
              "theme": {
                "enum": [
                  "dark",
                  "light"
                ],
                "type": "string",
                "description": "Map Component basemap and UI theme ('dark' or 'light'; default 'dark'). Also accepted at top-level theme or presentation.style_overrides.theme."
              },
              "view_name": {
                "enum": [
                  "empty",
                  "points_only",
                  "review",
                  "selection"
                ],
                "type": "string",
                "description": "Built-in presentation template. Defaults: select mode → selection; empty project → empty; points-only TS → points_only; TAL/review → review. Diagnostics use presentation.debug_panel (or style_overrides.debug_panel), not a separate template."
              },
              "debug_panel": {
                "type": "boolean",
                "description": "Per-request debug modifier. When true, the MC #debug block shows session/mode/TAL/revision/zoom diagnostics and per-row legend meta. It replaces a custom QA template."
              },
              "style_overrides": {
                "type": "object",
                "description": "Optional style hints forwarded to the MC renderer (may include theme: 'dark' | 'light' or debug_panel).",
                "additionalProperties": true
              }
            },
            "additionalProperties": false
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Named presentation context stored on map_config and restored when the TS opens."
      },
      "project_name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Name",
        "default": null,
        "description": "First-class Territory Solution short name shown as the Map Component panel title. Persists to ts.properties.map_config.project_name; when an MC session is open for this TS, configure_map pushes config_changed so the title refreshes without reopening the map."
      },
      "active_tal_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Active Tal Id",
        "default": null,
        "description": "Durable active alignment restored when the Territory Solution opens."
      },
      "classification": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "bins": {
                "type": "integer",
                "minimum": 1
              },
              "breaks": {
                "type": "array",
                "items": {
                  "type": "number"
                }
              },
              "colors": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "labels": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "method": {
                "type": "string",
                "minLength": 1
              },
              "metric": {
                "type": "string",
                "minLength": 1
              }
            },
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Project-level map_config classification (e.g. primary metric context for selection-impact preview). It leaves point colors unchanged; a patch naming a point_layer is routed to point_layer_classifications with a warning."
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "merge_strategy": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Merge Strategy",
        "default": null
      },
      "active_part_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Active Part Layer",
        "default": null
      },
      "expected_revision": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Revision",
        "default": null
      },
      "loaded_part_layers": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Loaded Part Layers",
        "default": null
      },
      "expected_content_hash": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Expected Content Hash",
        "default": null
      },
      "point_layer_classifications": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "point_layer"
              ],
              "properties": {
                "clear": {
                  "type": "boolean",
                  "description": "When true, remove this channel's classification and leave the other channels and the base style. field is not required. Group colors stored on classification are removed when that object is this channel."
                },
                "field": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Point property to classify. Required unless the entry only patches style."
                },
                "label": {
                  "type": "string",
                  "minLength": 1
                },
                "sizes": {
                  "type": "array",
                  "items": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  }
                },
                "style": {
                  "type": "object",
                  "properties": {
                    "size": {
                      "type": "number",
                      "exclusiveMinimum": 0
                    },
                    "color": {
                      "type": "string",
                      "minLength": 1
                    },
                    "shape": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Point symbol from the MC catalog: circle|ring|square|square_open|triangle|triangle_open|triangle_down|triangle_down_open|diamond|diamond_open|star|star4|star6|star8|cross|house|pin|pin_solid|square_pin|square_pin_solid|flag|hexagon|pentagon|shield|arrow_up|building|tower|person|vehicle|gear|paint_swath."
                    },
                    "opacity": {
                      "type": "number",
                      "maximum": 1,
                      "minimum": 0
                    }
                  },
                  "description": "Base point symbol for the layer, merged over any existing style. Gives two point layers distinct colors.",
                  "additionalProperties": true
                },
                "colors": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  },
                  "description": "Optional explicit color ramp for the color channel; defaults to the shared MC palette."
                },
                "method": {
                  "enum": [
                    "quantile",
                    "equal_interval",
                    "categorical",
                    "manual"
                  ],
                  "type": "string",
                  "description": "Defaults to quantile when every value is numeric, categorical otherwise; manual when classes are supplied."
                },
                "shapes": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  },
                  "description": "Required for the shape channel unless every manual class carries a shape. Catalog: circle, ring, square, square_open, triangle, triangle_open, triangle_down, triangle_down_open, diamond, diamond_open, star, star4, star6, star8, cross, house, pin, pin_solid, square_pin, square_pin_solid, flag, hexagon, pentagon, shield, arrow_up, building, tower, person, vehicle, gear, paint_swath (Designer and role aliases such as user/rep, residence, warehouse, truck, circle2, invertedTriangle, superstar also work)."
                },
                "channel": {
                  "enum": [
                    "color",
                    "size",
                    "shape"
                  ],
                  "type": "string",
                  "default": "color"
                },
                "classes": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "description": "Manual breaks. Each class needs value/values (categorical) or min/max (range) plus the channel value."
                },
                "max_size": {
                  "type": "number",
                  "exclusiveMinimum": 0
                },
                "min_size": {
                  "type": "number",
                  "exclusiveMinimum": 0
                },
                "filterable": {
                  "type": "boolean",
                  "default": true
                },
                "class_count": {
                  "type": "integer",
                  "default": 5,
                  "maximum": 12,
                  "minimum": 2
                },
                "point_layer": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Target point layer id from ts.properties.point_layers or ingest_accounts."
                }
              },
              "additionalProperties": true
            }
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Applied point-layer symbology. The server computes breaks from the in-session point features, writes ts.properties.point_layers[].<channel>_classification, and pushes config_changed so an open MC repaints. One entry per layer/channel."
      }
    }
  }

  arguments 383 lines copy
• import_designer_project auth-required never probed

  Opens an EasyTerritory Designer project as a Territory Solution: the server exports it from Designer and imports it (part-based territories, non-part polygon areas such as radius buffers or hand-drawn shapes, point layers up to 250,000 features with Designer symbols/classifications, and routes). No file passes through the agent. Returns a task; the result has ts_handle and designer_warnings. With map_session_id the project replaces the open map's content. include_points / point_layers / include_routes / include_manual_polygons narrow it; part_layer forces the part layer. A Designer part layer is mapped to its EZT part layer id (listed in designer_warnings); one with no EZT match fails UNKNOWN_PART_LAYER with available_part_layers; retry with the user's choice as part_layer. Requires link_designer; project_id comes from list_designer_projects.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869

  {
    "type": "object",
    "title": "import_designer_projectArguments",
    "required": [
      "project_id"
    ],
    "properties": {
      "part_layer": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Part Layer",
        "default": null
      },
      "project_id": {
        "type": "string",
        "title": "Project Id",
        "description": "Designer project id from list_designer_projects."
      },
      "point_layers": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Point Layers",
        "default": null
      },
      "include_points": {
        "type": "boolean",
        "title": "Include Points",
        "default": true
      },
      "include_routes": {
        "type": "boolean",
        "title": "Include Routes",
        "default": true
      },
      "map_session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Map Session Id",
        "default": null,
        "description": "Open map session (msess_...) from get_map_visualization. Its Territory Solution is the input; omit ts_handle when set."
      },
      "include_manual_polygons": {
        "type": "boolean",
        "title": "Include Manual Polygons",
        "default": true
      }
    }
  }

  arguments 69 lines copy