{
  "slug": "io-github-wyre-ai-kpn-mcp",
  "name": "io.github.WYRE-AI/kpn-mcp",
  "title": "KPN Grexx",
  "description": "KPN IRMA on Grexx: address checks, prequalification, customers, orders, mobile and line tools.",
  "version": "2.3.1",
  "publishedAt": "2026-10-22T00:04:52.490323Z",
  "updatedAt": "2026-10-22T00:04:52.490323Z",
  "repoUrl": "https://github.com/WYRE-AI/kpn-mcp",
  "websiteUrl": "https://github.com/WYRE-AI/kpn-mcp",
  "namespace": {
    "type": "github",
    "owner": "WYRE-AI"
  },
  "kind": "local",
  "packages": [
    {
      "registryType": "oci",
      "identifier": "ghcr.io/wyre-ai/kpn-mcp:v2.3.1",
      "version": null,
      "transport": "stdio",
      "runtimeHint": null
    }
  ],
  "remotes": [],
  "envVars": [
    {
      "name": "KPN_GREXX_USERNAME",
      "isSecret": false,
      "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",
      "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",
      "isSecret": false,
      "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",
      "isSecret": false,
      "isRequired": false,
      "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",
      "isSecret": false,
      "isRequired": false,
      "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",
      "isSecret": false,
      "isRequired": false,
      "description": "Legacy developer.kpn.com project client ID. Used only when KPN_LEGACY_DEVELOPER_API=1."
    },
    {
      "name": "KPN_CLIENT_SECRET",
      "isSecret": true,
      "isRequired": false,
      "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",
      "isSecret": false,
      "isRequired": false,
      "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",
      "isSecret": true,
      "isRequired": false,
      "description": "Optional legacy MSM app secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_MSM_CLIENT_ID."
    },
    {
      "name": "KPN_BASE_URL",
      "isSecret": false,
      "isRequired": false,
      "description": "Legacy developer.kpn.com base URL. Env only. Used only when KPN_LEGACY_DEVELOPER_API=1."
    },
    {
      "name": "MCP_TRANSPORT",
      "isSecret": false,
      "isRequired": false,
      "description": "Transport mode. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting."
    },
    {
      "name": "AUTH_MODE",
      "isSecret": false,
      "isRequired": false,
      "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",
      "isSecret": false,
      "isRequired": false,
      "description": "Log verbosity: debug, info, warn, error"
    }
  ],
  "category": "business",
  "subcategory": "prices",
  "company": "",
  "categoryAuto": true,
  "checks": [
    {
      "id": "source-linked",
      "label": "Source repository linked",
      "result": "pass",
      "detail": "https://github.com/WYRE-AI/kpn-mcp"
    },
    {
      "id": "version-pinned",
      "label": "Version pinned",
      "result": "pass",
      "detail": "Every package has an explicit version"
    },
    {
      "id": "secrets-requested",
      "label": "Secrets requested",
      "result": "warn",
      "detail": "Asks for 3 secrets: KPN_GREXX_PASSWORD, KPN_CLIENT_SECRET, KPN_MSM_CLIENT_SECRET"
    },
    {
      "id": "known-registry",
      "label": "Known package registry",
      "result": "pass",
      "detail": "All packages come from npm, PyPI, OCI, NuGet or MCPB"
    },
    {
      "id": "namespace",
      "label": "Namespace ownership",
      "result": "info",
      "detail": "Name verified via GitHub account WYRE-AI"
    },
    {
      "id": "meta-text",
      "label": "Registry text aimed at the AI",
      "result": "pass",
      "detail": "Description and settings contain no hidden characters or instructions to the AI"
    },
    {
      "id": "code-flags",
      "label": "Code red flags",
      "result": "info",
      "detail": "oci packages are not read yet"
    }
  ],
  "scannedAt": "2026-10-29",
  "level": "Scanned",
  "install": [
    {
      "label": "Claude Desktop (oci)",
      "kind": "claude_desktop_json",
      "text": "{\n  \"mcpServers\": {\n    \"kpn-mcp\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-e\",\n        \"KPN_GREXX_USERNAME\",\n        \"-e\",\n        \"KPN_GREXX_PASSWORD\",\n        \"-e\",\n        \"KPN_GREXX_BASE_URL\",\n        \"ghcr.io/wyre-ai/kpn-mcp:v2.3.1\"\n      ],\n      \"env\": {\n        \"KPN_GREXX_USERNAME\": \"<your value>\",\n        \"KPN_GREXX_PASSWORD\": \"<your value>\",\n        \"KPN_GREXX_BASE_URL\": \"<your value>\"\n      }\n    }\n  }\n}"
    }
  ],
  "curated": true,
  "stars": 0,
  "archived": false,
  "pushedAt": "2026-10-22T00:03:34Z",
  "health": {
    "score": 39,
    "parts": {
      "popularity": 0,
      "activity": 0.6,
      "issues": null,
      "security": 0.8
    },
    "fail": 0,
    "warn": 1,
    "raw": {
      "stars": 0,
      "forks": 0,
      "downloads": null,
      "hn": null,
      "issuesOpen": 0,
      "issuesClosed": 0,
      "prsMerged": 9,
      "commits90": 0,
      "release": "2026-10-22T00:03:35Z",
      "pushed": "2026-10-22T00:03:34Z",
      "growth": null,
      "growthDays": null,
      "archived": false
    },
    "at": "2026-10-31T07:35:52.424Z"
  }
}