xupersplit
Split shared expenses in a group — no account needed. See who owes whom and settle up.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"xupersplit": {
"url": "https://split.xuper.fun/api/mcp"
}
}
}Remote endpoints
https://split.xuper.fun/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟡create_split(title, participants, currency)
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",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"description": "What the split is for, e.g. \"Ski trip\"."
},
"participants": {
"minItems": 2,
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Names of everyone splitting, at least two."
},
"currency": {
"description": "Currency code. Defaults to SEK.",
"type": "string",
"enum": [
"SEK",
"EUR",
"USD",
"NOK",
"DKK",
"ISK",
"GBP",
"CHF",
"PLN",
"THB",
"SATS"
]
}
},
"required": [
"title",
"participants"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"currency": {
"type": "string"
},
"created_at": {
"type": "string"
},
"total_spent": {
"type": "number"
},
"settled": {
"type": "boolean"
},
"secure": {
"type": "boolean"
},
"participants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"paid": {
"type": "number"
},
"owes": {
"type": "number"
},
"settled": {
"type": "number"
},
"balance": {
"type": "number"
},
"payment_methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"paid",
"owes",
"settled",
"balance",
"payment_methods"
],
"additionalProperties": false
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"expense",
"transfer"
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount": {
"type": "number"
},
"date": {
"type": "string"
},
"paid_by": {
"type": "string"
},
"paid_by_id": {
"type": "string"
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shared_by": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"kind",
"description",
"amount",
"date",
"paid_by",
"paid_by_id",
"to",
"shared_by"
],
"additionalProperties": false
}
},
"settlement": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"required": [
"from",
"to",
"amount"
],
"additionalProperties": false
}
}
},
"required": [
"key",
"url",
"title",
"currency",
"created_at",
"total_spent",
"settled",
"secure",
"participants",
"entries",
"settlement"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_split(split)
Read a split: participants, expenses, per-person balances and the shortest set of payments that settles everyone up.
Input Schema
{
"type": "object",
"properties": {
"split": {
"type": "string",
"description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
}
},
"required": [
"split"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"currency": {
"type": "string"
},
"created_at": {
"type": "string"
},
"total_spent": {
"type": "number"
},
"settled": {
"type": "boolean"
},
"secure": {
"type": "boolean"
},
"participants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"paid": {
"type": "number"
},
"owes": {
"type": "number"
},
"settled": {
"type": "number"
},
"balance": {
"type": "number"
},
"payment_methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"paid",
"owes",
"settled",
"balance",
"payment_methods"
],
"additionalProperties": false
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"expense",
"transfer"
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount": {
"type": "number"
},
"date": {
"type": "string"
},
"paid_by": {
"type": "string"
},
"paid_by_id": {
"type": "string"
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shared_by": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"kind",
"description",
"amount",
"date",
"paid_by",
"paid_by_id",
"to",
"shared_by"
],
"additionalProperties": false
}
},
"settlement": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"required": [
"from",
"to",
"amount"
],
"additionalProperties": false
}
}
},
"required": [
"key",
"url",
"title",
"currency",
"created_at",
"total_spent",
"settled",
"secure",
"participants",
"entries",
"settlement"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡add_expense(split, amount, paid_by, description, split_between, ...)
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",
"properties": {
"split": {
"type": "string",
"description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
},
"amount": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Amount in the split's currency, as a decimal (e.g. 249.50)."
},
"paid_by": {
"type": "string",
"description": "Who paid — 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 — what you must not do is pick a payer silently."
},
"description": {
"description": "What it was, e.g. \"Groceries\".",
"type": "string"
},
"split_between": {
"description": "Names of the people sharing this cost, split equally. Defaults to everyone.",
"type": "array",
"items": {
"type": "string"
}
},
"shares": {
"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.",
"type": "array",
"items": {
"type": "object",
"properties": {
"participant": {
"type": "string"
},
"amount": {
"type": "number",
"exclusiveMinimum": 0
},
"weight": {
"type": "number",
"exclusiveMinimum": 0
}
},
"required": [
"participant"
]
}
},
"date": {
"description": "Date as YYYY-MM-DD. Defaults to today.",
"type": "string"
}
},
"required": [
"split",
"amount",
"paid_by"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"currency": {
"type": "string"
},
"created_at": {
"type": "string"
},
"total_spent": {
"type": "number"
},
"settled": {
"type": "boolean"
},
"secure": {
"type": "boolean"
},
"participants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"paid": {
"type": "number"
},
"owes": {
"type": "number"
},
"settled": {
"type": "number"
},
"balance": {
"type": "number"
},
"payment_methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"paid",
"owes",
"settled",
"balance",
"payment_methods"
],
"additionalProperties": false
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"expense",
"transfer"
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount": {
"type": "number"
},
"date": {
"type": "string"
},
"paid_by": {
"type": "string"
},
"paid_by_id": {
"type": "string"
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shared_by": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"kind",
"description",
"amount",
"date",
"paid_by",
"paid_by_id",
"to",
"shared_by"
],
"additionalProperties": false
}
},
"settlement": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"required": [
"from",
"to",
"amount"
],
"additionalProperties": false
}
}
},
"required": [
"key",
"url",
"title",
"currency",
"created_at",
"total_spent",
"settled",
"secure",
"participants",
"entries",
"settlement"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢record_payment(split, from, to, amount, description, ...)
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",
"properties": {
"split": {
"type": "string",
"description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
},
"from": {
"type": "string",
"description": "Who sent the money — a participant's name (or id) in this split."
},
"to": {
"type": "string",
"description": "Who received it — a participant's name (or id) in this split."
},
"amount": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Amount in the split's currency, as a decimal (e.g. 249.50)."
},
"description": {
"description": "How it was paid, e.g. \"Swish, 3 March\". Shown in the history.",
"type": "string"
},
"date": {
"description": "Date as YYYY-MM-DD. Defaults to today.",
"type": "string"
}
},
"required": [
"split",
"from",
"to",
"amount"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"currency": {
"type": "string"
},
"created_at": {
"type": "string"
},
"total_spent": {
"type": "number"
},
"settled": {
"type": "boolean"
},
"secure": {
"type": "boolean"
},
"participants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"paid": {
"type": "number"
},
"owes": {
"type": "number"
},
"settled": {
"type": "number"
},
"balance": {
"type": "number"
},
"payment_methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"paid",
"owes",
"settled",
"balance",
"payment_methods"
],
"additionalProperties": false
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"expense",
"transfer"
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount": {
"type": "number"
},
"date": {
"type": "string"
},
"paid_by": {
"type": "string"
},
"paid_by_id": {
"type": "string"
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shared_by": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"kind",
"description",
"amount",
"date",
"paid_by",
"paid_by_id",
"to",
"shared_by"
],
"additionalProperties": false
}
},
"settlement": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"required": [
"from",
"to",
"amount"
],
"additionalProperties": false
}
}
},
"required": [
"key",
"url",
"title",
"currency",
"created_at",
"total_spent",
"settled",
"secure",
"participants",
"entries",
"settlement"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡update_entry(split, entry_id, amount, description, paid_by, ...)
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",
"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."
},
"amount": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Amount in the split's currency, as a decimal (e.g. 249.50)."
},
"description": {
"type": "string"
},
"paid_by": {
"description": "Move the entry to a different payer.",
"type": "string"
},
"to": {
"description": "New recipient — payments only.",
"type": "string"
},
"split_between": {
"description": "Names of the people sharing this cost, split equally. Defaults to everyone.",
"type": "array",
"items": {
"type": "string"
}
},
"shares": {
"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.",
"type": "array",
"items": {
"type": "object",
"properties": {
"participant": {
"type": "string"
},
"amount": {
"type": "number",
"exclusiveMinimum": 0
},
"weight": {
"type": "number",
"exclusiveMinimum": 0
}
},
"required": [
"participant"
]
}
},
"date": {
"description": "Date as YYYY-MM-DD. Defaults to today.",
"type": "string"
}
},
"required": [
"split",
"entry_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"currency": {
"type": "string"
},
"created_at": {
"type": "string"
},
"total_spent": {
"type": "number"
},
"settled": {
"type": "boolean"
},
"secure": {
"type": "boolean"
},
"participants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"paid": {
"type": "number"
},
"owes": {
"type": "number"
},
"settled": {
"type": "number"
},
"balance": {
"type": "number"
},
"payment_methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"paid",
"owes",
"settled",
"balance",
"payment_methods"
],
"additionalProperties": false
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"expense",
"transfer"
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount": {
"type": "number"
},
"date": {
"type": "string"
},
"paid_by": {
"type": "string"
},
"paid_by_id": {
"type": "string"
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shared_by": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"kind",
"description",
"amount",
"date",
"paid_by",
"paid_by_id",
"to",
"shared_by"
],
"additionalProperties": false
}
},
"settlement": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"required": [
"from",
"to",
"amount"
],
"additionalProperties": false
}
}
},
"required": [
"key",
"url",
"title",
"currency",
"created_at",
"total_spent",
"settled",
"secure",
"participants",
"entries",
"settlement"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🔴delete_entry(split, entry_id)
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.
Input Schema
{
"type": "object",
"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."
}
},
"required": [
"split",
"entry_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"currency": {
"type": "string"
},
"created_at": {
"type": "string"
},
"total_spent": {
"type": "number"
},
"settled": {
"type": "boolean"
},
"secure": {
"type": "boolean"
},
"participants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"paid": {
"type": "number"
},
"owes": {
"type": "number"
},
"settled": {
"type": "number"
},
"balance": {
"type": "number"
},
"payment_methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"paid",
"owes",
"settled",
"balance",
"payment_methods"
],
"additionalProperties": false
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"expense",
"transfer"
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount": {
"type": "number"
},
"date": {
"type": "string"
},
"paid_by": {
"type": "string"
},
"paid_by_id": {
"type": "string"
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shared_by": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"kind",
"description",
"amount",
"date",
"paid_by",
"paid_by_id",
"to",
"shared_by"
],
"additionalProperties": false
}
},
"settlement": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"required": [
"from",
"to",
"amount"
],
"additionalProperties": false
}
}
},
"required": [
"key",
"url",
"title",
"currency",
"created_at",
"total_spent",
"settled",
"secure",
"participants",
"entries",
"settlement"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡add_participant(split, name)
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",
"properties": {
"split": {
"type": "string",
"description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
},
"name": {
"type": "string",
"minLength": 1
}
},
"required": [
"split",
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"currency": {
"type": "string"
},
"created_at": {
"type": "string"
},
"total_spent": {
"type": "number"
},
"settled": {
"type": "boolean"
},
"secure": {
"type": "boolean"
},
"participants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"paid": {
"type": "number"
},
"owes": {
"type": "number"
},
"settled": {
"type": "number"
},
"balance": {
"type": "number"
},
"payment_methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"paid",
"owes",
"settled",
"balance",
"payment_methods"
],
"additionalProperties": false
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"expense",
"transfer"
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount": {
"type": "number"
},
"date": {
"type": "string"
},
"paid_by": {
"type": "string"
},
"paid_by_id": {
"type": "string"
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shared_by": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"kind",
"description",
"amount",
"date",
"paid_by",
"paid_by_id",
"to",
"shared_by"
],
"additionalProperties": false
}
},
"settlement": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"required": [
"from",
"to",
"amount"
],
"additionalProperties": false
}
}
},
"required": [
"key",
"url",
"title",
"currency",
"created_at",
"total_spent",
"settled",
"secure",
"participants",
"entries",
"settlement"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡rename_participant(split, participant, name)
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",
"properties": {
"split": {
"type": "string",
"description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
},
"participant": {
"type": "string",
"description": "Who to rename — a participant's name (or id) in this split."
},
"name": {
"type": "string",
"minLength": 1,
"description": "The new name."
}
},
"required": [
"split",
"participant",
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"currency": {
"type": "string"
},
"created_at": {
"type": "string"
},
"total_spent": {
"type": "number"
},
"settled": {
"type": "boolean"
},
"secure": {
"type": "boolean"
},
"participants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"paid": {
"type": "number"
},
"owes": {
"type": "number"
},
"settled": {
"type": "number"
},
"balance": {
"type": "number"
},
"payment_methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"paid",
"owes",
"settled",
"balance",
"payment_methods"
],
"additionalProperties": false
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"expense",
"transfer"
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount": {
"type": "number"
},
"date": {
"type": "string"
},
"paid_by": {
"type": "string"
},
"paid_by_id": {
"type": "string"
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shared_by": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"kind",
"description",
"amount",
"date",
"paid_by",
"paid_by_id",
"to",
"shared_by"
],
"additionalProperties": false
}
},
"settlement": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"required": [
"from",
"to",
"amount"
],
"additionalProperties": false
}
}
},
"required": [
"key",
"url",
"title",
"currency",
"created_at",
"total_spent",
"settled",
"secure",
"participants",
"entries",
"settlement"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🔴remove_participant(split, 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.
Input Schema
{
"type": "object",
"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 — a participant's name (or id) in this split."
}
},
"required": [
"split",
"participant"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"currency": {
"type": "string"
},
"created_at": {
"type": "string"
},
"total_spent": {
"type": "number"
},
"settled": {
"type": "boolean"
},
"secure": {
"type": "boolean"
},
"participants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"paid": {
"type": "number"
},
"owes": {
"type": "number"
},
"settled": {
"type": "number"
},
"balance": {
"type": "number"
},
"payment_methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"paid",
"owes",
"settled",
"balance",
"payment_methods"
],
"additionalProperties": false
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"expense",
"transfer"
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount": {
"type": "number"
},
"date": {
"type": "string"
},
"paid_by": {
"type": "string"
},
"paid_by_id": {
"type": "string"
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shared_by": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"kind",
"description",
"amount",
"date",
"paid_by",
"paid_by_id",
"to",
"shared_by"
],
"additionalProperties": false
}
},
"settlement": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"required": [
"from",
"to",
"amount"
],
"additionalProperties": false
}
}
},
"required": [
"key",
"url",
"title",
"currency",
"created_at",
"total_spent",
"settled",
"secure",
"participants",
"entries",
"settlement"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🔴set_payment_methods(split, participant, methods)
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.
Input Schema
{
"type": "object",
"properties": {
"split": {
"type": "string",
"description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
},
"participant": {
"type": "string",
"description": "Whose details these are — a participant's name (or id) in this split."
},
"methods": {
"maxItems": 8,
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"swish",
"vipps",
"mobilepay",
"revolut",
"lightning",
"evm",
"solana",
"iban"
]
},
"value": {
"type": "string",
"description": "Phone number for swish/vipps/mobilepay, IBAN, Revolut tag, Lightning address, 0x/ENS address, or Solana address."
}
},
"required": [
"type",
"value"
]
}
}
},
"required": [
"split",
"participant",
"methods"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"currency": {
"type": "string"
},
"created_at": {
"type": "string"
},
"total_spent": {
"type": "number"
},
"settled": {
"type": "boolean"
},
"secure": {
"type": "boolean"
},
"participants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"paid": {
"type": "number"
},
"owes": {
"type": "number"
},
"settled": {
"type": "number"
},
"balance": {
"type": "number"
},
"payment_methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"paid",
"owes",
"settled",
"balance",
"payment_methods"
],
"additionalProperties": false
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"expense",
"transfer"
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount": {
"type": "number"
},
"date": {
"type": "string"
},
"paid_by": {
"type": "string"
},
"paid_by_id": {
"type": "string"
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shared_by": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"kind",
"description",
"amount",
"date",
"paid_by",
"paid_by_id",
"to",
"shared_by"
],
"additionalProperties": false
}
},
"settlement": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"required": [
"from",
"to",
"amount"
],
"additionalProperties": false
}
}
},
"required": [
"key",
"url",
"title",
"currency",
"created_at",
"total_spent",
"settled",
"secure",
"participants",
"entries",
"settlement"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡update_split(split, title, currency)
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",
"properties": {
"split": {
"type": "string",
"description": "The split key, or the whole https://split.xuper.fun/k/<key> link."
},
"title": {
"type": "string",
"minLength": 1
},
"currency": {
"type": "string",
"enum": [
"SEK",
"EUR",
"USD",
"NOK",
"DKK",
"ISK",
"GBP",
"CHF",
"PLN",
"THB",
"SATS"
]
}
},
"required": [
"split"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"currency": {
"type": "string"
},
"created_at": {
"type": "string"
},
"total_spent": {
"type": "number"
},
"settled": {
"type": "boolean"
},
"secure": {
"type": "boolean"
},
"participants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"paid": {
"type": "number"
},
"owes": {
"type": "number"
},
"settled": {
"type": "number"
},
"balance": {
"type": "number"
},
"payment_methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"type",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"paid",
"owes",
"settled",
"balance",
"payment_methods"
],
"additionalProperties": false
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"expense",
"transfer"
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amount": {
"type": "number"
},
"date": {
"type": "string"
},
"paid_by": {
"type": "string"
},
"paid_by_id": {
"type": "string"
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shared_by": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"kind",
"description",
"amount",
"date",
"paid_by",
"paid_by_id",
"to",
"shared_by"
],
"additionalProperties": false
}
},
"settlement": {
"type": "array",
"items": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"required": [
"from",
"to",
"amount"
],
"additionalProperties": false
}
}
},
"required": [
"key",
"url",
"title",
"currency",
"created_at",
"total_spent",
"settled",
"secure",
"participants",
"entries",
"settlement"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence