Skip to main content
Glama

areaguide

A forwarding client for the ikeytz maps read/link service — the public, read-only service behind a Ludwigsburg locksmith's service-area site. It covers service areas, places, geo and page data, and link composers for that site.

areaguide contains no maps logic of its own. It serves tools/list locally from a verbatim capture of the upstream server's 68 tools (name, title, description and inputSchema; the capture's outputSchema fields and annotations are not reproduced), and forwards every tools/call to the upstream endpoint. Upstream results pass through unchanged; a failed hop comes back as an areaguide error: ... text result with isError set.

Upstream

  • Default endpoint: https://maps.ikeytz.com/mcp

  • Override: set IKEYTZ_MAPS_MCP_URL to another streamable-HTTP MCP endpoint. (The override is a reconstruction; the default endpoint is the pinned one.)

  • No account and no API key are needed.

  • The forwarding hop runs initialize (protocolVersion 2025-03-26, clientInfo areaguide / 0.1.0), then notifications/initialized, then tools/call, and honours an Mcp-Session-Id header when the upstream issues one. Replies may be plain JSON or server-sent events.

Related MCP server: Google Maps MCP Server

CLI usage

npx @reneturcios/areaguide get_service_area '{"slug":"ludwigsburg"}'
npx @reneturcios/areaguide list_service_areas '{}'
npx @reneturcios/areaguide --version

Each tool subcommand takes a single JSON argument string, forwards the call and prints the result as JSON. Exit codes: 0 success, 1 a forwarded-call error, 2 usage error.

MCP usage

npx @reneturcios/areaguide mcp

MCP client config:

{
  "mcpServers": {
    "areaguide": {
      "command": "npx",
      "args": ["-y", "@reneturcios/areaguide", "mcp"]
    }
  }
}

Unknown tool names, and arguments that are not a JSON object, are rejected locally with InvalidParams before any network hop.

Docker

docker run -i ghcr.io/cloudcorprecords/areaguide          # stdio MCP server (CMD defaults to "mcp")
docker run --rm ghcr.io/cloudcorprecords/areaguide get_service_area '{"slug":"ludwigsburg"}'

Tools (68)

list_service_areas, get_service_area, get_ort_datetime, get_geo_office, get_contact, get_discovery, get_llms_mcp_server, get_llms_mcp_web, find_by_keyword, find_by_serp, get_serp_snippet, find_by_plz, find_by_geo, find_by_icbm, find_by_gebiet, find_by_area, list_slugs, list_plz, get_hub, get_embed_map, get_geo_api, get_grenze, get_grenze_koordinaten, get_lage, get_geschichte, distance_to_office, resolve_maps_url, find_by_google_maps, get_legal, get_urheberrecht, get_copyright, get_impressum, get_agb, get_nutzungsbedingungen, get_datenschutz, get_widerruf, site_overview, get_business_identity, list_nav, list_footer, list_locales, resolve_locale_url, get_prices, get_invoice_line_items, list_services, get_emergency, list_auswahl, get_auswahl_item, get_about, get_partner_info, get_links, get_review_url, list_faq, get_faq, list_wissen, get_wissen_entry, list_ratgeber, get_ratgeber, get_page_summary, get_ai_page, get_llms_txt, get_ai_txt, get_sitemap_txt, list_whatsapp_options, compose_tel_mobile, compose_tel_landline, compose_whatsapp, compose_mailto.

Development

npm install
npm run build   # tsc -> dist/ (dist/cli.js is the bin)
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # tsx src/cli.ts

License

MIT — Copyright (c) 2026 Rene Turcios.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables geocoding, reverse geocoding, elevation profiles, static map PNGs, and coordinate reprojection using MapTiler's OpenStreetMap data.
      85 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables desktop agents and clients to access geospatial services via a hosted MCP server, including OpenStreetMap queries, address and business search, POI discovery, routing, matrices, isochrones, map matching, optimization, elevation and terrain, basemap styling, spatial analysis, rendering, usage, and service status.
      33 npm
      MIT