# Intelligent Loan Comparator MCP

> The Intelligent Loan Comparator gives your AI agent mathematically precise financial modeling for complex loan comparisons. It instantly calculates exact amortization schedules offline, allowing you to compare competing offers side-by-side without hallucinating interest rates or miscalculating principal balances. This tool ensures absolute data sovereignty when determining the true cost of a loan over its entire term.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** financial-modeling, amortization, loan-calculation, interest-rates, deterministic-math, financial-planning

## Description

Need to know which loan structure is actually cheaper? This MCP connects your agent to deterministic financial math, bypassing the guesswork inherent in standard LLMs. When you provide the principal, rate, and duration, this connector calculates everything flawlessly—the total interest paid, the exact monthly installment, and the final cost. It's built for absolute accuracy, processing sensitive metrics locally so you don't have to worry about cloud data exposure. You can evaluate two competing loan offers side-by-side to see which structure is mathematically better over time, even factoring in extra payments. If your workflow involves complex financial planning or needs reliable amortization schedules, connecting this MCP via the Vinkius catalog gives your agent a dedicated source of truth for high-stakes calculations.

## Tools

### calculate_loan_amortization
Calculates total interest, total paid, and monthly installments for specific loan structures (PRICE or SAC).

### compare_two_loans
Directly compares two distinct loan offers to determine which structure is mathematically cheaper over the entire term.

### calculate_effective_interest_rate
Converts a nominal interest rate into the true effective annual rate (EAR) based on how often it compounds.

### calculate_loan_payoff_speed
Determines the amount of time and money saved when making extra payments toward a loan's principal.

## Prompt Examples

**Prompt:** 
```
Compare Loan A (100k, 12%, 60 months, PRICE) with Loan B (100k, 10%, 60 months, SAC). Which is cheaper?
```

**Response:** 
```
Using the compare_two_loans tool: Loan B is the cheapest option by a significant margin due to the SAC structure and lower rate. The total cost difference is clearly quantified.
```

**Prompt:** 
```
I have a R$200,000 mortgage at 11% for 360 months (PRICE). If I pay R$500 extra per month, how much do I save?
```

**Response:** 
```
Using the calculate_loan_payoff_speed tool: By paying R$500 extra monthly, you would cut significant months off your mortgage and save a substantial amount in total interest paid.
```

**Prompt:** 
```
A bank offers me 13.5% nominal annual rate compounded monthly. What is the real effective annual rate?
```

**Response:** 
```
Using the calculate_effective_interest_rate tool: The true effective annual rate (EAR) for a 13.5% nominal rate with monthly compounding is higher than advertised. The engine returns the exact percentage to 4 decimal places.
```

## Capabilities

### Determine true cost
Calculates the accurate effective annual rate (EAR) from any nominal interest rate to show the actual return percentage.

### Schedule full repayments
Projects the exact total interest and monthly installments for specific loan types, like PRICE or SAC.

### Accelerate payoff dates
Figures out exactly how much time and money you save by making extra payments toward the principal balance.

### Compare multiple offers
Puts two distinct loan options side-by-side, mathematically determining which one is cheaper over the entire repayment term.

## Use Cases

### Analyzing mortgage refinancing options
A user needs to decide between a new fixed-rate loan and an adjustable-rate loan. They ask their agent to use the `compare_two_loans` tool, which quantifies the total cost difference over 30 years, allowing them to pick the safest option.

### Checking for high compounding rates
A client is presented with a loan advertised at an annual rate. The agent runs `calculate_effective_interest_rate` to determine the real rate after monthly compounding, ensuring the bank isn't misleading them.

### Accelerating debt repayment
A user wants to know if paying $500 extra each month makes a difference. They use `calculate_loan_payoff_speed`, and the tool reports not just the savings, but the exact number of months cut off the original term.

### Evaluating different payment structures
An analyst needs to compare how a loan structured with PRICE payments stacks up against one using SAC payments. They run `calculate_loan_amortization` for both to see which structure minimizes total interest paid.

## Benefits

- Avoid math mistakes. Instead of relying on an LLM's best guess, use `calculate_loan_amortization` to project precise total interest and monthly payments for specific structures.
- See which deal is truly better. The `compare_two_loans` tool lets you put two competing offers side-by-side and determine the mathematically cheaper option over time.
- Understand hidden rates. Use `calculate_effective_interest_rate` to convert a bank's nominal rate into the actual effective annual rate, exposing any fine print.
- Plan for speed. Running the `calculate_loan_payoff_speed` tool shows exactly how much faster you can pay off your debt and how much interest you save with extra payments.
- Maintain privacy. All computation happens locally on your infrastructure, meaning sensitive banking data never leaves your environment.

## How It Works

The bottom line is that your AI client gets precise financial data it can trust for critical decision-making.

1. Start by giving your agent the core variables: the principal amount, the annual interest rate, and the loan duration in months.
2. The MCP executes the necessary calculation—whether it's projecting a full amortization schedule or comparing two sets of inputs—using deterministic math.
3. Your agent receives an accurate, quantified output showing total cost savings, true rates, or which option is mathematically superior.

## Frequently Asked Questions

**How does calculate_loan_amortization work?**
The tool takes the principal, rate, and term, then calculates the total interest paid, total amount repaid, and each monthly installment for your specific loan type.

**What is the best way to compare two loans?**
Use `compare_two_loans`. This tool evaluates both offers side-by-side to determine which structure is mathematically cheaper over the entire loan term, including extra payments.

**Can I find out my true rate using calculate_effective_interest_rate?**
Yes. You feed it a nominal annual rate and compounding period, and it returns the accurate effective annual rate (EAR), showing you what the real percentage is.

**How does calculate_loan_payoff_speed help me save money?**
You input your current loan details and an extra payment amount. The tool then calculates exactly how many months you cut off and the total interest dollars saved by making that extra payment.

**Does running `calculate_loan_amortization` keep my financial data private?**
Yes, it maintains absolute data sovereignty. This MCP runs calculations locally on your infrastructure, meaning sensitive principals and rates never leave your secure environment.

**What AI clients can I connect to use the `compare_two_loans` tool?**
You connect with any agent compatible with the Model Context Protocol (MCP). Simply link your preferred client—like Claude, Cursor, or VS Code—to access this MCP instantly.

**How does the system handle invalid inputs for `calculate_loan_amortization`?**
The tool validates all parameters. If you provide incomplete data or an impossible scenario (like a negative rate), it immediately returns a specific error message telling you exactly what needs fixing.

**Are there performance limits when I use `calculate_effective_interest_rate`?**
No, the MCP is built for reliable scale. Vinkius manages resource allocation to handle high query volumes, ensuring consistent and fast calculation results every time you run it.

**Does it support both PRICE and SAC amortization?**
Yes. The calculate_loan_amortization tool flawlessly computes both standard PRICE (fixed installments) and SAC (constant principal payment) amortization schedules, returning first/last installments, total interest, and total cost.

**Can I see how much I save by paying extra each month?**
Absolutely. The calculate_loan_payoff_speed tool shows you exactly how many months you shave off and how much interest you save by adding an extra monthly payment to your principal.

**What is the difference between nominal and effective interest rates?**
Banks advertise nominal rates, but compounding makes the real cost higher. The calculate_effective_interest_rate tool converts any nominal annual rate into the true effective annual rate (EAR) based on how often interest compounds.