HitPay MCP server
Commit Oct 30, 2026Enables AI clients to manage HitPay payments, invoices, and account balances through live API access and automated integration scaffolding.
Also known as hit-pay/claude-code-plugin, claude-code-plugin
- Stars
- 1
- Tools
- 20
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 30, 2026
- License
- MIT
What is HitPay MCP?
HitPay enables AI clients to manage HitPay payments, invoices, and account balances through live API access and automated integration scaffolding. It exposes 20 tools, such as get_account_status, get_balances, get_payment_request.
Summary generated from the project's README
About HitPay MCP server
Managing Southeast Asian payment integrations and business transactions becomes direct through HitPay MCP Server. Developers use this tool to scaffold production-ready code for checkout flows, webhook handling, and payment methods across markets like Singapore, Malaysia, and the Philippines. It provides deep knowledge of HitPay patterns to help build Next.js integrations or embeddable payment forms using HitPay.js.
Users can connect via a local setup requiring HITPAY_API_KEY and HITPAY_SALT environment variables, or use the hosted version which utilizes OAuth for business owners and admins. The local version allows for technical tasks like generating test webhook payloads with /hitpay:webhook-test or scaffolding projects with /hitpay:init. The hosted server enables querying live sales, transactions, and account balances.
Through specific MCP tools, the server handles read operations like get_balances and list_invoices, alongside create operations such as create_payment_request and create_recurring_billing. It maintains security by excluding destructive actions like refunds or cancellations from its automated skills.
What you can do with it
- 1Scaffold payment integrationsGenerate a complete Next.js payment integration for specific markets like Singapore or Malaysia.
- 2Test webhook securityCreate a test webhook payload and a curl command to verify payment notifications.
- 3Manage business financesQuery live sales, transactions, payouts, and account balances through an OAuth connection.
- 4Generate QR paymentsCreate a scannable QR payment page for specific amounts and currencies.
Written from the project's README. Every use case is checked against a quote from it.
How to install HitPay MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall HitPay MCP in Claude Code
$ claude mcp add --transport http claude-code-plugin https://mcp.hit-pay.com/Install HitPay MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"claude-code-plugin": {
"url": "https://mcp.hit-pay.com/"
}
}
}Install HitPay MCP in VS Code
.vscode/mcp.json
{
"servers": {
"claude-code-plugin": {
"type": "http",
"url": "https://mcp.hit-pay.com/"
}
}
}Install HitPay MCP in VS Code CLI
$ code --add-mcp '{"name":"claude-code-plugin","type":"http","url":"https://mcp.hit-pay.com/"}'Install HitPay MCP in Codex
$ codex mcp add claude-code-plugin --url https://mcp.hit-pay.com/Install HitPay MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.claude-code-plugin] url = "https://mcp.hit-pay.com/"
Install HitPay MCP in Gemini CLI
$ gemini mcp add -s user --transport http claude-code-plugin https://mcp.hit-pay.com/Install HitPay MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"claude-code-plugin": {
"url": "https://mcp.hit-pay.com/",
"type": "http"
}
}
}HitPay MCP tools 20
Detected from the READMEget_account_statusget_balancesget_payment_requestlist_payment_requestslist_chargesget_charge_detaillist_customersget_customerlist_invoiceslist_subscription_planslist_static_qrsget_supported_qr_methods
| get_account_status | — | |
| get_balances | — | |
| get_payment_request | — | |
| list_payment_requests | — | |
| list_charges | — | |
| get_charge_detail | — | |
| list_customers | — | |
| get_customer | — | |
| list_invoices | — | |
| list_subscription_plans | — | |
| list_static_qrs | — | |
| get_supported_qr_methods | — |
Show all 20 toolsShow fewer tools
get_account_infocreate_payment_requestcreate_customercreate_invoicecreate_embedded_qrcreate_static_qrcreate_webhook_eventcreate_recurring_billing
| get_account_info | — | |
| create_payment_request | — | |
| create_customer | — | |
| create_invoice | — | |
| create_embedded_qr | — | |
| create_static_qr | — | |
| create_webhook_event | — | |
| create_recurring_billing | — |
Configuration
HITPAY_API_KEYHITPAY_SALT
| Name | Description | |
|---|---|---|
| HITPAY_API_KEY | — | |
| HITPAY_SALT | — |
Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablehit-pay/claude-code-plugin is public and reachablegithub.com/hit-pay/claude-code-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-30github.com/hit-pay/claude-code-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model20 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubHitPay 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
| Layer | What It Does | Files |
|---|---|---|
| MCP Server | Live API access — create payments, check statuses, query account | .mcp.json |
| Skills | Teach Claude correct code patterns for HitPay integration | skills/ (5 skills) |
| Commands | Developer actions — scaffold, lookup, test, QR checkout | commands/ (4 commands) |
Installation
Via Marketplace (recommended)
/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.
| Skill | Triggers On | What 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
| Command | Description | Example |
|---|---|---|
/hitpay:init |
Scaffold a complete integration | /hitpay:init nextjs sg,my |
/hitpay:methods |
Look up payment methods by country | /hitpay:methods ph |
/hitpay:webhook-test |
Generate test webhook payload + curl | /hitpay:webhook-test charge.created |
/hitpay:qr-checkout |
Generate QR payment page with scannable codes | /hitpay:qr-checkout 100 sgd paynow |
MCP Tools
When HITPAY_API_KEY is set, Claude can use these tools during development:
Read Operations
get_account_status— Check KYC and enabled providersget_balances— Current account balancesget_payment_request— Payment request detailslist_payment_requests— List payment requestslist_charges— List charges with filtersget_charge_detail— Charge detailslist_customers— List customersget_customer— Customer detailslist_invoices— List invoiceslist_subscription_plans— Subscription planslist_static_qrs— Static QR codesget_supported_qr_methods— Available QR methodsget_account_info— Account summary
Create Operations
create_payment_request— Create payment with checkout URLcreate_customer— Create customer recordcreate_invoice— Create invoicecreate_embedded_qr— Generate QR for payment collectioncreate_static_qr— Create permanent QR (POS)create_webhook_event— Register webhook URLcreate_recurring_billing— Set up subscription
Hosted HitPay MCP Server
HitPay also runs an official MCP server at https://mcp.hit-pay.com/ for querying and acting on your live HitPay business: sales, transactions, payouts and balances, plus creating payment links, invoices, products and recurring plans. It signs you in with your HitPay login over OAuth, so there is no API key to set. Only business owners and admins can authorize it.
claude mcp add --transport http hitpay https://mcp.hit-pay.com/
Then run /mcp and choose hitpay to sign in. See the MCP server docs.
Supported Markets
| Market | Currency | Key Methods |
|---|---|---|
| Singapore | SGD | PayNow, GrabPay, ShopeePay, Cards |
| Malaysia | MYR | GrabPay, ShopeePay, Touch 'n Go, FPX |
| Philippines | PHP | QR Ph, GCash, ShopeePay |
| Thailand | THB | PromptPay, TrueMoney |
| Vietnam | VND | VietQR, ZaloPay |
| India | INR→SGD | UPI |
| Australia | AUD | PayTo |
| Cross-border | Auto FX | 9 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
HitPay MCP questions
How do I add HitPay MCP to Claude Code?
Run claude mcp add --transport http claude-code-plugin https://mcp.hit-pay.com/ in your terminal. Add --scope user to make it available in every project.
How do I add HitPay MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does HitPay MCP provide?
It exposes 20 tools, including get_account_status, get_balances, get_payment_request, list_payment_requests, list_charges.