Model Context Protocol · read-only

easypaydirect-mcp

Give Claude — or any MCP client — safe, read-only access to your Easy Pay Direct / NMI‑family gateway: transactions, subscriptions, recurring plans, and the Customer Vault, in plain language.

Get started Tools reference View on npm ↗

npx easypaydirect-mcp

Read‑only by design. The server talks only to the gateway’s Query API (/api/query.php) and has no code path to the transaction endpoint (transact.php) — so it cannot charge, refund, void, or modify subscriptions or the vault, even if a model is prompted to. See Security.

Why it exists

Easy Pay Direct is built on the NMI / Network Merchants platform, and no vendor in that ecosystem ships an MCP server. This one works for EPD and every NMI white‑label gateway — just point it at your host. EPD is the headline example, not the limit.

🔎

Transactions

Look up one by ID, or search by date range, condition, action type, source, and more.

🔁

Subscriptions & plans

Inspect recurring subscriptions and billing plans straight from the gateway.

🗄️

Customer Vault

Read stored customer profiles — metadata only, never full card numbers.

🔐

Safe by construction

Key stays in the environment; the toolset is lookups only. No writes exist to misuse.

Quick start

Run it over stdio with two environment variables:

Variable	Required	Description
NMI_SECURITY_KEY	✅	Gateway API security key (a read‑only key is recommended).
NMI_API_URL	—	Gateway base URL. Defaults to https://secure.nmi.com; set to your EPD / white‑label host.

Then wire it into Claude Desktop or Claude Code — full walkthrough in Getting started.

Documentation

• Getting started — install and connect to Claude
• Configuration — environment variables and finding your key
• Tools reference — all seven read‑only tools
• Security — posture, credential handling, reporting
• Architecture & API mapping — how tools map to the Query API

---

MIT‑licensed · Unofficial — not affiliated with Easy Pay Direct or NMI.