接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y [email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
NMI_SECURITY_KEY=<secret> NMI_API_URL=<value> claude mcp add io.github.praveendias1180-easypaydirect-mcp -- npx -y easypaydirect-mcp@0.1.3在終端機中執行。
{ "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 還是本機指令? 兩種安裝方式的差異
📖 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>" } } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
發布者列出了以下環境變數:NMI_SECURITY_KEY, NMI_API_URL。
Easypaydirect 透過 stdio 在本機執行。
上次檢查時間:2026-11-10。 Read-only MCP server for the Easy Pay Direct (EPD) / NMI-family payment gateway Query API.