Skip to main content
Glama

Create infrastructure zone

create_infrastructure_zone

Create an operational hydraulic boundary (pressure zone, DMA, sewershed, etc.). boundary is a GeoJSON Polygon, or a MultiPolygon when the area comes in separate pieces. (network_id, name) must be unique. Requires infrastructure_zones:write scope.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "network_id": "<network_id>",
      "kind": "<kind>",
      "name": "<name>",
      "boundary": "<boundary>"
    },
    "name": "create_infrastructure_zone"
  }
}

Input Schema

NameRequiredDescriptionDefault
codeNoOptional short code (e.g. "PZ-04")
kindYesZone kind (required)
nameYesZone name (required)
notesNoFree-form notes
boundaryYesGeoJSON Polygon or MultiPolygon (EPSG:4326). Each ring is closed; coordinates are [lon, lat]. Use MultiPolygon for a boundary in separate pieces - an area split by a rail corridor, or one containing an island.
network_idYesInfrastructure network ID (required) - resolve via list_infrastructure_networks

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / network_id / description
      Previous value: -"Infrastructure network ID (required)"New value: +"Infrastructure network ID (required) - resolve via list_infrastructure_networks"
  2. Changed4 schema fields changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • removedInput schema / additionalProperties
      Removed value: -false
    • changedInput schema / properties / boundary / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coordinates": {
      -        "items": {
      -          "items": {
      -            "items": [
      -              {
      -                "type": "number"
      -              },
      -              {
      -                "type": "number"
      -              }
      -            ],
      -            "maxItems": 2,
      -            "minItems": 2,
      -            "type": "array"
      -          },
      -          "type": "array"
      -        },
      -        "type": "array"
      -      },
      -      "type": {
      -        "const": "Polygon",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "coordinates"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coordinates": {
      -        "items": {
      -          "items": {
      -            "items": {
      -              "items": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "number"
      -                }
      -              ],
      -              "maxItems": 2,
      -              "minItems": 2,
      -              "type": "array"
      -            },
      -            "type": "array"
      -          },
      -          "type": "array"
      -        },
      -        "type": "array"
      -      },
      -      "type": {
      -        "const": "MultiPolygon",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "coordinates"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "coordinates": {
      +        "items": {
      +          "items": {
      +            "items": false,
      +            "maxItems": 2,
      +            "minItems": 2,
      +            "prefixItems": [
      +              {
      +                "type": "number"
      +              },
      +              {
      +                "type": "number"
      +              }
      +            ],
      +            "type": "array"
      +          },
      +          "type": "array"
      +        },
      +        "type": "array"
      +      },
      +      "type": {
      +        "const": "Polygon",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "coordinates"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "coordinates": {
      +        "items": {
      +          "items": {
      +            "items": {
      +              "items": false,
      +              "maxItems": 2,
      +              "minItems": 2,
      +              "prefixItems": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "number"
      +                }
      +              ],
      +              "type": "array"
      +            },
      +            "type": "array"
      +          },
      +          "type": "array"
      +        },
      +        "type": "array"
      +      },
      +      "type": {
      +        "const": "MultiPolygon",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "coordinates"
      +    ],
      +    "type": "object"
      +  }
      +]
    • addedInput schema / properties / network_id / pattern
      Added value: +"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
  3. Changed4 schema fields changed
    • changedInput schema / $schema
      Previous value: -"https://json-schema.org/draft/2020-12/schema"New value: +"http://json-schema.org/draft-07/schema#"
    • addedInput schema / additionalProperties
      Added value: +false
    • changedInput schema / properties / boundary / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "coordinates": {
      -        "items": {
      -          "items": {
      -            "items": false,
      -            "maxItems": 2,
      -            "minItems": 2,
      -            "prefixItems": [
      -              {
      -                "type": "number"
      -              },
      -              {
      -                "type": "number"
      -              }
      -            ],
      -            "type": "array"
      -          },
      -          "type": "array"
      -        },
      -        "type": "array"
      -      },
      -      "type": {
      -        "const": "Polygon",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "coordinates"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "coordinates": {
      -        "items": {
      -          "items": {
      -            "items": {
      -              "items": false,
      -              "maxItems": 2,
      -              "minItems": 2,
      -              "prefixItems": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "number"
      -                }
      -              ],
      -              "type": "array"
      -            },
      -            "type": "array"
      -          },
      -          "type": "array"
      -        },
      -        "type": "array"
      -      },
      -      "type": {
      -        "const": "MultiPolygon",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "coordinates"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coordinates": {
      +        "items": {
      +          "items": {
      +            "items": [
      +              {
      +                "type": "number"
      +              },
      +              {
      +                "type": "number"
      +              }
      +            ],
      +            "maxItems": 2,
      +            "minItems": 2,
      +            "type": "array"
      +          },
      +          "type": "array"
      +        },
      +        "type": "array"
      +      },
      +      "type": {
      +        "const": "Polygon",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "coordinates"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coordinates": {
      +        "items": {
      +          "items": {
      +            "items": {
      +              "items": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "number"
      +                }
      +              ],
      +              "maxItems": 2,
      +              "minItems": 2,
      +              "type": "array"
      +            },
      +            "type": "array"
      +          },
      +          "type": "array"
      +        },
      +        "type": "array"
      +      },
      +      "type": {
      +        "const": "MultiPolygon",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "coordinates"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedInput schema / properties / network_id / pattern
      Removed value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
  4. Changed4 schema fields changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • removedInput schema / additionalProperties
      Removed value: -false
    • changedInput schema / properties / boundary / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coordinates": {
      -        "items": {
      -          "items": {
      -            "items": [
      -              {
      -                "type": "number"
      -              },
      -              {
      -                "type": "number"
      -              }
      -            ],
      -            "maxItems": 2,
      -            "minItems": 2,
      -            "type": "array"
      -          },
      -          "type": "array"
      -        },
      -        "type": "array"
      -      },
      -      "type": {
      -        "const": "Polygon",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "coordinates"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coordinates": {
      -        "items": {
      -          "items": {
      -            "items": {
      -              "items": [
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "number"
      -                }
      -              ],
      -              "maxItems": 2,
      -              "minItems": 2,
      -              "type": "array"
      -            },
      -            "type": "array"
      -          },
      -          "type": "array"
      -        },
      -        "type": "array"
      -      },
      -      "type": {
      -        "const": "MultiPolygon",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "coordinates"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "coordinates": {
      +        "items": {
      +          "items": {
      +            "items": false,
      +            "maxItems": 2,
      +            "minItems": 2,
      +            "prefixItems": [
      +              {
      +                "type": "number"
      +              },
      +              {
      +                "type": "number"
      +              }
      +            ],
      +            "type": "array"
      +          },
      +          "type": "array"
      +        },
      +        "type": "array"
      +      },
      +      "type": {
      +        "const": "Polygon",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "coordinates"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "coordinates": {
      +        "items": {
      +          "items": {
      +            "items": {
      +              "items": false,
      +              "maxItems": 2,
      +              "minItems": 2,
      +              "prefixItems": [
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "number"
      +                }
      +              ],
      +              "type": "array"
      +            },
      +            "type": "array"
      +          },
      +          "type": "array"
      +        },
      +        "type": "array"
      +      },
      +      "type": {
      +        "const": "MultiPolygon",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "coordinates"
      +    ],
      +    "type": "object"
      +  }
      +]
    • addedInput schema / properties / network_id / pattern
      Added value: +"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
  5. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Adds real context beyond the annotations: the (network_id, name) uniqueness constraint and the required infrastructure_zones:write scope. Annotations already cover the write/non-idempotent safety profile, so the added constraints and auth requirement are what earn credit here.

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

Conciseness5/5

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

Three short sentences, front-loaded with the purpose, then the boundary format, then the constraint and scope. No filler or repetition.

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

Completeness4/5

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

For a create tool with no output schema and full schema documentation, the description covers purpose, key constraint, and permission requirement. It could say what happens on a uniqueness violation (rejected vs. error message), but nothing critical is missing.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents kind, name, code, notes, boundary format, and network_id resolution. The description adds only the composite uniqueness rule for (network_id, name); the boundary Polygon/MultiPolygon explanation largely repeats the schema's own text.

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

Purpose4/5

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

States a specific verb and resource ("Create an operational hydraulic boundary") and enumerates the domain meanings (pressure zone, DMA, sewershed). It is clearly distinct from create_infrastructure_network and create_infrastructure_asset, though it does not name those siblings explicitly.

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

Usage Guidelines3/5

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

Usage is only implied by the purpose statement — an agent can infer this is for defining a new zone under a network, but there is no explicit when-to-use, when-not, or alternative (e.g., update_infrastructure_zone, bulk_create) guidance.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources