Power your agent
Perintah milik penerbit sendiri. Bukan endpoint PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code tidak punya tautan instal untuk perintah lokal. Salin perintah di bawah dan jalankan di terminal.
NMI_SECURITY_KEY=<secret> NMI_API_URL=<value> claude mcp add io.github.praveendias1180-easypaydirect-mcp -- npx -y easypaydirect-mcp@0.1.3Jalankan di terminal.
{ "mcpServers": { "io.github.praveendias1180-easypaydirect-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "NMI_SECURITY_KEY": "<secret>", "NMI_API_URL": "<value>" } } }}claude_desktop_config.json
URL remote atau perintah di mesin Anda? Perbedaan kedua cara instal
Jalankan di PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
Buka📖 Documentation: https://praveendias1180.github.io/easypaydirect-mcp/
Unofficial, read-only Model Context Protocol server for the Easy Pay Direct (EPD) / NMI-family payment gateway.
Give an AI assistant (Claude Desktop, Claude Code, or any MCP client) safe, read-only access to your gateway's transactions, subscriptions, recurring plans, and Customer Vault records — so you can ask questions like "find the failed transactions for this customer last week" or "is this subscription still active?" in plain language.
Easy Pay Direct is built on the NMI / Network Merchants gateway platform, so this server works with any NMI white-label gateway — just point it at your gateway's host. EPD is the headline example, not the limit.
⚠️ Not affiliated with, endorsed by, or sponsored by Easy Pay Direct or NMI. "Easy Pay Direct", "EPD", and "NMI" are trademarks of their respective owners. This is an independent open-source client for their public Query API.
This server talks only to the gateway's Query API (/api/query.php) — the reporting endpoint. It has no code path to the transaction endpoint (transact.php), so it cannot charge a card, issue a refund, void a transaction, or modify the vault. An LLM connected to this server can look, but it cannot touch money. See docs/security.md.
Write operations may arrive in a future major version — always opt-in, off by default, and loudly gated.
Requires Node.js 18+.
# no install needed — run straight from npm
npx easypaydirect-mcp
The server speaks MCP over stdio and expects two environment variables:
See docs/configuration.md for how to find your key and host.
No local Node.js needed. Build the image from the repository root, then run it with -i — MCP talks over stdio, so the container needs stdin kept open:
docker build -t easypaydirect-mcp .
docker run --rm -i \
-e NMI_SECURITY_KEY=your_read_only_security_key \
-e NMI_API_URL=https://secure.nmi.com \
easypaydirect-mcp
Or keep the variables in an env file (--env-file .env). .env is already git-ignored — never commit a real key.
Claude Desktop — add to claude_desktop_config.json (see examples/claude-desktop-config.json):
{
"mcpServers": {
"easypaydirect": {
"command": "npx",
"args": ["-y", "easypaydirect-mcp"],
"env": {
"NMI_SECURITY_KEY": "your_read_only_security_key",
"NMI_API_URL": "https://secure.nmi.com"
}
}
}
}
Claude Code:
claude mcp add easypaydirect \
-e NMI_SECURITY_KEY=your_read_only_security_key \
-e NMI_API_URL=https://secure.nmi.com \
-- npx -y easypaydirect-mcp
To use the Docker image instead, swap the command — a bare -e NAME forwards the variable into the container:
claude mcp add easypaydirect \
-e NMI_SECURITY_KEY=your_read_only_security_key \
-e NMI_API_URL=https://secure.nmi.com \
-- docker run --rm -i -e NMI_SECURITY_KEY -e NMI_API_URL easypaydirect-mcp
Full walkthrough: docs/getting-started.md.
The plugin installs the MCP server and an Agent Skill that teaches Claude how to read gateway data correctly — for example that a successful ACH sale is only submitted, not paid, and that EPD timestamps are UTC.
Set the key in your shell (the plugin reads it from the environment), then install:
export NMI_SECURITY_KEY=your_read_only_security_key
export NMI_API_URL=https://secure.nmi.com # optional; your EPD / white-label host
/plugin marketplace add praveendias1180/easypaydirect-mcp
/plugin install easypaydirect@easypaydirect-mcp
Using another client? The skill is a plain SKILL.md — add it to any tool that supports Agent Skills.
All tools are read-only. Full reference in docs/tools.md.
git clone https://github.com/praveendias1180/easypaydirect-mcp.git
cd easypaydirect-mcp
npm install
npm run build # compile TypeScript to dist/
npm run typecheck # type-check only
Local run against the MCP Inspector:
npx @modelcontextprotocol/inspector node dist/index.js
Architecture and how tools map to the Query API: docs/nmi-api-mapping.md.
Planned / under consideration — contributions welcome (see open issues):
search_transactions (#3)Read-only stays the default posture — any write support would be a separate, opt-in, gated major version.
See the changelog for released changes.
Contributions are welcome — this aims to be a small, dependable, read-only MCP server. See CONTRIBUTING.md for the ground rules and dev setup.
New here? Start with a good first issue — each one has context, a task checklist, file pointers, and acceptance criteria. Have a question? Open a Discussion.
MIT © the easypaydirect-mcp contributors.
Read-only MCP server for the Easy Pay Direct (EPD) / NMI-family payment gateway Query API.
{ "mcpServers": { "io.github.praveendias1180-easypaydirect-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "NMI_SECURITY_KEY": "<secret>", "NMI_API_URL": "<value>" } } }}Tool
Belum ada daftar tool. Server remote mendapatkannya setelah pemeriksaan kesehatan pertama.
FAQ
Salin konfigurasi stdio untuk Cursor, Claude Desktop, Claude Code, atau VS Code di halaman ini. Konfigurasi ini memakai instalasi dari penerbit, bukan proxy PlugMCP.
Penerbit mencantumkan variabel lingkungan berikut: NMI_SECURITY_KEY, NMI_API_URL.
Easypaydirect berjalan secara lokal melalui stdio.
Terakhir diperiksa 2026-11-10. Read-only MCP server for the Easy Pay Direct (EPD) / NMI-family payment gateway Query API.