American Default Research

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Read-only MCP for U.S. household distress: 96 indicators, ADI composite, 3,144 counties.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "American Default Research": {
      "url": "https://mcp.americandefault.org/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (6)

• get_indicator read-only

  Fetch a compact snapshot of an American Default economic indicator by slug. Returns latest value, unit, frequency, direction, pre-computed aggregates (period averages, extremes, sustained runs), editorial prose (when available), and canonical APA / MLA / Chicago / news-copy citations. Raw historical series is NOT included — use https://americandefault.org/api/indicators/{slug}.json for the full data. Slug examples: 'the-buffer' (personal savings rate), 'mortgage-delinquency', 'initial-unemployment-claims-sa'.

  Parameters:

  • slug (required) — string — The kebab-case indicator slug (e.g., 'the-buffer' for personal savings rate, 'mortgage-delinquency', 'initial-unemployment-claims-sa'). 103 indicators available. Use `search_indicators` first to discover which slug corresponds to a concept.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_indicator_v2 read-only

  Fetch an explicitly versioned compact indicator snapshot. Returns the latest value and canonical citation plus `trend_suppressed` and `series_breaks` comparison-safety fields. Callers must pass `response_version='v2'`; unsupported versions fail closed. The legacy `get_indicator` tool remains pinned to its original v1 shape.

  Parameters:

  • slug (required) — string — The kebab-case indicator slug (e.g., 'the-buffer' or 'the-pinch'). Use `search_indicators` to discover slugs.
  • response_version (required) — string — Required explicit response contract version. The only supported value for this tool is 'v2'.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_county_scorecard read-only

  Fetch a county's County Distress Index (CDI) scorecard by 5-digit FIPS code. Returns composite score (0-100), score label, national + state rank, 5-domain breakdown (Delinquency, Default & Legal, Debt Burden, Labor, Safety Net & Buffer), key findings, and pre-baked APA / MLA / Chicago / news-copy citations. Accepts 4-digit FIPS with implicit leading zero. 3,144 counties available.

  Parameters:

  • fips (required) — string — The 5-digit numeric county FIPS code as a string (e.g., '13063' for Clayton County, GA). 4-digit values are zero-padded internally. 3,144 counties available.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_adi_composite read-only

  Fetch the latest quarterly reading of the American Distress Index (ADI) composite. Returns the composite score (0-100), band (1-5) with its label and the literal reading gloss, the composite's own rank in history, and the five-domain breakdown (Delinquency, Default & Legal, Debt Burden, Labor, Safety Net & Buffer) with domain scores and member component percentiles. Updated quarterly.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_indicators read-only

  Search the 103-indicator registry by keyword. Returns ranked matches (up to `limit`, default 10, max 50) with slug, branded name, underlying name, category, and canonical URL. Scoring is substring+prefix over slug, branded_name, name, and category — e.g. query 'savings' returns both The Buffer (personal saving rate) and The Safety Net (emergency savings survey). Use this when you want to discover which slug corresponds to a concept before calling `get_indicator`.

  Parameters:

  • query (required) — string — The keyword to search (e.g., 'savings', 'mortgage', 'inflation'). Scoring runs substring + prefix matching over slug, branded_name, name, and category fields.
  • limit — integer — Max number of ranked matches to return. Default 10. Hard cap 50 (values above are clamped). Values above 1000 are rejected as abuse.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_cross_correlations read-only

  Fetch statistically-validated leading/lagging relationships for an indicator. Source: the five-filter leading-indicator scanner (cross-correlation → first-differenced CCF → multi-crisis validation → Granger causality → out-of-sample validation). Returns two lists: `as_leader` (pairs where this indicator precedes its follower) and `as_follower` (pairs where another indicator precedes this one). Only fully-validated pairs are included — partial matches are not surfaced. Most of the 103 indicators return empty lists; only a handful of pairs clear the full gauntlet.

  Parameters:

  • slug (required) — string — The kebab-case indicator slug to look up (e.g., 'the-buffer', 'initial-unemployment-claims-sa'). Returns split lists of pairs where this indicator is the leader vs the follower. Empty lists are common — only fully-validated pairs surface.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.