MCP tools reference

You never need to call tools yourself; your assistant chooses them. This list helps when you want to understand what an assistant did, or you’re building with OweJar.

How changes work: prepare, then save

Each change has two tools: prepare_… and the action itself, such as prepare_entry_create and entry_create. Preparing changes nothing and returns a preview and an operation ID. The assistant then sends the same prepared change to save it. Only an accepted result means it was saved. Amounts are exact, in the currency’s smallest unit (for example paise or cents).

Account and discovery

• get_profile, get_app_capabilities, list_books

Reading your book

• get_balances, get_person_balances, list_people, list_entries, list_expenses, list_expense_shares, list_settlements
• list_bills, list_deliveries, list_tracked_occurrences, list_recurring_rules, list_expense_recurring_rules, list_reminders
• list_categories, list_subcategories, list_activity, list_settings
• get_agenda (what needs attention: due bills, deliveries, entries, reminders and recurring dates, plus group requests), get_spending_insights, get_person_statement, get_repayment_quote
• export_private_book (a spreadsheet file of your people, entries, payments, expenses or split shares)

The list_… tools take optional filters, and each tool names the ones it supports: for example q (name contains) and balance (owed_to_you, you_owe, outstanding or settled) for people, or personId, status and from/to dates (milliseconds since 1970) for entries. Results come newest first, a page at a time, unless the tool is given a sort, such as name_asc or owed_to_you_desc for people or due_date_asc for entries.

Changing your book

• People: person_create, person_update, person_merge*, person_delete*, set_person_payer
• Money: entry_create, entry_update, entry_delete*, settlement_record, settlement_record_lump_sum (one payment spread over what you and a person owe, oldest first, like Settle on a person in the app), settlement_reverse*
• Expenses: expense_create, expense_update, expense_delete*, share_reopen*
• Bills and deliveries: record_bill_payment, bill_skip, bill_amount_set, bill_reopen*, delivery_receive, delivery_skip, delivery_reopen*
• Schedules and reminders: rule_create, expense_rule_create, occurrence_skip, create_recurring_entry_or_expense, reminder_create
• Statements: create_person_statement_link, revoke_person_statement_link

Groups

• Reading: list_shared_v3_balances (who owes whom across all your groups), get_shared_v3_balances (one group), get_shared_v3_snapshot (pass a group to read just that group), export_shared_v3_space, list_shared_inbox
• Groups and expenses: shared_v3_space_create, shared_v3_expense_create, shared_v3_expense_update, shared_v3_expense_void*, shared_v3_refund_create, shared_v3_refund_void*, shared_v3_comment_create
• Payments: shared_v3_settlement_propose (I paid a member), shared_v3_settlement_receive (I was paid, including by a guest), shared_v3_settlement_confirm, shared_v3_settlement_reject (decline, or withdraw your own pending payment), shared_v3_settlement_record_guest (paid to a guest), shared_v3_reminder_send (remind a member)
• Invites and guests: get_group_invite_link, shared_v3_invite_link_create, shared_v3_participant_create_guest, shared_v3_participant_claim_request (hand a guest’s place to a connected friend or a profile code)
• Connections and invitations: list_shared_connections, list_shared_invitations, get_sharing_profile, resolve_shared_identity
• Helpers: calculate_shared_item_split, get_exchange_rate, scan_receipt (where available)

Every group and friend space uses the shared_v3_… tools, including groups without guests. The older shared_… group tools are no longer offered to assistants; the OweJar apps are unaffected.

If an assistant makes too many requests in a minute, OweJar answers with rate_limited and how many seconds to wait (retryAfter); the assistant can then try again.

* Needs your approval before it can be saved.

For the full catalogue, ask your assistant to list OweJar’s tools, or read the REST API description at /v1/openapi.json.