@markcolabs/mcp 0.4.1 → 0.4.2

package/README.md

@@ -1,126 +1,126 @@
-# @markcolabs/mcp
-
-> Thin stdio-HTTPS shim that gives AI agents (Claude Desktop, MCP Inspector, any MCP client) access to financial calculator tools hosted at [digitalcalculator.info](https://www.digitalcalculator.info/mcp/). New tools are added server-side without a package update — call `tools/list` on the hosted endpoint for the current list.
-
-**v0.4.1** — stdio-HTTPS shim (S142/ADR-0044a). Engine source is private and runs in AWS Lambda; this package is a transport adapter only (~60 lines, zero engine code, MIT-licensed).
-
----
-
-## Install
-
-```bash
-npm install -g @markcolabs/mcp
-```
-
-Or run without installing (recommended):
-
-```bash
-npx -y @markcolabs/mcp
-```
-
-## Quickstart - Claude Desktop
-
-Add to `claude_desktop_config.json`:
-- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
-
-```json
-{
-  "mcpServers": {
-    "digitalcalculator": {
-      "command": "npx",
-      "args": ["-y", "@markcolabs/mcp"]
-    }
-  }
-}
-```
-
-Restart Claude Desktop. Ask "what tools do you have?" and Claude should list the available financial calculator tools.
-
-Full setup instructions: [www.digitalcalculator.info/mcp/quickstart/](https://www.digitalcalculator.info/mcp/quickstart/)
-
----
-
-## Tools
-
-Tools are served by the hosted endpoint at `mcp.digitalcalculator.info/mcp`. New tools are added server-side — the package does not need to be updated when the tool set grows. Call `tools/list` for the authoritative current list.
-
-Tools currently available (as of v0.4.1):
-
-| Tool | Input (summary) | Returns (summary) |
-|---|---|---|
-| `mortgage_monthly_payment` | `principal`, `annualRatePercent`, `termYears` | Monthly P&I, total interest, total paid |
-| `compound_interest_future_value` | `principal`, `annualRatePercent`, `years`, `compoundingFrequency`, optional `monthlyContribution` | Future value, contributions, interest earned |
-| `retirement_401k_projection` | balance, salary, contribution %, employer match, return %, ages | Year-by-year balance, IRS 2026 limits applied |
-| `social_security_estimated_benefit` | `birthYear`, `currentEarnings`, `claimAge`, optional `yearsWorked`, `lifeExpectancy` | Monthly benefit at FRA, adjusted for claim age, lifetime projection |
-| `paycheck_net_pay` | `grossAnnualSalary`, `payFrequency`, `federalFilingStatus`, `state`, pre-/post-tax deductions | Per-paycheck gross/federal/FICA/state/net, annualized totals |
-| `ira_contribution_limit` | `age`, `filingStatus`, `magi`, `type` ('traditional' or 'roth') | Eligible contribution, Roth phase-out, catch-up, 2026 IRS limits |
-| `roth_conversion_tax_impact` | `conversionAmount`, `age`, `filingStatus`, `currentTaxableIncome`, optional retirement rate | Federal tax owed, marginal/effective rate, 5-year-rule flag |
-| `rmd_distribution_amount` | `accountBalance`, `ownerAge` (>= 73) | Required minimum distribution, Uniform Lifetime Table factor |
-| `hsa_contribution_limit` | `age`, `coverageTier` ('self-only' or 'family'), optional `employerContribution` | Total annual limit, employee max remaining, 2026 IRS limits |
-| `inflation_adjusted_value` | `amount`, `inflationRate`, `years`, optional `mode` | Future value or purchasing power after N years of inflation |
-| `savings_future_balance` | `initialDeposit`, `monthlyContribution`, `annualInterestRate`, `years` | Future balance, total contributions, interest earned |
-
-| Resource | Purpose |
-|---|---|
-| `dc://disclaimers/ymyl` | Canonical YMYL disclaimer string returned in every tool response. |
-| `dc://methodologies/manifest` | Methodology URLs for all available calculator tools. |
-
-Every tool response includes a `disclaimer` field ("Estimates only - for educational purposes...") and an `engineVersion` field. Failures return:
-
-```json
-{ "error": { "code": "INPUT_VALIDATION", "message": "...", "field": "...", "retriable": false } }
-```
-
-Error codes: `INPUT_VALIDATION`, `BUSINESS_RULE`, `INTERNAL`, `RATE_LIMIT` (only `RATE_LIMIT` is retriable).
-
-Full input schemas and output shapes: [www.digitalcalculator.info/mcp/api-reference/](https://www.digitalcalculator.info/mcp/api-reference/)
-
----
-
-## Hosted endpoint
-
-The MCP endpoint accepts JSON-RPC directly:
-
-```bash
-curl -X POST https://mcp.digitalcalculator.info/mcp \
-  -H 'Content-Type: application/json' \
-  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
-```
-
-Rate-limited to 100 req / 5 min per IP.
-
----
-
-## Architecture
-
-v0.4.x is a thin transport adapter with no calculation logic. Because engines run server-side, new tools appear automatically to any connected MCP client without a package update:
-
-```
-Claude Desktop -> stdin -> @markcolabs/mcp (shim) -> HTTPS -> mcp.digitalcalculator.info/mcp -> Lambda engine
-```
-
-The shim adds a 30-second request timeout (matching the AWS API Gateway integration ceiling) and a `User-Agent` header for diagnostics.
-
----
-
-## Licensing
-
-MIT - see [LICENSE](./LICENSE). The calculator engines at the hosted endpoint are proprietary; the MIT license does not apply to them.
-
----
-
-## Links
-
-- [Quickstart](https://www.digitalcalculator.info/mcp/quickstart/) - install and first call in under 5 minutes
-- [API Reference](https://www.digitalcalculator.info/mcp/api-reference/) - full schemas, output shapes, error codes
-- [FAQ](https://www.digitalcalculator.info/mcp/faq/) - accuracy, YMYL posture, rate limits, support
-- [GitHub repo](https://github.com/mark57-ux/digitalcalculator/tree/main/packages/mcp)
-
-## Support
-
-Open an issue at [github.com/mark57-ux/digitalcalculator/issues](https://github.com/mark57-ux/digitalcalculator/issues). Include the tool name, the input that reproduces the issue, and the expected vs. actual output.
-
-## License
-
-MIT - see [LICENSE](./LICENSE). Markcolabs LLC.
+# @markcolabs/mcp
+
+> Thin stdio-HTTPS shim that gives AI agents (Claude Desktop, MCP Inspector, any MCP client) access to financial calculator tools hosted at [digitalcalculator.info](https://www.digitalcalculator.info/mcp/). New tools are added server-side without a package update — call `tools/list` on the hosted endpoint for the current list.
+
+**v0.4.2** — stdio-HTTPS shim (S142/ADR-0044a). Engine source is private and runs in AWS Lambda; this package is a transport adapter only (~60 lines, zero engine code, MIT-licensed).
+
+---
+
+## Install
+
+```bash
+npm install -g @markcolabs/mcp
+```
+
+Or run without installing (recommended):
+
+```bash
+npx -y @markcolabs/mcp
+```
+
+## Quickstart - Claude Desktop
+
+Add to `claude_desktop_config.json`:
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "digitalcalculator": {
+      "command": "npx",
+      "args": ["-y", "@markcolabs/mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop. Ask "what tools do you have?" and Claude should list the available financial calculator tools.
+
+Full setup instructions: [www.digitalcalculator.info/mcp/quickstart/](https://www.digitalcalculator.info/mcp/quickstart/)
+
+---
+
+## Tools
+
+Tools are served by the hosted endpoint at `mcp.digitalcalculator.info/mcp`. New tools are added server-side — the package does not need to be updated when the tool set grows. Call `tools/list` for the authoritative current list.
+
+Tools currently available (as of v0.4.2):
+
+| Tool | Input (summary) | Returns (summary) |
+|---|---|---|
+| `mortgage_monthly_payment` | `principal`, `annualRatePercent`, `termYears` | Monthly P&I, total interest, total paid |
+| `compound_interest_future_value` | `principal`, `annualRatePercent`, `years`, `compoundingFrequency`, optional `monthlyContribution` | Future value, contributions, interest earned |
+| `retirement_401k_projection` | balance, salary, contribution %, employer match, return %, ages | Year-by-year balance, IRS 2026 limits applied |
+| `social_security_estimated_benefit` | `birthYear`, `currentEarnings`, `claimAge`, optional `yearsWorked`, `lifeExpectancy` | Monthly benefit at FRA, adjusted for claim age, lifetime projection |
+| `paycheck_net_pay` | `grossAnnualSalary`, `payFrequency`, `federalFilingStatus`, `state`, pre-/post-tax deductions | Per-paycheck gross/federal/FICA/state/net, annualized totals |
+| `ira_contribution_limit` | `age`, `filingStatus`, `magi`, `type` ('traditional' or 'roth') | Eligible contribution, Roth phase-out, catch-up, 2026 IRS limits |
+| `roth_conversion_tax_impact` | `conversionAmount`, `age`, `filingStatus`, `currentTaxableIncome`, optional retirement rate | Federal tax owed, marginal/effective rate, 5-year-rule flag |
+| `rmd_distribution_amount` | `accountBalance`, `ownerAge` (>= 73) | Required minimum distribution, Uniform Lifetime Table factor |
+| `hsa_contribution_limit` | `age`, `coverageTier` ('self-only' or 'family'), optional `employerContribution` | Total annual limit, employee max remaining, 2026 IRS limits |
+| `inflation_adjusted_value` | `amount`, `inflationRate`, `years`, optional `mode` | Future value or purchasing power after N years of inflation |
+| `savings_future_balance` | `initialDeposit`, `monthlyContribution`, `annualInterestRate`, `years` | Future balance, total contributions, interest earned |
+
+| Resource | Purpose |
+|---|---|
+| `dc://disclaimers/ymyl` | Canonical YMYL disclaimer string returned in every tool response. |
+| `dc://methodologies/manifest` | Methodology URLs for all available calculator tools. |
+
+Every tool response includes a `disclaimer` field ("Estimates only - for educational purposes...") and an `engineVersion` field. Failures return:
+
+```json
+{ "error": { "code": "INPUT_VALIDATION", "message": "...", "field": "...", "retriable": false } }
+```
+
+Error codes: `INPUT_VALIDATION`, `BUSINESS_RULE`, `INTERNAL`, `RATE_LIMIT` (only `RATE_LIMIT` is retriable).
+
+Full input schemas and output shapes: [www.digitalcalculator.info/mcp/api-reference/](https://www.digitalcalculator.info/mcp/api-reference/)
+
+---
+
+## Hosted endpoint
+
+The MCP endpoint accepts JSON-RPC directly:
+
+```bash
+curl -X POST https://mcp.digitalcalculator.info/mcp \
+  -H 'Content-Type: application/json' \
+  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
+```
+
+Rate-limited to 100 req / 5 min per IP.
+
+---
+
+## Architecture
+
+v0.4.x is a thin transport adapter with no calculation logic. Because engines run server-side, new tools appear automatically to any connected MCP client without a package update:
+
+```
+Claude Desktop -> stdin -> @markcolabs/mcp (shim) -> HTTPS -> mcp.digitalcalculator.info/mcp -> Lambda engine
+```
+
+The shim adds a 30-second request timeout (matching the AWS API Gateway integration ceiling) and a `User-Agent` header for diagnostics.
+
+---
+
+## Licensing
+
+MIT - see [LICENSE](./LICENSE). The calculator engines at the hosted endpoint are proprietary; the MIT license does not apply to them.
+
+---
+
+## Links
+
+- [Quickstart](https://www.digitalcalculator.info/mcp/quickstart/) - install and first call in under 5 minutes
+- [API Reference](https://www.digitalcalculator.info/mcp/api-reference/) - full schemas, output shapes, error codes
+- [FAQ](https://www.digitalcalculator.info/mcp/faq/) - accuracy, YMYL posture, rate limits, support
+- [GitHub repo](https://github.com/mark57-ux/digitalcalculator/tree/main/packages/mcp)
+
+## Support
+
+Open an issue at [github.com/mark57-ux/digitalcalculator/issues](https://github.com/mark57-ux/digitalcalculator/issues). Include the tool name, the input that reproduces the issue, and the expected vs. actual output.
+
+## License
+
+MIT - see [LICENSE](./LICENSE). Markcolabs LLC.

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * @markcolabs/mcp v0.4.1 — stdio↔HTTPS shim.
+ * @markcolabs/mcp v0.4.2 — stdio↔HTTPS shim.
  *
  * Proxies MCP JSON-RPC messages from stdin to the hosted MCP server at
  * mcp.digitalcalculator.info/mcp and writes responses back to stdout.

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * @markcolabs/mcp v0.4.1 — stdio↔HTTPS shim.
+ * @markcolabs/mcp v0.4.2 — stdio↔HTTPS shim.
  *
  * Proxies MCP JSON-RPC messages from stdin to the hosted MCP server at
  * mcp.digitalcalculator.info/mcp and writes responses back to stdout.
@@ -16,7 +16,7 @@ import * as readline from "readline";
 import * as https from "https";
 const MCP_ENDPOINT = "https://mcp.digitalcalculator.info/mcp";
 const SESSION_ID = Math.random().toString(36).slice(2);
-const PACKAGE_VERSION = "0.4.1";
+const PACKAGE_VERSION = "0.4.2";
 const REQUEST_TIMEOUT_MS = 30_000;
 function post(body) {
     return new Promise((resolve, reject) => {

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@markcolabs/mcp",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "private": false,
   "description": "MCP stdio↔HTTPS shim for digitalcalculator.info financial calculators. Proxies MCP JSON-RPC to the hosted server at mcp.digitalcalculator.info/mcp. Per ADR-0044a: engine source is private; this package is a thin transport adapter only.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "digitalcalculator-mcp": "./dist/index.js"
+    "digitalcalculator-mcp": "dist/index.js"
   },
   "scripts": {
     "build": "tsc",
@@ -63,7 +63,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/mark57-ux/digitalcalculator.git",
+    "url": "git+https://github.com/mark57-ux/digitalcalculator.git",
     "directory": "packages/mcp"
   }
 }