siteguide

A forwarding client for the ikeytz website read/link service — the public, read-only service behind a Ludwigsburg locksmith's main website. It covers services, fixed prices, service areas, FAQ entries, knowledge articles and guides, discovery files, and link composers for that site.

siteguide contains no website logic of its own. It serves tools/list locally from a verbatim capture of the upstream server's 47 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 a siteguide error: ... text result with isError set.

Upstream

• Default endpoint: https://www.ikeytz.com/mcp
• Override: set IKEYTZ_WEBSITE_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 siteguide / 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.

CLI usage

npx @reneturcios/siteguide get_service_area '{"slug":"pattonville"}'
npx @reneturcios/siteguide site_overview '{}'
npx @reneturcios/siteguide --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/siteguide mcp

MCP client config:

{
  "mcpServers": {
    "siteguide": {
      "command": "npx",
      "args": ["-y", "@reneturcios/siteguide", "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/siteguide          # stdio MCP server (CMD defaults to "mcp")
docker run --rm ghcr.io/cloudcorprecords/siteguide get_service_area '{"slug":"pattonville"}'

Tools (47)

site_overview, get_business_identity, list_nav, list_footer, list_locales, resolve_locale_url, get_prices, get_ort_datetime, get_invoice_line_items, list_services, get_emergency, list_auswahl, get_auswahl_item, list_service_areas, get_service_area, get_geo_office, get_contact, get_legal, get_about, get_partner_info, get_links, get_it, get_mcp_hub, get_review_url, list_faq, get_faq, list_wissen, get_wissen_entry, list_ratgeber, get_ratgeber, get_page_summary, get_ai_page, get_serp_snippet, find_by_keyword, get_discovery, get_llms_txt, get_llms_jsonld, get_llms_serp_txt, get_llms_mcp_server, get_llms_mcp_web, 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.