Skip to content

evan-moon/firma

v0.18.0 Feature

This release adds 3 notable features for engineering teams evaluating rollout.

Published 1mo MCP Developer Tools
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

claude cli finnhub local-first mcp personal-finance
+4 more
portfolio sqlite stock typescript

Summary

AI summary

Added Equity Risk Premium, Real FCF Yield metrics to valuation and Return Decomposition with FX effect plus Risk Summary to portfolio reports.

Full changelog

What's new

firma show valuation

  • Equity Risk Premium (ERP) — earnings yield minus 10Y Treasury yield. Positive = equities offer a premium over risk-free; negative = bonds are currently more attractive.
  • Real FCF Yield — FCF yield minus 10Y breakeven inflation. Positive = company generates returns above inflation; negative = value depends on future growth.
  • Both metrics require a FRED API key (firma config set fred-key). Plain-text interpretation note included for both CLI and MCP.

firma show portfolio

  • Return Decomposition (non-USD display currency only) — per-ticker breakdown of USD price return vs FX effect vs total home-currency return, weighted by avg buy date.
  • Risk Summary — Sharpe, Sortino, annualized return, volatility, max drawdown, win rate. Uses live FEDFUNDS rate as risk-free rate when FRED key is set.
  • Both sections include a plain-text interpretation note at the bottom.

MCP (show_valuation, show_portfolio)

  • show_valuation response includes erp_pct, erp_note, real_fcf_yield_pct, real_fcf_yield_note, treasury_10y_pct, earnings_yield_pct, breakeven_inflation_pct
  • show_portfolio response includes risk_summary (with note) and fx_decomposition (with note) fields

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track evan-moon/firma

Get notified when new releases ship.

Sign up free

About evan-moon/firma

Local-first CLI asset tracker for overseas stock investors with Claude Desktop MCP integration. 13 tools for portfolio tracking, net worth snapshots, cash flow analysis, and market research (earnings, insider trades, SEC filings)

All releases →

Related context

Earlier breaking changes

  • v0.20.0 Brief no longer returns 'projected_net_worth' or 'on_track'.
  • v0.20.0 `simulate_goal_projection` renamed to `project_net_worth`.

Beta — feedback welcome: [email protected]