KPN Grexx MCP Setup & Guide

{
  "id": "io.github.WYRE-AI/kpn-mcp",
  "type": "mcp-server",
  "version": "2.2.1",
  "displayName": "KPN Grexx",
  "description": "KPN IRMA on Grexx: address checks, prequalification, customers, orders, mobile and line tools.",
  "repository": {
    "url": "https://github.com/WYRE-AI/kpn-mcp",
    "source": "github"
  },
  "homepage": "https://github.com/WYRE-AI/kpn-mcp",
  "distribution": {
    "packages": [
      {
        "registryType": "oci",
        "identifier": "ghcr.io/wyre-ai/kpn-mcp:v2.2.1",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "KPN_GREXX_USERNAME",
            "description": "Grexx API username. Passed to the SDK as the OAuth client_id (portal: API Gegevens). The SDK sends it with HTTP Basic on the token endpoint. This server does not mint the token.",
            "isRequired": true
          },
          {
            "name": "KPN_GREXX_PASSWORD",
            "description": "Grexx API password. Passed to the SDK as the OAuth client_secret (scope=all). The SDK sends it with HTTP Basic on the token endpoint.",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "KPN_GREXX_BASE_URL",
            "description": "Grexx interface root, without /realtime. Env only — never a gateway header. No default; acceptatie and production differ.",
            "isRequired": true
          },
          {
            "name": "KPN_GREXX_TOKEN_URL",
            "description": "OAuth token endpoint. Env only — never a gateway header. Production will differ from acceptatie."
          },
          {
            "name": "KPN_LEGACY_DEVELOPER_API",
            "description": "Set to 1 to also register the developer.kpn.com tools (disturbances, availability, SIM swap, MSM). Default is Grexx only."
          },
          {
            "name": "KPN_CLIENT_ID",
            "description": "Legacy developer.kpn.com project client ID. Used only when KPN_LEGACY_DEVELOPER_API=1."
          },
          {
            "name": "KPN_CLIENT_SECRET",
            "description": "Legacy developer.kpn.com project client secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_CLIENT_ID.",
            "isSecret": true
          },
          {
            "name": "KPN_MSM_CLIENT_ID",
            "description": "Optional legacy MSM app ID. Used only when KPN_LEGACY_DEVELOPER_API=1. Must be paired with KPN_MSM_CLIENT_SECRET."
          },
          {
            "name": "KPN_MSM_CLIENT_SECRET",
            "description": "Optional legacy MSM app secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_MSM_CLIENT_ID.",
            "isSecret": true
          },
          {
            "name": "KPN_BASE_URL",
            "description": "Legacy developer.kpn.com base URL. Env only. Used only when KPN_LEGACY_DEVELOPER_API=1."
          },
          {
            "name": "MCP_TRANSPORT",
            "description": "Transport mode. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting."
          },
          {
            "name": "AUTH_MODE",
            "description": "Credential source: 'env' reads KPN_GREXX_* locally, 'gateway' expects X-KPN-Grexx-Username and X-KPN-Grexx-Password. Base URL and token URL stay env-only."
          },
          {
            "name": "LOG_LEVEL",
            "description": "Log verbosity: debug, info, warn, error"
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.WYRE-AI/kpn-mcp",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.WYRE-AI%2Fkpn-mcp/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}