Lets an AI client create split bill payment pages and track collections via PayNow in Singapore.
Also known as JojoYay/splitbill-mcp, splitbill-mcp
- Stars
- 0
- Tools
- 3
- Downloads, 30 days
- —
- Latest version
- 1.0.7
- Last commit
- Nov 4, 2026
- License
- MIT
What is SplitBill MCP?
SplitBill lets an AI client create split bill payment pages and track collections via PayNow in Singapore. It exposes 3 tools, such as create_split, list_splits, get_split.
Summary generated from the project's README
About SplitBill MCP server
SplitBill allows developers to integrate bill splitting and payment collection via PayNow into AI clients. It is designed for users in Singapore who need to divide costs from receipts or total amounts among multiple participants. The server facilitates the creation of payment pages that include PayNow QR codes, allowing participants to pay directly from their own banking apps without money passing through the service.
Users can connect via a remote server using OAuth 2.1, which handles dynamic client registration and PKCE, or through a local stdio installation using a token starting with wkn_. The toolset includes create_split for generating pages with custom amounts or equal splits, list_splits to view collection progress, and get_split to check individual payment statuses. The system supports English, Japanese, and Chinese, and automatically deletes pages seven days after the final payment is made.
What you can do with it
- 1Divide a group dinner costAsk the AI to split a specific total amount among a set number of people.
- 2Handle custom individual amountsInstruct the AI to assign a specific lower amount to one person while re-splitting the remainder.
- 3Monitor collection progressRequest a summary of how much money has been collected and who still owes funds.
- 4Manage payments with receiptsCreate a split page that allows participants to view the original receipt attached to the total.
Written from the project's README. Every use case is checked against a quote from it.
How to install SplitBill MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall SplitBill MCP in Claude Code
$ claude mcp add --env 'SPLITBILL_TOKEN=<YOUR_SPLITBILL_TOKEN>' splitbill-mcp -- npx -y splitbill-mcpInstall SplitBill MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"splitbill-mcp": {
"command": "npx",
"args": [
"-y",
"splitbill-mcp"
],
"env": {
"SPLITBILL_TOKEN": "<YOUR_SPLITBILL_TOKEN>"
}
}
}
}Install SplitBill MCP in VS Code
.vscode/mcp.json
{
"servers": {
"splitbill-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"splitbill-mcp"
],
"env": {
"SPLITBILL_TOKEN": "<YOUR_SPLITBILL_TOKEN>"
}
}
}
}Install SplitBill MCP in VS Code CLI
$ code --add-mcp '{"name":"splitbill-mcp","type":"stdio","command":"npx","args":["-y","splitbill-mcp"],"env":{"SPLITBILL_TOKEN":"<YOUR_SPLITBILL_TOKEN>"}}'Install SplitBill MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"splitbill-mcp": {
"command": "npx",
"args": [
"-y",
"splitbill-mcp"
],
"env": {
"SPLITBILL_TOKEN": "<YOUR_SPLITBILL_TOKEN>"
}
}
}
}Install SplitBill MCP in Codex
$ codex mcp add splitbill-mcp --env 'SPLITBILL_TOKEN=<YOUR_SPLITBILL_TOKEN>' -- npx -y splitbill-mcpInstall SplitBill MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.splitbill-mcp] command = "npx" args = ["-y", "splitbill-mcp"] [mcp_servers.splitbill-mcp.env] SPLITBILL_TOKEN = "<YOUR_SPLITBILL_TOKEN>"
Install SplitBill MCP in Gemini CLI
$ gemini mcp add -s user -e 'SPLITBILL_TOKEN=<YOUR_SPLITBILL_TOKEN>' splitbill-mcp npx -- -y splitbill-mcpInstall SplitBill MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"splitbill-mcp": {
"command": "npx",
"args": [
"-y",
"splitbill-mcp"
],
"env": {
"SPLITBILL_TOKEN": "<YOUR_SPLITBILL_TOKEN>"
}
}
}
}Needs a key before it starts
Started on 16 Nov 2026 with no keys, it stopped and asked for one, so a client sees no tools until you set the variables above.
SplitBill MCP tools 3
Detected from the READMEcreate_splitlist_splitsget_split
| create_split | — | |
| list_splits | — | |
| get_split | — |
Configuration
SPLITBILL_TOKENRequiredSecretYour SplitBill key from https://sposched.jittee.com/split/mcp/ (starts with wkn_). It carries the PayNow account that collects the money.
| Name | Description | |
|---|---|---|
| SPLITBILL_TOKEN | Your SplitBill key from https://sposched.jittee.com/split/mcp/ (starts with wkn_). It carries the PayNow account that collects the money. | RequiredSecret |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubSplitBill MCP
Split bills and collect payments through PayNow (Singapore) — from the AI you already use.
You paid for the dinner. SplitBill works out who owes what and gives you links to send. Money never passes through us: everyone pays from their own banking app.
- Product page: https://jittee.com/splitbill
- Web app (no sign-up): https://sposched.jittee.com/split/
Features
- Create a split bill from a receipt or a total
- Equal split, or a custom amount for one person (the rest is re-split)
- The person who paid up front is counted but never billed
- Participant management — names optional; payers can enter their own
- Shareable payment URLs (one per amount) + a read-only status link
- PayNow QR on the payment page
- Payment status tracking (self-reported with a transfer screenshot)
- Receipts attached to the total, visible to payers
- 日本語 / English / 中文
Example
User:
Split SGD 891 between 4 people.
AI: creates a SplitBill payment page
SGD 222.75 × 3 participants (you paid up front, so you are not billed)
Share: https://sposched.jittee.com/split/pay/?t=…
Manage: https://sposched.jittee.com/split/manage/?t=… (keep this one to yourself)
Status: https://sposched.jittee.com/split/manage/?t=… (read-only, safe to share)
Setup
Option A — point your client at the remote server (recommended)
https://jittee.com/mcp/splitbill
That endpoint speaks OAuth 2.1 (dynamic client registration + PKCE), so there is no key to copy around. Connecting opens SplitBill, you enter the PayNow number (or UEN) that should receive the money plus the display name your payers will see in their banking app, and you press allow. The key is created at that moment and kept by your client, and the AI is never asked for your number again.
Claude Code
claude mcp add --transport http splitbill https://jittee.com/mcp/splitbill
Claude Desktop / claude.ai / ChatGPT — Settings → Connectors → add a custom connector and paste the URL. Leave authentication on OAuth.
Smithery — https://smithery.ai/server/jittee/splitbill does the same through its gateway.
Option B — hold the key yourself
For a stdio install, or a client that does not speak OAuth.
Open https://sposched.jittee.com/split/mcp/ and enter the PayNow number (or UEN) that should
receive the money, plus the display name your payers will see in their banking app. You get a
key that starts with wkn_, shown only once.
⚠️ That key can create pages that collect money to your PayNow. Keep it to yourself. It cannot move money. If you lose it, just create another one.
Claude Code
claude mcp add splitbill --env SPLITBILL_TOKEN=wkn_xxx -- npx -y splitbill-mcp
Any client with a JSON config
{
"mcpServers": {
"splitbill": {
"command": "npx",
"args": ["-y", "splitbill-mcp"],
"env": { "SPLITBILL_TOKEN": "wkn_xxx" }
}
}
}
Remote, with the key in the URL — for clients that cannot send headers. Choose No authentication, since the key is already in the URL:
https://jittee.com/mcp/splitbill?token=wkn_xxx
Then ask
"Split this receipt four ways. Tanaka did not drink, so $20 for him."
Tools
| Tool | What it does |
|---|---|
create_split |
Create the page. Takes a total or itemised receipt, a head count, optional names, per-person overrides and rounding. Returns the manage URL, the share URLs (one per amount) and a read-only status URL. |
list_splits |
Splits created with this key, newest first, with how much has been collected and who is left. |
get_split |
One split: who has paid, their notes, the share URLs. |
By default you are treated as the person who paid up front: you count towards the head
count, but no payment link is created for you. Pass i_paid: false to turn that off.
Environment
| Variable | Meaning |
|---|---|
SPLITBILL_TOKEN |
Your key from /split/mcp (starts with wkn_). Required. |
SPLITBILL_URL |
Endpoint override. Only needed to point at a non-production environment. |
Good to know
- No sign-up, no login. The key is the only credential.
- Money never passes through us. Payments go directly between banking apps over PayNow. SplitBill only shows the amount and the recipient, and records who says they have paid.
- Pages delete themselves 7 days after the last payment, images included.
- NRIC cannot be used as a PayNow recipient (Singapore PDPA); mobile number or UEN only.
- Amounts are SGD.
- Anyone can create a split page, so payment pages carry a standing warning and a report button. Never send money from a link you got from someone you do not know.
Privacy and terms
- Privacy policy: https://sposched.jittee.com/split/privacy/
- Terms of use: https://sposched.jittee.com/split/terms/
- Contact: info@jittee.com
License
MIT © Jittee Pte. Ltd.
SplitBill MCP questions
How do I add SplitBill MCP to Claude Code?
Run claude mcp add --env 'SPLITBILL_TOKEN=<YOUR_SPLITBILL_TOKEN>' splitbill-mcp -- npx -y splitbill-mcp in your terminal. Add --scope user to make it available in every project.
How do I add SplitBill 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 SplitBill MCP provide?
It exposes 3 tools, including create_split, list_splits, get_split.
How does the money transfer work?
Money does not pass through the service; everyone pays directly from their own banking app via PayNow.
Can I use my NRIC for PayNow?
No, NRIC cannot be used as a PayNow recipient due to Singapore PDPA; you must use a mobile number or UEN.
How long do the split pages last?
Pages and their associated images are automatically deleted 7 days after the last payment is made.
Do I need to create an account?
No, there is no sign-up or login required; the authentication key is the only credential needed.