# HitPay MCP Server

Wires your agent into the HitPay gateway: create payments, invoices and QR codes, read balances, all from the chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: hit-pay
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hit-pay/claude-code-plugin
- Updated: 2026-03-17
- HTML: https://affpapa.org/en/nevibecode/mcp/hitpay-mcp-server

## What it does

The server exposes HitPay's API to Claude. Your agent can pull account status and balances, issue an invoice, generate a payment request with a checkout URL, register a customer or set up recurring billing. Five bundled skills cover the integration side: API routes, webhook handling, the HitPay.js embed, and QR checkout pages.

Setup needs two environment variables, `HITPAY_API_KEY` and `HITPAY_SALT`. No key means the tools stay dark. The salt feeds HMAC-SHA256 signature checks, and every webhook handler the plugin writes includes them.

Only reads and payment creation ship in the skills. Refunds, deletions, transfers and cancellations are left out on purpose, so the agent cannot touch destructive money operations. API keys never land in client-side code. Markets span Singapore, Malaysia, the Philippines, Thailand, Vietnam, Indonesia, India and Australia, with SGD, MYR, PHP, THB, VND, IDR, INR and AUD.

## Requirements
- Remote server: `https://mcp.hit-pay.com/`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.hit-pay.com/
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add hitpay-mcp-server --url https://mcp.hit-pay.com/
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hitpay-mcp-server": {
            "url": "https://mcp.hit-pay.com/"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hitpay-mcp-server": {
            "type": "http",
            "url": "https://mcp.hit-pay.com/"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http hitpay-mcp-server https://mcp.hit-pay.com/
```

## When to use it
- spin up a payment link and hand it to a customer
- issue an invoice without opening the dashboard
- check account balance and KYC status
- generate a webhook handler with signature verification
- build a QR page for PayNow or QRIS

## Example prompts
- Scaffold a HitPay integration for Next.js, Singapore and Malaysia
- Which payment methods work in the Philippines?
- Generate a test webhook for `charge.created`

## Similar
- [BlindPay](https://affpapa.org/en/nevibecode/mcp/blindpay.md) — MCP server · ★ 9
- [webhook-integration](https://affpapa.org/en/nevibecode/skills/webhook-integration.md) — skill · 1100 installs
- [Yolfi Payments MCP](https://affpapa.org/en/nevibecode/mcp/yolfi-payments-mcp.md) — MCP server · ★ 177
- [mcp-pagseguro](https://affpapa.org/en/nevibecode/mcp/mcp-pagseguro.md) — MCP server · ★ 274
- [subscription-integration](https://affpapa.org/en/nevibecode/skills/subscription-integration.md) — skill · 1000 installs
- [stripe-integration](https://affpapa.org/en/nevibecode/skills/sickn33-stripe-integration.md) — skill · 999 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md