KPN Grexx

io.github.WYRE-AI/kpn-mcp

KPN IRMA on Grexx: address checks, prequalification, customers, orders, mobile and line tools.

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "kpn-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wyre-ai/kpn-mcp:v2.3.1"
      ],
      "env": {
        "KPN_GREXX_USERNAME": "<your KPN_GREXX_USERNAME>",
        "KPN_GREXX_PASSWORD": "<your KPN_GREXX_PASSWORD>",
        "KPN_GREXX_BASE_URL": "<your KPN_GREXX_BASE_URL>",
        "KPN_GREXX_TOKEN_URL": "https://service-accept.grexx.today/oauth/access_token",
        "KPN_CLIENT_SECRET": "<your KPN_CLIENT_SECRET>",
        "KPN_MSM_CLIENT_SECRET": "<your KPN_MSM_CLIENT_SECRET>",
        "KPN_BASE_URL": "https://api-prd.kpn.com",
        "MCP_TRANSPORT": "stdio",
        "AUTH_MODE": "env",
        "LOG_LEVEL": "info"
      }
    }
  }
}
Environment variables
  • KPN_GREXX_USERNAMErequiredGrexx 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.
  • KPN_GREXX_PASSWORDrequiredsecretGrexx API password. Passed to the SDK as the OAuth client_secret (scope=all). The SDK sends it with HTTP Basic on the token endpoint.
  • KPN_GREXX_BASE_URLrequiredGrexx 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).
  • KPN_GREXX_TOKEN_URLOAuth 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).
  • KPN_CLIENT_SECRETsecretLegacy developer.kpn.com project client secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_CLIENT_ID.
  • KPN_MSM_CLIENT_SECRETsecretOptional legacy MSM app secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_MSM_CLIENT_ID.
  • KPN_BASE_URLLegacy developer.kpn.com base URL. Env only. Used only when KPN_LEGACY_DEVELOPER_API=1.
  • MCP_TRANSPORTTransport mode. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.
  • AUTH_MODECredential 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.
  • LOG_LEVELLog verbosity: debug, info, warn, error

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
2.3.1
Registry
active
Published
10/22/2026
Browse all Developer Tools →

Add the badge to your site

Show visitors that KPN Grexx is listed here — it’s also the link we check for a free listing.

KPN Grexx — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-wyre-ai-kpn-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="KPN Grexx — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![KPN Grexx — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-wyre-ai-kpn-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.