PlanFi Skills — Planejamento Financeiro & FIRE para Claude Code
KameronKales/planfi-skills
Análise financeira pessoal e FIRE em linguagem natural, sem planilhas ou cadastros.
Ver no GitHubMCP server que transforma Claude em analista de planejamento financeiro pessoal e FIRE (independência financeira/aposentadoria antecipada). Fornece cálculos reais como projeções de patrimônio líquido, idade para FIRE, taxa de sucesso em Monte Carlo, otimização fiscal, cronogramas de quitação de dívidas e análises rent-vs-buy, alimentado por 150+ anos de dados históricos de mercado.
Instalação
npx convez-ai KameronKales/planfi-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Calcular idade FIRE e projetar patrimônio líquido com dados históricos de mercado
- Análise comparativa rent-vs-buy com break-even points e apreciação esperada
- Otimização fiscal: Roth conversions, tax-loss harvesting, mega-backdoor Roth
- Planejamento de renda na aposentadoria: bond ladders, pensões, anuidades, tax-bridge
- Análise de concentração de ações (RSUs, ISOs) e timing de exercício
Veredito

Ferramenta sólida e prática para análise quantitativa de planejamento financeiro pessoal. Open-source, sem autenticação e integrada ao ecossistema Claude Code, mas claramente não substitui aconselhamento profissional — adequada para simulações educacionais e primeiras estimativas.
README
A tradução para o português deste README ainda está na fila.
PlanFi Skills — AI personal-finance & FIRE planning for Claude Code
Free, open-source Claude Code Agent Skills that turn Claude into a personal-finance & FIRE planning analyst. Ask in plain English and get real numbers back — net-worth projections, your FIRE (financial-independence / retire-early) age, Monte Carlo success rates, tax savings, debt-payoff timelines, rent-vs-buy break-evens, and rental-property returns.
No spreadsheets, no signup, no API key. The math — and 150+ years of historical market data — runs on the public planfi MCP server; these skills just turn your questions into the right tool calls.
Ask Claude things like…
- "Can I retire at 50 with $1.2M saved and $4k/mo spending?"
- "Should I rent or buy a $500k house — what appreciation rate makes buying win?"
- "How do I cut my taxes — Roth conversions, mega-backdoor Roth, tax-loss harvesting?"
- "When should I claim Social Security, and how do I bridge healthcare before Medicare?"
- "Ladder $40k/yr of safe cash across brokered CDs and I-Bonds for 5 years — what's the blended yield and tax hit?"
- "Avalanche or snowball — and should I prepay my mortgage or invest the cash?"
- "Are my RSUs too concentrated, and when do my ISOs trigger AMT?"
- "Is this Airbnb a good investment — cash-on-cash, cap rate, break-even occupancy?"
- "Am I already financially independent, or how many years until I am?"
- "We're a PA family with a $1M estate — how much inheritance tax will our kids owe, and would moving change it?"
- "Will long-term care wipe out my survivor's plan — should I self-insure or buy an LTC/hybrid policy?"
- "How much can I safely spend each year — Guyton-Klinger guardrails vs VPW vs a static 4%?"
- "Do I qualify for the Saver's Credit on $34k income, and how much is it worth on a $2k Roth IRA?"
- "How much can I pull from my IRA penalty-free at 52 with a 72(t) SEPP — amortization vs RMD vs annuitization?"
- "Is a fixed-indexed annuity with a 9% cap worth it vs keeping my rollover IRA invested, and how is the non-qualified gain taxed?"
- "How much Roth conversion room do I have before RMDs hit at 73, and will my RMDs trigger a Medicare IRMAA surcharge?"
- "What's my Lean / Fat / Barista FIRE number, and can part-time income bridge me to full retirement?"
- "Should I early-exercise and file an 83(b)? Does my startup stock qualify for the QSBS exclusion?"
- "What's the after-tax return on this rental once I add depreciation, recapture, and a 1031 exchange?"
- "How big should my emergency fund be, and is rolling my 529 leftovers into a Roth worth it?"
- "Lease, finance, or pay cash for this car? And should I consolidate my credit-card debt?"
- "Does a HELOC or reverse mortgage make sense, and how much do I owe in quarterly estimated taxes?"
Quick start
Fastest — the skills.sh CLI (any agent, no setup). Add this whole catalog (pick a skill, or grab them all), or install just one:
npx skills add KameronKales/planfi-skills # choose from all 12
npx skills add KameronKales/planfi-skills --all # install all 12
npx skills add holdequity/planfi-<name> # just one skill (table below)
Or, in Claude Code, add the catalog as a plugin marketplace + connect the MCP that powers it:
claude plugin marketplace add KameronKales/planfi-skills
claude mcp add --transport http planfi https://ai.planfi.app/mcp
Then just ask.
Skills
| Skill | What it does | Install (skills.sh CLI) |
|---|---|---|
| str-investment-analyzer | Analyze short-term-rental (Airbnb/VRBO) property investments by city: cash flow, cash-on-cash, cap rate, break-even occupancy, risk flag, managed-vs-self comparison, and a hold-period return (or indefinite buy-and-hold). | npx skills add holdequity/planfi-str-analyzer |
| financial-forecast | Build a complete FIRE / financial forecast: net-worth projection, FIRE age, Monte Carlo success rate, insights, action plan, what-if scenario comparisons, childcare cost + dependent-care FSA / Child & Dependent Care Credit / Child Tax Credit offsets with a corrected second-income tradeoff, and education/estate deep-dives including a 529→Roth rollover (SECURE 2.0) + 5-year gift-tax-averaged 529 superfunding optimizer, plus estate- and inheritance-tax exposure covering the 6 inheritance-tax states (PA/NJ/KY/IA/MD/NE, taxed by beneficiary relationship class regardless of estate size) and ~12 estate-tax states (MA/NY/OR/WA + CT/DC/HI/IL/ME/MD/MN/RI/VT). | npx skills add holdequity/planfi-financial-forecast |
| rent-vs-buy | Rent vs buy: breakeven home-appreciation rate (pre & after tax), per-horizon BUY-vs-RENT net worth, payoff/crossover years, invest-the-difference opportunity cost, and — if they already own — home-equity extraction (HELOC revolving draw/repay, cash-out refi, or reverse mortgage) as a liquidity/decumulation lever instead of selling. | npx skills add holdequity/planfi-rent-vs-buy |
| tax-optimizer | Cut taxes across accounts and years: broad tax optimization (asset location, tax-loss harvesting, charitable), multi-year ISO/conversion timing (AMT/NIIT/IRMAA-aware), Roth conversion ladders, mega-backdoor Roth space, advanced surtaxes (NIIT/AMT/state), tax-gain harvesting (how much long-term gain you can realize at the 0% capital-gains rate before NIIT/IRMAA bites), retirement relocation / state-tax arbitrage with full 50-state + DC progressive single/MFJ brackets (compare the lifetime after-tax cost of retiring in one state vs another), the federal Saver's Credit (50/20/10% of retirement contributions for lower/moderate income), and 72(t)/SEPP substantially-equal-payment sizing for penalty-free access to retirement money before 59½. | npx skills add holdequity/planfi-tax-optimizer |
| equity-comp-planner | Value and tax employer equity (RSUs, ISOs, NSOs, ESPP), find the ISO/AMT crossover, and assess single-stock concentration risk with a tax-aware diversification plan. | npx skills add holdequity/planfi-equity-comp-planner |
| retirement-income | Plan retirement decumulation: tax-smart withdrawal order, dynamic/variable spending strategies (Guyton-Klinger guardrails, VPW, spending smile, bucket+buffer vs a static 4% SWR), Social Security claiming age, ACA healthcare bridge before Medicare, projected RMDs with a tax-torpedo and Roth-conversion-runway readout (the low-income years before RMDs start at 73/75), Medicare IRMAA tier and surcharge-cliff lookup, estate-tax exposure, guaranteed income (pension lump-sum vs lifetime monthly, SPIA/QLAC vs DIY portfolio), deferred/accumulation annuity products (fixed-indexed FIA cap/participation crediting, RILA buffer/floor, multi-year-guaranteed MYGA, and variable annuities with a GLWB rollup rider) with non-qualified exclusion-ratio tax and 1035 exchanges, a bond/TIPS ladder income floor that guarantees the first N years of spending (sequence-of-returns protection), a mass-market safe-cash ladder for the same near-term need (FDIC-insured CD ladders — brokered vs bank, early-withdrawal penalty, callable — plus I-Bonds and Series EE savings bonds with their purchase caps and federal tax-deferral / state exemption), and long-term-care cost exposure with a self-insure vs traditional vs hybrid LTC-policy tradeoff (including the impact on a surviving spouse's plan). | npx skills add holdequity/planfi-retirement-income |
| debt-and-cashflow | Pay down debt and route surplus cash optimally: avalanche/snowball debt payoff order, balance-transfer / debt-consolidation break-even (personal loan vs 0% transfer vs status quo), mortgage prepay vs invest, refinance break-even, a next-best-dollar funding waterfall, student-loan strategy (IDR / PSLF / refinance vs aggressive payoff), emergency-fund / cash-runway sizing (months-of-runway target from job stability, dependents, and income type, plus a too-much-cash check), and finance vs lease vs pay-cash car analysis (real-dollar net cost over your hold horizon, net of resale, interest, and the opportunity cost of cash). | npx skills add holdequity/planfi-debt-and-cashflow |
| fire-tracker | Track FIRE progress: are you already financially independent / can you coast, how you benchmark against peers, your Lean / Fat / Barista FIRE numbers (incl. a part-time-income bridge), which net-worth milestones you've hit, and whether you can hit a target retirement age (with the easiest levers to pull). | npx skills add holdequity/planfi-fire-tracker |
| self-employed-planner | Plan self-employed / business-owner retirement: max Solo 401(k) vs SEP-IRA vs SIMPLE contribution room, the §199A QBI deduction (thresholds, W-2/UBIA cap, SSTB phaseout), the S-corp reasonable-salary tradeoff (payroll tax vs QBI vs retirement room), and estimated/quarterly tax & 90%/110% safe-harbor planning to avoid underpayment penalties. | npx skills add holdequity/planfi-self-employed-planner |
| relocation-planner | Compare retirement relocation / state-tax arbitrage by orchestrating the public planfi MCP — how much a move (e.g. CA→TX/FL) saves in state income tax (full 50-state + DC progressive single/MFJ brackets), property tax, estate tax, and cost of living, and whether it's worth it. | npx skills add holdequity/planfi-relocation-planner |
| long-term-rental-analyzer | Long-term-rental after-tax analyzer: 27.5-yr depreciation shelter, ~25% recapture at sale, 1031 like-kind deferral, and a Schedule E P&L (rent, vacancy, opex, NOI). | npx skills add holdequity/planfi-long-term-rental-analyzer |
| startup-equity-planner | Model the irreversible 30-day 83(b) early-exercise election and the QSBS section 1202 gain exclusion (up to $10M/10x basis) for startup founders, early employees, and C-corp sellers — by orchestrating the public planfi MCP. | npx skills add holdequity/planfi-startup-equity-planner |
How it works
These skills are thin orchestration — they contain no financial logic of their own. Every calculation, every tax rule, and 150+ years of historical market data live server-side on the public planfi MCP (https://ai.planfi.app/mcp — no auth, no API key). A skill gathers your inputs, calls the right tool(s), and shows the result. Any MCP-capable agent gets the same answers; the skills just make it one-click inside Claude Code.
Use it in any MCP client (not just Claude Code)
The skills are Claude Code packaging — but the engine is a standard
Model Context Protocol server at
https://ai.planfi.app/mcp (Streamable HTTP, no auth). Connect it from any
MCP-capable agent and you get all the same tools directly. And because every
tool is self-orchestrating — it reports its own assumed defaults and
suggests the next step — you get solid answers even without a skill wrapper.
Most clients take an mcpServers config block:
{
"mcpServers": {
"planfi": { "type": "http", "url": "https://ai.planfi.app/mcp" }
}
}
| Client | How to add it |
|---|---|
| Claude Code | claude mcp add --transport http planfi https://ai.planfi.app/mcp |
| Cursor | add the block above to ~/.cursor/mcp.json (field: url) |
| Windsurf | ~/.codeium/windsurf/mcp_config.json (field: serverUrl) |
| Cline / VS Code | paste the block into the Cline MCP settings |
| Claude Desktop & stdio-only clients | bridge with npx -y mcp-remote https://ai.planfi.app/mcp |
| ChatGPT (custom connectors / Deep Research) | add a connector pointing at the MCP URL |
| Custom / your own agent | it's plain MCP Streamable HTTP — POST JSON-RPC tools/list / tools/call to the URL with Accept: application/json, text/event-stream |
Field names vary slightly by client and version — check your client's MCP docs;
the URL is always https://ai.planfi.app/mcp.
Why PlanFi Skills
- Real models, not vibes — Monte Carlo backtesting on real historical returns, tax-aware (AMT / NIIT / IRMAA), inflation-adjusted.
- Free & open source (MIT) — no account, no paywall.
- Composable — start with a forecast, then drill into taxes, Social Security, or real estate; every result points to the next best step.
FAQ
Is it free? Yes — MIT-licensed skills plus a public, no-auth MCP.
Do I need an account or API key? No.
Is this financial advice? No — these are planning estimates to inform your own decisions.
What is FIRE? Financial Independence, Retire Early: the point where your investments can cover your spending indefinitely.
Can I use the tools without Claude Code? Yes — connect the MCP (https://ai.planfi.app/mcp) from any MCP-capable client. The skills just make it turnkey in Claude Code.
Generated from the planfi-app monorepo (source of truth) and mirrored here — don't edit directly; changes flow via CI. MIT licensed. Not financial advice; planning estimates only.