How do I install Easypaydirect?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Easypaydirect need an API key?

The publisher lists these environment variables: NMI_SECURITY_KEY, NMI_API_URL.

What transport does Easypaydirect use?

Easypaydirect runs locally over stdio.

When was Easypaydirect last checked?

Last checked 2026-11-10. Read-only MCP server for the Easy Pay Direct (EPD) / NMI-family payment gateway Query API.

Easypaydirect MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

NMI_SECURITY_KEY — Gateway API security key (a read-only key is recommended).
NMI_API_URL — Gateway API base URL; defaults to https://secure.nmi.com. Set to your EPD / white-label host.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1NMI_SECURITY_KEY=<secret> NMI_API_URL=<value> claude mcp add io.github.praveendias1180-easypaydirect-mcp -- npx -y easypaydirect-mcp@0.1.3

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.praveendias1180-easypaydirect-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "NMI_SECURITY_KEY": "<secret>",11        "NMI_API_URL": "<value>"12      }13    }14  }15}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

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.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.3

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

easypaydirect-mcp

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

Why read-only?

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.

Install & run

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:

Variable	Required	Description
`NMI_SECURITY_KEY`	✅	Your gateway API security key (a read-only key is recommended). Merchant portal → Settings → Security Keys.
`NMI_API_URL`	—	Gateway API base URL. Defaults to `https://secure.nmi.com`. For EPD/white-labels, set this to your gateway's host.

See docs/configuration.md for how to find your key and host.

Run with Docker

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.

Connect it to Claude

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.

Claude Code plugin (server + skill)

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.

Tools

All tools are read-only. Full reference in docs/tools.md.

Tool	What it does
`get_transaction`	Fetch one transaction by gateway transaction ID.
`search_transactions`	Search transactions by date range + filters (condition, action type, payment type, source, email, order id).
`get_subscription`	Fetch one recurring subscription by ID.
`list_subscriptions`	List recurring subscriptions, optionally by created/updated date range.
`list_recurring_plans`	List recurring billing plans (or one by `plan_id`).
`get_customer_vault_record`	Fetch one stored Customer Vault record by ID.
`list_customer_vault`	List stored Customer Vault records, optionally by date range.

Develop

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.

Roadmap

Planned / under consideration — contributions welcome (see open issues):

Tests — unit suite with recorded Query API fixtures (#1)
Friendlier dates — accept ISO-8601 in date filters (#2)
More filters — merchant-defined fields on search_transactions (#3)
Better errors — map NMI response codes to actionable messages (#4)
Distribution — publish-on-release automation (#8)
Docs — response-field reference (#9)

Read-only stays the default posture — any write support would be a separate, opt-in, gated major version.

See the changelog for released changes.

Contributing

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.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Easypaydirect?

Does Easypaydirect need an API key?

What transport does Easypaydirect use?

When was Easypaydirect last checked?

Documentation

easypaydirect-mcp

Why read-only?

Install & run

Run with Docker

Connect it to Claude

Claude Code plugin (server + skill)

Tools

Develop

Roadmap

Contributing

License