calculate_compound_interest
Returns the future value of a lump-sum principal plus a monthly contribution under monthly compounding, for any savings or deposit projection rather than a NISA-specific one.
LABSCO SUMMARY
Household savings maths and market context in one place, with the sourcing stated per tool.
The four planning tools are pure arithmetic — no network, no key, same answer every time — while the market side is explicit about where each number came from and how fresh it is. Two things worth knowing before you rely on it: the quotes are described as roughly hour-delayed reference values, and two of the calendars are hand-curated and refreshed about twice a year, which is why separate live-fetch tools exist alongside them.
What it is
A Japanese-language finance server with two halves: compounding calculators that run as pure functions with no network call, and market, macro and geopolitical data pulled from public sources.
What you get
- Monthly-compounding projections for a NISA or iDeCo style plan — future value, gains and the year-by-year path
- A retirement check across optimistic, realistic and pessimistic scenarios, which back-solves the monthly contribution needed when the realistic one falls short
- The reverse calculation on its own: what monthly amount reaches a target sum in a given number of years
- A snapshot of 28 headline instruments in one call — yen crosses, the dollar index, Nikkei, TOPIX, S&P 500, NASDAQ, VIX, SOX, DAX, FTSE, Hang Seng, KOSPI, US 10y and 5y yields, gold, oil, copper, Bitcoin and Ethereum — with the change on the day
- Any other Yahoo Finance ticker on demand, optionally with P/E, P/B, dividend yield and beta
- A 0-100 risk-on/risk-off score built from VIX, the S&P 500, the US 10-year and the dollar index, with its component scores, and the last 30 trading days
- Performance ranking over a period, the US 10y-5y yield spread in basis points, the sector heat map across the eleven US sector ETFs, and open/pre-open/closed/holiday status for Tokyo, Shanghai, London and New York
- Per-stock depth: dividend history by calendar year, and the analyst consensus with average, high and low price targets
- Economic calendars from two directions — a hand-curated schedule of the big set pieces, and official release calendars fetched live from BEA, the New York Fed, the Federal Reserve, the Census Bureau, Japan's Cabinet Office and the Bank of Japan
- Upcoming central-bank speaking engagements, with Fed speakers annotated by role and whether they hold a vote
- The latest US employment, CPI and PPI prints with core measures, unemployment and average hourly earnings, month-on-month and year-on-year
- Geopolitics split in two: a curated calendar of confirmed summits, bilaterals, elections and official risk dates with source URLs, and a live pulse of headline metadata from BBC World, Al Jazeera and Google News
Requirements
No account and no key. Run it with npx -y lit-forge-mcp@latest over stdio; the npm package is lit-forge-mcp, currently 0.20.0. The US macro figures come from the BLS Public Data API v2 unauthenticated, which caps the unregistered tier at 25 requests a day and is cached for 6 hours. Market quotes come from Yahoo Finance and are described as roughly one hour delayed reference values. Tool descriptions and output are in Japanese.
Setup effort
One command — npx -y lit-forge-mcp@latest
USE CASES
01
Working out whether the retirement plan actually adds up
Run the three scenarios from your age, savings, contribution and target spending — the shortfall comes back with the monthly amount that would close it.
02
Sizing a monthly contribution against a target
Project the balance forward with monthly compounding, or solve backwards for the contribution that reaches the number.
03
Summarizing where markets stand this morning
Take the 28-instrument snapshot, add the risk-on/risk-off score, and see which US sectors moved.
04
Finding out when the next big print lands
Read the curated calendar for the set pieces and the live official release calendars for everything it does not cover.
05
Preparing for a week of central-bank commentary
List the upcoming speakers filtered by country, and check the latest inflation and jobs prints they will be reacting to.
06
Choosing a dividend stock for the growth allowance
Pull the dividend history by calendar year and the analyst consensus, plus the fundamentals on the quote.
07
Separating a scheduled geopolitical event from a breaking one
Read the confirmed calendar for what was already on the books, and the news pulse for what is happening now.
19 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
calculate_required_monthly
Works backwards from a target amount, current savings, an assumed annual rate and a contribution period to the monthly contribution needed to reach it — the answer to how much a goal costs per month.
get_analyst_consensus
Returns a stock's analyst rating distribution from strong buy to strong sell, the average, high and low price targets, and a month-by-month breakdown, from Yahoo Finance. Coverage is deep for US listings and often missing for Japanese stocks and ETFs. An aggregate rather than advice.
get_central_bank_speakers
Returns upcoming speeches and appearances by central bank officials — Federal Reserve governors and regional presidents, the Bank of Japan, the ECB, the Bank of England — from ForexFactory's free calendar in date order. US speakers are annotated with role and voting status from the current year's roster, and importance is raised for the chair and for voting members. Policy meetings and data releases are in get_economic_events_today instead.
get_dividend_history
Returns a stock's or ETF's dividend payments over the past N years with calendar-year totals, from Yahoo Finance; an instrument that pays nothing returns an empty dividends array. Not investment advice.
get_economic_events_today
Returns today's or this week's major economic events — FOMC and Bank of Japan policy meetings, US payrolls, CPI, GDP, China PMI and similar releases — from a schedule curated by hand. Multi-day events such as Jackson Hole match on each day they run. The default range is today, so pass range=week whenever the question reaches beyond today. Speeches by central bank officials are in get_central_bank_speakers instead.
get_economic_release_pulse
Fetches the official release calendars of the BEA, the New York Fed, the Federal Reserve, the Census Bureau, the Cabinet Office and the Bank of Japan in parallel and returns scheduled releases for today or the week, filtered by country and period. It exists to cover what the hand-curated get_economic_events_today leaves out, and the two are meant to be used together.
get_geopolitical_calendar
Returns confirmed official schedules only, in four subcategories: bilateral meetings and state visits, international summits such as G7, G20, IMF, APEC, BRICS and NATO, national elections in major countries, and scheduled geopolitical risk dates such as sanctions taking effect or treaty deadlines. Each event carries participants, a primary-source URL and notes on what to watch in FX, equities, bonds and commodities. The data is curated by hand from primary sources and refreshed by pull request every six months; unfolding events are out of scope.
get_geopolitical_pulse
Returns what is happening geopolitically right now by fetching BBC World, Al Jazeera and Google News RSS in parallel, deduplicating and sorting by publication time. Each article comes back as objective metadata only — title, publisher, publication time, URL and the publisher's own short summary — with no market interpretation attached, which is left to the caller.
get_market_sessions
Returns each market's current status — open, pre-open, closed or holiday — for Tokyo (9:00-15:30 JST), Shanghai (10:30-16:00 JST), London (17:00-25:30 JST) and New York (22:30-29:00 JST), naming the holiday where one applies. Holiday calendars are curated by hand, and the result is an approximation that does not model daylight-saving transitions or unscheduled closures.
get_market_snapshot
Returns the current level and change on the day for 28 headline instruments from Yahoo Finance: yen crosses and EUR/USD, the dollar index, the Nikkei average, TOPIX, the Dow, S&P 500, NASDAQ, VIX, NYSE FANG+, SOX, DAX, FTSE, Shanghai Composite, Hang Seng, KOSPI, SENSEX, US 10-year and 5-year yields, gold, crude, copper, bitcoin and ether. Values run about an hour behind and are reference figures, not investment advice.
get_market_thermometer
Returns a 0 to 100 risk-on/risk-off score built from VIX and the daily changes in the S&P 500, the US 10-year yield and the dollar index, where 50 is neutral, 70 and above leans risk-on and 30 and below leans risk-off. Each component's score and the past 30 trading days are included. An overview measure rather than a recommendation.
get_performance_ranking
Ranks the 28 tracked instruments by performance over a chosen period and returns the top and bottom N. The 1w and 1m periods cover USD/JPY, the S&P 500, NASDAQ, the Dow, the US 10-year yield, VIX and DXY only. A numeric sort rather than a recommendation.
get_quote
Returns the current level, change on the day and a sparkline for any Yahoo Finance ticker — equities, FX, indices, commodities or crypto — for instruments outside the get_market_snapshot roster. With includeFundamentals it adds PER, PBR, dividend yield and beta for individual stocks. Not investment advice.
get_sector_heatmap
Returns the current level and change on the day for the US sector ETFs in one call: technology XLK, financials XLF, healthcare XLV, consumer discretionary XLY, consumer staples XLP, energy XLE, industrials XLI, utilities XLU, materials XLB, real estate XLRE and communications XLC — the view for reading sector rotation.
get_us_macro_latest
Returns the latest US employment, CPI and PPI prints with their core measures, the unemployment rate and average hourly earnings — seven series aggregated from a single BLS Public Data API v2 request — each with month-over-month and year-over-year change. It runs unauthenticated within the BLS unregistered allowance of 25 requests a day, behind a six-hour cache.
get_yield_spread
Returns the spread between the US 10-year yield (^TNX) and the US 5-year yield (^FVX), with the change in basis points on the day; positive is a normal curve and negative an inverted one.
plan_retirement
Projects retirement funding from age, current savings, monthly contribution, planned retirement age, desired monthly spending in retirement, risk tolerance and expected pension, returning optimistic, realistic and pessimistic scenarios. Where the realistic scenario falls short, it back-solves the monthly contribution that would close the gap.
simulate_nisa
Projects the future value, gains and year-by-year path of a fixed monthly contribution compounded monthly at an assumed annual rate over a set number of years — a plain projection for NISA or iDeCo contributions.
BEFORE YOU INSTALL
What to know first
Tools you get
19 tools when we connected. Parts of the documentation still say 18; get_central_bank_speakers was added in v0.18.0.
Requires
npx on PATH
Where it runs
All 3 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 19 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y lit-forge-mcp@latestMCP Clients
Claude Desktop, Cursor
JSON
{
"mcpServers": {
"lit-forge": {
"command": "npx",
"args": [
"-y",
"lit-forge-mcp@latest"
]
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add lit-forge -- npx -y lit-forge-mcp@latest
