English Français العربية

HitPay MCP Server

Official registry Finance and payments

Official HitPay MCP: sales, payouts, balances; create payment links and invoices. OAuth; no refunds.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http hitpay-mcp-server 'https://mcp.hit-pay.com/'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hitpay-mcp-server": {
            "type": "http",
            "url": "https://mcp.hit-pay.com/"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. HitPay Plugin for Claude Code
  2. What's Inside
  3. Installation
  4. Setup
  5. Skills
  6. Commands
  7. MCP Tools
  8. Supported Markets
  9. Security
  10. License

HitPay Plugin for Claude Code

Zero-config SEA payment integration for Claude Code. Gives Claude deep knowledge of HitPay's payment gateway plus live API access — so when developers ask for payment integration, Claude scaffolds production-ready code with the right payment methods, webhook handling, and checkout flows.

What's Inside

LayerWhat It DoesFiles
MCP ServerLive API access — create payments, check statuses, query account.mcp.json
SkillsTeach Claude correct code patterns for HitPay integrationskills/ (5 skills)
CommandsDeveloper actions — scaffold, lookup, test, QR checkoutcommands/ (4 commands)

Installation

/plugin marketplace add hit-pay/claude-code-plugin
/plugin install hitpay@hitpay-plugins
Local Development
git clone https://github.com/hit-pay/claude-code-plugin.git hitpay-plugin
claude --plugin-dir ./hitpay-plugin

Setup

Set your HitPay API credentials:

export HITPAY_API_KEY=your_api_key_here
export HITPAY_SALT=your_webhook_salt_here

Get these from your HitPay Dashboard under Settings > Payment Gateway > API Keys.

Skills

Skills are auto-invoked when Claude detects relevant context in your conversation.

SkillTriggers OnWhat It Teaches
payment-integration"add HitPay", "payment checkout", "accept payments"API routes, redirect/QR/selector flows, auth headers, test cards
webhook-handler"webhook signature", "payment notification", "verify webhook"HMAC-SHA256 verification, event types, IP allowlisting, idempotency
payment-methods"methods in Malaysia", "which payment methods", "supported methods"Country-to-method mapping, API values, currencies, unavailable methods
drop-in-ui"embed payment form", "HitPay.js", "checkout popup"HitPay.js script, init options, Next.js integration, event handling
qr-checkout"QR checkout page", "QR payment page", "show QR code for PayNow"Pre-rendered QR images, local HTML page, offline-capable, no CDN

Commands

CommandDescriptionExample
/hitpay:initScaffold a complete integration/hitpay:init nextjs sg,my
/hitpay:methodsLook up payment methods by country/hitpay:methods ph
/hitpay:webhook-testGenerate test webhook payload + curl/hitpay:webhook-test charge.created
/hitpay:qr-checkoutGenerate QR payment page with scannable codes/hitpay:qr-checkout 100 sgd paynow,qris

MCP Tools

When HITPAY_API_KEY is set, Claude can use these tools during development:

Read Operations
  • get_account_status — Check KYC and enabled providers
  • get_balances — Current account balances
  • get_payment_request — Payment request details
  • list_payment_requests — List payment requests
  • list_charges — List charges with filters
  • get_charge_detail — Charge details
  • list_customers — List customers
  • get_customer — Customer details
  • list_invoices — List invoices
  • list_subscription_plans — Subscription plans
  • list_static_qrs — Static QR codes
  • get_supported_qr_methods — Available QR methods
  • get_account_info — Account summary
Create Operations
  • create_payment_request — Create payment with checkout URL
  • create_customer — Create customer record
  • create_invoice — Create invoice
  • create_embedded_qr — Generate QR for payment collection
  • create_static_qr — Create permanent QR (POS)
  • create_webhook_event — Register webhook URL
  • create_recurring_billing — Set up subscription

Supported Markets

MarketCurrencyKey Methods
SingaporeSGDPayNow, GrabPay, ShopeePay, Cards
MalaysiaMYRGrabPay, ShopeePay, Touch 'n Go, FPX
PhilippinesPHPQR Ph, GCash, ShopeePay
ThailandTHBPromptPay, TrueMoney
VietnamVNDVietQR, ZaloPay
IndonesiaIDRQRIS
IndiaINR→SGDUPI
AustraliaAUDPayTo
Cross-borderAuto FX9 borderless QR methods

Security

This plugin follows a safe-by-default approach:

  • Included: Read operations + payment creation (reversible/safe)
  • Excluded from skills: Refunds, deletions, transfers, cancellations (destructive/financial operations)
  • Webhook verification: All generated webhook handlers include HMAC-SHA256 signature checks
  • API keys: Never exposed client-side in generated code

License

MIT

Frequently asked questions

What is HitPay MCP Server?

Official HitPay MCP: sales, payouts, balances; create payment links and invoices. OAuth; no refunds.

How do I install HitPay MCP Server?

It runs as a remote server. In Claude Code: claude mcp add --transport http hitpay-mcp-server 'https://mcp.hit-pay.com/'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does HitPay MCP Server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is HitPay MCP Server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains HitPay MCP Server?

It is published by hit-pay. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.