Compute a business / SaaS / finance metric with exact decimal precision.

Supported metric values -> params keys (rates/margins are decimals, 0.05 = 5%):

• ltv -> arpu, churn_rate, [gross_margin=1]

• cac -> total_spend, new_customers

• ltv_cac_ratio -> ltv, cac

• payback_period_months-> cac, monthly_revenue_per_customer, [gross_margin=1]

• contribution_margin -> revenue, variable_costs

• gross_margin -> revenue, cogs

• churn_rate -> customers_lost, customers_at_start

• mrr_growth_rate -> beginning_mrr, ending_mrr

• arr -> mrr

• break_even_units -> fixed_costs, price_per_unit, variable_cost_per_unit

• nrr -> starting_mrr, expansion_mrr, contraction_mrr, churned_mrr

• grr -> starting_mrr, contraction_mrr, churned_mrr

• rule_of_40 -> growth_rate, profit_margin

• magic_number -> current_quarter_revenue, prior_quarter_revenue, prior_quarter_sm_spend

Call list_metrics for full schemas.

Args: metric: Name of the metric to compute. params: Object of named numeric parameters for the chosen metric. currency: ISO currency code used to format monetary results.

List every supported metric with description, required and optional params.

Convert an amount between major currencies with Decimal precision.

Supported: USD, EUR, GBP, JPY, CAD, AUD, CHF, CNY, INR. Returns the converted amount, exact cross-rate, provider, and timestamps.

Rates: static offline table by default. A date (YYYY-MM-DD) or live=true uses live/historical ECB rates (frankfurter.app); on any network failure the server falls back to static rates with a warning note.

Args: amount: Amount in from_currency (>= 0). from_currency: Source ISO 4217 code. to_currency: Target ISO 4217 code. date: Optional historical date (YYYY-MM-DD) -> live provider. live: Force live (true) or static (false); null = auto.

Business-day arithmetic honoring weekends and regional public holidays.

Operations: add_business_days (needs days, may be negative) | count_business_days (needs end_date, inclusive) | next_business_day | previous_business_day.

Regions: US, UK, EU, NONE (weekends only) are built in and offline. If the optional holidays package is installed, ANY ISO country code also works (DE, FR, CA, AU, JP, IN, ...). custom_holidays (YYYY-MM-DD list) are added.

Args: operation: One of the four operations above. start_date: Anchor date, ISO YYYY-MM-DD. days: Business days to add (add_business_days; negative allowed). end_date: End date (count_business_days), ISO. region: US | UK | EU | NONE | ISO country code. custom_holidays: Optional extra holiday dates (YYYY-MM-DD).

Compound-interest / growth math (future value, present value, or CAGR).

Operations: future_value (needs rate, years, present_value) | present_value (needs rate, years, future_value) | cagr (needs begin_value, end_value, years). rate is an annual decimal (0.08 = 8%). compounding: daily | weekly | monthly | quarterly | semiannually | annually | continuous.

Net Present Value (discounted cash flow) of a periodic cashflow series.

NPV = sum(CF_t / (1 + rate)^t), t = 0..n. Index 0 is period 0 (typically the negative initial investment).

Args: rate: Discount rate per period as a decimal (0.10 = 10%). cashflows: List of >= 2 numbers, e.g. [-10000, 3000, 4200, 6800]. currency: ISO code for formatting.

Internal Rate of Return: the per-period rate where NPV == 0.

Solved with Newton's method + a bisection fallback. Requires at least one negative and one positive cashflow.

Args: cashflows: List of >= 2 numbers, e.g. [-10000, 3000, 4200, 6800]. guess: Optional starting rate for Newton's method (decimal).

Level-payment loan: monthly payment, total interest, payoff, and schedule.

payment = P * r / (1 - (1 + r)^-n), r = annual_rate/12, n = term_months.

Args: principal: Loan amount (> 0). annual_rate: Nominal annual rate as a decimal (0.06 = 6%). term_months: Number of monthly payments (> 0). extra_payment: Optional extra principal each month (shortens the term). currency: ISO code for formatting. include_schedule: If true, return the full month-by-month schedule.

Asset depreciation schedule.

Methods: straight_line | declining_balance (double-declining) | sum_of_years_digits. Returns Year-1 depreciation plus the full yearly schedule (book value converges to salvage_value).

Args: method: Depreciation method (see above). cost: Initial asset cost. salvage_value: Residual value at end of life (<= cost). useful_life_years: Whole years (> 0). currency: ISO code for formatting.

Run many calculations in one request to cut agent round-trips.

Each item is {"tool": <name>, "arguments": {...}}. Results are returned in order; a failure in one item never aborts the batch (its slot holds an error envelope). Batchable tools: calculate_metric, currency_convert, business_days, compound_growth, net_present_value, internal_rate_of_return, loan_amortization, depreciation, list_metrics.

Args: calls: List of {"tool": str, "arguments": object} items (max 100).

Return server health/status metadata (name, version, tools, capabilities).