UseCOS MCP Server
# UseCOS MCP Server (`usecos-mcp`)
Official Model Context Protocol (MCP) server for [UseCOS](https://usecos.app) — 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](https://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](https://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](https://usecos.app/pay) · [Methodology](https://usecos.app/methodology/paycheck-calculator-validation) |
| `calculate_canadian_gst_hst` | Add or reverse-extract GST, PST, and HST across all 13 Canadian provinces and territories. | [usecos.app/gst](https://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](https://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](https://usecos.app/vin) |
## Quick Start
### Claude Desktop / Cursor / Windsurf
Add `usecos` to your MCP configuration:
```json
{
"mcpServers": {
"usecos": {
"command": "npx",
"args": ["-y", "usecos-mcp"]
}
}
}
```
### Run from source
```bash
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.
TDQS
Scored across 6 tools
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.
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.
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.
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.