Docs

Developers/mcp

MCP server

Let AI assistants use LoanPilot via the Model Context Protocol.

4 sections

MCP server

@ippopone/loanpilot-mcp is a Model Context Protocol server that lets AI assistants (Claude Desktop, Cursor, and other MCP clients) use LoanPilot through your API key.

Tools

  • whoami — the user/team the key belongs to
  • list_analyses — recent analyses
  • get_analysis — one analysis with its decision, score and full result
  • list_products — the team's loan products
  • analyze_statement — upload a PDF (base64) and start an analysis; optional bureau_report (base64) attaches a free credit report
  • combine_statements — combine 2–6 PDFs (base64) for one account; optional bureau_report (base64) attaches a free credit report
  • upload_credit_report — upload a credit report (base64) for a free, standalone bureau-only check
  • run_credit_check / list_credit_checks / get_credit_check — credit-bureau reports (billable)
  • create_customer / list_customers / get_customer / update_customer / attach_to_customer — PAN-keyed borrower profiles (Customers)
  • get_customer_catalog — the KYC vocabulary (employment types, loan purposes, business categories, …)
  • get_customer_profile / update_customer_profile — read and upsert a borrower's KYC (partial; null clears a field)
  • list_customer_businesses / add_customer_business / update_customer_business / remove_customer_business — the borrower's businesses (name required, category from the catalog)

Credit reports are free to upload

analyze_statement and combine_statements take an optional bureau_report (base64 of an Experian / Equifax / CRIF report, JSON or TXT) plus bureau_report_name; the bureau is auto-detected and folded into the analysis with no entitlement and no enquiry cost. upload_credit_report does the same on its own — pass content (base64) and an optional file_name to get a standalone bureau-only check with the full normalized report. A file that isn't a recognised report returns an error.

Claude Desktop (stdio)

{
  "mcpServers": {
    "loanpilot": {
      "command": "npx",
      "args": ["-y", "@ippopone/loanpilot-mcp"],
      "env": { "LOANPILOT_API_KEY": "lp_live_..." }
    }
  }
}

Hosted (remote, streamable HTTP)

Point an MCP client that supports remote servers at https://api.ippo.one/mcp and send your key as Authorization: Bearer lp_live_.... To self-host:

loanpilot-mcp --http --port 3007