KPN Grexx

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-10-22T00:04:52.490323Z",
      "publishedAt": "2026-10-22T00:04:52.490323Z",
      "statusChangedAt": "2026-10-22T00:04:52.490323Z"
    }
  },
  "server": {
    "name": "io.github.WYRE-AI/kpn-mcp",
    "title": "KPN Grexx",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "2.3.1",
    "packages": [
      {
        "transport": {
          "type": "stdio"
        },
        "identifier": "ghcr.io/wyre-ai/kpn-mcp:v2.3.1",
        "registryType": "oci",
        "environmentVariables": [
          {
            "name": "KPN_GREXX_USERNAME",
            "format": "string",
            "isRequired": true,
            "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."
          },
          {
            "name": "KPN_GREXX_PASSWORD",
            "format": "string",
            "isSecret": true,
            "isRequired": true,
            "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."
          },
          {
            "name": "KPN_GREXX_BASE_URL",
            "format": "string",
            "isRequired": true,
            "description": "Grexx interface root, without /realtime. No default; acceptatie and production differ. In gateway mode a connection may override it with X-Grexx-Api-Url (together with X-Grexx-Token-Url, allowlisted Grexx hosts only)."
          },
          {
            "name": "KPN_GREXX_TOKEN_URL",
            "format": "string",
            "default": "https://service-accept.grexx.today/oauth/access_token",
            "description": "OAuth token endpoint. Production differs from acceptatie. In gateway mode a connection may override it with X-Grexx-Token-Url (together with X-Grexx-Api-Url)."
          },
          {
            "name": "KPN_LEGACY_DEVELOPER_API",
            "format": "string",
            "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",
            "format": "string",
            "description": "Legacy developer.kpn.com project client ID. Used only when KPN_LEGACY_DEVELOPER_API=1."
          },
          {
            "name": "KPN_CLIENT_SECRET",
            "format": "string",
            "isSecret": true,
            "description": "Legacy developer.kpn.com project client secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_CLIENT_ID."
          },
          {
            "name": "KPN_MSM_CLIENT_ID",
            "format": "string",
            "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",
            "format": "string",
            "isSecret": true,
            "description": "Optional legacy MSM app secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_MSM_CLIENT_ID."
          },
          {
            "name": "KPN_BASE_URL",
            "format": "string",
            "default": "https://api-prd.kpn.com",
            "description": "Legacy developer.kpn.com base URL. Env only. Used only when KPN_LEGACY_DEVELOPER_API=1."
          },
          {
            "name": "MCP_TRANSPORT",
            "format": "string",
            "default": "stdio",
            "description": "Transport mode. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting."
          },
          {
            "name": "AUTH_MODE",
            "format": "string",
            "default": "env",
            "description": "Credential source: 'env' reads KPN_GREXX_* locally, 'gateway' expects X-KPN-Grexx-Username and X-KPN-Grexx-Password, plus optional X-Grexx-Api-Url and X-Grexx-Token-Url per connection."
          },
          {
            "name": "LOG_LEVEL",
            "format": "string",
            "default": "info",
            "description": "Log verbosity: debug, info, warn, error"
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/WYRE-AI/kpn-mcp",
      "source": "github"
    },
    "websiteUrl": "https://github.com/WYRE-AI/kpn-mcp",
    "description": "KPN IRMA on Grexx: address checks, prequalification, customers, orders, mobile and line tools."
  }
}