# Finance Toolkit MCP > The Finance Toolkit MCP lets your AI agent run complex financial math that standard LLMs fail at. It calculates loan amortization (SAC/PRICE), compound interest rates, ROI percentages, and simple interest using an exact V8 JavaScript engine. This ensures the calculations are precise every time. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** financial-math, roi-calculation, amortization, loan-projections, deterministic-math, v8-engine ## Description Running accurate financial models requires more than just language understanding; it demands absolute mathematical precision. When you need to calculate things like bond schedules or investment growth, relying on a standard large language model is risky—they can hallucinate figures that lead to bad business decisions. This MCP solves that problem by handling all the math using an exact V8 JavaScript engine, keeping sensitive data local and secure. Instead of trying to compute these formulas internally, your agent delegates the work. You can generate detailed amortization tables comparing SAC or PRICE methods, track return on investment (ROI), or calculate compound interest over years. This functionality is hosted within the comprehensive Vinkius catalog, meaning you connect once to access deterministic math for all your financial needs. ## Tools ### calculate_amortization Generates a full loan payment schedule, comparing SAC and PRICE methods using an exact rate input. ### calculate_compound_interest Calculates future investment value based on compound interest rates over a set time period. ### calculate_roi Computes the percentage return (ROI) to measure profit against initial expenditures. ### calculate_simple_interest Calculates basic interest accrual over time, using a straightforward non-compounding formula. ## Prompt Examples **Prompt:** ``` I need to finance a $500,000 property over 360 months at a 0.8% monthly interest rate. Give me the summary using the SAC table. ``` **Response:** ``` Using the calculate_amortization tool: The first installment is $5,388.89, the last is $1,400.00. Total interest paid will be $722,000.00. ``` **Prompt:** ``` If I invest $10,000 for 5 years with an annual compound interest rate of 7%, what will be the final amount? ``` **Response:** ``` Using the calculate_compound_interest tool: The final amount will be $14,025.52, generating $4,025.52 in pure interest. ``` **Prompt:** ``` Calculate the ROI for a marketing campaign where we invested $2,500 and generated $8,700 in sales. ``` **Response:** ``` Using the calculate_roi tool: The net profit is $6,200, resulting in a phenomenal ROI of 248%. ``` ## Capabilities ### Generate Amortization Schedules Creates summarized loan payment tables, comparing Constant Amortization (SAC) and French Price (PRICE) methods. ### Calculate Compound Interest Growth Determines the future value of an investment using customizable compounding frequencies over time. ### Compute Return on Investment Calculates the percentage return (ROI) based on initial costs versus generated profit. ### Calculate Simple Interest Determines the total interest accrued over a period using basic, non-compounding formulas. ## Use Cases ### Modeling a Mortgage Refinance A client needs to compare two different loan structures. They ask their agent to run calculate_amortization for both SAC and PRICE schedules based on new rates, immediately seeing the total interest paid difference without opening multiple spreadsheets. ### Evaluating Marketing Spend The marketing team needs to know if a $50k campaign was worth it. They use calculate_roi with sales data ($2M revenue) and get an exact 390% ROI instantly, proving the budget spend. ### Forecasting Retirement Savings A user wants to know their retirement savings goal. They ask for a compound interest calculation over 30 years with 7% annual compounding, getting a precise projected final amount. ### Analyzing Short-Term Debt The business needs quick estimates on short-term loans where compounding isn't the primary factor. They use calculate_simple_interest to get reliable baseline calculations immediately. ## Benefits - Avoid hallucinated math. Because this tool uses a deterministic V8 JavaScript engine, you get calculations for ROI and amortization that are 100% accurate, every time. - Compare complex loan types instantly. Use calculate_amortization to generate detailed SAC or PRICE schedules, letting you visualize different repayment paths in one step. - Model long-term growth with confidence. Calculate compound interest accurately, setting customizable compounding frequencies for precise investment projections. - Determine true profitability fast. The calculate_roi tool gives you an immediate percentage of return on any project, simplifying budget justification. - Keep your data private. All sensitive financial plans and proprietary rates are processed locally, meaning the math never leaves your secure infrastructure. ## How It Works The bottom line is your AI client gets guaranteed accurate numbers for financial modeling without relying on built-in LLM calculations. 1. You instruct your agent to perform a complex calculation, like finding ROI or running an amortization schedule. 2. Your agent calls this MCP and sends the required parameters (e.g., principal amount, rate type). 3. The V8 engine runs the math deterministically, returning only the exact numerical result or structured table data. ## Frequently Asked Questions **How does the Finance Toolkit MCP handle complex loan math?** The toolkit uses a deterministic V8 JavaScript engine to perform calculations like calculate_amortization. This means it guarantees mathematical accuracy, preventing the hallucination of figures common in standard AI models. **Can I use this MCP for different types of interest?** Yes. It offers tools for calculating both compound interest using calculate_compound_interest and basic interest using calculate_simple_interest, covering most financial needs. **What is the difference between SAC and PRICE amortization with this MCP?** The calculate_amortization tool lets you compare these two methods directly. SAC (Constant Amortization) keeps the principal reduction constant, while PRICE (French) spreads payments evenly. **Is the data I use for ROI calculations private?** Yes. The MCP processes sensitive financial planning and proprietary rates locally within your infrastructure, meaning the data never leaves your controlled environment. **Does calculate_compound_interest handle varying compounding periods?** It does. You can specify the frequency of compounding (times per year) beyond just annual compounding, ensuring highly accurate projections for investments.