Content
# lit-forge MCP server
[](https://www.npmjs.com/package/lit-forge-mcp)
[](./LICENSE)
[](https://nodejs.org)
**A Model Context Protocol (MCP) stdio server providing direct access to various economic and market data, as well as personal asset formation simulations.**
Compatible with any MCP-enabled AI client, such as Claude Desktop, Claude Code, and Cursor.
> **Latest highlights (v0.20.0)**: Added a live adapter for ForexFactory in `get_economic_release_pulse`, dynamically retrieving JOLTS job openings, S&P Global PMI flash, and ISM manufacturing/non-manufacturing and consumer confidence (CB/University of Michigan) and ADP employment.
>
> **v0.19.0**: Added U.S. Census Bureau's Advance Economic Indicators Report to `get_economic_release_pulse`, filling in coverage gaps for wholesale and retail inventories, and trade balances.
>
> **v0.18.0**: Introduced a new tool `get_central_bank_speakers`, live retrieving central bank speaker events from ForexFactory's free calendar.
>
> **v0.16.0**: Added University of Michigan Consumer Sentiment Index and Conference Board Consumer Confidence Index to `get_economic_events_today`.
>
> **v0.15.0**: Added DOL/ETA new unemployment insurance claims and S&P Global US PMI flash to `get_economic_release_pulse`.
>
> **v0.14.0**: Integrated PFEI (Principal Federal Economic Indicators) Schedule from the White House OMB/OIRA, enabling automated retrieval of BLS major indicators.
You can ask Claude, GPT, or Cursor, for example:
- "Will my retirement savings be enough? How much should I save monthly to reach $2,000,000?"
- "Summarize today's market snapshot in 28 indicators. Which sector is strong?"
- "When is the next employment statistics release? What are the scheduled FRB announcements this month?"
- "What are the latest CPI and PPI year-over-year changes? Compare core CPI and core PPI."
- "What's happening with the G7 summit? What are the current Iran situation headlines?"
## Provided Tools (18 types)
### Personal Asset Formation Planner (pure functions, no external APIs) — 4 tools
A suite of monthly compound interest simulations for NISA, iDeCo, and retirement planning.
| Tool Name | Description |
|---|---|
| `simulate_nisa` | Calculate evaluation value, profit, and annual transition based on monthly investment amount, expected annual interest rate, and years. |
| `plan_retirement` | Diagnose retirement fund sufficiency with 3 scenarios (optimistic, realistic, pessimistic) based on age, savings, income, desired living expenses, risk tolerance, and pension. |
| `calculate_required_monthly` | Calculate required monthly investment to reach a target amount based on current savings, annual interest rate, and years. |
| `calculate_compound_interest` | A general compound interest calculator for lump sum and monthly investments. |
### Market Snapshot & Individual Stocks — 2 tools
| Tool Name | Description |
|---|---|
| `get_market_snapshot` | Retrieve 28 major market indicators, including USD/JPY, EUR/JPY, and S&P 500. |
| `get_quote` | Get current price, previous day's change, and fundamentals (PER, PBR, dividend yield, beta, market capitalization) for a specified Yahoo Finance ticker. |
### Market Overview — 5 tools
| Tool Name | Description |
|---|---|
| `get_market_thermometer` | A 0-100 risk-on/risk-off score based on VIX, S&P 500, and US 10-year treasury yield. |
| `get_performance_ranking` | Sort 28 market indicators by performance over 1 day, 1 week, or 1 month. |
| `get_yield_spread` | US 10-year - 5-year yield spread. |
| `get_market_sessions` | Current trading session status for major markets (Tokyo, Shanghai, London, NY). |
| `get_sector_heatmap` | Daily change for US sector ETFs (SPDR, 11 sectors). |
### Individual Stock Analysis — 2 tools
| Tool Name | Description |
|---|---|
| `get_dividend_history` | Retrieve historical dividend data for a specified stock or ETF. |
| `get_analyst_consensus` | Get analyst recommendations, target prices, and monthly recommendation breakdown for a specified stock. |
### Economic Events, Central Bank Speakers & Macro Data — 4 tools
| Tool Name | Description |
|---|---|
| `get_economic_events_today` | Retrieve today's or this week's economic events with importance levels. |
| `get_central_bank_speakers` | Live retrieve central bank speaker events from ForexFactory's free calendar. |
| `get_economic_release_pulse` | Officially retrieve and aggregate economic indicator release schedules from various institutions. |
| `get_us_macro_latest` | Get latest US macro data (7 series) from BLS Public Data API v2. |
### Geopolitics — 2 tools
| Tool Name | Description |
|---|---|
| `get_geopolitical_calendar` | Retrieve scheduled geopolitical events for today, this week, or this month. |
| `get_geopolitical_pulse` | Real-time geopolitical event updates from BBC World, Al Jazeera, and Google News. |
## HTTP Communication
Market and analysis tools use **Yahoo Finance API**, `get_us_macro_latest` uses **BLS Public Data API v2**, `get_economic_release_pulse` uses **official institution calendars**, `get_geopolitical_pulse` uses **BBC, Al Jazeera, and Google News RSS**, and `get_central_bank_speakers` uses **ForexFactory's free calendar**.
## Installation / Setup
### For Claude Desktop
Add the following to `claude_desktop_config.json`.
```json
{
"mcpServers": {
"lit-forge": {
"command": "npx",
"args": ["-y", "lit-forge-mcp@latest"]
}
}
}
```
### For Claude Code
```bash
claude mcp add lit-forge -- npx -y lit-forge-mcp@latest
```
### For Cursor
Add the same JSON to `~/.cursor/mcp.json` or project-level `.cursor/mcp.json`.
## Local Development
```bash
git clone https://github.com/noblabs/lit-forge-mcp.git
cd lit-forge-mcp
npm install
npm run build
node dist/index.js # start stdio server
```
## Usage Examples
You can ask Claude:
**Personal Asset Planning**
- "Will my retirement savings be enough?"
- "How much should I save monthly to reach $2,000,000 in 20 years?"
**Market Snapshot**
- "Summarize today's market snapshot."
- "What are the current prices for BTC-USD and GBPJPY=X?"
**Individual Stock Analysis**
- "Show KO's dividend history for the past 10 years."
- "What are the analyst recommendations and target prices for NVDA?"
**Economic Indicators & Latest Data**
- "What are the scheduled economic events this week?"
- "When is the next employment statistics release?"
- "What are the latest CPI and PPI year-over-year changes?"
**Central Bank Speakers**
- "What are the Fed speaker events today?"
- "List the ECB and BOE speaker events this week."
**Geopolitics**
- "What are the scheduled geopolitical events this week?"
- "What are the latest news on the G7 summit?"
## Investment Disclaimer
The calculations provided are for reference purposes only and do not guarantee actual investment results. **Investment decisions are your responsibility**.
Public pension amounts are estimated based on standard values; accurate amounts can be confirmed on [nenkin.go.jp](https://www.nenkin.go.jp/n_net/).
## License
MIT
