KPN Grexx
KPN IRMA on Grexx: address checks, prequalification, customers, orders, mobile and line…
- 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.1Add 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.RequiredKPN_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.RequiredKPN_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).RequiredKPN_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.