MCP server HitPay
Commit 30 de out. de 2026Permite que clientes de IA gerenciem pagamentos, faturas e saldos de conta da HitPay por meio de acesso à API em tempo real e scaffolding de integração automatizado.
Também conhecido como hit-pay/claude-code-plugin, claude-code-plugin
- Stars
- 1
- Ferramentas
- 20
- Downloads, 30 dias
- —
- Versão mais recente
- 1.0.0
- Último commit
- 30 de out. de 2026
- Licença
- MIT
O que é o MCP HitPay?
Permite que clientes de IA gerenciem pagamentos, faturas e saldos de conta da HitPay por meio de acesso à API em tempo real e scaffolding de integração automatizado. Ele expõe 20 ferramentas, como get_account_status, get_balances, get_payment_request.
Resumo gerado a partir do README do projeto
Sobre o MCP server de HitPay
Gerenciar integrações de pagamento e transações comerciais no Sudeste Asiático torna-se direto com o HitPay MCP Server. Desenvolvedores utilizam esta ferramenta para realizar o scaffolding de código pronto para produção para fluxos de checkout, manipulação de webhooks e métodos de pagamento em mercados como Singapura, Malásia e Filipinas. Ele fornece conhecimento profundo dos padrões da HitPay para ajudar a construir integrações Next.js ou formulários de pagamento incorporáveis usando HitPay.js.
Os usuários podem se conectar via uma configuração local que requer as variáveis de ambiente HITPAY_API_KEY e HITPAY_SALT, ou usar a versão hospedada que utiliza OAuth para proprietários de empresas e administradores. A versão local permite tarefas técnicas como gerar payloads de teste de webhook com /hitpay:webhook-test ou realizar o scaffolding de projetos com /hitpay:init. O servidor hospedado permite consultar vendas em tempo real, transações e saldos de conta.
Por meio de ferramentas MCP específicas, o servidor lida com operações de leitura como get_balances e list_invoices, além de operações de criação como create_payment_request e create_recurring_billing. Ele mantém a segurança excluindo ações destrutivas, como reembolsos ou cancelamentos, de suas SKILLs automatizadas.
O que você pode fazer com ele
- 1Scaffold de integrações de pagamentoGere uma integração de pagamento Next.js completa para mercados específicos como Singapura ou Malásia.
- 2Testar segurança de webhookCrie um payload de teste de webhook e um comando curl para verificar notificações de pagamento.
- 3Gerenciar finanças empresariaisConsulte vendas em tempo real, transações, payouts e saldos de conta por meio de uma conexão OAuth.
- 4Gerar pagamentos via QRCrie uma página de pagamento via QR Code escaneável para valores e moedas específicos.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP HitPay
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP HitPay no Claude Code
$ claude mcp add --transport http claude-code-plugin https://mcp.hit-pay.com/Instalar o MCP HitPay no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"claude-code-plugin": {
"url": "https://mcp.hit-pay.com/"
}
}
}Instalar o MCP HitPay no VS Code
.vscode/mcp.json
{
"servers": {
"claude-code-plugin": {
"type": "http",
"url": "https://mcp.hit-pay.com/"
}
}
}Instalar o MCP HitPay no VS Code CLI
$ code --add-mcp '{"name":"claude-code-plugin","type":"http","url":"https://mcp.hit-pay.com/"}'Instalar o MCP HitPay no Codex
$ codex mcp add claude-code-plugin --url https://mcp.hit-pay.com/Instalar o MCP HitPay no Codex config.toml
~/.codex/config.toml
[mcp_servers.claude-code-plugin] url = "https://mcp.hit-pay.com/"
Instalar o MCP HitPay no Gemini CLI
$ gemini mcp add -s user --transport http claude-code-plugin https://mcp.hit-pay.com/Instalar o MCP HitPay no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"claude-code-plugin": {
"url": "https://mcp.hit-pay.com/",
"type": "http"
}
}
}Ferramentas do MCP HitPay 20
Detectadas a partir do 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 | — |
Mostrar todas as 20 ferramentasMostrar menos ferramentas
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 | — |
Configuração
HITPAY_API_KEYHITPAY_SALT
| Nome | Descrição | Tipo |
|---|---|---|
| HITPAY_API_KEY | — | |
| HITPAY_SALT | — |
Verificações automatizadas
Executado em 13 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelhit-pay/claude-code-plugin is public and reachablegithub.com/hit-pay/claude-code-plugin ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-10-30github.com/hit-pay/claude-code-plugin ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo20 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNo tool named like delete, drop or execPassou
- O endpoint remoto responde ao handshake do MCPHTTPS endpoint answered 401 (sign-in required)Passou
README
Ver no 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
Perguntas sobre o MCP HitPay
Como adiciono o MCP HitPay ao Claude Code?
Execute claude mcp add --transport http claude-code-plugin https://mcp.hit-pay.com/ no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP HitPay ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Quais ferramentas o MCP HitPay oferece?
Ele expõe 20 ferramentas, incluindo get_account_status, get_balances, get_payment_request, list_payment_requests, list_charges.