# Splitwise — how to use (mcp.ai)

Splitwise helps you split bills and expenses with friends and family.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_splitwise?ms=1781541720000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `splitwise_add_friend`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/splitwise`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/splitwise/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/splitwise/add/friend` — Tool to add a new friend to splitwise. use when you have the friend's email and name details ready.
  - body: { user_email: string, user_last_name?: string, user_first_name?: string }
- `POST https://api.mcp.ai/api/splitwise/create/expense` — Tool to create a new splitwise expense. use when you need to record a payment or bill in a group or between users. provide either split equally or a custom users list for shares.
  - body: { cost: string, date?: string, users?: object[], details?: string, group_id: integer, category_id?: integer, description: string, currency_code?: string, split_equally?: boolean, repeat_interval?: string }
- `POST https://api.mcp.ai/api/splitwise/delete/expense` — Tool to delete an existing expense by its id. use after confirming you have a valid expense id.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/splitwise/delete/friend` — Tool to delete an existing friend by id. use when you need to remove a friend relationship by its user id. call after confirming the correct friend id.
  - body: { friend_id: integer }
- `POST https://api.mcp.ai/api/splitwise/get/categories` — Tool to retrieve expense categories. use when you need to list available categories before creating an expense.
- `POST https://api.mcp.ai/api/splitwise/get/currencies` — Tool to retrieve a list of supported currencies. use when you need to display or validate currency options.
- `POST https://api.mcp.ai/api/splitwise/get/current/user` — Tool to retrieve information about the current authenticated user. use when you need profile details of the logged-in user.
- `POST https://api.mcp.ai/api/splitwise/get/group` — Action to retrieve information about a group.
  - body: { id: integer }

## More
- Page: https://mcp.ai/splitwise
- Agent spec (llms.txt): https://mcp.ai/splitwise/llms.txt
- Postman collection: https://mcp.ai/splitwise/postman.json