# Compare Macro Histories

Compares inflation, rate and bond yield histories across countries, keeping sources.

- Repository: https://github.com/koala73/worldmonitor (89946 stars)
- Category: Data and ML
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add koala73/worldmonitor --skill compare-macro-history -g -a claude-code -y`
Codex: `npx skills add koala73/worldmonitor --skill compare-macro-history -g -a codex -y`
Cursor: `npx skills add koala73/worldmonitor --skill compare-macro-history -g -a cursor -y`
Gemini CLI: `npx skills add koala73/worldmonitor --skill compare-macro-history -g -a gemini-cli -y`

## Description

Compare CPI, interest rates and sovereign yield histories from seeded official reports. Use for inflation or rate trends; preserve country provenance, index base, frequency, yield measure and missing readings.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# compare-macro-history

Use when the user asks about inflation, policy-rate trends or sovereign yields over time. These are dated seeded reports rather than live market quotes.

## Connected plugin

Call `get_macro_history` on the connected WorldMonitor MCP server at `https://worldmonitor.app/mcp`. Use the existing connection rather than requesting an API key in chat. A subscription is required; explain a denial and stop.

| Dataset | Country |
|---|---|
| `us-cpi` | Omit |
| `us-interest-rates` | Omit |
| `us-treasury-yields` | Omit |
| `world-cpi` | Required country name or ISO code |
| `government-yields` | Required country name or ISO code |

Set `history: true` (default) for bounded histories or `false` for the latest snapshot. `limit` defaults to 30 and accepts 1..365 observations per series. Histories retain chronological order and select the newest observations. For a cross-country comparison, request one country at a time and align observation dates and definitions before comparing.

The response is `{dataset, history, truncated, data}`. Read `unavailable` first. A missing reading or tenor is unknown, not zero. `truncated: true` means the response is not full history. Dates are Unix milliseconds, rates and yields are percentages. Retain CPI source, frequency and index base; distinguish par Treasury yields from country spot/other yield measures. Do not compare index levels with different bases as inflation rates.

Example: request `{"dataset":"world-cpi","country":"Germany","limit":12}` and `{"dataset":"us-cpi","limit":12}`. Compare available year-over-year changes on common dates, explain methodology differences and missing periods, and cite the returned source labels. Do not invent unavailable readings or extrapolate a forecast.

## REST and authentication

Server-to-server GET routes correspond to the datasets:

The rest: https://github.com/koala73/worldmonitor/blob/HEAD/public/.well-known/agent-skills/compare-macro-history/SKILL.md
