Skip to main content
Glama
UseCOS MCP Server

UseCOS MCP Server

by rivlosys

UseCOS MCP Server (usecos-mcp)

Official Model Context Protocol (MCP) server for UseCOS — deterministic, zero-tracking Canadian financial, tax, mortgage, automotive, and ISO 3779 VIN calculations.

All calculations run locally using the exact open-source TypeScript engines powering usecos.app. No API keys, no user data collection, and no LLM guesswork on financial math.

Tools Included

Tool

What it calculates

Interactive Web Tool & Methodology

calculate_canadian_mortgage

Canadian semi-annual compounding payment, CMHC default insurance, provincial land transfer tax, and OSFI B-20 stress-test payment (max(rate + 2%, 5.25%)).

usecos.app/mortgage

compare_mortgage_renewals

Side-by-side Canadian mortgage renewal offer comparison (scheduled payment, term interest, principal paid, ending balance, net switching cost, total term cost).

usecos.app/mortgage/renewal-offer-analyzer

calculate_canadian_paycheck

Federal and provincial income tax, CPP/CPP2, EI/QPIP, Ontario surtax/health premium, and take-home pay for all 13 Canadian provinces and territories.

usecos.app/pay · Methodology

calculate_canadian_gst_hst

Add or reverse-extract GST, PST, and HST across all 13 Canadian provinces and territories.

usecos.app/gst

calculate_canadian_auto_loan

Auto loan monthly payment, sales tax after trade-in, net trade-in equity, and total interest.

usecos.app/auto-loan-calculator-canada

validate_iso_vin

17-character ISO 3779 / US 49 CFR Part 565 VIN check-digit validation (Position 9 Modulo-11), WMI, model year, and plant code decoding.

usecos.app/vin

Related MCP server: precisioncalc-mcp

Quick Start

Claude Desktop / Cursor / Windsurf

Add usecos to your MCP configuration:

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

Run from source

node dist/index.js

Disclaimers & Scope

Results are deterministic estimates based on published statutory formulas (Interest Act semi-annual compounding, OSFI B-20, CRA payroll formulas, ISO 3779). They do not replace a lender's commitment, tax professional advice, or a full vehicle history report.

Available Tools

6 tools
calculate_canadian_auto_loanB

Calculate Canadian auto loan monthly payment, provincial sales tax after trade-in, net trade-in equity, and total interest.

Inputs: vehiclePrice (required), annualRatePercent (required), fees, rebate, +5 more.

calculate_canadian_gst_hstB

Calculate or reverse-extract Canadian GST, PST, and HST for any province or territory.

Inputs: amount (required), province, includeInTotal.

calculate_canadian_mortgageB

Calculate Canadian mortgage payment (semi-annual compounding), CMHC insurance, provincial land transfer tax, and OSFI B-20 stress-test payment.

Inputs: rate (required), price (required), mode, amort, +6 more.

calculate_canadian_paycheckB

Calculate Canadian take-home pay, federal/provincial income tax, CPP/CPP2, EI/QPIP, and Ontario surtax across all 13 provinces and territories.

Inputs: amount (required), period, province, retirementRRSP.

compare_mortgage_renewalsA

Deterministically compare 2 or 3 Canadian mortgage renewal offers by scheduled payment, term interest, principal paid, ending balance, switching costs, and total term cost.

Inputs: offers (required), position (required).

validate_iso_vinA

Validate a 17-character Vehicle Identification Number (VIN) under ISO 3779 and US 49 CFR Part 565, verifying the Position 9 check digit and decoding WMI, model year, and plant code.

Inputs: vin (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 6 tools

    Disambiguation4/5

    Each tool covers a clearly distinct financial domain: sales tax, auto loans, VIN validation, mortgages, renewal comparison, and payroll. The only mild overlap is between calculate_canadian_mortgage and compare_mortgage_renewals, since both deal with mortgage payments and term interest, but the descriptions make the comparison-vs-single-calculation boundary reasonably clear.

    Naming Consistency4/5

    Names follow a predictable verb_noun pattern (calculate_..., validate_..., compare_...) with a shared 'canadian' qualifier in most cases. compare_mortgage_renewals drops the 'canadian' qualifier, a minor deviation but not confusing.

    Tool Count5/5

    Six tools is well within a comfortable scope and each maps to a distinct calculator or validator with no filler. The set is focused on Canadian personal-finance math and nothing feels redundant or missing purely for coverage's sake.

    Completeness3/5

    Core workflows (sales tax, auto loan, mortgage, renewal comparison, paycheck, VIN) are covered, but a Canadian finance calculator suite has notable gaps: no standalone amortization schedule, no lease-vs-buy, RRSP/TFSA/savings or investment calculators, and no generic income-tax-only tool. Agents can work around these but some common requests will dead-end.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      The most comprehensive everyday calculator MCP server — 501 tools across 22 categories covering 8 countries' tax systems (FR, BE, CH, CA, US, UK, MA, SN). Finance, health, math, science, construction, conversions, education, sport, cooking, travel, and more. Free, no API key required. Streamable HTTP transport.
      15
      20 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that provides deterministic, high-precision business, finance, and operational calculations such as SaaS metrics, currency conversion, business days, and financial formulas, returning structured JSON results.
      11
      41 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Public, no-login MCP server exposing SmartMoney77's financial calculators: compound interest, FIRE number, credit-card payoff, emergency fund, inflation, fees and the cost of waiting. Also computes historical "what if I had invested" returns from real yearly price data, and builds deep links and share packs for calculators in 6 localized editions.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides deterministic developer utilities as MCP tools, including UUID/password generation, hashing, encoding, JWT decoding, cron scheduling, regex execution, and text analysis. Runs entirely locally with no network calls, telemetry, or API keys.
      20
      84 npm
      MIT