KPN Network Checks
Address- and number-level lookups against KPN: current and planned outages at a Dutch address (Disturbance Check), available access technology and speeds at an address (Speed Check), and the date of t
SKILL.mdmsp-claude-plugins/kpn/kpn/skills/network-checks/SKILL.md
GitHubKPN Network Checks
Overview
Three read-only checks that need only the main KPN project keys. They cover the Netherlands only.
Addresses
Both address tools take a Dutch postcode (1234AB; spaces and lowercase are
accepted), a house number, and an optional extension (toevoeging, e.g. A,
bis). Get the extension right: flats at the same number can be on
different lines.
Outage triage: kpn_disturbances_check
Returns current and planned disturbances (broadband, fixed, mobile, generic) for the address. An empty result is a real answer: KPN knows of no disturbance there. It is not an error, and it does not rule out a problem with the customer's own equipment or line.
Typical flow when a KPN site is down:
kpn_disturbances_checkfor the site address.- If a disturbance is listed, report its type, start and expected end, and stop troubleshooting on-site equipment.
- If nothing is listed, continue with the customer's own network (router/firewall in the RMM) and consider a KPN ticket.
Availability: kpn_availability_check
Lists the access technologies available at the address (fibre, copper), maximum download/upload speeds, planned fibre dates and third-party fibre information. Use it for upgrade conversations and site surveys, not for diagnosing an outage.
SIM-swap check: kpn_sim_swap_get_date
Returns when the SIM behind a mobile number was last swapped. A recent swap
just before a password or MFA reset request is a classic account-takeover
signal. Pass maxAgeHours (for example 72) to get a direct
swappedWithinMaxAge flag.
- Only KPN NL mobile numbers are covered; others return "not a KPN mobile number or unknown".
- It is a fraud check on a person's number: use it for the user's own security, and don't run it speculatively.
- A recent swap is a reason to verify identity another way before resetting anything, not proof of fraud.