MCP.so
Sign In

American Default Research

@vibecode1

Repository

About American Default Research

Read-only MCP for U.S. household financial distress data. Query 96 economic indicators (mortgage delinquency, unemployment claims, savings rate, credit conditions, foreclosure activity, and more), the American Distress Index (ADI) composite score, and county-level distress scores

#economic-data#finance#research#government#housing#economy

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "american-default-research": {
      "url": "https://mcp.americandefault.org/mcp",
      "transport": "streamable-http"
    }
  }
}

Tools

6

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

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.

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.

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.

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

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.

Overview

What is American Default Research?

American Default Research is a Model Context Protocol server that exposes 96 economic distress indicators, the American Distress Index (ADI) composite score, and county-level distress scores across all 3,144 U.S. counties to MCP-compatible AI agents. It is designed for AI agents that need to retrieve structured economic distress data.

How to use American Default Research?

Point any MCP-compatible client at the hosted streamable-HTTP endpoint at https://mcp.americandefault.org/mcp. For Claude Desktop, add the endpoint URL to claude_desktop_config.json. The server exposes five tools: get_indicator, get_county_scorecard, get_adi_composite, search_indicators, and get_cross_correlations. A local install is possible for self-hosting but requires data files not included in the repo.

Key features of American Default Research

  • Exposes 5 tools for retrieving distress data, ADI, and correlations.
  • Data covers all 3,144 U.S. counties with 96 economic indicators.
  • Each response includes canonical citations in APA, MLA, Chicago, and news-copy formats.
  • Schema versioning ensures backward compatibility (v1 tools stay live).
  • Built-in rate limiting for the HTTP transport (per-minute burst and per-hour sustained).
  • Supports both stdio (for local clients) and streamable-HTTP transports.

Use cases of American Default Research

  • An AI agent retrieves the latest American Distress Index composite score using get_adi_composite.
  • A financial analyst's assistant fetches a county-level distress scorecard for a given FIPS code.
  • A researcher searches for economic indicators by keyword (e.g., "mortgage delinquency") via search_indicators.
  • An agent analyzes leading/lagging relationships between two indicators via get_cross_correlations.
  • A policy brief generator automatically cites each data point with pre-formatted APA citations.

FAQ from American Default Research

What data sources does American Default Research use?

Data is sourced from FRED, BLS, NY Fed Household Debt and Credit Report, ATTOM Data Solutions, Mortgage Bankers Association, American Bankruptcy Institute / Epiq Systems, and additional primary government and industry sources.

Is the server free to use for AI agents?

The hosted endpoint is available without an explicit cost mentioned; the server supports anonymous and issued bearer-token tiers. Data is free to use with attribution per the canonical attribution block.

Can I run American Default Research locally instead of using the hosted endpoint?

The local installation is possible but requires data files (data/ and site/src/data/) not included in the repo. You can mirror data from the public API or use the repo as a code reference only.

What happens if an indicator slug has no populated data yet?

10 of 96 bundles return status: "awaiting_population" with full metadata and a null latest_value—agents can discover the slug exists without receiving phantom data.

How are response sizes managed for LLM context budgets?

Each endpoint has a defined response size budget (e.g., get_indicator ≤ 16 KB, get_county_scorecard ≤ 25 KB). The raw 300+ point indicator series is omitted from get_indicator to keep context manageable; the full series is available at a separate API endpoint.

Frequently asked questions

What data sources does American Default Research use?

Data is sourced from FRED, BLS, NY Fed Household Debt and Credit Report, ATTOM Data Solutions, Mortgage Bankers Association, American Bankruptcy Institute / Epiq Systems, and additional primary government and industry sources.

Is the server free to use for AI agents?

The hosted endpoint is available without an explicit cost mentioned; the server supports anonymous and issued bearer-token tiers. Data is free to use with attribution per the canonical attribution block.

Can I run American Default Research locally instead of using the hosted endpoint?

The local installation is possible but requires data files (`data/` and `site/src/data/`) not included in the repo. You can mirror data from the public API or use the repo as a code reference only.

What happens if an indicator slug has no populated data yet?

10 of 96 bundles return `status: "awaiting_population"` with full metadata and a null `latest_value`—agents can discover the slug exists without receiving phantom data.

How are response sizes managed for LLM context budgets?

Each endpoint has a defined response size budget (e.g., `get_indicator` ≤ 16 KB, `get_county_scorecard` ≤ 25 KB). The raw 300+ point indicator series is omitted from `get_indicator` to keep context manageable; the full series is available at a separate API endpoint.

Comments

Basic information

Category

Data & Analytics

Transports

stdio

Author

vibecode1

Submitted by

Ross Kilburn

More Data & Analytics MCP servers

CoinLobster

CoinLobster

The only MCP server with live whale trades across 15 exchanges plus on-chain DEX flow. Smart Money Radar, real liquidations and outcome-scored signals. No API key required.

3

Grabbit MCP

Grabbit

Remote MCP server that helps AI agents find Reddit buyer-intent threads, check subreddit rules, read full conversations, and manage human-reviewed lead workflows.

Subtext

Subtext by Fullstory

Session replay, built for agents. Subtext is agentic session review: it captures production sessions of your app and connects them to your coding agent — Claude Code, Cursor, Codex, Devin, your own harness — so it can

9

LeadMarina

LeadMarina

Verified local-business leads: search any niche in any city, query your lead library, and export to Close, GoHighLevel, Google Sheets, or emailed files — every email SMTP-checked, every phone verified with line type and

Octolens

Octolens

Give your AI agents every brand mention across the internet — 15+ platforms, AI-filtered, one structured feed.