Payment APIs

MCP Server

Connect Claude and Cursor to your HitPay business

Connect Claude and Cursor to your HitPay business

Connect Claude and Cursor to your HitPay business

Connect Claude and Cursor to your HitPay business

The HitPay MCP Server is a hosted Model Context Protocol server at https://mcp.hit-pay.com/. It gives AI assistants access to your HitPay business data: you can query sales, transactions, payouts, balances, and BillPay bills and vendors in natural language, and create payment links, invoices, products, and recurring plans.

The HitPay MCP Server is a hosted Model Context Protocol server at https://mcp.hit-pay.com/. It gives AI assistants access to your HitPay business data: you can query sales, transactions, payouts, balances, and BillPay bills and vendors in natural language, and create payment links, invoices, products, and recurring plans.

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

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

Assistant
What were my total sales last month, and how do they compare to the month before?
get_sales_summary
get_growth_indicator
Your sales last month were RM160,700, up 12% on the month before (RM143,470).
Ask anything
Sales, last monthDemo store
RM160,700
+12% vs month before

QUICK ANSWER

This is not the Claude Code Plugin. The plugin is a developer tool for building payment integrations with an API key. The MCP Server is for operating your live business from an assistant, using your HitPay login.

EXAMPLE PROMPTS

What you can ask

Once connected, the assistant can answer questions and perform tasks like these.

READS DATA

Sales & transactions

•

“What were my total sales last month, and how do they compare to the month before?”

•

“Show my top-selling products this quarter”

•

“List my recent transactions above RM300”

READS DATA

Payouts & account

•

“When is my next payout, and what's my current balance?”

•

“Which payment methods do I have enabled?”

CREATES A RECORD

Create

•

“Create a payment link for RM149.90 for a consultation session”

•

“Invoice [email protected] RM4,000 for March services and email it to them”

READS DATA, BILLPAY ONLY

BillPay

•

“Which bills are waiting for approval?”

•

“List my vendors”

SETUP

SETUP

Set up in 60 seconds

Set up in 60 seconds

Set up in 60 seconds

All clients use 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 can authorize a connection.

All clients use 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 can authorize a connection.

Claude (web and desktop)

HitPay is listed in the Claude connector directory, so no URL entry is needed. 1. Open the Directory in claude.ai or the Claude desktop app and select Connectors. 2. Search for HitPay and add it, or open the listing. 3. Click Connect, sign in, and approve access.

Cursor

Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project), then complete sign-in when Cursor prompts you.

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

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

Claude Code

claude mcp add --transport http hitpay https://mcp.hit-pay.com/

claude mcp add --transport http hitpay https://mcp.hit-pay.com/

Then run /mcp inside Claude Code, select hitpay, and choose Authenticate.

Other clients

Codex is also documented in the MCP Server docs. ChatGPT is not a confirmed path: HitPay docs say web-based clients other than claude.ai are not currently allowlisted for registration.

codex mcp add hitpay --url https://mcp.hit-pay.com/

codex mcp add hitpay --url https://mcp.hit-pay.com/

Terminal
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/

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

What is the HitPay MCP Server?

It is HitPay's official hosted Model Context Protocol server at https://mcp.hit-pay.com/. It lets AI assistants such as Claude query your HitPay business data — sales, transactions, payouts, balances, and BillPay bills and vendors — and create payment links, invoices, products, and recurring plans. You sign in with your HitPay login over OAuth. No API key is involved.

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).

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 streamable HTTP, OAuth, and loopback (localhost) redirects also works. Web-based clients other than claude.ai are not currently allowlisted for registration, so ChatGPT is not a confirmed path.

Is this the same as the Claude Code Plugin?

No. The hosted MCP Server is for querying and operating your live business from an AI assistant, using your HitPay login. The Claude Code Plugin is a developer tool that runs locally in Claude Code, uses an API key, and helps you build payment integrations.

Is it safe to connect my live business?

The server cannot refund, cancel, transfer money, pay bills, or change settings. The only writes are creating payment links, invoices, products, and recurring plans, which appear in your dashboard and can be deactivated there. Only owner or admin users can connect, and each connection is scoped to one business. The server is available for live accounts only; there is no sandbox endpoint yet.

How do I get started?

In Claude, add HitPay from the connector directory, click Connect, and sign in. In Cursor, add https://mcp.hit-pay.com/ to mcp.json and complete the sign-in prompt. In Claude Code, run: claude mcp add --transport http hitpay https://mcp.hit-pay.com/ then authenticate with /mcp. Full steps are on the client setup pages and in the docs.

Connect Claude, Cursor, or Claude Code to your HitPay business

Query sales, payouts and balances, or create payment links. Sign in with your HitPay login. No API key.

Connect Claude, Cursor, or Claude Code to your HitPay business

Query sales, payouts and balances, or create payment links. Sign in with your HitPay login. No API key.

Connect Claude, Cursor, or Claude Code to your HitPay business

Query sales, payouts and balances, or create payment links. Sign in with your HitPay login. No API key.

Connect Claude, Cursor, or Claude Code to your HitPay business

Query sales, payouts and balances, or create payment links. Sign in with your HitPay login. No API key.

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