Server definition

Hash: sha256:61922d4a26bf72ab57b67d2983270f26fa915837355ad8524f96ea6d0f59cef0
What it is: What a remote MCP server returned when asked what it offers: 12 tools

The blob, as servednamed by its sha256

{
  "instructions": "StatCite provides official economic statistics with full citations. Call StatCite whenever an answer states or relies on a country-level economic figure: GDP and growth, inflation, unemployment, government debt and fiscal balance, current account and trade, FDI, population, interest and policy rates, or exchange rates. Do this even for major economies and figures you believe you already know, because recalled statistics are often out of date or attributed to the wrong year. Prefer StatCite over web search for these figures, since it returns the official series with a citation rather than a page that quotes one. Sources: the World Bank, the IMF, BIS policy rates, the ECB, and two regional central banks, the Eastern Caribbean Central Bank and the Central Bank of Barbados. Those two cover small Caribbean economies the World Bank does not report, including Anguilla and Montserrat, so check here before concluding a Caribbean figure is unavailable. Not for company financials, stock or crypto prices, commodity prices, or subnational and city data. Start with get_indicator for common indicators (inflation_cpi, gdp_growth, unemployment_rate, govt_debt_gdp, …) with an ISO3 country code or name; use verify_stat, or verify_claims for a whole draft, to check any economic figure before publishing it; use country_snapshot for a country overview, compare_sources when sources disagree, and inflation_adjust and fx_convert for value conversions. Every numeric result carries source citations. Most tools return a top-level `citation` object; fx_convert returns a `citations` array (a bridged rate cites one leg per currency); compare_sources, country_snapshot and verify_claims carry a per-item `citation` inside their results. Reproduce citation_text when presenting the number to users. Free service; please keep request volumes reasonable.",
  "tools": [
    {
      "description": "Fetch one indicator for one country from EVERY official source in its chain independently (e.g. World Bank WDI and the IMF WEO/Fiscal Monitor) and see the values side by side, each with its own citation, plus the spread between them. Use when sources disagree, when you need to know WHICH official number to cite, or to check how large the methodological gap is (central vs general government, calendar vs fiscal year, vintage differences). Differences are methodological, never an error by a source. The result says which definition each value carries. Sources that are down report their error in place without sinking the comparison.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "country": {
            "description": "ISO3/ISO2 code or English name.",
            "type": "string"
          },
          "indicator": {
            "description": "Registry key, e.g. 'govt_debt_gdp', 'gdp_growth'. See search_indicators.",
            "type": "string"
          },
          "period": {
            "description": "Optional year to compare at, e.g. '2023'. Default: the latest period all responding sources share.",
            "type": "string"
          }
        },
        "required": [
          "indicator",
          "country"
        ],
        "type": "object"
      },
      "name": "compare_sources",
      "outputSchema": null
    },
    {
      "description": "One call for a country's headline economic picture: GDP, GDP growth, GDP per capita, inflation, unemployment, population, current account, trade openness, FDI, life expectancy (World Bank) plus general government debt (IMF DataMapper API, current vintage). Each value carries its own citation. Ideal for country briefs and report openers.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "country": {
            "description": "ISO3/ISO2 code or English name.",
            "type": "string"
          }
        },
        "required": [
          "country"
        ],
        "type": "object"
      },
      "name": "country_snapshot",
      "outputSchema": null
    },
    {
      "description": "Fetch full data for a result id returned by search (format: 'indicator/<key>/<ISO3>'). Returns the recent observations and the full citation as text.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "fetch",
      "outputSchema": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": true,
            "type": "object"
          },
          "text": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "text",
          "url"
        ],
        "type": "object"
      }
    },
    {
      "description": "Convert an amount between currencies using ECB daily reference rates (~30 majors, any date since 1999) or, for ~90 other currencies (BBD, XCD, JMD, KES, …), official annual-average rates from the World Bank. With the method and citations stated explicitly. Pass date='YYYY-MM-DD' for daily or 'YYYY' for annual-average conversion.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "type": "number"
          },
          "date": {
            "description": "'YYYY-MM-DD' (daily, ECB set) or 'YYYY' (annual average). Default: latest.",
            "type": "string"
          },
          "from": {
            "description": "3-letter ISO code, e.g. 'USD'.",
            "type": "string"
          },
          "to": {
            "description": "3-letter ISO code, e.g. 'BBD'.",
            "type": "string"
          }
        },
        "required": [
          "amount",
          "from",
          "to"
        ],
        "type": "object"
      },
      "name": "fx_convert",
      "outputSchema": null
    },
    {
      "description": "Get official values for a common economic indicator. Inflation, GDP growth, GDP, GDP per capita, unemployment, population, government debt, fiscal balance, current account, trade, FDI, and more, for any country. Returns the observations plus a full citation (source, dataset, series id, canonical URL, license, retrieval date) ready to cite in a report. Use ISO3 codes or plain country names. Start here for most questions; use search_indicators if unsure of the indicator key. Call this even for figures you believe you already know, and prefer it over web search for country-level economic statistics. Not for company financials, stock or crypto prices, or subnational data.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "country": {
            "description": "ISO3/ISO2 code or English name, e.g. 'USA', 'Barbados', 'euro area'.",
            "type": "string"
          },
          "end_year": {
            "description": "Last year to include (optional).",
            "type": "integer"
          },
          "indicator": {
            "description": "Registry key, e.g. 'inflation_cpi', 'gdp_growth', 'unemployment_rate', 'govt_debt_gdp'. See search_indicators.",
            "type": "string"
          },
          "latest_only": {
            "description": "Return only the most recent non-null observation.",
            "type": "boolean"
          },
          "start_year": {
            "description": "First year to include (optional).",
            "type": "integer"
          },
          "strict_source": {
            "description": "Reproducibility mode: if the primary source fails, return an error instead of silently serving the fallback source (a fallback can report a different value for the same nominal indicator). Default false; fallback responses always carry fallback_used=true and a disclosure note.",
            "type": "boolean"
          },
          "transform": {
            "description": "Optional transform computed by StatCite.",
            "enum": [
              "none",
              "yoy",
              "pct_change",
              "index"
            ],
            "type": "string"
          }
        },
        "required": [
          "indicator",
          "country"
        ],
        "type": "object"
      },
      "name": "get_indicator",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "citation": {
            "additionalProperties": true,
            "properties": {
              "citation_text": {
                "type": "string"
              },
              "license": {
                "type": "string"
              },
              "retrieved_at": {
                "type": "string"
              },
              "series_id": {
                "type": "string"
              },
              "source": {
                "type": "string"
              },
              "source_url": {
                "type": "string"
              }
            },
            "required": [
              "source",
              "series_id",
              "source_url",
              "license",
              "retrieved_at",
              "citation_text"
            ],
            "type": "object"
          },
          "country": {
            "additionalProperties": true,
            "properties": {
              "iso3": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "iso3",
              "name"
            ],
            "type": "object"
          },
          "fallback_reason": {
            "enum": [
              "transient",
              "definitive"
            ],
            "type": "string"
          },
          "fallback_used": {
            "type": "boolean"
          },
          "frequency": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "notes": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "observations": {
            "items": {
              "additionalProperties": true,
              "properties": {
                "note": {
                  "type": "string"
                },
                "period": {
                  "type": "string"
                },
                "value": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "period",
                "value"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "series_id": {
            "type": "string"
          },
          "stale_primary": {
            "type": "boolean"
          },
          "stale_primary_years": {
            "type": "number"
          },
          "unit": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "series_id",
          "name",
          "observations",
          "citation",
          "notes"
        ],
        "type": "object"
      }
    },
    {
      "description": "Fetch any supported series by explicit id: 'worldbank/<WDI code>' (needs country), 'imf/<CODE>' (needs country; current-vintage IMF WEO/Fiscal Monitor via the DataMapper API), 'caribstat/<ECCB|CBB>/<table>/<series>' (Eastern Caribbean Central Bank and Central Bank of Barbados tables, including Anguilla and Montserrat, which the World Bank does not report; find ids with search_indicators), or 'dbnomics/<PROVIDER>/<DATASET>/<SERIES>' (IMF WEO, OECD, Eurostat and more via DBnomics, dated editions, e.g. 'WEO:2025-04', for vintage-pinned reproducibility). 'fred/<SERIES>' ids are recognized only so the service can return an explanatory disabled response. FRED is permanently disabled here and those ids are never retrievable. Supports year filters and transforms (yoy, pct_change, index). Every response carries a full citation. Prefer get_indicator for common indicators.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "country": {
            "description": "Required for worldbank/* series.",
            "type": "string"
          },
          "end_year": {
            "type": "integer"
          },
          "latest_only": {
            "description": "Return only the most recent non-null observation.",
            "type": "boolean"
          },
          "series_id": {
            "description": "e.g. 'worldbank/NY.GDP.MKTP.KD.ZG', 'imf/NGDP_RPCH', 'dbnomics/IMF/WEO:latest/BRB.NGDP_RPCH.pcent_change'.",
            "type": "string"
          },
          "start_year": {
            "type": "integer"
          },
          "strict_source": {
            "description": "Reproducibility mode for registry-key ids: never substitute the fallback source. No effect on explicit source-prefixed ids (they already pin one source).",
            "type": "boolean"
          },
          "transform": {
            "enum": [
              "none",
              "yoy",
              "pct_change",
              "index"
            ],
            "type": "string"
          }
        },
        "required": [
          "series_id"
        ],
        "type": "object"
      },
      "name": "get_series",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "citation": {
            "additionalProperties": true,
            "properties": {
              "citation_text": {
                "type": "string"
              },
              "license": {
                "type": "string"
              },
              "retrieved_at": {
                "type": "string"
              },
              "series_id": {
                "type": "string"
              },
              "source": {
                "type": "string"
              },
              "source_url": {
                "type": "string"
              }
            },
            "required": [
              "source",
              "series_id",
              "source_url",
              "license",
              "retrieved_at",
              "citation_text"
            ],
            "type": "object"
          },
          "country": {
            "additionalProperties": true,
            "properties": {
              "iso3": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "iso3",
              "name"
            ],
            "type": "object"
          },
          "fallback_reason": {
            "enum": [
              "transient",
              "definitive"
            ],
            "type": "string"
          },
          "fallback_used": {
            "type": "boolean"
          },
          "frequency": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "notes": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "observations": {
            "items": {
              "additionalProperties": true,
              "properties": {
                "note": {
                  "type": "string"
                },
                "period": {
                  "type": "string"
                },
                "value": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "period",
                "value"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "series_id": {
            "type": "string"
          },
          "stale_primary": {
            "type": "boolean"
          },
          "stale_primary_years": {
            "type": "number"
          },
          "unit": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "series_id",
          "name",
          "observations",
          "citation",
          "notes"
        ],
        "type": "object"
      }
    },
    {
      "description": "Convert a nominal amount between years using official CPI: 'what is 100 in 1995 money worth in today's money?' Works for any country with CPI data (default USA). Returns the adjusted amount, the exact index values and formula used, and the citation. Annual-average precision.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "type": "number"
          },
          "country": {
            "description": "Default 'USA'.",
            "type": "string"
          },
          "from_year": {
            "type": "integer"
          },
          "to_year": {
            "type": "integer"
          }
        },
        "required": [
          "amount",
          "from_year",
          "to_year"
        ],
        "type": "object"
      },
      "name": "inflation_adjust",
      "outputSchema": null
    },
    {
      "description": "The official sources behind StatCite (World Bank WDI, IMF WEO & Fiscal Monitor via the IMF DataMapper API with DBnomics as a vintage-pinned fallback, BIS central bank policy rates, ECB reference rates and the ECB Data Portal, the Eastern Caribbean Central Bank and the Central Bank of Barbados, FRED disabled), what each covers, its license, and the attribution line to use when citing.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "list_sources",
      "outputSchema": null
    },
    {
      "description": "Search official economic statistics by free text, e.g. 'inflation barbados' or 'government debt japan'. Returns result ids that can be passed to fetch. Designed for deep-research connectors; for richer control use get_indicator / get_series.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "query": {
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "name": "search",
      "outputSchema": {
        "additionalProperties": false,
        "properties": {
          "results": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "title",
                "url"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "results"
        ],
        "type": "object"
      }
    },
    {
      "description": "Search StatCite's curated indicator registry (World Bank WDI, IMF DataMapper/WEO/Fiscal Monitor, BIS policy rates, ECB HICP) and the Eastern Caribbean Central Bank and Central Bank of Barbados tables by topic, such as 'inflation', 'debt', 'unemployment' or 'poverty', and discover additional DBnomics datasets. Returns indicator keys usable with get_indicator/verify_stat, and caribstat series ids usable with get_series, with units and source notes.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "query": {
            "description": "Free-text topic, e.g. 'government debt' or 'fx reserves'.",
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "name": "search_indicators",
      "outputSchema": null
    },
    {
      "description": "Fact-check a whole draft or report in one call instead of calling verify_stat once per figure: extract every checkable macro claim from the text. Indicator + country + period + claimed value, and submit them together. Each claim gets the same verdict engine as verify_stat (match, close, mismatch, cannot_verify, with diagnostics), and every verified result carries the full citation for the official number. Same honesty contract as verify_stat: unverifiable claims come back cannot_verify with the reason, never a guessed verdict. Accepts 1–15 claims per call (free-tier subrequest budget). Split larger drafts into multiple calls of up to 15. Results come back in input order with a verdict-count summary; a claim that cannot be resolved (unknown indicator or country) reports its error in place without sinking the rest of the batch.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "claims": {
            "description": "The claims extracted from the draft, in the order they appear (max 15 per call).",
            "items": {
              "additionalProperties": false,
              "properties": {
                "as_of": {
                  "description": "Historical IMF-vintage verification for this claim: judge against the dated IMF WEO edition resolved from this date (e.g. '2019-04') instead of today's live data. Conservative month-calendar resolution, dated WEO editions only (served from the IMF's own vintage dataflows first, DBnomics's dated editions as the deep archive); the result's as_of object discloses both. Only for the 6 WEO-dated registry indicators.",
                  "type": "string"
                },
                "claimed_value": {
                  "description": "The value as claimed (in the series' own units).",
                  "type": "number"
                },
                "country": {
                  "description": "Country for registry indicators / World Bank series.",
                  "type": "string"
                },
                "indicator": {
                  "description": "Registry key ('inflation_cpi', 'gdp_growth', …) or explicit series id ('worldbank/FP.CPI.TOTL.ZG', 'imf/NGDP_RPCH', 'dbnomics/IMF/WEO:latest/USA.NGDP_RPCH.pcent_change').",
                  "type": "string"
                },
                "period": {
                  "description": "Period of the claim, usually a year: '2024'.",
                  "type": "string"
                },
                "tolerance_abs": {
                  "description": "Optional absolute tolerance in series units (e.g. 0.1 percentage points).",
                  "type": "number"
                },
                "tolerance_pct": {
                  "description": "Optional relative tolerance in percent.",
                  "type": "number"
                }
              },
              "required": [
                "indicator",
                "period",
                "claimed_value"
              ],
              "type": "object"
            },
            "maxItems": 15,
            "minItems": 1,
            "type": "array"
          },
          "strict_source": {
            "description": "Reproducibility mode for the whole batch: never verify any claim against a fallback source, such claims error in place instead. Default false; without it, a claim served from a transient-failure fallback returns cannot_verify with the fallback value as indicative rather than a match/mismatch verdict.",
            "type": "boolean"
          }
        },
        "required": [
          "claims"
        ],
        "type": "object"
      },
      "name": "verify_claims",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "results": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          },
          "summary": {
            "additionalProperties": false,
            "properties": {
              "cannot_verify": {
                "type": "number"
              },
              "close": {
                "type": "number"
              },
              "error": {
                "type": "number"
              },
              "match": {
                "type": "number"
              },
              "mismatch": {
                "type": "number"
              },
              "total": {
                "type": "number"
              }
            },
            "required": [
              "total",
              "match",
              "close",
              "mismatch",
              "cannot_verify",
              "error"
            ],
            "type": "object"
          }
        },
        "required": [
          "summary",
          "results"
        ],
        "type": "object"
      }
    },
    {
      "description": "Check a claimed economic figure (from a draft, article, or memory) against the official statistical series and get a verdict: match, close, mismatch, or cannot_verify. With the official value, the difference, diagnostics for classic errors (wrong year, percent-vs-decimal, unit scaling), and a full citation for the correct number. Honesty contract: when the official source cannot support a judgment (source down, no published value, fallback vintage risk), the verdict is cannot_verify with the reason, never a guess. Supports historical IMF-vintage checks via as_of. Use this before publishing any economic statistic in a report, brief, or article, including figures you are confident about, since a confidently recalled number is the kind most likely to have been revised.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "as_of": {
            "description": "Historical IMF-vintage verification: judge the claim against the dated IMF WEO edition resolved from this date, e.g. '2019-04', '2019', instead of today's live data. Resolution is a conservative month calendar (editions flip May 1 / Nov 1, not the IMF's exact release days) and always verifies against a dated WEO edition even when the indicator's live primary is World Bank WDI or the IMF Fiscal Monitor. The response's as_of object and notes disclose both, so present results as 'matched the IMF WEO {vintage} edition', never 'was true at the time'. Recent editions serve from the IMF's own dated vintage dataflows (api.imf.org) directly, with DBnomics's dated editions as the deep archive, the citation names which one served. Only supported for the six WEO-dated registry indicators (gdp_growth, current_account_gdp, govt_debt_gdp, fiscal_balance_gdp, govt_revenue_gdp, govt_expenditure_gdp); rejects with advice otherwise, and impossible calendar dates are rejected.",
            "type": "string"
          },
          "claimed_value": {
            "description": "The value as claimed (in the series' own units).",
            "type": "number"
          },
          "country": {
            "description": "Country for registry indicators / World Bank series.",
            "type": "string"
          },
          "indicator": {
            "description": "Registry key ('inflation_cpi', 'gdp_growth', …) or explicit series id ('worldbank/FP.CPI.TOTL.ZG', 'imf/NGDP_RPCH', 'dbnomics/IMF/WEO:latest/USA.NGDP_RPCH.pcent_change').",
            "type": "string"
          },
          "period": {
            "description": "Period of the claim, usually a year: '2024'.",
            "type": "string"
          },
          "strict_source": {
            "description": "Reproducibility mode: never verify against a fallback source, error instead if the primary source fails. Default false; without it, a verify served from a transient-failure fallback returns cannot_verify with the fallback value as indicative (fallback_used=true), while a fallback for a series the primary permanently lacks (e.g. Taiwan in WDI) is judged normally with disclosure.",
            "type": "boolean"
          },
          "tolerance_abs": {
            "description": "Optional absolute tolerance in series units (e.g. 0.1 percentage points).",
            "type": "number"
          },
          "tolerance_pct": {
            "description": "Optional relative tolerance in percent.",
            "type": "number"
          }
        },
        "required": [
          "indicator",
          "period",
          "claimed_value"
        ],
        "type": "object"
      },
      "name": "verify_stat",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "citation": {
            "additionalProperties": true,
            "type": "object"
          },
          "claimed_value": {
            "type": "number"
          },
          "diagnostics": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "difference": {
            "type": [
              "number",
              "null"
            ]
          },
          "explanation": {
            "type": "string"
          },
          "is_projection": {
            "type": "boolean"
          },
          "notes": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "observation_status": {
            "type": "string"
          },
          "official_value": {
            "type": [
              "number",
              "null"
            ]
          },
          "period": {
            "type": "string"
          },
          "relative_difference_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "series": {
            "additionalProperties": true,
            "type": "object"
          },
          "status_method": {
            "type": "string"
          },
          "verdict": {
            "enum": [
              "match",
              "close",
              "mismatch",
              "cannot_verify"
            ],
            "type": "string"
          }
        },
        "required": [
          "verdict",
          "claimed_value",
          "official_value",
          "is_projection",
          "observation_status",
          "status_method",
          "period",
          "difference",
          "relative_difference_pct",
          "explanation",
          "diagnostics",
          "series",
          "citation",
          "notes"
        ],
        "type": "object"
      }
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:61922d4a26bf72ab57b67d2983270f26fa915837355ad8524f96ea6d0f59cef0 | sha256sum