MCP Server

Cursor

Use the HitPay MCP Server in Cursor

Use the HitPay MCP Server in Cursor

Use the HitPay MCP Server in Cursor

Use the HitPay MCP Server in Cursor

Cursor can connect to the hosted HitPay MCP server over streamable HTTP. You add the server URL to your MCP config, then complete HitPay sign-in in the browser when Cursor prompts you. No API key is involved.

Cursor can connect to the hosted HitPay MCP server over streamable HTTP. You add the server URL to your MCP config, then complete HitPay sign-in in the browser when Cursor prompts you. No API key is involved.

Sign in with your HitPay login. No API key is involved.

Sign in with your HitPay login. No API key is involved.

~/.cursor/mcp.json
Claude CodeCursorCodex
1# Add the hosted server
2claude mcp add --transport http \
3 hitpay https://mcp.hit-pay.com/
4
5# Then run /mcp inside Claude Code,
6# select hitpay, and choose Authenticate.
1{
2 "mcpServers": {
3 "hitpay": {
4 "url": "https://mcp.hit-pay.com/"
5 }
6 }
7}
1# Codex
2codex mcp add hitpay --url https://mcp.hit-pay.com/

QUICK ANSWER

The hosted server is at https://mcp.hit-pay.com/. Authentication uses OAuth. You sign in with your HitPay dashboard login and authorize the connection for one business. API keys are not involved.

SETUP

Setup

Setup

All clients connect to the same endpoint: https://mcp.hit-pay.com/. Connecting opens the HitPay login page in your browser. Sign in, pick which business to connect under Connect as, and approve.

Only users with the owner or admin role on a business can authorize a connection. Other team-member roles (such as staff or cashier) cannot connect.

60-second setup

1. Add the server to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
"mcpServers": {
"hitpay": {
"url": "https://mcp.hit-pay.com/"
}
}
}

{
"mcpServers": {
"hitpay": {
"url": "https://mcp.hit-pay.com/"
}
}
}

2. When Cursor prompts you, sign in with your HitPay dashboard login, choose the business under Connect as, and approve.

This is the setup published in the HitPay MCP Server docs. Cursor is a desktop client that uses loopback redirects, which those docs say work without extra configuration.

EXAMPLE PROMPTS

Example prompts

The assistant selects tools automatically based on your prompt. You do not call tools directly.

EXAMPLE 1

โ€œWhat were my total sales last month, and how do they compare to the month before?โ€

โ€ข

Mapped tools: get_sales_summary, get_growth_indicator

โ€ข

Reads sales totals and the growth comparison the server exposes for a date range.

EXAMPLE 2

โ€œWhen is my next payout, and what's my current balance?โ€

โ€ข

Mapped tools: get_payout_schedule, get_balances

โ€ข

Reads payout timing and current balances. The server cannot initiate a payout or transfer.

EXAMPLE 3

โ€œCreate a payment link for RM149.90 for a consultation sessionโ€

โ€ข

Mapped tools: create_payment_link

โ€ข

One of the four write tools. The link is visible in your HitPay dashboard and can be deactivated there.

Other documented prompts include: โ€œShow my top-selling products this quarterโ€; โ€œList my recent transactions above RM300โ€; โ€œWhich payment methods do I have enabled?โ€; โ€œInvoice [email protected] RM4,000 for March services and email it to themโ€; โ€œWhich bills are waiting for approval?โ€; and โ€œList my vendorsโ€.

TOOLS

Available tools

Available tools

The server exposes 24 tools for every connected business: 20 read tools and 4 create tools. Businesses with BillPay also get 4 extra read tools for bills and vendors.

Sales & analytics

get_sales_summary, get_top_products, get_sales_by_payment_method, get_sales_by_category, get_transactions_volume, get_channel_distribution, get_growth_indicator

Sales & analytics

get_sales_summary, get_top_products, get_sales_by_payment_method, get_sales_by_category, get_transactions_volume, get_channel_distribution, get_growth_indicator

Transactions

list_charges, get_charge_details, get_charge_refunds

Transactions

list_charges, get_charge_details, get_charge_refunds

Payouts & balances

list_payouts, get_payout_schedule, get_balances

Payouts & balances

list_payouts, get_payout_schedule, get_balances

Commerce records

list_orders, list_invoices, list_payment_links, get_payment_link

Commerce records

list_orders, list_invoices, list_payment_links, get_payment_link

Account

get_payment_methods, get_verification_status, get_integrations

Account

get_payment_methods, get_verification_status, get_integrations

BillPay

list_bills, get_bill, list_vendors, get_vendor. Shown only when the business has BillPay.

BillPay

list_bills, get_bill, list_vendors, get_vendor. Shown only when the business has BillPay.

Create

create_payment_link, create_invoice, create_product, create_recurring_plan

Create

create_payment_link, create_invoice, create_product, create_recurring_plan

Create

create_payment_link, create_invoice, create_product, create_recurring_plan

Picked for you

The assistant selects tools automatically based on your prompt. You do not call them directly.

Picked for you

The assistant selects tools automatically based on your prompt. You do not call them directly.

Bills awaiting approval include an approve_url that opens the bill in the HitPay dashboard. Vendor bank details are not returned.

LIMITS

What the server does not do

The only write operations are the four create_* tools listed above; everything else is read-only.

NOT EXPOSED

The server does not expose

โœ•

Refunds, or cancelling and modifying transactions

โœ•

Payout or transfer operations

โœ•

Submitting, approving, rejecting, funding, or paying bills

โœ•

Changes to account settings, payment methods, or team members

WRITE TOOLS

The only write operations

โœ“

create_payment_link

โœ“

create_invoice

โœ“

create_product

โœ“

create_recurring_plan

SECURITY

SECURITY

Security

Security

Security

Authentication uses OAuth. You sign in with your HitPay dashboard login and authorize the connection for one business. API keys are not involved, and each connection is scoped to the business it was authorized for.

Authentication uses OAuth. You sign in with your HitPay dashboard login and authorize the connection for one business. API keys are not involved, and each connection is scoped to the business it was authorized for.

OAuth 2.0 with PKCE

OAuth 2.0 authorization code flow with PKCE. You approve access on dashboard.hit-pay.com, and your password is never shared with the AI assistant or client.

Business-scoped tokens

A connection can only see the business it was authorized for.

Owner and admin only

Other team-member roles cannot authorize a connection.

Rate limited

Rate limited to 30 requests per minute per business.

Revocable

Remove the connector from your MCP client to stop it making new requests.

dashboard.hit-pay.com
Connect to HitPay
Connect as
Choose a business
Kopi & ClayOwner
Kopi & Clay CafรฉAdmin
Clay StudioStaff
CancelApprove
Your password is never shared with the AI assistant or client.

FAQ

Frequently asked questions

Frequently asked questions

Do I need an API key?

No. The MCP Server authenticates with your HitPay account login via OAuth. API keys are only used by the developer tools (Claude Code Plugin, Agent Skills, and the CLI).

How is this different from the Claude Code Plugin?

Both use the Model Context Protocol, but they serve different audiences. The hosted MCP Server authenticates with your account login and is for querying and operating your business from an AI assistant. The Claude Code Plugin runs locally inside Claude Code, authenticates with an API key, and is for developers building payment integrations. It exposes integration-focused API tools and code-generation skills.

Is it safe to connect to my live business?

The server exposes no destructive operations: it cannot refund, cancel, transfer money, pay bills, or change settings. The only writes are creating payment links, invoices, products, and recurring plans, all of which are visible in your dashboard and can be deactivated there. For bills awaiting approval, it returns a dashboard approve_url instead of approving the bill. Only owner or admin users can authorize a connection, and each connection is scoped to one business.

Can my team members connect?

Team members with the admin role can connect, in addition to the account owner. Other roles (such as staff or cashier) cannot authorize a connection. Tokens are always scoped to the single business that was authorized.

Does it work with the sandbox environment?

Not yet. The MCP Server is currently available for live accounts at mcp.hit-pay.com only.

Which AI assistants can I use?

HitPay documents setup for Claude (web and desktop), Claude Code, Codex, and Cursor. Any other native MCP client that supports the streamable HTTP transport with OAuth and loopback (localhost) redirects also works. Web-based clients other than claude.ai are not currently allowlisted for registration.

Connect Cursor to your HitPay business

Add mcp.hit-pay.com to mcp.json, sign in with your HitPay login, and query sales, payouts, or create payment links.

Connect Cursor to your HitPay business

Add mcp.hit-pay.com to mcp.json, sign in with your HitPay login, and query sales, payouts, or create payment links.

Connect Cursor to your HitPay business

Add mcp.hit-pay.com to mcp.json, sign in with your HitPay login, and query sales, payouts, or create payment links.

Connect Cursor to your HitPay business

Add mcp.hit-pay.com to mcp.json, sign in with your HitPay login, and query sales, payouts, or create payment links.

Singapore

Philippines

Malaysia

Australia & New Zealand

HitPay operates under HitPay Payment Solutions Sdn Bhd (SSM Registration: 202101017021) and Mobiedge E-commerce Sdn Bhd (SSM Registration: 201501003595). HitPay Payment Solutions Sdn Bhd (HitPay Malaysia) is a technology service provider and partners with Stripe Payments Malaysia Sdn Bhd, a registered merchant acquirer by the Bank Negara Malaysia under the Financial Services Act 2013 when it comes to undertaking the relevant regulated activities.


HitPay Malaysia also works as a payment service agent appointed by RHB Bank as well as an approved money service business agent under the principal license, MoneyMatch Sdn Bhd. Mobiedge E-commerce Sdn Bhd is a wholly-owned subsidiary of HitPay Malaysia and is a registered merchant acquirer regulated by Bank Negara Malaysia.


HITPAY PAYMENT SOLUTIONS SDN. BHD.

Level 1 & 2, Tower 3, Avenue 7 Horizon 2 Bangsar South City, Bangsar South, 59200 Kuala Lumpur, Malaysia

ยฉ 2026 HitPay Payment Solutions Pte Ltd. All rights reserved.

Worldโ€™s Top Fintech Companies 2026 award badge by CNBC and Statista.
Singaporeโ€™s Top Fintech Companies 2026 award badge by Tech in Asia.

BNM Registered Acquirer

PCI DSS Certified

Singapore

Philippines

Malaysia

Australia & New Zealand

HitPay operates under HitPay Payment Solutions Sdn Bhd (SSM Registration: 202101017021) and Mobiedge E-commerce Sdn Bhd (SSM Registration: 201501003595). HitPay Payment Solutions Sdn Bhd (HitPay Malaysia) is a technology service provider and partners with Stripe Payments Malaysia Sdn Bhd, a registered merchant acquirer by the Bank Negara Malaysia under the Financial Services Act 2013 when it comes to undertaking the relevant regulated activities.


HitPay Malaysia also works as a payment service agent appointed by RHB Bank as well as an approved money service business agent under the principal license, MoneyMatch Sdn Bhd. Mobiedge E-commerce Sdn Bhd is a wholly-owned subsidiary of HitPay Malaysia and is a registered merchant acquirer regulated by Bank Negara Malaysia.


HITPAY PAYMENT SOLUTIONS SDN. BHD.

Level 1 & 2, Tower 3, Avenue 7 Horizon 2 Bangsar South City, Bangsar South, 59200 Kuala Lumpur, Malaysia

ยฉ 2026 HitPay Payment Solutions Pte Ltd. All rights reserved.

Worldโ€™s Top Fintech Companies 2026 award badge by CNBC and Statista.
Singaporeโ€™s Top Fintech Companies 2026 award badge by Tech in Asia.

BNM Registered Acquirer

PCI DSS Certified

Singapore

Philippines

Malaysia

Australia & New Zealand

HitPay operates under HitPay Payment Solutions Sdn Bhd (SSM Registration: 202101017021) and Mobiedge E-commerce Sdn Bhd (SSM Registration: 201501003595). HitPay Payment Solutions Sdn Bhd (HitPay Malaysia) is a technology service provider and partners with Stripe Payments Malaysia Sdn Bhd, a registered merchant acquirer by the Bank Negara Malaysia under the Financial Services Act 2013 when it comes to undertaking the relevant regulated activities.


HitPay Malaysia also works as a payment service agent appointed by RHB Bank as well as an approved money service business agent under the principal license, MoneyMatch Sdn Bhd. Mobiedge E-commerce Sdn Bhd is a wholly-owned subsidiary of HitPay Malaysia and is a registered merchant acquirer regulated by Bank Negara Malaysia.


HITPAY PAYMENT SOLUTIONS SDN. BHD.

Level 1 & 2, Tower 3, Avenue 7 Horizon 2 Bangsar South City, Bangsar South, 59200 Kuala Lumpur, Malaysia

ยฉ 2026 HitPay Payment Solutions Pte Ltd. All rights reserved.

Worldโ€™s Top Fintech Companies 2026 award badge by CNBC and Statista.
Singaporeโ€™s Top Fintech Companies 2026 award badge by Tech in Asia.

BNM Registered Acquirer

PCI DSS Certified

Singapore

Philippines

Malaysia

Australia & New Zealand

HitPay operates under HitPay Payment Solutions Sdn Bhd (SSM Registration: 202101017021) and Mobiedge E-commerce Sdn Bhd (SSM Registration: 201501003595). HitPay Payment Solutions Sdn Bhd (HitPay Malaysia) is a technology service provider and partners with Stripe Payments Malaysia Sdn Bhd, a registered merchant acquirer by the Bank Negara Malaysia under the Financial Services Act 2013 when it comes to undertaking the relevant regulated activities.


HitPay Malaysia also works as a payment service agent appointed by RHB Bank as well as an approved money service business agent under the principal license, MoneyMatch Sdn Bhd. Mobiedge E-commerce Sdn Bhd is a wholly-owned subsidiary of HitPay Malaysia and is a registered merchant acquirer regulated by Bank Negara Malaysia.


HITPAY PAYMENT SOLUTIONS SDN. BHD.

Level 1 & 2, Tower 3, Avenue 7 Horizon 2 Bangsar South City, Bangsar South, 59200 Kuala Lumpur, Malaysia

ยฉ 2026 HitPay Payment Solutions Pte Ltd. All rights reserved.

Worldโ€™s Top Fintech Companies 2026 award badge by CNBC and Statista.
Singaporeโ€™s Top Fintech Companies 2026 award badge by Tech in Asia.

BNM Registered Acquirer

PCI DSS Certified