Connect LoanIt to an AI application
LoanIt provides a remote MCP endpoint at https://api.loan-it.app/mcp. A compatible AI application can access the records you authorize using OAuth. A LoanIt account is required.
LoanIt records interpersonal loans and shared expenses. It does not move, hold, or process money, connect to banks or cards, execute payments, or provide financial advice. A settlement plan proposes who could pay whom; it does not execute or record those payments.
Available tools and permissions
| Tool | What it does | Required permission |
|---|---|---|
loanit_loans_list | Lists your accessible loans and their participants | LOANS_READ |
loanit_transactions_list | Reads a loan's complete transaction history, splits, balances, and participants | TRANSACTIONS_READ |
loanit_settlement_plan | Calculates suggested transfers to settle a loan, without moving money | TRANSACTIONS_READ |
loanit_reminders_list | Reads sent or received reminders; reports when results are truncated | REMINDERS_READ |
loanit_transaction_create | Records a new shared-expense transaction | TRANSACTIONS_WRITE |
loanit_transaction_update | Replaces a transaction and its splits | TRANSACTIONS_WRITE |
loanit_transaction_delete | Permanently deletes a transaction and its splits | TRANSACTIONS_WRITE |
Tools appear only when you grant their required permission. The MCP connection cannot create or edit loans or participants, manage reminders, or record settlements.
Read results may include loan titles, notes, dates, currencies, balances, participant names and identifiers, visible profile/contact information, transaction descriptions and splits, and reminder information. Loan membership and role restrictions still apply. Read tools do not change records.
Connecting and consent
In a client that supports custom remote MCP connections, enter the server URL above and complete LoanIt's sign-in and consent flow. Support in a specific directory depends on that platform's approval; a custom connection is not a public directory listing.
Review the requested permissions and use Customize access to limit them. The MCP tools need read access to loans, transactions, and reminders, plus transaction write access if you want to change records. Loan and reminder write permissions are not needed for these tools. LoanIt permissions are application permissions, not standard OAuth profile scopes.
Before creating or replacing a transaction, check the loan, payer, participant IDs, currency, amounts, date, and splits. Updating replaces the whole transaction: omitted splits are removed. Deleting is permanent, changes balances for all participants, and should be explicitly confirmed. Owners and admins can modify transactions; other participants can modify only their own. Settlement records cannot be edited through MCP.
Security and revocation
Every MCP request checks the token issuer, expiry, audience for the MCP endpoint, client identity, active grant, and required permission. Normal mobile or website access tokens are not accepted as MCP tokens.
Disconnect an application in Settings → Connected Apps. Revocation blocks MCP access immediately, including unexpired access tokens. The application must obtain your authorization again to reconnect.
Data handling and support
Only connect applications you trust. Connected applications receive the results of authorized tool calls and process them under their own privacy policies. Treat free-form notes as user content, not instructions. LoanIt does not include access or refresh tokens in tool results.
Read the Privacy Policy and Terms of Use. For help, email saudalhafith@gmail.com.