MCP.Market

Zen MCP server

by krystiangw·io.github.krystiangw/zen·v0.1.1

Unofficial MCP server for the ZEN.com Payment Gateway: payment links, transactions, refunds.

B78/100grade B
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
Growing

0 stars60 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • cancel_transactionwrite action

    Destructive write: cancel a ZEN transaction. This may prevent or reverse payment processing; confirm before use.

  • capture_transaction

    Destructive write: capture an authorized transaction, causing funds to be collected. Confirm before use.

  • create_customerwrite action

    Write operation: create a customer record in ZEN for future payment flows; this stores personal data.

  • create_payment_linkwrite action

    Write operation: create a hosted ZEN checkout link and QR code for a customer to pay.

  • create_payoutwrite action

    Highest-risk destructive write: send money outward through ZEN. Verify recipient, channel, currency, and amount before use.

  • download_report

    Read-only: request a transaction or settlement report download from ZEN.

  • get_payment_link

    Read-only: retrieve a hosted ZEN payment link by ID.

  • get_payout

    Read-only: retrieve a ZEN payout by its ZEN ID.

  • get_transaction

    Read-only: retrieve a transaction by exactly one ZEN ID or merchant transaction ID.

  • list_payment_links

    Read-only: list hosted ZEN payment links.

  • list_payment_methods

    Read-only: list payment methods available to the configured ZEN terminal.

  • list_supported_currencies

    Read-only: list currencies confirmed in the public ZEN documentation.

  • refund_transactionwrite action

    Destructive write: return all or part of a payment to the customer. Confirm the transaction and amount before use.

  • verify_webhook_signature

    Read-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

no findings
  • 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
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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-mcp

For 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.

  • Clip
    MCP server for Clip (PayClip) — Mexico's leading acquirer: payment links, card charges, refunds
    B
  • PayRam
    Install, configure, operate and integrate self-hosted PayRam crypto payment gateways.
    B
  • Fortrip
    Search hotels worldwide, compare live room rates, and create booking payment links.
    A
  • Boundra — Payment Approval Gateway for AI Agents
    Allow, ask, or veto — a policy decision point your agent consults before signing any payment
    A
  • three.ws Agent Payments
    Governed x402 payment sessions: pay any endpoint with budget, allowlist & per-tx caps, no key.
    B

More from krystiangw →