Servidor MCP

xupersplit

io.github.kanylbullen/xupersplit
Finanzas e inversión Público y accesible MCP 2025-11-25

Qué hace este MCP

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.
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Destructivo
Esquema de entrada
{'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."}}}
Esquema de salida
{'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.
Solo lectura
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Destructivo
Esquema de entrada
{'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."}}}
Esquema de salida
{'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.
Esquema de entrada
{'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."}}}
Esquema de salida
{'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.
Destructivo
Esquema de entrada
{'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."}}}
Esquema de salida
{'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.
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Esquema de entrada
{'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'}}}
Esquema de salida
{'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}
Añadido
update_split
17 de September de 2026 a las 12:42
Añadido
set_payment_methods
17 de September de 2026 a las 12:42
Añadido
remove_participant
17 de September de 2026 a las 12:42
Añadido
rename_participant
17 de September de 2026 a las 12:42
Añadido
add_participant
17 de September de 2026 a las 12:42
Añadido
delete_entry
17 de September de 2026 a las 12:42
Añadido
update_entry
17 de September de 2026 a las 12:42
Añadido
record_payment
17 de September de 2026 a las 12:42
Añadido
add_expense
17 de September de 2026 a las 12:42
Añadido
get_split
17 de September de 2026 a las 12:42
Añadido
create_split
17 de September de 2026 a las 12:42