Zen MCP Server
by krystiangwio.github.krystiangw/zenv0.1.1
Unofficial MCP server for the ZEN.com Payment Gateway (payment links, transactions, refunds, payouts, reporting).
context tax
queued
security
queued
cold start
queued
freshness
Maintained53d ago
Install Zen MCP server
Install in Claude Code
claude mcp add zen -e ZEN_API_KEY='<zen-api-key>' -e ZEN_PAYWALL_SECRET='<zen-paywall-secret>' -e ZEN_IPN_SECRET='<zen-ipn-secret>' -- npx -y @krystiangw/zen-mcpInstall in Cursor
{
"mcpServers": {
"zen": {
"command": "npx",
"args": [
"-y",
"@krystiangw/zen-mcp"
],
"env": {
"ZEN_API_KEY": "<zen-api-key>",
"ZEN_PAYWALL_SECRET": "<zen-paywall-secret>",
"ZEN_IPN_SECRET": "<zen-ipn-secret>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"zen": {
"command": "npx",
"args": [
"-y",
"@krystiangw/zen-mcp"
],
"env": {
"ZEN_API_KEY": "<zen-api-key>",
"ZEN_PAYWALL_SECRET": "<zen-paywall-secret>",
"ZEN_IPN_SECRET": "<zen-ipn-secret>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"zen": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@krystiangw/zen-mcp"
],
"env": {
"ZEN_API_KEY": "<zen-api-key>",
"ZEN_PAYWALL_SECRET": "<zen-paywall-secret>",
"ZEN_IPN_SECRET": "<zen-ipn-secret>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"zen": {
"command": "npx",
"args": [
"-y",
"@krystiangw/zen-mcp"
],
"env": {
"ZEN_API_KEY": "<zen-api-key>",
"ZEN_PAYWALL_SECRET": "<zen-paywall-secret>",
"ZEN_IPN_SECRET": "<zen-ipn-secret>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ZEN_API_KEY | yes | yes | ZEN Terminal API Key (Authorization header) |
| ZEN_PAYWALL_SECRET | — | yes | ZEN paywall secret for request signing (required for write ops) |
| ZEN_IPN_SECRET | — | yes | ZEN IPN secret for webhook verification |
| ZEN_ENV | — | — | sandbox (default) or production |
Freshness
Maintained — last maintenance signal 53d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-17 · 53d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-17 · 53d ago · official registry · v0.1.1
FAQ
›How do I install the Zen MCP server in Claude Code?
Run: claude mcp add zen -e ZEN_API_KEY='<zen-api-key>' -e ZEN_PAYWALL_SECRET='<zen-paywall-secret>' -e ZEN_IPN_SECRET='<zen-ipn-secret>' -- npx -y @krystiangw/zen-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Zen require an API key?
Yes. It expects ZEN_API_KEY, ZEN_PAYWALL_SECRET, ZEN_IPN_SECRET, of which 3 are secrets.
›Can I use Zen as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Zen in the official MCP registry?
Yes, as io.github.krystiangw/zen.