Skip to main content
Glama
UseCOS MCP Server

UseCOS MCP Server

by rivlosys
README.md
# 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

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