MCP Server

xupersplit

io.github.kanylbullen/xupersplit
Finance & Investing Public & reachable MCP 2025-11-25

What this MCP does

Creates and manages accountless group expense splits, calculates balances, records repayments, and displays settlement instructions.

add_expense
Add an expense
Record something one person paid for the group. Split equally by default; pass split_between for a subset, or shares for an uneven split. One expense covers one set of people — a receipt whose items aren't all shared by everyone is several expenses, so call this once per group of items that the same people share, rather than splitting the total equally. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['split', 'amount', 'paid_by'], 'properties': {'date': {'type': 'string', 'description': 'Date as YYYY-MM-DD. Defaults to today.'}, 'split': {'type': 'string', 'description': 'The split key, or the whole https://split.xuper.fun/k/<key> link.'}, 'amount': {'type': 'number', 'description': "Amount in the split's currency, as a decimal (e.g. 249.50).", 'exclusiveMinimum': 0}, 'shares': {'type': 'array', 'items': {'type': 'object', 'required': ['participant'], 'properties': {'amount': {'type': 'number', 'exclusiveMinimum': 0}, 'weight': {'type': 'number', 'exclusiveMinimum': 0}, 'participant': {'type': 'string'}}}, 'description': "Uneven split. Either an exact `amount` per person (must add up to the total) or a relative `weight` per person (e.g. weight 2 for a couple). Don't combine with split_between."}, 'paid_by': {'type': 'string', 'description': "Who paid â\x80\x94 a participant's name (or id) in this split. A card receipt rarely names the payer, so ask unless you know: guess wrong and every balance points the wrong way. If the user counts themselves among the participants, assume it was them and say that you assumed it â\x80\x94 what you must not do is pick a payer silently."}, 'description': {'type': 'string', 'description': 'What it was, e.g. "Groceries".'}, 'split_between': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Names of the people sharing this cost, split equally. Defaults to everyone.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['key', 'url', 'title', 'currency', 'created_at', 'total_spent', 'settled', 'secure', 'participants', 'entries', 'settlement'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'secure': {'type': 'boolean'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'kind', 'description', 'amount', 'date', 'paid_by', 'paid_by_id', 'to', 'shared_by'], 'properties': {'id': {'type': 'string'}, 'to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'date': {'type': 'string'}, 'kind': {'enum': ['expense', 'transfer'], 'type': 'string'}, 'amount': {'type': 'number'}, 'paid_by': {'type': 'string'}, 'shared_by': {'type': 'array', 'items': {'type': 'string'}}, 'paid_by_id': {'type': 'string'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'settled': {'type': 'boolean'}, 'currency': {'type': 'string'}, 'created_at': {'type': 'string'}, 'settlement': {'type': 'array', 'items': {'type': 'object', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'amount': {'type': 'number'}}, 'additionalProperties': False}}, 'total_spent': {'type': 'number'}, 'participants': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'paid', 'owes', 'settled', 'balance', 'payment_methods'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'owes': {'type': 'number'}, 'paid': {'type': 'number'}, 'balance': {'type': 'number'}, 'settled': {'type': 'number'}, 'payment_methods': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
add_participant
Add a participant
Add someone to an existing split. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['split', 'name'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'split': {'type': 'string', 'description': 'The split key, or the whole https://split.xuper.fun/k/<key> link.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['key', 'url', 'title', 'currency', 'created_at', 'total_spent', 'settled', 'secure', 'participants', 'entries', 'settlement'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'secure': {'type': 'boolean'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'kind', 'description', 'amount', 'date', 'paid_by', 'paid_by_id', 'to', 'shared_by'], 'properties': {'id': {'type': 'string'}, 'to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'date': {'type': 'string'}, 'kind': {'enum': ['expense', 'transfer'], 'type': 'string'}, 'amount': {'type': 'number'}, 'paid_by': {'type': 'string'}, 'shared_by': {'type': 'array', 'items': {'type': 'string'}}, 'paid_by_id': {'type': 'string'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'settled': {'type': 'boolean'}, 'currency': {'type': 'string'}, 'created_at': {'type': 'string'}, 'settlement': {'type': 'array', 'items': {'type': 'object', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'amount': {'type': 'number'}}, 'additionalProperties': False}}, 'total_spent': {'type': 'number'}, 'participants': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'paid', 'owes', 'settled', 'balance', 'payment_methods'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'owes': {'type': 'number'}, 'paid': {'type': 'number'}, 'balance': {'type': 'number'}, 'settled': {'type': 'number'}, 'payment_methods': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
create_split
Create a split
Create a new xupersplit for sharing expenses in a group. No account needed. Returns a secret link — give it to the user and tell them to share it with the group, since anyone holding the link can see and edit the split.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['title', 'participants'], 'properties': {'title': {'type': 'string', 'minLength': 1, 'description': 'What the split is for, e.g. "Ski trip".'}, 'currency': {'enum': ['SEK', 'EUR', 'USD', 'NOK', 'DKK', 'ISK', 'GBP', 'CHF', 'PLN', 'THB', 'SATS'], 'type': 'string', 'description': 'Currency code. Defaults to SEK.'}, 'participants': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 2, 'description': 'Names of everyone splitting, at least two.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['key', 'url', 'title', 'currency', 'created_at', 'total_spent', 'settled', 'secure', 'participants', 'entries', 'settlement'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'secure': {'type': 'boolean'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'kind', 'description', 'amount', 'date', 'paid_by', 'paid_by_id', 'to', 'shared_by'], 'properties': {'id': {'type': 'string'}, 'to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'date': {'type': 'string'}, 'kind': {'enum': ['expense', 'transfer'], 'type': 'string'}, 'amount': {'type': 'number'}, 'paid_by': {'type': 'string'}, 'shared_by': {'type': 'array', 'items': {'type': 'string'}}, 'paid_by_id': {'type': 'string'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'settled': {'type': 'boolean'}, 'currency': {'type': 'string'}, 'created_at': {'type': 'string'}, 'settlement': {'type': 'array', 'items': {'type': 'object', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'amount': {'type': 'number'}}, 'additionalProperties': False}}, 'total_spent': {'type': 'number'}, 'participants': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'paid', 'owes', 'settled', 'balance', 'payment_methods'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'owes': {'type': 'number'}, 'paid': {'type': 'number'}, 'balance': {'type': 'number'}, 'settled': {'type': 'number'}, 'payment_methods': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
delete_entry
Delete an entry
Remove an expense or payment for good. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.
Destructive
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['split', 'entry_id'], 'properties': {'split': {'type': 'string', 'description': 'The split key, or the whole https://split.xuper.fun/k/<key> link.'}, 'entry_id': {'type': 'string', 'description': "The entry's id, from get_split."}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['key', 'url', 'title', 'currency', 'created_at', 'total_spent', 'settled', 'secure', 'participants', 'entries', 'settlement'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'secure': {'type': 'boolean'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'kind', 'description', 'amount', 'date', 'paid_by', 'paid_by_id', 'to', 'shared_by'], 'properties': {'id': {'type': 'string'}, 'to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'date': {'type': 'string'}, 'kind': {'enum': ['expense', 'transfer'], 'type': 'string'}, 'amount': {'type': 'number'}, 'paid_by': {'type': 'string'}, 'shared_by': {'type': 'array', 'items': {'type': 'string'}}, 'paid_by_id': {'type': 'string'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'settled': {'type': 'boolean'}, 'currency': {'type': 'string'}, 'created_at': {'type': 'string'}, 'settlement': {'type': 'array', 'items': {'type': 'object', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'amount': {'type': 'number'}}, 'additionalProperties': False}}, 'total_spent': {'type': 'number'}, 'participants': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'paid', 'owes', 'settled', 'balance', 'payment_methods'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'owes': {'type': 'number'}, 'paid': {'type': 'number'}, 'balance': {'type': 'number'}, 'settled': {'type': 'number'}, 'payment_methods': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_split
Read a split
Read a split: participants, expenses, per-person balances and the shortest set of payments that settles everyone up.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['split'], 'properties': {'split': {'type': 'string', 'description': 'The split key, or the whole https://split.xuper.fun/k/<key> link.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['key', 'url', 'title', 'currency', 'created_at', 'total_spent', 'settled', 'secure', 'participants', 'entries', 'settlement'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'secure': {'type': 'boolean'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'kind', 'description', 'amount', 'date', 'paid_by', 'paid_by_id', 'to', 'shared_by'], 'properties': {'id': {'type': 'string'}, 'to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'date': {'type': 'string'}, 'kind': {'enum': ['expense', 'transfer'], 'type': 'string'}, 'amount': {'type': 'number'}, 'paid_by': {'type': 'string'}, 'shared_by': {'type': 'array', 'items': {'type': 'string'}}, 'paid_by_id': {'type': 'string'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'settled': {'type': 'boolean'}, 'currency': {'type': 'string'}, 'created_at': {'type': 'string'}, 'settlement': {'type': 'array', 'items': {'type': 'object', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'amount': {'type': 'number'}}, 'additionalProperties': False}}, 'total_spent': {'type': 'number'}, 'participants': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'paid', 'owes', 'settled', 'balance', 'payment_methods'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'owes': {'type': 'number'}, 'paid': {'type': 'number'}, 'balance': {'type': 'number'}, 'settled': {'type': 'number'}, 'payment_methods': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
record_payment
Record a payment
Record that one person paid another back, settling part or all of a debt. Use get_split first to see who should pay whom. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['split', 'from', 'to', 'amount'], 'properties': {'to': {'type': 'string', 'description': "Who received it â\x80\x94 a participant's name (or id) in this split."}, 'date': {'type': 'string', 'description': 'Date as YYYY-MM-DD. Defaults to today.'}, 'from': {'type': 'string', 'description': "Who sent the money â\x80\x94 a participant's name (or id) in this split."}, 'split': {'type': 'string', 'description': 'The split key, or the whole https://split.xuper.fun/k/<key> link.'}, 'amount': {'type': 'number', 'description': "Amount in the split's currency, as a decimal (e.g. 249.50).", 'exclusiveMinimum': 0}, 'description': {'type': 'string', 'description': 'How it was paid, e.g. "Swish, 3 March". Shown in the history.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['key', 'url', 'title', 'currency', 'created_at', 'total_spent', 'settled', 'secure', 'participants', 'entries', 'settlement'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'secure': {'type': 'boolean'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'kind', 'description', 'amount', 'date', 'paid_by', 'paid_by_id', 'to', 'shared_by'], 'properties': {'id': {'type': 'string'}, 'to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'date': {'type': 'string'}, 'kind': {'enum': ['expense', 'transfer'], 'type': 'string'}, 'amount': {'type': 'number'}, 'paid_by': {'type': 'string'}, 'shared_by': {'type': 'array', 'items': {'type': 'string'}}, 'paid_by_id': {'type': 'string'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'settled': {'type': 'boolean'}, 'currency': {'type': 'string'}, 'created_at': {'type': 'string'}, 'settlement': {'type': 'array', 'items': {'type': 'object', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'amount': {'type': 'number'}}, 'additionalProperties': False}}, 'total_spent': {'type': 'number'}, 'participants': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'paid', 'owes', 'settled', 'balance', 'payment_methods'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'owes': {'type': 'number'}, 'paid': {'type': 'number'}, 'balance': {'type': 'number'}, 'settled': {'type': 'number'}, 'payment_methods': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
remove_participant
Remove a participant
Remove someone from a split. Only works if they aren't on any expense yet. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.
Destructive
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['split', 'participant'], 'properties': {'split': {'type': 'string', 'description': 'The split key, or the whole https://split.xuper.fun/k/<key> link.'}, 'participant': {'type': 'string', 'description': "Who to remove â\x80\x94 a participant's name (or id) in this split."}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['key', 'url', 'title', 'currency', 'created_at', 'total_spent', 'settled', 'secure', 'participants', 'entries', 'settlement'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'secure': {'type': 'boolean'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'kind', 'description', 'amount', 'date', 'paid_by', 'paid_by_id', 'to', 'shared_by'], 'properties': {'id': {'type': 'string'}, 'to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'date': {'type': 'string'}, 'kind': {'enum': ['expense', 'transfer'], 'type': 'string'}, 'amount': {'type': 'number'}, 'paid_by': {'type': 'string'}, 'shared_by': {'type': 'array', 'items': {'type': 'string'}}, 'paid_by_id': {'type': 'string'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'settled': {'type': 'boolean'}, 'currency': {'type': 'string'}, 'created_at': {'type': 'string'}, 'settlement': {'type': 'array', 'items': {'type': 'object', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'amount': {'type': 'number'}}, 'additionalProperties': False}}, 'total_spent': {'type': 'number'}, 'participants': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'paid', 'owes', 'settled', 'balance', 'payment_methods'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'owes': {'type': 'number'}, 'paid': {'type': 'number'}, 'balance': {'type': 'number'}, 'settled': {'type': 'number'}, 'payment_methods': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
rename_participant
Rename a participant
Change a participant's name. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['split', 'participant', 'name'], 'properties': {'name': {'type': 'string', 'minLength': 1, 'description': 'The new name.'}, 'split': {'type': 'string', 'description': 'The split key, or the whole https://split.xuper.fun/k/<key> link.'}, 'participant': {'type': 'string', 'description': "Who to rename â\x80\x94 a participant's name (or id) in this split."}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['key', 'url', 'title', 'currency', 'created_at', 'total_spent', 'settled', 'secure', 'participants', 'entries', 'settlement'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'secure': {'type': 'boolean'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'kind', 'description', 'amount', 'date', 'paid_by', 'paid_by_id', 'to', 'shared_by'], 'properties': {'id': {'type': 'string'}, 'to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'date': {'type': 'string'}, 'kind': {'enum': ['expense', 'transfer'], 'type': 'string'}, 'amount': {'type': 'number'}, 'paid_by': {'type': 'string'}, 'shared_by': {'type': 'array', 'items': {'type': 'string'}}, 'paid_by_id': {'type': 'string'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'settled': {'type': 'boolean'}, 'currency': {'type': 'string'}, 'created_at': {'type': 'string'}, 'settlement': {'type': 'array', 'items': {'type': 'object', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'amount': {'type': 'number'}}, 'additionalProperties': False}}, 'total_spent': {'type': 'number'}, 'participants': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'paid', 'owes', 'settled', 'balance', 'payment_methods'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'owes': {'type': 'number'}, 'paid': {'type': 'number'}, 'balance': {'type': 'number'}, 'settled': {'type': 'number'}, 'payment_methods': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
set_payment_methods
Set payment details
Set how a participant wants to be paid back, so the split can show a QR code or pay link. Replaces their current list (pass an empty array to clear it). Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.
Destructive
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['split', 'participant', 'methods'], 'properties': {'split': {'type': 'string', 'description': 'The split key, or the whole https://split.xuper.fun/k/<key> link.'}, 'methods': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'enum': ['swish', 'vipps', 'mobilepay', 'revolut', 'lightning', 'evm', 'solana', 'iban'], 'type': 'string'}, 'value': {'type': 'string', 'description': 'Phone number for swish/vipps/mobilepay, IBAN, Revolut tag, Lightning address, 0x/ENS address, or Solana address.'}}}, 'maxItems': 8}, 'participant': {'type': 'string', 'description': "Whose details these are â\x80\x94 a participant's name (or id) in this split."}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['key', 'url', 'title', 'currency', 'created_at', 'total_spent', 'settled', 'secure', 'participants', 'entries', 'settlement'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'secure': {'type': 'boolean'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'kind', 'description', 'amount', 'date', 'paid_by', 'paid_by_id', 'to', 'shared_by'], 'properties': {'id': {'type': 'string'}, 'to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'date': {'type': 'string'}, 'kind': {'enum': ['expense', 'transfer'], 'type': 'string'}, 'amount': {'type': 'number'}, 'paid_by': {'type': 'string'}, 'shared_by': {'type': 'array', 'items': {'type': 'string'}}, 'paid_by_id': {'type': 'string'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'settled': {'type': 'boolean'}, 'currency': {'type': 'string'}, 'created_at': {'type': 'string'}, 'settlement': {'type': 'array', 'items': {'type': 'object', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'amount': {'type': 'number'}}, 'additionalProperties': False}}, 'total_spent': {'type': 'number'}, 'participants': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'paid', 'owes', 'settled', 'balance', 'payment_methods'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'owes': {'type': 'number'}, 'paid': {'type': 'number'}, 'balance': {'type': 'number'}, 'settled': {'type': 'number'}, 'payment_methods': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
update_entry
Update an entry
Change an existing expense or payment. Only the fields you pass are changed. Entry ids come from get_split. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['split', 'entry_id'], 'properties': {'to': {'type': 'string', 'description': 'New recipient â\x80\x94 payments only.'}, 'date': {'type': 'string', 'description': 'Date as YYYY-MM-DD. Defaults to today.'}, 'split': {'type': 'string', 'description': 'The split key, or the whole https://split.xuper.fun/k/<key> link.'}, 'amount': {'type': 'number', 'description': "Amount in the split's currency, as a decimal (e.g. 249.50).", 'exclusiveMinimum': 0}, 'shares': {'type': 'array', 'items': {'type': 'object', 'required': ['participant'], 'properties': {'amount': {'type': 'number', 'exclusiveMinimum': 0}, 'weight': {'type': 'number', 'exclusiveMinimum': 0}, 'participant': {'type': 'string'}}}, 'description': "Uneven split. Either an exact `amount` per person (must add up to the total) or a relative `weight` per person (e.g. weight 2 for a couple). Don't combine with split_between."}, 'paid_by': {'type': 'string', 'description': 'Move the entry to a different payer.'}, 'entry_id': {'type': 'string', 'description': "The entry's id, from get_split."}, 'description': {'type': 'string'}, 'split_between': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Names of the people sharing this cost, split equally. Defaults to everyone.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['key', 'url', 'title', 'currency', 'created_at', 'total_spent', 'settled', 'secure', 'participants', 'entries', 'settlement'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'secure': {'type': 'boolean'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'kind', 'description', 'amount', 'date', 'paid_by', 'paid_by_id', 'to', 'shared_by'], 'properties': {'id': {'type': 'string'}, 'to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'date': {'type': 'string'}, 'kind': {'enum': ['expense', 'transfer'], 'type': 'string'}, 'amount': {'type': 'number'}, 'paid_by': {'type': 'string'}, 'shared_by': {'type': 'array', 'items': {'type': 'string'}}, 'paid_by_id': {'type': 'string'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'settled': {'type': 'boolean'}, 'currency': {'type': 'string'}, 'created_at': {'type': 'string'}, 'settlement': {'type': 'array', 'items': {'type': 'object', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'amount': {'type': 'number'}}, 'additionalProperties': False}}, 'total_spent': {'type': 'number'}, 'participants': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'paid', 'owes', 'settled', 'balance', 'payment_methods'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'owes': {'type': 'number'}, 'paid': {'type': 'number'}, 'balance': {'type': 'number'}, 'settled': {'type': 'number'}, 'payment_methods': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
update_split
Rename a split
Change a split's title or currency. The currency is locked once the split has expenses. Works on simple, accountless splits. Secure splits (created by a signed-in user) are read-only here and must be opened in a browser.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['split'], 'properties': {'split': {'type': 'string', 'description': 'The split key, or the whole https://split.xuper.fun/k/<key> link.'}, 'title': {'type': 'string', 'minLength': 1}, 'currency': {'enum': ['SEK', 'EUR', 'USD', 'NOK', 'DKK', 'ISK', 'GBP', 'CHF', 'PLN', 'THB', 'SATS'], 'type': 'string'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['key', 'url', 'title', 'currency', 'created_at', 'total_spent', 'settled', 'secure', 'participants', 'entries', 'settlement'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}, 'secure': {'type': 'boolean'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'kind', 'description', 'amount', 'date', 'paid_by', 'paid_by_id', 'to', 'shared_by'], 'properties': {'id': {'type': 'string'}, 'to': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'date': {'type': 'string'}, 'kind': {'enum': ['expense', 'transfer'], 'type': 'string'}, 'amount': {'type': 'number'}, 'paid_by': {'type': 'string'}, 'shared_by': {'type': 'array', 'items': {'type': 'string'}}, 'paid_by_id': {'type': 'string'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'settled': {'type': 'boolean'}, 'currency': {'type': 'string'}, 'created_at': {'type': 'string'}, 'settlement': {'type': 'array', 'items': {'type': 'object', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'amount': {'type': 'number'}}, 'additionalProperties': False}}, 'total_spent': {'type': 'number'}, 'participants': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'paid', 'owes', 'settled', 'balance', 'payment_methods'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'owes': {'type': 'number'}, 'paid': {'type': 'number'}, 'balance': {'type': 'number'}, 'settled': {'type': 'number'}, 'payment_methods': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
Added
update_split
Sept. 17, 2026, 12:42 p.m.
Added
set_payment_methods
Sept. 17, 2026, 12:42 p.m.
Added
remove_participant
Sept. 17, 2026, 12:42 p.m.
Added
rename_participant
Sept. 17, 2026, 12:42 p.m.
Added
add_participant
Sept. 17, 2026, 12:42 p.m.
Added
delete_entry
Sept. 17, 2026, 12:42 p.m.
Added
update_entry
Sept. 17, 2026, 12:42 p.m.
Added
record_payment
Sept. 17, 2026, 12:42 p.m.
Added
add_expense
Sept. 17, 2026, 12:42 p.m.
Added
get_split
Sept. 17, 2026, 12:42 p.m.
Added
create_split
Sept. 17, 2026, 12:42 p.m.