{"serverId":"mcp-registry/com.statisticsoftheworld/sotw","tools":[{"name":"compare_countries","fixed":{"name":"compare_countries","description":"Compare 2-10 countries on selected indicators.","inputSchema":{"type":"object","required":["country_ids"],"properties":{"country_ids":{"type":"array","items":{"type":"string"},"description":"List of country codes (max 10)"},"indicator_ids":{"type":"array","items":{"type":"string"},"description":"Indicator IDs to compare (default: GDP, population, life expectancy, etc.)"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":117,"tokensAfter":117},{"name":"compare_sources","fixed":{"name":"compare_sources","description":"Compare source readings. Default mode returns latest IMF, World Bank and UN readings with their own years. For the 20-economy, 10-concept research pilot, provide country_id and year (exact year or common) to compare IMF and World Bank in the same period, inspect definition mismatches and retrieve recorded-state provenance. Optional as_of and revision pin SOTW stored state, not publisher availability.","inputSchema":{"type":"object","required":["indicator_id"],"properties":{"year":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1960},{"enum":["common"],"type":"string"}],"description":"Opt into the research pilot: exact year or latest common past year. Requires country_id."},"as_of":{"type":"string","description":"Optional SOTW recording cutoff: date at UTC midnight or ISO timestamp with timezone. Publisher availability is not established."},"revision":{"type":"string","description":"Archive transaction watermark returned by an earlier comparison. Requires as_of."},"country_id":{"type":"string","description":"Optional ISO3 code to return a single country instead of all"},"indicator_id":{"type":"string","description":"Concept key, e.g. IMF.NGDPD (GDP), IMF.NGDPDPC (GDP per capita), IMF.NGDP_RPCH (real growth)"},"processing_version":{"enum":["source-comparison-v1"],"type":"string","description":"Pin the comparison processing contract."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":390,"tokensAfter":390},{"name":"get_available_indicators","fixed":{"name":"get_available_indicators","description":"List all available indicators grouped by category.","inputSchema":{"type":"object","properties":{"category":{"type":"string","description":"Optional: filter by category name"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":64,"tokensAfter":64},{"name":"get_company_facts","fixed":{"name":"get_company_facts","description":"Read the reviewed SEC company catalog, or exact issuer/concept facts with exact decimal strings, fiscal contexts, filing dates, units and immutable acquisition evidence. Publication pins guard current registry coherence; they do not reconstruct a full historical filing snapshot. No inferred quarters or currency conversions.","inputSchema":{"type":"object","properties":{"to":{"type":"string"},"cik":{"type":"string","pattern":"^[0-9]{10}$"},"tag":{"type":"string"},"from":{"type":"string"},"limit":{"type":"integer","maximum":1000,"minimum":1},"evidence":{"type":"string"},"filed_to":{"type":"string"},"filed_from":{"type":"string"},"publication":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":206,"tokensAfter":206},{"name":"get_country_list","fixed":{"name":"get_country_list","description":"List all 217 countries and territories, plus the World aggregate, with metadata (region, income level, capital).","inputSchema":{"type":"object","properties":{"region":{"type":"string","description":"Optional: filter by region"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":76,"tokensAfter":76},{"name":"get_country_overview","fixed":{"name":"get_country_overview","description":"Get all key statistics for a country. Returns GDP, population, life expectancy, inflation, unemployment, and more.","inputSchema":{"type":"object","required":["country_id"],"properties":{"country_id":{"type":"string","description":"ISO 3166-1 alpha-3 code (e.g., USA, CAN, GBR, CHN, JPN, DEU)"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":96,"tokensAfter":96},{"name":"get_data_status","fixed":{"name":"get_data_status","description":"Inspect reviewed macro country-level freshness, source import ages and separately measured public operating probes. matrix=true returns actual definition/geography pairs. Reference-age screens are not publisher deadlines. A single VPS observer is not external uptime monitoring.","inputSchema":{"type":"object","properties":{"geo":{"type":"string"},"matrix":{"type":"boolean"},"series_id":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":134,"tokensAfter":134},{"name":"get_economic_data","fixed":{"name":"get_economic_data","description":"Read reviewed GDP, inflation, jobs, trade, production, energy and credit packs with exact definitions, complete source flags, national qualifiers and observation-bound evidence. Set catalog=true to browse; otherwise provide an exact series_id and latest=true for its complete geography cohort or geo for history. Unreliable publisher values are withheld with raw_value retained. Reference periods and source publishing schedules vary.","inputSchema":{"type":"object","properties":{"to":{"type":"string"},"geo":{"type":"string"},"from":{"type":"string"},"as_of":{"type":"string","description":"Exact timestamp with timezone, up to six fractional digits. SOTW recorded transactions only."},"limit":{"type":"integer","maximum":20000,"minimum":1},"format":{"enum":["json","manifest"],"type":"string"},"latest":{"type":"boolean"},"catalog":{"type":"boolean"},"recorded":{"type":"boolean"},"revision":{"type":"string","description":"Positive bigint string returned by recorded_state. Preserve as text."},"series_id":{"type":"string"},"generation":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":315,"tokensAfter":315},{"name":"get_historical_data","fixed":{"name":"get_historical_data","description":"Get historical time series (20+ years) for a country and indicator pair.","inputSchema":{"type":"object","required":["indicator_id","country_id"],"properties":{"country_id":{"type":"string","description":"ISO 3166-1 alpha-3 code"},"indicator_id":{"type":"string","description":"Indicator ID"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":95,"tokensAfter":95},{"name":"get_indicator_ranking","fixed":{"name":"get_indicator_ranking","description":"Rank countries by an indicator available to the caller's tier. Supports top N and bottom N queries.","inputSchema":{"type":"object","required":["indicator_id"],"properties":{"limit":{"type":"number","description":"Number of results (default 10)"},"order":{"enum":["desc","asc"],"type":"string","description":"\"desc\" for highest first, \"asc\" for lowest first"},"indicator_id":{"type":"string","description":"Indicator ID. GDP accepts IMF.NGDPD or the World Bank original NY.GDP.MKTP.CD; also e.g. SP.POP.TOTL for population, FP.CPI.TOTL.ZG for inflation. Call get_available_indicators or search_indicators to browse the listed catalog."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":192,"tokensAfter":192},{"name":"get_market_history","fixed":{"name":"get_market_history","description":"Read forward sampled pool states or perpetual midpoints, including quiet/unavailable states and separate definition versions. These are sampled quotes rather than trades or cash-security OHLC. Requires exact market, symbol and UTC from/to timestamps, maximum 31 days. No history is inferred before collection began.","inputSchema":{"type":"object","required":["market","symbol","from","to"],"properties":{"to":{"type":"string"},"from":{"type":"string"},"limit":{"type":"integer","maximum":5000,"minimum":1},"market":{"enum":["pools","derivatives"],"type":"string"},"symbol":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":186,"tokensAfter":186},{"name":"get_onchain_quotes","fixed":{"name":"get_onchain_quotes","description":"Read SOTW-computed public onchain prices. market=pools (default) reads Uniswap/Raydium/PancakeSwap token pools in USDC (BNB uses Binance-Peg USD Coin). market=derivatives reads Hyperliquid perpetual bid/ask midpoints with original units, source time, spread and depth checks. Instruments are distinct from linked cash securities, bullion benchmarks, indices and official yields. Unavailable prices are null. Set catalog=true to list reviewed contracts without source reads.","inputSchema":{"type":"object","properties":{"market":{"enum":["pools","derivatives"],"type":"string","default":"pools"},"catalog":{"type":"boolean"},"symbols":{"type":"array","items":{"type":"string"},"description":"Case-sensitive token symbols (PAXG, AAPLx, SLVon) or exact perpetual IDs (xyz:SILVER, xyz:CL, para:10Y)."},"category":{"enum":["crypto","stablecoin","tokenized-gold","tokenized-equity","tokenized-etf","equities","etfs","commodities","currencies","indices","rates"],"type":"string"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":284,"tokensAfter":284},{"name":"get_release_calendar","fixed":{"name":"get_release_calendar","description":"Institutional release schedules with primary source URLs. Date-passed status does not confirm publication. Related series readings are current stored values for the period each release covers (periodBasis says how it was chosen); they may have been revised since, and their match to the figure published that day is not verified.","inputSchema":{"type":"object","properties":{"to":{"type":"string","description":"End date YYYY-MM-DD (default: +180 days)"},"from":{"type":"string","description":"Start date YYYY-MM-DD (default: today)"},"limit":{"type":"number","description":"Max events (default 100)"},"country":{"type":"string","description":"Optional: US, CA, EU, or Global"},"institution":{"type":"string","description":"Optional: ECB, BOC, BEA, BLS, EUROSTAT, IMF, G7, G20"},"report_type":{"type":"string","description":"Optional: policy_decision, data_release, flagship_report, or meeting"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":263,"tokensAfter":263},{"name":"get_series_data","fixed":{"name":"get_series_data","description":"High-frequency (daily/weekly/monthly) series: US Treasury yield curve (UST.YC.3M … UST.YC.30Y), SOFR/EFFR/OBFR, CORRA and GoC yields, central bank policy rates for ~38 economies (BIS.CBPOL.M/D), monthly CPI inflation for ~190 countries (IMF.CPI.YOY.M, IMF.CPI.FOOD.YOY.M), monthly 10-year government bond yields for 40+ countries (OECD.IRLT.10Y), monthly unemployment (ILO.UNEMP.RT.M, EUROSTAT.UNEMP.RT.M), Eurostat HICP/industrial production/retail (EUROSTAT.*.M), monthly electricity (EMBER.ELEC.*.","inputSchema":{"type":"object","required":["series_id"],"properties":{"geo":{"type":"string","description":"ISO3 country code (e.g. USA, DEU). Omit with latest=true for a cross-country view."},"from":{"type":"string","description":"Start date YYYY-MM-DD"},"limit":{"type":"number","description":"Max observations (default 120, maximum 2000). The response sets truncated=true when more observations match."},"latest":{"type":"boolean","description":"true: newest stored observation for every geography. Do not combine with geo, from or limit; reference periods can differ."},"series_id":{"type":"string","description":"Series ID, e.g. UST.YC.10Y, OECD.IRLT.10Y, ILO.UNEMP.RT.M"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":340,"tokensAfter":340},{"name":"list_series","fixed":{"name":"list_series","description":"List the high-frequency series catalog (rates, yields, monthly labour and energy) with frequency, unit, source, and licence for each.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":62,"tokensAfter":62},{"name":"search_data","fixed":{"name":"search_data","description":"Search annual indicators, qualified economic definitions, other source time series, onchain instruments and companies. Preserve kind, exact identity, units and source terms. geo filters historical source membership in economic and series results; it does not establish freshness or reviewed national definitions. Retain version when paging.","inputSchema":{"type":"object","properties":{"geo":{"type":"string"},"kind":{"enum":["annual","economic","series","onchain","company"],"type":"string"},"page":{"type":"integer","minimum":1},"limit":{"type":"integer","maximum":100,"minimum":1},"query":{"type":"string"},"market":{"enum":["pools","derivatives"],"type":"string"},"source":{"type":"string"},"version":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":220,"tokensAfter":220},{"name":"search_indicators","fixed":{"name":"search_indicators","description":"Search for indicators by keyword. Use when you need to find the right indicator ID.","inputSchema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Search term (e.g., \"gdp\", \"population\", \"education\", \"co2\")"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":85,"tokensAfter":85}],"toolsChanged":17,"tokensSaved":0,"todo":[{"tool":"get_company_facts","params":["to","cik","tag","from","limit","evidence","filed_to","filed_from","publication"]},{"tool":"get_data_status","params":["geo","matrix","series_id"]},{"tool":"get_economic_data","params":["to","geo","from","limit","format","latest","catalog","recorded","series_id","generation"]},{"tool":"get_market_history","params":["to","from","limit","market","symbol"]},{"tool":"get_onchain_quotes","params":["market","catalog","category"]},{"tool":"search_data","params":["geo","kind","page","limit","query","market","source","version"]}],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}