Use LoanCompass from your AI assistant or the terminal

LoanCompass exposes everything you can do on the loan pages as a set of tools an AI assistant can call: Claude, ChatGPT, Cursor, Codex, Windsurf, or any app that supports MCP. Add a person, record a loan or a repayment, move a loan to someone else, confirm a payment a borrower says they made, read what is due this month or when the money comes back. You describe the change in plain words; the assistant looks up the right person and loan, confirms anything destructive, and reports the new balance.

MCP is an open standard that lets assistants call tools. LoanCompass offers it two ways: a hosted connector you sign in to from the assistant (nothing to install), or a small local tool that runs on your machine with a personal access token. Either way the connection is yours alone, you can cut it off from Profile → Security at any time, and no AI service is involved on our side.

The easiest route, and the only one the web apps can use. Give the assistant this address, sign in to LoanCompass when it asks, and press Allow:

https://api.loancompass.app/mcp

• Claude.ai: Settings → Connectors → Add custom connector, paste the address.
• Claude Desktop and Cursor: add it as a remote (HTTP) MCP server in their connector or MCP settings.
• ChatGPT: Settings → Connectors, paste the address. General-purpose tools like these need developer mode turned on.
• Claude Code:

  claude mcp add --transport http loancompass https://api.loancompass.app/mcp

Each assistant you connect appears under Profile → Security → Connected apps, where one click disconnects it. No token to copy and nothing to install.

The tool is the loancompass package on npm, so there is nothing to download by hand. It needs Node.js 20 or newer, which most assistants already require. Sign in, then check it:

npx loancompass login
npx loancompass whoami

Your browser opens on LoanCompass; press Authorize and the terminal picks it up. That creates a personal access token named after this computer and saves it to a config file in your home directory that only your user can read. npx loancompass logout forgets it; revoke it under Profile → Security → API tokens as well if the machine changes hands.

npx loancompass login --token lcp_…

Register the server once in the assistant you use. Each block is the whole setup.

claude mcp add --scope user loancompass -- npx -y loancompass mcp

{
  "mcpServers": {
    "loancompass": { "command": "npx", "args": ["-y", "loancompass", "mcp"] }
  }
}

codex mcp add loancompass -- npx -y loancompass mcp

Then just ask. The assistant resolves names to the right person and loan, asks when a name matches more than one, and always checks with you before deleting anything, moving a loan, or accepting a payment claim, because accepting records a real repayment.

Every tool your assistant uses is also a command. Ids come from the list commands; names can be searched instead of typed exactly. Install it globally with npm i -g loancompass to drop the npx.

npx loancompass whoami
npx loancompass borrowers list --search maria
npx loancompass loans list --search car
npx loancompass repayments add <loanId> --amount 200
npx loancompass loans update <loanId> --borrower <personId>   # move a loan
npx loancompass proposals list
npx loancompass proposals accept <loanId> <proposalId>
npx loancompass requests list
npx loancompass requests approve <requestId>
npx loancompass this-month
npx loancompass forecast --months 6
npx loancompass borrowed list                                  # what you owe

# Add --json to any command for machine-readable output.
# Deletes refuse to run without --yes.