calcfi-mcp-cli

Short-name npm entrypoint for the CalcFi MCP server — 24 personal-finance tools, 10 mesh resources, 7 prompts. 100% free data (BEA / BLS / Census / FRED / Freddie Mac). YMYL-safe (educational only, not advice).

This package is a thin wrapper that forwards to calcfi-mcp-server. It exists so the install command stays short:

npm install -g calcfi-mcp-cli

If you prefer the canonical name, calcfi-mcp-server works identically.

Quick start

Claude Desktop (claude_desktop_config.json)

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Or, after npm install -g calcfi-mcp-cli:

{
  "mcpServers": {
    "calcfi": {
      "command": "calcfi-mcp"
    }
  }
}

Cursor (~/.cursor/mcp.json)

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

Continue.dev (~/.continue/config.json)

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "calcfi-mcp-cli"]
        }
      }
    ]
  }
}

Standalone (debug)

calcfi-mcp

Reads JSON-RPC frames on stdin, writes responses on stdout. Logs go to stderr.

What's inside

24 tools, 10 mesh resources, 7 prompts. See calcfi-mcp-server for the full schema. Highlights:

• mortgage_payment — principal+interest, PMI, taxes, insurance (Freddie Mac PMMS-driven defaults)
• paycheck_breakdown — federal + state withholding (BLS-driven)
• cpi_lookup — Bureau of Labor Statistics CPI series
• fred_series — Federal Reserve FRED economic data
• bea_regional — Bureau of Economic Analysis regional income/spending

Every response is brand-stamped with source, methodology, disclaimer. Wikipedia-style provenance.

YMYL safety

This server provides educational calculation output, not financial advice. Every response includes a disclaimer pointing users to a licensed professional. Do not strip it.

Free tier guarantee

Zero paid API keys required. All data sourced from free US government APIs (BEA, BLS, Census, FRED, Freddie Mac PMMS).

License

MIT — Jere Salmisto

Links

• Homepage: https://calcfi.app/mcp
• Issues: https://github.com/jeresalmisto/calcfi-mcp/issues
• Canonical package: https://www.npmjs.com/package/calcfi-mcp-server