About firenum retirement planner
When can you retire? A FIRE plan based on your numbers, graded by Monte Carlo and every year since 1872.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
Endpoint
https://firenum.com/mcpCopy install command
Claude CodeTerminal
claude mcp add --transport http com-firenum-fire-planner https://firenum.com/mcpCursor.cursor/mcp.json
{"mcpServers":{"com-firenum-fire-planner":{"type":"http","url":"https://firenum.com/mcp"}}}Open in CursorVS Code.vscode/mcp.json
{"servers":{"com-firenum-fire-planner":{"type":"http","url":"https://firenum.com/mcp"}}}Open in VS CodeClaude Desktopclaude_desktop_config.json
{"mcpServers":{"com-firenum-fire-planner":{"type":"http","url":"https://firenum.com/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"com-firenum-fire-planner":{"serverUrl":"https://firenum.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
1| Parameter | Type | Required | Description |
|---|---|---|---|
| hsa | number | No | Health Savings Account balance. Default growth 7%. |
| cash | number | No | Cash/checking balance. Default growth 0%. |
| debt | number | No | Debt balance. |
| food | number | No | Monthly food expense. |
| roth | number | No | Roth account balance (Roth IRA, Roth 401k). Default growth 7%. |
| birth | integer | No | Birth year (YYYY). From an age, send the current year minus the age. Used with retire_age to compute retirement date. |
| crypto | number | No | Cryptocurrency balance. Default growth 0%. |
| growth | number | No | Default portfolio growth rate (percentage). Retirement, Roth, brokerage and HSA balances follow it as the market rate (randomized in Monte Carlo, historical in backtests); it also overrides the fixed defaults of the other assets. |
| retire | integer | No | Target retirement year (YYYY). Takes precedence over retire_age. |
| salary | number | No | Annual gross salary, as they said it (don't subtract tax). Grows 3%/year, stops at retirement (open-ended if no retirement date is given). The planner doesn't deduct taxes; if they gave a tax amount, include it in expenses. |
| target | number | No | Accepted from older links and ignored. The planner answers with a retirement date, not a target. |
| housing | number | No | Monthly housing expense (rent/mortgage). |
| pension | number | No | Annual pension income. Starts at retirement (immediately if no retirement date is given). |
| savings | number | No | High-yield savings balance. Default growth 4.5%. |
| currency | enum | No | Display currency. All amounts should be in this currency.USD | EUR | GBP | JPY | CAD | AUD | CHF | INR | NZD |
| expenses | number | No | Total monthly spending. Send this alone, or categories alone. If both are sent, categories count as part of this total and only the remainder becomes "Monthly expenses" (never added on top). Do not repeat the total as a category. |
| brokerage | number | No | Taxable brokerage account balance. Default growth 7%. |
| debt_name | string | No | Name/label for the debt. Default "Debt". |
| debt_rate | number | No | Debt annual interest rate (percentage). |
| inflation | number | No | Default inflation rate (percentage). Overrides individual expense defaults. |
| insurance | number | No | Monthly insurance expense. |
| utilities | number | No | Monthly utilities expense. |
| healthcare | number | No | Monthly healthcare expense. |
| retire_age | integer | No | Target retirement age. Requires birth to compute retirement year. Ignored if retire is provided. |
| retirement | number | No | Retirement account balance (401k, IRA, etc). Default growth 7%. |
| real_estate | number | No | Real estate equity. Default growth 4%. |
| side_income | number | No | Annual side hustle / freelance income. Stops at retirement (open-ended if no retirement date is given). |
| debt_payment | number | No | Monthly debt payment. |
| discretionary | number | No | Monthly discretionary spending. |
| rental_income | number | No | Annual rental income. |
| transportation | number | No | Monthly transportation expense. |
| social_security | number | No | Annual Social Security income. Starts at the later of retirement and age 67 (uses whichever is known; immediately if neither). |
| hsa_contribution | number | No | Monthly HSA contribution. |
| part_time_income | number | No | Annual part-time income in retirement (Barista FIRE). Starts at the retirement date and runs on; with no retirement date given, the plan retires at the earliest date that works with this income. |
| cash_contribution | number | No | Monthly cash contribution. |
| roth_contribution | number | No | Monthly Roth account contribution. |
| crypto_contribution | number | No | Monthly crypto contribution. |
| savings_contribution | number | No | Monthly savings contribution. |
| brokerage_contribution | number | No | Monthly brokerage contribution. |
| retirement_contribution | number | No | Monthly retirement account contribution. |
| real_estate_contribution | number | No | Monthly real estate contribution (e.g., extra mortgage principal). |
Details
The maintainer has not added details yet. Check the README in the repository.
Comments
Markdown supported
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.