Payment APIs
MCP Server
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 SGD 100”
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 SGD 49.90 for a consultation session”
•
“Invoice [email protected] SGD 1,200 for March services and email it to them”
READS DATA, BILLPAY ONLY
BillPay
•
“Which bills are waiting for approval?”
•
“List my vendors”
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.
Claude Code
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.
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.
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
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.
FAQ
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.
