KPN MCP Server
by wyre-aiio.github.WYRE-AI/kpn-mcpv1.1.1
MCP server for KPN: outage checks, address availability, SIM swap and business mobile (MSM).
context tax
queued
security
queued
cold start
queued
freshness
Active1d ago
Install KPN MCP server
Install in Claude Code
claude mcp add kpn -e KPN_CLIENT_ID='<kpn-client-id>' -e KPN_CLIENT_SECRET='<kpn-client-secret>' -e KPN_MSM_CLIENT_SECRET='<kpn-msm-client-secret>' -- docker run -i --rm -e KPN_CLIENT_ID -e KPN_CLIENT_SECRET -e KPN_MSM_CLIENT_SECRET ghcr.io/wyre-ai/kpn-mcp:v1.1.1Install in Cursor
{
"mcpServers": {
"kpn": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KPN_CLIENT_ID",
"-e",
"KPN_CLIENT_SECRET",
"-e",
"KPN_MSM_CLIENT_SECRET",
"ghcr.io/wyre-ai/kpn-mcp:v1.1.1"
],
"env": {
"KPN_CLIENT_ID": "<kpn-client-id>",
"KPN_CLIENT_SECRET": "<kpn-client-secret>",
"KPN_MSM_CLIENT_SECRET": "<kpn-msm-client-secret>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"kpn": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KPN_CLIENT_ID",
"-e",
"KPN_CLIENT_SECRET",
"-e",
"KPN_MSM_CLIENT_SECRET",
"ghcr.io/wyre-ai/kpn-mcp:v1.1.1"
],
"env": {
"KPN_CLIENT_ID": "<kpn-client-id>",
"KPN_CLIENT_SECRET": "<kpn-client-secret>",
"KPN_MSM_CLIENT_SECRET": "<kpn-msm-client-secret>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"kpn": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KPN_CLIENT_ID",
"-e",
"KPN_CLIENT_SECRET",
"-e",
"KPN_MSM_CLIENT_SECRET",
"ghcr.io/wyre-ai/kpn-mcp:v1.1.1"
],
"env": {
"KPN_CLIENT_ID": "<kpn-client-id>",
"KPN_CLIENT_SECRET": "<kpn-client-secret>",
"KPN_MSM_CLIENT_SECRET": "<kpn-msm-client-secret>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"kpn": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KPN_CLIENT_ID",
"-e",
"KPN_CLIENT_SECRET",
"-e",
"KPN_MSM_CLIENT_SECRET",
"ghcr.io/wyre-ai/kpn-mcp:v1.1.1"
],
"env": {
"KPN_CLIENT_ID": "<kpn-client-id>",
"KPN_CLIENT_SECRET": "<kpn-client-secret>",
"KPN_MSM_CLIENT_SECRET": "<kpn-msm-client-secret>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| KPN_CLIENT_ID | yes | — | KPN API Store project client ID (developer.kpn.com → Dashboard → Projects) |
| KPN_CLIENT_SECRET | yes | yes | KPN API Store project client secret |
| KPN_MSM_CLIENT_ID | — | — | Optional customer GRIP-bound Mobile Services Management app ID (falls back to KPN_CLIENT_ID) |
| KPN_MSM_CLIENT_SECRET | — | yes | Optional MSM app secret; must be set together with KPN_MSM_CLIENT_ID |
| KPN_BASE_URL | — | — | KPN API base URL (env mode only) |
| MCP_TRANSPORT | — | — | Transport mode. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting. |
| AUTH_MODE | — | — | Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway. |
| LOG_LEVEL | — | — | Log verbosity: debug, info, warn, error |
Freshness
Active — last maintenance signal 1d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-09 · 1d ago · GitHub
Latest release
2026-10-09 · 1d ago · GitHub · v2.0.1
Package published
no data · npm/PyPI
Registry entry updated
2026-09-25 · 14d ago · official registry · v1.1.1
FAQ
›How do I install the KPN MCP server in Claude Code?
Run: claude mcp add kpn -e KPN_CLIENT_ID='<kpn-client-id>' -e KPN_CLIENT_SECRET='<kpn-client-secret>' -e KPN_MSM_CLIENT_SECRET='<kpn-msm-client-secret>' -- docker run -i --rm -e KPN_CLIENT_ID -e KPN_CLIENT_SECRET -e KPN_MSM_CLIENT_SECRET ghcr.io/wyre-ai/kpn-mcp:v1.1.1. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does KPN require an API key?
Yes. It expects KPN_CLIENT_ID, KPN_CLIENT_SECRET, KPN_MSM_CLIENT_SECRET, of which 2 are secrets.
›Can I use KPN as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is KPN in the official MCP registry?
Yes, as io.github.WYRE-AI/kpn-mcp.