Skip to content
MCP server

KPN Grexx

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
2.3.1
Listing updated
5 days ago

About KPN Grexx

KPN Grexx is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add kpn-mcp --env KPN_GREXX_USERNAME='<KPN_GREXX_USERNAME>' --env KPN_GREXX_PASSWORD='<KPN_GREXX_PASSWORD>' --env KPN_GREXX_BASE_URL='<KPN_GREXX_BASE_URL>' --env KPN_CLIENT_SECRET='<KPN_CLIENT_SECRET>' --env KPN_MSM_CLIENT_SECRET='<KPN_MSM_CLIENT_SECRET>' -- docker run -i --rm -e KPN_GREXX_USERNAME -e KPN_GREXX_PASSWORD -e KPN_GREXX_BASE_URL -e KPN_CLIENT_SECRET -e KPN_MSM_CLIENT_SECRET ghcr.io/wyre-ai/kpn-mcp:v2.3.1

Add to claude_desktop_config.json

{
  "mcpServers": {
    "kpn-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KPN_GREXX_USERNAME",
        "-e",
        "KPN_GREXX_PASSWORD",
        "-e",
        "KPN_GREXX_BASE_URL",
        "-e",
        "KPN_CLIENT_SECRET",
        "-e",
        "KPN_MSM_CLIENT_SECRET",
        "ghcr.io/wyre-ai/kpn-mcp:v2.3.1"
      ],
      "env": {
        "KPN_GREXX_USERNAME": "<KPN_GREXX_USERNAME>",
        "KPN_GREXX_PASSWORD": "<KPN_GREXX_PASSWORD>",
        "KPN_GREXX_BASE_URL": "<KPN_GREXX_BASE_URL>",
        "KPN_CLIENT_SECRET": "<KPN_CLIENT_SECRET>",
        "KPN_MSM_CLIENT_SECRET": "<KPN_MSM_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "kpn-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KPN_GREXX_USERNAME",
        "-e",
        "KPN_GREXX_PASSWORD",
        "-e",
        "KPN_GREXX_BASE_URL",
        "-e",
        "KPN_CLIENT_SECRET",
        "-e",
        "KPN_MSM_CLIENT_SECRET",
        "ghcr.io/wyre-ai/kpn-mcp:v2.3.1"
      ],
      "env": {
        "KPN_GREXX_USERNAME": "<KPN_GREXX_USERNAME>",
        "KPN_GREXX_PASSWORD": "<KPN_GREXX_PASSWORD>",
        "KPN_GREXX_BASE_URL": "<KPN_GREXX_BASE_URL>",
        "KPN_CLIENT_SECRET": "<KPN_CLIENT_SECRET>",
        "KPN_MSM_CLIENT_SECRET": "<KPN_MSM_CLIENT_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "kpn-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KPN_GREXX_USERNAME",
        "-e",
        "KPN_GREXX_PASSWORD",
        "-e",
        "KPN_GREXX_BASE_URL",
        "-e",
        "KPN_CLIENT_SECRET",
        "-e",
        "KPN_MSM_CLIENT_SECRET",
        "ghcr.io/wyre-ai/kpn-mcp:v2.3.1"
      ],
      "env": {
        "KPN_GREXX_USERNAME": "<KPN_GREXX_USERNAME>",
        "KPN_GREXX_PASSWORD": "<KPN_GREXX_PASSWORD>",
        "KPN_GREXX_BASE_URL": "<KPN_GREXX_BASE_URL>",
        "KPN_CLIENT_SECRET": "<KPN_CLIENT_SECRET>",
        "KPN_MSM_CLIENT_SECRET": "<KPN_MSM_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "kpn-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KPN_GREXX_USERNAME",
        "-e",
        "KPN_GREXX_PASSWORD",
        "-e",
        "KPN_GREXX_BASE_URL",
        "-e",
        "KPN_CLIENT_SECRET",
        "-e",
        "KPN_MSM_CLIENT_SECRET",
        "ghcr.io/wyre-ai/kpn-mcp:v2.3.1"
      ],
      "env": {
        "KPN_GREXX_USERNAME": "<KPN_GREXX_USERNAME>",
        "KPN_GREXX_PASSWORD": "<KPN_GREXX_PASSWORD>",
        "KPN_GREXX_BASE_URL": "<KPN_GREXX_BASE_URL>",
        "KPN_CLIENT_SECRET": "<KPN_CLIENT_SECRET>",
        "KPN_MSM_CLIENT_SECRET": "<KPN_MSM_CLIENT_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "kpn-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KPN_GREXX_USERNAME",
        "-e",
        "KPN_GREXX_PASSWORD",
        "-e",
        "KPN_GREXX_BASE_URL",
        "-e",
        "KPN_CLIENT_SECRET",
        "-e",
        "KPN_MSM_CLIENT_SECRET",
        "ghcr.io/wyre-ai/kpn-mcp:v2.3.1"
      ],
      "env": {
        "KPN_GREXX_USERNAME": "<KPN_GREXX_USERNAME>",
        "KPN_GREXX_PASSWORD": "<KPN_GREXX_PASSWORD>",
        "KPN_GREXX_BASE_URL": "<KPN_GREXX_BASE_URL>",
        "KPN_CLIENT_SECRET": "<KPN_CLIENT_SECRET>",
        "KPN_MSM_CLIENT_SECRET": "<KPN_MSM_CLIENT_SECRET>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • KPN_GREXX_USERNAMEGrexx 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.Required
  • KPN_GREXX_PASSWORDGrexx API password. Passed to the SDK as the OAuth client_secret (scope=all). The SDK sends it with HTTP Basic on the token endpoint.Required
  • KPN_GREXX_BASE_URLGrexx 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).Required
  • 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_LEGACY_DEVELOPER_APISet to 1 to also register the developer.kpn.com tools (disturbances, availability, SIM swap, MSM). Default is Grexx only.
  • KPN_CLIENT_IDLegacy developer.kpn.com project client ID. Used only when KPN_LEGACY_DEVELOPER_API=1.
  • KPN_CLIENT_SECRETLegacy developer.kpn.com project client secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_CLIENT_ID.
  • KPN_MSM_CLIENT_IDOptional legacy MSM app ID. Used only when KPN_LEGACY_DEVELOPER_API=1. Must be paired with KPN_MSM_CLIENT_SECRET.
  • KPN_MSM_CLIENT_SECRETOptional 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

Pricing

Open source

KPN Grexx FAQ

Is KPN Grexx free?

Yes. KPN Grexx is open source, so you can use and self-host it for free.

How do I add KPN Grexx to Claude Code?

Run this command in your terminal: claude mcp add kpn-mcp --env KPN_GREXX_USERNAME='<KPN_GREXX_USERNAME>' --env KPN_GREXX_PASSWORD='<KPN_GREXX_PASSWORD>' --env KPN_GREXX_BASE_URL='<KPN_GREXX_BASE_URL>' --env KPN_CLIENT_SECRET='<KPN_CLIENT_SECRET>' --env KPN_MSM_CLIENT_SECRET='<KPN_MSM_CLIENT_SECRET>' -- docker run -i --rm -e KPN_GREXX_USERNAME -e KPN_GREXX_PASSWORD -e KPN_GREXX_BASE_URL -e KPN_CLIENT_SECRET -e KPN_MSM_CLIENT_SECRET ghcr.io/wyre-ai/kpn-mcp:v2.3.1

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers