KPN Grexx MCP

An MCP server for KPN (Dutch telco) IRMA APIs hosted by Grexx, aimed at MSP helpdesks. It provides tools for outage and speed checks, SIM swap, business-mobile management, address checks, prequalification, and customer order data retrieval. It supports both legacy and modern MCP specs via a shared factory.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

Community listingLocal stdioSource reviewed; not executedPublished by WYRE-AI

You need:Grexx username and password are the OAuth client_id and client_secret

Vendor documentation

What you can do with it

Check internet outage and speed at a Dutch address
Perform prequalification for broadband services
Retrieve customer and order data
Manage SIM swaps and mobile settings

Source and maintenance

Community listingRegistry 2.3.1

mcp-registry: io.github.WYRE-AI/kpn-mcp@2.3.1 Source repository Project website

Maintenance checked: Nov 1, 2026, 4:29 AM UTC

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

ghcr.io/wyre-ai/kpn-mcp:v2.3.1

oci

ghcr.io/wyre-ai/kpn-mcp:v2.3.1 package definition

{
  "transport": "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",
      "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",
      "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",
      "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"
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.

Cursor configuration

{
  "mcpServers": {
    "kpn-grexx-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KPN_GREXX_USERNAME=<YOUR_KPN_GREXX_USERNAME>",
        "-e",
        "KPN_GREXX_PASSWORD=<YOUR_KPN_GREXX_PASSWORD>",
        "-e",
        "KPN_GREXX_BASE_URL=<YOUR_KPN_GREXX_BASE_URL>",
        "-e",
        "KPN_GREXX_TOKEN_URL=<YOUR_KPN_GREXX_TOKEN_URL>",
        "-e",
        "KPN_LEGACY_DEVELOPER_API=<YOUR_KPN_LEGACY_DEVELOPER_API>",
        "-e",
        "KPN_CLIENT_ID=<YOUR_KPN_CLIENT_ID>",
        "-e",
        "KPN_CLIENT_SECRET=<YOUR_KPN_CLIENT_SECRET>",
        "-e",
        "KPN_MSM_CLIENT_ID=<YOUR_KPN_MSM_CLIENT_ID>",
        "-e",
        "KPN_MSM_CLIENT_SECRET=<YOUR_KPN_MSM_CLIENT_SECRET>",
        "-e",
        "KPN_BASE_URL=<YOUR_KPN_BASE_URL>",
        "-e",
        "MCP_TRANSPORT=<YOUR_MCP_TRANSPORT>",
        "-e",
        "AUTH_MODE=<YOUR_AUTH_MODE>",
        "-e",
        "LOG_LEVEL=<YOUR_LOG_LEVEL>",
        "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": "<YOUR_KPN_GREXX_TOKEN_URL>",
        "KPN_LEGACY_DEVELOPER_API": "<YOUR_KPN_LEGACY_DEVELOPER_API>",
        "KPN_CLIENT_ID": "<YOUR_KPN_CLIENT_ID>",
        "KPN_CLIENT_SECRET": "<YOUR_KPN_CLIENT_SECRET>",
        "KPN_MSM_CLIENT_ID": "<YOUR_KPN_MSM_CLIENT_ID>",
        "KPN_MSM_CLIENT_SECRET": "<YOUR_KPN_MSM_CLIENT_SECRET>",
        "KPN_BASE_URL": "<YOUR_KPN_BASE_URL>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "AUTH_MODE": "<YOUR_AUTH_MODE>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.

Cline configuration

{
  "mcpServers": {
    "kpn-grexx-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KPN_GREXX_USERNAME=<YOUR_KPN_GREXX_USERNAME>",
        "-e",
        "KPN_GREXX_PASSWORD=<YOUR_KPN_GREXX_PASSWORD>",
        "-e",
        "KPN_GREXX_BASE_URL=<YOUR_KPN_GREXX_BASE_URL>",
        "-e",
        "KPN_GREXX_TOKEN_URL=<YOUR_KPN_GREXX_TOKEN_URL>",
        "-e",
        "KPN_LEGACY_DEVELOPER_API=<YOUR_KPN_LEGACY_DEVELOPER_API>",
        "-e",
        "KPN_CLIENT_ID=<YOUR_KPN_CLIENT_ID>",
        "-e",
        "KPN_CLIENT_SECRET=<YOUR_KPN_CLIENT_SECRET>",
        "-e",
        "KPN_MSM_CLIENT_ID=<YOUR_KPN_MSM_CLIENT_ID>",
        "-e",
        "KPN_MSM_CLIENT_SECRET=<YOUR_KPN_MSM_CLIENT_SECRET>",
        "-e",
        "KPN_BASE_URL=<YOUR_KPN_BASE_URL>",
        "-e",
        "MCP_TRANSPORT=<YOUR_MCP_TRANSPORT>",
        "-e",
        "AUTH_MODE=<YOUR_AUTH_MODE>",
        "-e",
        "LOG_LEVEL=<YOUR_LOG_LEVEL>",
        "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": "<YOUR_KPN_GREXX_TOKEN_URL>",
        "KPN_LEGACY_DEVELOPER_API": "<YOUR_KPN_LEGACY_DEVELOPER_API>",
        "KPN_CLIENT_ID": "<YOUR_KPN_CLIENT_ID>",
        "KPN_CLIENT_SECRET": "<YOUR_KPN_CLIENT_SECRET>",
        "KPN_MSM_CLIENT_ID": "<YOUR_KPN_MSM_CLIENT_ID>",
        "KPN_MSM_CLIENT_SECRET": "<YOUR_KPN_MSM_CLIENT_SECRET>",
        "KPN_BASE_URL": "<YOUR_KPN_BASE_URL>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "AUTH_MODE": "<YOUR_AUTH_MODE>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.

VS Code configuration

{
  "servers": {
    "kpn-grexx-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KPN_GREXX_USERNAME=<YOUR_KPN_GREXX_USERNAME>",
        "-e",
        "KPN_GREXX_PASSWORD=<YOUR_KPN_GREXX_PASSWORD>",
        "-e",
        "KPN_GREXX_BASE_URL=<YOUR_KPN_GREXX_BASE_URL>",
        "-e",
        "KPN_GREXX_TOKEN_URL=<YOUR_KPN_GREXX_TOKEN_URL>",
        "-e",
        "KPN_LEGACY_DEVELOPER_API=<YOUR_KPN_LEGACY_DEVELOPER_API>",
        "-e",
        "KPN_CLIENT_ID=<YOUR_KPN_CLIENT_ID>",
        "-e",
        "KPN_CLIENT_SECRET=<YOUR_KPN_CLIENT_SECRET>",
        "-e",
        "KPN_MSM_CLIENT_ID=<YOUR_KPN_MSM_CLIENT_ID>",
        "-e",
        "KPN_MSM_CLIENT_SECRET=<YOUR_KPN_MSM_CLIENT_SECRET>",
        "-e",
        "KPN_BASE_URL=<YOUR_KPN_BASE_URL>",
        "-e",
        "MCP_TRANSPORT=<YOUR_MCP_TRANSPORT>",
        "-e",
        "AUTH_MODE=<YOUR_AUTH_MODE>",
        "-e",
        "LOG_LEVEL=<YOUR_LOG_LEVEL>",
        "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": "<YOUR_KPN_GREXX_TOKEN_URL>",
        "KPN_LEGACY_DEVELOPER_API": "<YOUR_KPN_LEGACY_DEVELOPER_API>",
        "KPN_CLIENT_ID": "<YOUR_KPN_CLIENT_ID>",
        "KPN_CLIENT_SECRET": "<YOUR_KPN_CLIENT_SECRET>",
        "KPN_MSM_CLIENT_ID": "<YOUR_KPN_MSM_CLIENT_ID>",
        "KPN_MSM_CLIENT_SECRET": "<YOUR_KPN_MSM_CLIENT_SECRET>",
        "KPN_BASE_URL": "<YOUR_KPN_BASE_URL>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "AUTH_MODE": "<YOUR_AUTH_MODE>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.

Claude Desktop configuration

{
  "mcpServers": {
    "kpn-grexx-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KPN_GREXX_USERNAME=<YOUR_KPN_GREXX_USERNAME>",
        "-e",
        "KPN_GREXX_PASSWORD=<YOUR_KPN_GREXX_PASSWORD>",
        "-e",
        "KPN_GREXX_BASE_URL=<YOUR_KPN_GREXX_BASE_URL>",
        "-e",
        "KPN_GREXX_TOKEN_URL=<YOUR_KPN_GREXX_TOKEN_URL>",
        "-e",
        "KPN_LEGACY_DEVELOPER_API=<YOUR_KPN_LEGACY_DEVELOPER_API>",
        "-e",
        "KPN_CLIENT_ID=<YOUR_KPN_CLIENT_ID>",
        "-e",
        "KPN_CLIENT_SECRET=<YOUR_KPN_CLIENT_SECRET>",
        "-e",
        "KPN_MSM_CLIENT_ID=<YOUR_KPN_MSM_CLIENT_ID>",
        "-e",
        "KPN_MSM_CLIENT_SECRET=<YOUR_KPN_MSM_CLIENT_SECRET>",
        "-e",
        "KPN_BASE_URL=<YOUR_KPN_BASE_URL>",
        "-e",
        "MCP_TRANSPORT=<YOUR_MCP_TRANSPORT>",
        "-e",
        "AUTH_MODE=<YOUR_AUTH_MODE>",
        "-e",
        "LOG_LEVEL=<YOUR_LOG_LEVEL>",
        "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": "<YOUR_KPN_GREXX_TOKEN_URL>",
        "KPN_LEGACY_DEVELOPER_API": "<YOUR_KPN_LEGACY_DEVELOPER_API>",
        "KPN_CLIENT_ID": "<YOUR_KPN_CLIENT_ID>",
        "KPN_CLIENT_SECRET": "<YOUR_KPN_CLIENT_SECRET>",
        "KPN_MSM_CLIENT_ID": "<YOUR_KPN_MSM_CLIENT_ID>",
        "KPN_MSM_CLIENT_SECRET": "<YOUR_KPN_MSM_CLIENT_SECRET>",
        "KPN_BASE_URL": "<YOUR_KPN_BASE_URL>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "AUTH_MODE": "<YOUR_AUTH_MODE>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}

Let your agent find its tools

Find servers like KPN Grexx MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 6,671