American Default Research

org.americandefault由 americandefault.org 發布官方發布者v1.1.1更新於 Nov 3, 2026

唯讀的美國家庭金融研究：經濟指標、縣級評分、ADI 與引文。

AI 翻譯由 AI 模型根據下方的原文描述翻譯，可能有誤。

原文描述

Read-only U.S. household-finance research: economic indicators, county scores, ADI and citations.

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

American Default Research 的託管 MCP 服務（mcp.americandefault.org），由 americandefault.org 發布；無需登入；Streamable HTTP；6 個工具。

暫無 AI 概覽：以下資訊來自註冊中心條目和服務本身。

發布者
americandefault.org
端點
mcp.americandefault.org
最近檢查

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 American Default Research，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/org.americandefault%2Fresearch/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

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.

Anonymous access allows 10 calls per minute and 60 per hour per IP block. Higher-volume users can request an issued key through the public documentation. The static JSON endpoints are the suitable route for permitted bulk downloads. HTTP clients reading the website or its JSON endpoints should send a descriptive User-Agent identifying their application. Cloudflare Pages may reject a library's default identity with error 1010; a descriptive application name works without impersonating a browser. The hosted MCP transport is a separate endpoint.

Domain discovery

The main domain advertises the connector at https://americandefault.org/.well-known/ai-catalog.json. Its entry points to https://mcp.americandefault.org/mcp/server-card, using the experimental MCP Server Card format. This format describes identity and connection details; tools remain discoverable through the MCP protocol.

For clients using Cloudflare's earlier discovery convention, both domains serve /.well-known/mcp/server-card.json. That compatibility card includes the exact tool descriptions and input schemas returned by the running SDK. The main-domain route proxies only this public metadata from the MCP host, without forwarding cookies or authorization. Cards support CORS, HEAD and conditional ETag requests. The registry metadata supplies the same name and version used at initialization. Discovery metadata does not grant access or guarantee agent recommendations.

Research examples

  • Find indicators about mortgage delinquency, then retrieve the latest reading with its period and source.
  • Retrieve King County, Washington's county distress scorecard using FIPS 53033.
  • Retrieve the latest American Distress Index, its domains, and its historical reading. The index describes conditions and does not forecast outcomes.

Tools

ToolInputResult
search_indicatorsquery, optional limit (maximum 50)Matching indicators and public page links
get_indicator_v2slug, response_version: "v2"Latest reading, sources, citations, freshness and comparison warnings
get_indicatorslugLegacy v1 reading and citations
get_county_scorecardCounty fipsScore, domains, findings, dates and citations
get_adi_compositeNoneLatest published quarter, domains and historical context
get_cross_correlationsIndicator slugValidated research relationships; empty results are normal

Prefer v2 when comparing indicators. A series break or a suppressed trend means readings may not be comparable. Historical indicators are not presented as current. Full histories, where available, are at https://americandefault.org/api/indicators/{slug}.json.

Source and installation

This public repository is a source reference for the hosted connector. The production service also uses shared formatting, index metadata and public data files maintained separately. Cloning this repository alone does not provide a complete local data installation. Connect to the hosted endpoint above for normal use; no local process, API key or data download is needed.

For Cursor, add this to the client's MCP server configuration:

json
{  "mcpServers": {    "american-default-research": {      "url": "https://mcp.americandefault.org/mcp"    }  }}

For Cline, set the transport explicitly in cline_mcp_settings.json:

json
{  "mcpServers": {    "american-default-research": {      "type": "streamableHttp",      "url": "https://mcp.americandefault.org/mcp"    }  }}

All six tools are read-only. Invalid slugs or county codes return errors rather than fabricated results. The hosted HTTP health endpoint is /up.

Attribution and privacy

Our analysis is free to use with attribution to American Default Research. Source data stays under each publisher's terms; cite the source named here. These research tools do not need conversation history, account credentials, private documents, or personal financial details. Request bodies and bearer credentials must not be logged. The site's privacy policy is https://americandefault.org/privacy/.

Directory listing

[American Default Research on AllMCPs]

來源：README.md，提交 98273ee

工具

6

get_indicator

Get indicator

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-rate', 'initial-unemployment-claims-sa'.

輸入參數slug必填

get_indicator_v2

Get indicator (v2)

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.

輸入參數slug必填response_version必填

get_county_scorecard

Get county scorecard

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 the top and bottom 100, where the site prints it), 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.

輸入參數fips必填

get_adi_composite

Get ADI composite

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 reading of the inputs, and the five-domain breakdown (Delinquency, Default & Legal, Debt Burden, Labor, Safety Net & Buffer) with domain scores and member component percentiles. Updated quarterly.

無需輸入參數。

search_indicators

Search indicators

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

輸入參數limitquery必填

get_cross_correlations

Get cross-correlations

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 121 indicators return empty lists; only a handful of pairs clear the full gauntlet.

輸入參數slug必填

版本歷史

2
  1. v1.1.1最新Nov 3, 2026
  2. v1.0.1Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。