Eventual
API key

Integrations

Log it where you already are.

Log an expense from your iPhone, or ask an AI assistant to do it. Each integration signs in with an API key from your account.

Apple Shortcut
iPhone · iPad · Mac · Watch
Log an expense in three taps. It splits evenly between everyone in the group and uses today's date. You can change the split, description or date in the app later.

  1. Step 1

    Pick the group

    Every group you belong to.

  2. Step 2

    Pick who paid

    You're listed first.

  3. Step 3

    Type the amount

    In rupees.

Get the shortcut

When you add it, Shortcuts asks for two things: your API key and this URL.

Eventual URL
https://eventual.macintushar.xyz

Already installed? Download it again and replace the old shortcut to get fixes. Tip: say "Hey Siri, log to Eventual", or add it to your Home Screen or Action button.

Build it yourself

The shortcut uses three endpoints. Send your key in an x-api-key header. The first two return a { label: id } dictionary, which works directly with Choose from List.

Endpoints
GET  https://eventual.macintushar.xyz/api/shortcut/groups
GET  https://eventual.macintushar.xyz/api/shortcut/groups/{groupId}/members
POST https://eventual.macintushar.xyz/api/shortcut/groups/{groupId}/expenses
     { "paidByUserId": "…", "amount": 1200.5, "description": "optional" }
  1. Get Contents of URL (groups) → Get Dictionary from Input → Choose from List. The chosen item is already the group ID; use it directly in the members and expense URLs.
  2. Do the same with the members endpoint to pick who paid.
  3. Ask for Input (Number), then POST the expense with a JSON body.
  4. Show Notification with the message field. It says what was logged, or why it wasn't.
AI assistants (MCP)
Connect any assistant that supports MCP. Then just say "Mac paid ₹3,600 for dinner in Goa weekend, split it evenly" or "Who owes me money?"
MCP server URL (Streamable HTTP)
https://eventual.macintushar.xyz/mcp

Authenticate with x-api-key: ev_… or Authorization: Bearer ev_…, whichever your client supports.

  1. Run this once in your terminal. Use --scope user to share it across projects.
Terminal
claude mcp add --transport http eventual https://eventual.macintushar.xyz/mcp \
  --header "x-api-key: ev_your_api_key"

Tools

  • listGroups

    Your groups and your balance in each

  • listExpenses

    Recent expenses in a group

  • createExpense

    Log an expense with any split method

  • getBalances

    Who owes whom, with simplified transfers