Skip to main content
Glama

ikeytz Einsatzgebiet-Karten

Find By Gebiet

find_by_gebiet
Read-only

WHAT: Multi-match Gebiete by q, name, or slug (substring, umlauts ok). RETURNS all matching point cards. USE for fuzzy place names. DOES NOT require exact slug. NEXT: get_service_area for one, or get_grenze.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
qNoName or slug query (preferred)
nameNoGerman place name substring (case-insensitive, umlauts ok), e.g. Grünbühl, Pattonville. Used when slug/plz omitted.
slugNoURL slug of one of the 52 Einsatzgebiete, e.g. pattonville, bietigheim-bissingen, walheim, gruenbuehl. Matches https://maps.ikeytz.com/{slug}. Lookup order when combined with plz/name: slug first.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
qNoResolved query
okYestrue = use summary, canonicalUrl, and extra keys. false = do not invent data; read error + hint and retry with valid args or open hint.
hintNoPresent when ok=false. Absolute URL or short recovery hint the agent should open or pass to another tool.
toolYesEcho of the tool name that produced this object (e.g. get_service_area).
countNo
errorNoPresent when ok=false. Codes include: unknown_place, unknown_discovery, unknown_doc, q_required, plz_required, coords_required, outside_service_area, url_required, not_maps_host, bad_url, path_or_url_required, serp_not_found, slug_or_coords_required, path_required.
itemsNo
localeNoLocale actually used for URLs. maps is German-only: always de (MAPS-E8 — no /en on maps). Requested non-de is ignored; payload locale=de.
relatedNoAlways includes https://maps.ikeytz.com/llms.txt.
summaryNoPrimary text for the model. For discovery tools this is the file window. For list tools a compact one-liner. Quote with attribution.
attributionYesRequired citation: 'Quelle: Schlüsseldienst Ludwigsburg ikeytz (ikeytz.com) · ai-train=no · https://maps.ikeytz.com/.well-known/ai.txt'
canonicalUrlNoBest URL to show the user: https://maps.ikeytz.com… page, public embed JSON, tel:+49…, mailto:…, https://wa.me/…, or a www pointer. Prefer this over constructing URLs.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / items / items / properties / grenze_api
      Added value: +{
      +  "description": "https://maps.ikeytz.com/api/v1/embed/ort/{slug}/grenze (GeoJSON)",
      +  "format": "uri",
      +  "type": "string"
      +}
    • addedOutput schema / properties / items / items / properties / punkt_api
      Added value: +{
      +  "description": "https://maps.ikeytz.com/api/v1/embed/ort/{slug}/punkt (GeoJSON Point)",
      +  "format": "uri",
      +  "type": "string"
      +}
  2. Changed4 schema fields changed
    • addedInput schema / properties / name / description
      Added value: +"German place name substring (case-insensitive, umlauts ok), e.g. Grünbühl, Pattonville. Used when slug/plz omitted."
    • addedInput schema / properties / q / description
      Added value: +"Name or slug query (preferred)"
    • addedInput schema / properties / slug / description
      Added value: +"URL slug of one of the 52 Einsatzgebiete, e.g. pattonville, bietigheim-bissingen, walheim, gruenbuehl. Matches https://maps.ikeytz.com/{slug}. Lookup order when combined with plz/name: slug first."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "description": "Always the same envelope. tools/call returns content[0].text = summary (or JSON) AND structuredContent = this object. On success ok=true with summary + canonicalUrl + extra fields. On failure ok=false with error (snake_case code) and hint (recovery URL). Never writes, never submits forms, never books. Attribution must be kept when quoting. Policy: ai-input yes with attribution; ai-train=no. Host is maps.ikeytz.com (geo/Einsatzgebiet). Prices/FAQ/legal HTML live on www — maps only points.",
      +  "properties": {
      +    "attribution": {
      +      "description": "Required citation: 'Quelle: Schlüsseldienst Ludwigsburg ikeytz (ikeytz.com) · ai-train=no · https://maps.ikeytz.com/.well-known/ai.txt'",
      +      "type": "string"
      +    },
      +    "canonicalUrl": {
      +      "description": "Best URL to show the user: https://maps.ikeytz.com… page, public embed JSON, tel:+49…, mailto:…, https://wa.me/…, or a www pointer. Prefer this over constructing URLs.",
      +      "type": "string"
      +    },
      +    "count": {
      +      "type": "number"
      +    },
      +    "error": {
      +      "description": "Present when ok=false. Codes include: unknown_place, unknown_discovery, unknown_doc, q_required, plz_required, coords_required, outside_service_area, url_required, not_maps_host, bad_url, path_or_url_required, serp_not_found, slug_or_coords_required, path_required.",
      +      "type": "string"
      +    },
      +    "hint": {
      +      "description": "Present when ok=false. Absolute URL or short recovery hint the agent should open or pass to another tool.",
      +      "type": "string"
      +    },
      +    "items": {
      +      "items": {
      +        "additionalProperties": true,
      +        "description": "One Einsatzgebiet point card (not a polygon).",
      +        "properties": {
      +          "distance_km": {
      +            "description": "Present on geo-ranked results: air distance from query point",
      +            "type": "number"
      +          },
      +          "embed_map": {
      +            "description": "https://maps.ikeytz.com/{slug}",
      +            "format": "uri",
      +            "type": "string"
      +          },
      +          "geo_api": {
      +            "description": "https://maps.ikeytz.com/api/v1/embed/ort/{slug}",
      +            "format": "uri",
      +            "type": "string"
      +          },
      +          "google_maps": {
      +            "description": "Paste-ready 'lat, lng'",
      +            "type": "string"
      +          },
      +          "icbm": {
      +            "description": "ICBM 'lat, lng' (same as google_maps)",
      +            "type": "string"
      +          },
      +          "kind": {
      +            "description": "stadtteil | ort",
      +            "type": "string"
      +          },
      +          "lat": {
      +            "description": "WGS84 latitude of THIS place",
      +            "type": "number"
      +          },
      +          "lng": {
      +            "description": "WGS84 longitude of THIS place",
      +            "type": "number"
      +          },
      +          "maps_mcp": {
      +            "const": "https://maps.ikeytz.com/mcp",
      +            "description": "maps MCP endpoint",
      +            "format": "uri",
      +            "type": "string"
      +          },
      +          "name": {
      +            "description": "German place name",
      +            "type": "string"
      +          },
      +          "parent": {
      +            "description": "Ludwigsburg or Landkreis Ludwigsburg",
      +            "type": "string"
      +          },
      +          "plz": {
      +            "description": "Postcode",
      +            "type": "string"
      +          },
      +          "slug": {
      +            "description": "maps slug",
      +            "type": "string"
      +          },
      +          "url": {
      +            "description": "Keyword/www page URL when present",
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "locale": {
      +      "description": "Locale actually used for URLs. maps is German-only: always de (MAPS-E8 — no /en on maps). Requested non-de is ignored; payload locale=de.",
      +      "enum": [
      +        "de"
      +      ],
      +      "type": "string"
      +    },
      +    "ok": {
      +      "description": "true = use summary, canonicalUrl, and extra keys. false = do not invent data; read error + hint and retry with valid args or open hint.",
      +      "type": "boolean"
      +    },
      +    "q": {
      +      "description": "Resolved query",
      +      "type": "string"
      +    },
      +    "related": {
      +      "description": "Always includes https://maps.ikeytz.com/llms.txt.",
      +      "items": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "summary": {
      +      "description": "Primary text for the model. For discovery tools this is the file window. For list tools a compact one-liner. Quote with attribution.",
      +      "type": "string"
      +    },
      +    "tool": {
      +      "description": "Echo of the tool name that produced this object (e.g. get_service_area).",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "ok",
      +    "tool",
      +    "attribution"
      +  ],
      +  "type": "object"
      +}
  3. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources