Spendify MCP server

Quick start

Add the server to Claude Code:

claude mcp add --transport http spendify https://sobrecodigo-api.azurewebsites.net/mcp

Or call it directly, without an MCP client:

curl -X POST https://sobrecodigo-api.azurewebsites.net/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

The web app at spendify.link needs JavaScript, so fetching its pages as text only returns the landing copy. Don't scrape it; use the MCP server.

Connection

Links and the group hash

Each group is identified by its hash, a UUID. Spendify links carry it in the hash query parameter, in any of these forms:

• https://spendify.link/gastos?hash=<hash>
• https://spendify.link/expenses?hash=<hash>
• https://www.spendify.link/expenses?hash=<hash>

When a user pastes a Spendify link, take the hash value and pass it to the tools. Anyone with the hash can read and edit the group, so treat it as a secret and don't post it publicly.

Tools

Tool names and argument names are exact. Field names are in Spanish. tools/list returns the same schemas as JSON.

create_expense_link

Creates a new group.

Returns hash, nombre and link. Give the link to the user.

rename_expense_link

Renames a group.

add_person

Adds a person to the group. Returns the updated list of people.

list_people

Lists the people in the group. Returns data, an array of { id, nombre, cvu }.

list_expense_types

Lists the group's expense categories. Returns an array of { id, descripcion }. New groups have: Vivienda, Transporte, Alimentación, Salud, Inversión, Educación, Deudas y Finanzas, Entretenimiento, Vestimenta y Cuidado Personal, Familia y Mascotas, Emergencias e Imprevistos, Donaciones y Regalos, Otros, Ahorros.

create_expense

Adds an expense, with who paid and who shares it.

• People must already exist in the group. Get IDs and names from list_people, and add anyone missing with add_person first.
• If pagadores or participantes is missing, or a name or ID isn't in the group, the call fails with HTTP 400 and nothing is saved.
• Returns ok, descripcion, gasto, and pagadores and participantes resolved to person IDs.

list_expenses

Lists the group's expenses. Returns data, an array of expenses with id, gasto, descripcion, created, tipoGasto, tipoPago and usuariosQueParticipanYPagan. In that last list, tipoParticipacion 1 is a payer with their monto, and 2 is a person in the split.

Results and errors

• A successful tools/call returns result.content[0].text, a JSON string. Parse it to read the data.
• A missing required field, a person who isn't in the group or an unknown tool returns HTTP 400 with a JSON-RPC error (code -32602). Messages are in Spanish, for example Falta el campo hash ("missing field: hash") or No existe el pagador 'Zoe' en este grupo ("payer 'Zoe' doesn't exist in this group").
• Other failures return HTTP 500 with a JSON-RPC error.

Full example

Add a 15000 dinner paid by Ana and split between Ana and Beto:

POST https://sobrecodigo-api.azurewebsites.net/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_expense",
    "arguments": {
      "hash": "<hash>",
      "descripcion": "Cena",
      "gasto": 15000,
      "tipoPago": "Efectivo",
      "tipoGastoDescripcion": "Alimentación",
      "pagadores": [{ "nombre": "Ana", "monto": 15000 }],
      "participantes": ["Ana", "Beto"]
    }
  }
}

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"ok\": true, \"hash\": \"<hash>\", \"link\": \"https://www.spendify.link/expenses?hash=<hash>\", \"descripcion\": \"Cena\", \"gasto\": 15000.0, \"pagadores\": [{\"id\": 4089, \"monto\": 15000.0}], \"participantes\": [4089, 4090]}"
      }
    ]
  }
}

Typical flow for a pasted link

1. Take hash from the link.
2. Call list_people, list_expenses and list_expense_types to see the group as it is now.
3. Add missing people with add_person.
4. Add each expense with create_expense, using people from list_people and a category from list_expense_types. If the user doesn't say who paid or who shares the expense, ask before creating it.
5. Call list_expenses to confirm, then send the user the link to review in the app.

To start from scratch, call create_expense_link first and give the user the returned link.

Things to watch for

• An unknown hash is not an error: list tools return an empty data array. If a pasted link shows no people and no expenses, check the hash before assuming the group is empty.
• If tipoGastoDescripcion is missing or doesn't match a category exactly, the expense is filed under "Vivienda" without warning.
• There's no currency field. Amounts are stored as plain numbers.
• Lists return everything in one page.

Machine-readable files

• llms.txt: this guide as Markdown.
• /.well-known/mcp.json: endpoint, transport and tool names as JSON.
• /.well-known/ard.json and ai-catalog.json: resource catalog for the site, including the MCP server.

Back to Spendify