MCP-Server

xupersplit

io.github.kanylbullen/xupersplit
Finanzen & Investieren Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

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.
Eingabeschema
{'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.'}}}
Ausgabeschema
{'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.
Eingabeschema
{'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.'}}}
Ausgabeschema
{'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.
Eingabeschema
{'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.'}}}
Ausgabeschema
{'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.
Destruktiv
Eingabeschema
{'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."}}}
Ausgabeschema
{'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.
Nur Lesen
Eingabeschema
{'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.'}}}
Ausgabeschema
{'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.
Eingabeschema
{'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.'}}}
Ausgabeschema
{'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.
Destruktiv
Eingabeschema
{'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."}}}
Ausgabeschema
{'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.
Eingabeschema
{'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."}}}
Ausgabeschema
{'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.
Destruktiv
Eingabeschema
{'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."}}}
Ausgabeschema
{'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.
Eingabeschema
{'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.'}}}
Ausgabeschema
{'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.
Eingabeschema
{'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'}}}
Ausgabeschema
{'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}
Hinzugefügt
update_split
17. September 2026 12:42
Hinzugefügt
set_payment_methods
17. September 2026 12:42
Hinzugefügt
remove_participant
17. September 2026 12:42
Hinzugefügt
rename_participant
17. September 2026 12:42
Hinzugefügt
add_participant
17. September 2026 12:42
Hinzugefügt
delete_entry
17. September 2026 12:42
Hinzugefügt
update_entry
17. September 2026 12:42
Hinzugefügt
record_payment
17. September 2026 12:42
Hinzugefügt
add_expense
17. September 2026 12:42
Hinzugefügt
get_split
17. September 2026 12:42
Hinzugefügt
create_split
17. September 2026 12:42