longbridge · hogan-yuan · Jun 26, 2026 · Jun 11, 2026 · Jun 11, 2026 · Jun 11, 2026
diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
@@ -280,12 +280,16 @@ export default defineConfig(
         {
           name: 'fetch-mcp-tools',
           async buildStart() {
-            const res = await fetch(MCP_TOOLS_URL)
-            if (!res.ok) throw new Error(`fetch mcp tools failed: HTTP ${res.status}`)
-            const json = await res.json()
-            mkdirSync(dirname(MCP_TOOLS_DATA_PATH), { recursive: true })
-            writeFileSync(MCP_TOOLS_DATA_PATH, JSON.stringify(json, null, 2))
-            console.log('✓ mcp-tools.json fetched')
+            try {
+              const res = await fetch(MCP_TOOLS_URL)
+              if (!res.ok) throw new Error(`fetch mcp tools failed: HTTP ${res.status}`)
+              const json = await res.json()
+              mkdirSync(dirname(MCP_TOOLS_DATA_PATH), { recursive: true })
+              writeFileSync(MCP_TOOLS_DATA_PATH, JSON.stringify(json, null, 2))
+              console.log('✓ mcp-tools.json fetched')
+            } catch (e) {
+              console.warn('⚠ mcp-tools.json fetch failed, using cached data:', (e as Error).message)
+            }
           },
         },
         groupIconVitePlugin(),

diff --git a/docs/en/docs/changelog.md b/docs/en/docs/changelog.md
@@ -6,6 +6,18 @@ sidebar_position: 7
 sidebar_icon: newspaper
 ---
 
+## 2026-06-25
+
+### SDK v4.3.3
+
+- **Macroeconomic indicators** — Two new `FundamentalContext` methods: `macroeconomic_indicators` lists all indicators (filter by country, keyword search), `macroeconomic` returns historical release data (actual / forecast / previous values) for a given indicator code
+
+
+### CLI v0.24.0
+
+- **New `macrodata` command** — Browse 400+ macro indicators across US/HK/CN/EU/JP/SG and query historical release data with actual, forecast, previous, and revised values; supports `--country`, `--keyword`, `--lang`, `--start`, `--end`, `--limit`, `--page`, `--format json`
+- MCP server updated in sync — `macrodata_indicators` and `macrodata` tools now available to AI agents via the Longbridge MCP server
+
 ## 2026-06-16
 
 ### CLI v0.23.2

diff --git a/docs/en/docs/cli/fundamentals/finance-calendar.md b/docs/en/docs/cli/fundamentals/finance-calendar.md
@@ -6,7 +6,7 @@ sidebar_position: 6
 
 # longbridge finance-calendar
 
-Browse upcoming financial events — earnings reports, dividend payments, stock splits, IPOs, and macroeconomic releases — filtered by symbol, watchlist, market, or event type.
+Browse upcoming financial events — earnings reports, dividend payments, stock splits, IPOs, and macrodata releases — filtered by symbol, watchlist, market, or event type.
 
 ## Subcommands
 
@@ -16,7 +16,7 @@ Browse upcoming financial events — earnings reports, dividend payments, stock
 | `dividend`  | Dividend announcements                      |
 | `split`     | Stock splits and merges                     |
 | `ipo`       | IPO listings                                |
-| `macrodata` | Macroeconomic data releases                 |
+| `macrodata` | Macrodata releases                 |
 | `closed`    | Market closure days                         |
 
 ## Examples
@@ -59,7 +59,7 @@ Shows both split and merge events for Hong Kong-listed stocks.
 longbridge finance-calendar macrodata --star 3
 ```
 
-Filters macroeconomic events to only show high-importance releases (3-star). Covers data like CPI, NFP, Fed rate decisions, and similar market-moving events.
+Filters macrodata events to only show high-importance releases (3-star). Covers data like CPI, NFP, Fed rate decisions, and similar market-moving events.
 
 ### IPO calendar
 

diff --git a/docs/en/docs/cli/fundamentals/macrodata.md b/docs/en/docs/cli/fundamentals/macrodata.md
@@ -0,0 +1,150 @@
+---
+title: 'macrodata'
+sidebar_label: 'macrodata'
+sidebar_position: 20
+---
+
+# longbridge macrodata
+
+Browse macrodata indicators and their historical release data — covering US, HK, CN, EU, JP, and SG markets.
+
+## Modes
+
+| Mode | Usage | Description |
+| ---- | ----- | ----------- |
+| List | `longbridge macrodata` | List all available indicators |
+| History | `longbridge macrodata <CODE>` | Historical releases for one indicator |
+
+## Examples
+
+### List all indicators
+
+```bash
+longbridge macrodata
+```
+
+```
+Total: 619
+Code   Name              Category    Country   Frequency   Source
+62267  Non-Farm Payroll  Employment  US        Monthly     Bureau of Labor Statistics
+...
+```
+
+### Filter by country
+
+```bash
+longbridge macrodata --country US
+longbridge macrodata --country HK
+longbridge macrodata --country CN
+```
+
+Supported country codes: `HK`, `CN`, `US`, `EU`, `JP`, `SG`.
+
+### Search by keyword
+
+```bash
+longbridge macrodata --keyword CPI
+longbridge macrodata --keyword CPI --country US
+```
+
+### Paginate the list
+
+```bash
+longbridge macrodata --country US --limit 50 --page 2
+```
+
+### Historical releases for a specific indicator
+
+```bash
+longbridge macrodata 62267
+```
+
+```
+Non-Farm Payroll  [Employment | Bureau of Labor Statistics · Monthly]
+
+Period      Actual   Forecast  Previous  Revised   Unit
+2026-05-01  272000   250000    265000    263500    Thousand
+2026-04-01  228000   137000    228000    228000    Thousand
+...
+```
+
+### Filter history by date range
+
+```bash
+longbridge macrodata 62267 --start 2024-01-01 --end 2024-12-31
+```
+
+### JSON output for AI / scripting
+
+```bash
+# List as JSON
+longbridge macrodata --format json
+
+# History as JSON
+longbridge macrodata 62267 --format json
+```
+
+**List JSON structure:**
+
+```json
+{
+  "count": 619,
+  "page": 1,
+  "limit": 20,
+  "has_more": true,
+  "list": [
+    {
+      "indicator_code": "62267",
+      "country": "US",
+      "name": "Non-Farm Payroll",
+      "periodicity": "Monthly",
+      "importance": 3
+    }
+  ]
+}
+```
+
+**History JSON structure:**
+
+```json
+{
+  "count": 24,
+  "page": 1,
+  "limit": 20,
+  "has_more": true,
+  "info": {
+    "indicator_code": "62267",
+    "country": "US",
+    "name": "Non-Farm Payroll",
+    "periodicity": "Monthly",
+    "importance": 3
+  },
+  "data": [
+    {
+      "period": "2026-05-01",
+      "release_at": 1781094600,
+      "actual_value": "272000",
+      "previous_value": "265000",
+      "forecast_value": "250000",
+      "unit": "Thousand"
+    }
+  ]
+}
+```
+
+:::tip
+`actual_value` is empty when the data has not yet been released (only `forecast_value` is available). `has_more: true` means additional pages exist — use `--page` to paginate.
+:::
+
+## Options
+
+| Option | Description | Default |
+| ------ | ----------- | ------- |
+| `--country` | Filter list: `HK` \| `CN` \| `US` \| `EU` \| `JP` \| `SG` | All |
+| `--keyword` | Filter list by indicator name (fuzzy, list mode only) | — |
+| `--start` | History start date `YYYY-MM-DD` | — |
+| `--end` | History end date `YYYY-MM-DD` | — |
+| `--lang` | Language for names/descriptions: `zh-CN` \| `zh-HK` \| `en` | — |
+| `--limit` | Max records per page (list: max 1000, history: max 100) | 20 |
+| `--page` | Page number, 1-based | 1 |
+| `--format` | `table` or `json` | `table` |
diff --git a/docs/en/docs/cli/release-notes.md b/docs/en/docs/cli/release-notes.md
@@ -7,6 +7,10 @@ sidebar_icon: newspaper
 
 # Release Notes
 
+### [v0.24.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.24.0)
+
+- **New `macrodata` command** — Browse 400+ macrodata indicators across US/HK/CN/EU/JP/SG; list mode with optional `--country` filter, history mode for a specific indicator code with `--start`/`--end` date range; `--format json` for AI/scripting workflows
+
 ### [v0.23.2](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.23.2)
 
 - **Local-time date parsing for CLI arguments** — date-only and legacy minute-resolution datetime inputs are interpreted in the user's local timezone before API calls; RFC 3339 datetime inputs are also supported