Zen MCP server
Unofficial MCP server for the ZEN.com Payment Gateway: payment links, transactions, refunds.
0 stars60 downloads/wk
Reviews
Write oneNobody has reviewed Zen yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Zen tools (14, 5 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
cancel_transactionwrite actionDestructive write: cancel a ZEN transaction. This may prevent or reverse payment processing; confirm before use.
capture_transactionDestructive write: capture an authorized transaction, causing funds to be collected. Confirm before use.
create_customerwrite actionWrite operation: create a customer record in ZEN for future payment flows; this stores personal data.
create_payment_linkwrite actionWrite operation: create a hosted ZEN checkout link and QR code for a customer to pay.
create_payoutwrite actionHighest-risk destructive write: send money outward through ZEN. Verify recipient, channel, currency, and amount before use.
download_reportRead-only: request a transaction or settlement report download from ZEN.
get_payment_linkRead-only: retrieve a hosted ZEN payment link by ID.
get_payoutRead-only: retrieve a ZEN payout by its ZEN ID.
get_transactionRead-only: retrieve a transaction by exactly one ZEN ID or merchant transaction ID.
list_payment_linksRead-only: list hosted ZEN payment links.
list_payment_methodsRead-only: list payment methods available to the configured ZEN terminal.
list_supported_currenciesRead-only: list currencies confirmed in the public ZEN documentation.
refund_transactionwrite actionDestructive write: return all or part of a payment to the customer. Confirm the transaction and amount before use.
verify_webhook_signatureRead-only: verify a ZEN IPN webhook signature using the configured IPN secret.
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan3 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 78 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Zen compares
Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 62% of 1,761 Finance servers
- Tools
- 14
- the typical Finance server has 8
- Tools that change things
- 36%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 60
- more than 55% of 421 Finance servers with a package
What its tools let an agent do: 9 read · 3 create · 1 change · 1 delete
Install Zen in Claude Code, Cursor or VS Code
Runs npx -y @krystiangw/zen-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add zen -- npx -y @krystiangw/zen-mcp
What the publisher says
From the Zen repository's README, as published. We do not edit it. Read it on GitHub
ZEN MCP
An MCP server that lets AI assistants work with the ZEN.com Payment Gateway: hosted payment links, transaction lookup, refunds, payouts, and reporting.
Project page
Unofficial. This project is not affiliated with, endorsed by, or maintained by ZEN.com.
What it does
Read-only tools:
- List terminal payment methods and documented currencies.
- Look up transactions, payment links, and payouts.
- List payment links and request reconciliation reports.
- Verify IPN webhook signatures locally.
Write tools:
- Create hosted payment links and QR codes without handling card data.
- Capture or cancel transactions and issue full or partial refunds.
- Create payouts and customer records.
Disclaimer
This integration was built from public ZEN documentation without access to a live merchant account. Endpoint versions, request fields, response fields, signing details, and webhook behavior must be checked against ZEN's current OpenAPI or Postman collection before production use. Mock mode is included for evaluation without an account.
Install
Add the published package to Claude Code:
claude mcp add zen --env ZEN_API_KEY=your_terminal_api_key -- npx -y @krystiangw/zen-mcpFor Claude Desktop, add this entry to its MCP configuration:
{
"mcpServers": {
"zen": {
"command": "npx",
"args": ["-y", "@krystiangw/zen-mcp"],
"env": {
"ZEN_API_KEY": "your_terminal_api_key",
"ZEN_PAYWALL_SECRET": "your_paywall_secret",
"ZEN_IPN_SECRET": "your_ipn_secret",
"ZEN_ENV": "sandbox"
}
}
}
}Configuration
In the ZEN merchant panel, go to my.zen.com → Shop settings → Terminal to find the Terminal API Key. Use sandbox first; the default API host is api.zen-test.com, although sandbox availability and onboarding requirements should be confirmed with ZEN.
No merchant account yet? You can open a ZEN business account. That is a referral link: it credits the author of this project if you sign up through it, and costs you nothing. Every other link in this README is a plain one.
Tools
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Zen: common questions
- Is Zen MCP server safe?
- Mostly: it is graded B (78/100). Read the Zen safety report
- How do I install Zen?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Zen need an API key?
- Yes. The registry entry asks for
ZEN_API_KEY,ZEN_PAYWALL_SECRET,ZEN_IPN_SECRET. - Is Zen maintained?
- The last commit was 79 days ago (2026-08-17). The latest release is v0.1.1.
- What can I use instead of Zen?
- Servers from other publishers that do the same job: Clip MCP server, PayRam MCP server and Fortrip MCP server.
- How does Zen compare with other Finance MCP servers?
- safety score 78/100 (higher than 62% of 1,761 Finance servers); tools 14 (the typical Finance server has 8); tools that change things 36% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Zen
Same job from other publishers: the closest match first, then the best rated.
- ClipMCP server for Clip (PayClip) — Mexico's leading acquirer: payment links, card charges, refundsnot reviewedGrowingB
PayRamInstall, configure, operate and integrate self-hosted PayRam crypto payment gateways.not reviewedGrowingB- FortripSearch hotels worldwide, compare live room rates, and create booking payment links.not reviewedGrowingA
- Boundra — Payment Approval Gateway for AI AgentsAllow, ask, or veto — a policy decision point your agent consults before signing any paymentnot reviewedGrowingA
- three.ws Agent PaymentsGoverned x402 payment sessions: pay any endpoint with budget, allowlist & per-tx caps, no key.not reviewedEstablishedB