American Default Research

vibecode1/american-default-mcp

Read-only research tools for U.S. household financial distress from American Default Research. Six tools: search_indicators finds economic indicators, get_indicator_v2 returns the latest reading with sources, citations and freshness warnings (get_indicator is the legacy v1 version), get_county_scorecard takes a county FIPS code, get_adi_composite returns the latest American Distress Index, and get_cross_correlations lists validated relationships between indicators. Results carry dates, original publishers and citations. Connect directly to the Streamable HTTP endpoint https://mcp.americandefault.org/mcp. Normal use needs no account or key, and anonymous access allows 10 calls a minute and 60 an hour per IP block. It does not touch private homeowner records or run arbitrary SQL.

tools: 6
transport: HTTP
last updated: Nov 2, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.americandefault.org/mcp --name research

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http research https://mcp.americandefault.org/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 6 tools

Verified live against the running server on Nov 5, 2026.

get_indicatorFetch 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 ci...1 params

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 ci...

Parameters* required

slug*string

The kebab-case indicator slug (e.g., 'the-buffer' for personal savings rate, 'mortgage-delinquency-rate', 'initial-unemployment-claims-sa'). 121 indicators available. Use `search_indicators` first...

get_indicator_v2Fetch 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_indicato...2 params

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_indicato...

Parameters* required

response_version*string

Required explicit response contract version. The only supported value for this tool is 'v2'.

slug*string

The kebab-case indicator slug (e.g., 'the-buffer' or 'the-pinch'). Use `search_indicators` to discover slugs.

get_county_scorecardFetch a county's County Distress Index (CDI) scorecard by 5-digit FIPS code. Returns the 0-100 score (the share of the other U.S. counties with a lower composite, rounded down; field composite_score), score label, national + state rank (national_rank_ordinal is filled only for...1 params

Fetch a county's County Distress Index (CDI) scorecard by 5-digit FIPS code. Returns the 0-100 score (the share of the other U.S. counties with a lower composite, rounded down; field composite_score), score label, national + state rank (national_rank_ordinal is filled only for...

Parameters* required

fips*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.

get_adi_compositeFetch the latest quarterly reading of the American Distress Index (ADI) composite. Returns the composite score (0-100), band (1-5) with its label, the composite's rank in its own published history (rank_in_history.reading: quote this beside the band label), the methodology rea...

Fetch the latest quarterly reading of the American Distress Index (ADI) composite. Returns the composite score (0-100), band (1-5) with its label, the composite's rank in its own published history (rank_in_history.reading: quote this beside the band label), the methodology rea...

No parameters. Call it with no arguments.

search_indicatorsSearch the 121-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' return...2 params

Search the 121-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' return...

Parameters* required

limitinteger

Max number of ranked matches to return. Default 10. Hard cap 50 (values above are clamped). Values above 1000 are rejected as abuse.default: 10

query*string

The keyword to search (e.g., 'savings', 'mortgage', 'inflation'). Scoring runs substring + prefix matching over slug, branded_name, name, and category fields.

get_cross_correlationsFetch 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`...1 params

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`...

Parameters* required

slug*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 com...

Readme

American Default Research MCP

Read-only research tools for U.S. household financial distress: economic indicators, county scorecards, and the American Distress Index, with dates, original publishers, and citations. The public service requires no account or API key for normal use. It does not access private homeowner records or expose the warehouse, arbitrary SQL, or financial transactions.

Connect to the hosted service

Endpoint: https://mcp.americandefault.org/mcp

Transport: Streamable HTTP. Public documentation: https://americandefault.org/press/mcp/

In Claude, open Customize, Connectors, and add a custom connector using that URL. In ChatGPT, use the custom MCP connection in developer mode where your account supports it. Directory publication is a separate platform review; this README does not claim that either platform has approved the listing.

View the full README on GitHub

Details

Repository: github.com/vibecode1/american-default-mcp
Website: americandefault.org/press/mcp
Transport: HTTP
Registry: MCP registry, active
Tools verified: Nov 5, 2026