American Default Research MCP Server

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

Tools

Last Updated

Jun 14, 2026

What is the American Default Research MCP Server?

The American Default Research MCP server gives AI agents structured, permission-aware access to American Default Research through the Model Context Protocol. With 5 pre-built actions, agents can read, create, and update American Default Research data on behalf of authorized users.

Willow ships the American Default Research MCP server as part of an enterprise control plane. Every call runs behind SSO (Okta, Azure AD), enforces RBAC and least-privilege at runtime, writes to a full audit trail, and integrates with Splunk and Loki for SIEM visibility. Connect from Claude Desktop, Claude Code, Cursor, ChatGPT, VS Code, n8n, or any custom agent. Install once, distribute org-wide, and see exactly how American Default Research is being used by every AI agent in your stack.

Tools

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

get_county_scorecard

Fetch a county's County Distress Index (CDI) scorecard by 5-digit FIPS code. Returns composite score (0-100), zone (Healthy / Normal / Elevated / Serious / Crisis), national + state rank, 5-domain breakdown (Consumer Credit Distress, Housing Cost Burden, Structural Poverty, Economic Vitality, Legal Distress), key findings, and pre-baked APA / MLA / Chicago / news-copy citations. Accepts 4-digit FIPS with implicit leading zero. 3,144 counties available.

get_adi_composite

Fetch the latest quarterly reading of the American Distress Index (ADI) composite. Returns composite score (0-100), zone, composite Z-score, and the 5-component breakdown (Buffer, Debt Stress, Financial Conditions, Cost Pressure, Labor) with Z-scores and point contributions. Updated quarterly.

search_indicators

Search the 96-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`.

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 96 indicators return empty lists; currently six pairs clear the full gauntlet.

Customize Tools

Edit descriptions, modify arguments, select tools, or add new ones

Set Up Your American Default Research MCP Server in Minutes

Add the following configuration to your MCP client. Authentication is handled via OAuth. Compatible with Claude Desktop, Claude Code, Cursor, ChatGPT, VS Code, n8n, and any MCP-compatible agent.

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "willow-american-default-research": {
      "type": "http",
      "url": "https://<org>.mcp-s.com/mcp/mcp/american-default-research"
    }
  }
}

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "willow-american-default-research": {
      "type": "http",
      "url": "https://<org>.mcp-s.com/mcp/mcp/american-default-research"
    }
  }
}

Claude Code

CLI

claude mcp add willow-american-default-research --transport http https://<org>.mcp-s.com/mcp/mcp/american-default-research

n8n

HTTP Request Node

{
  "url": "https://<org>.mcp-s.com/mcp/mcp/american-default-research",
  "method": "POST"
}

Or click "Install with Willow" above to set up automatically with SSO and RBAC preconfigured.

Enterprise Governance for American Default Research

Willow adds the layer American Default Research and every other SaaS doesn't ship out of the box: every call runs behind SSO (Okta, Azure AD), enforces RBAC and least-privilege at runtime, writes to full audit logs, and detects shadow AI usage across your stack. One MCP gateway. Any agent. Every tool.

American Default Research MCP Server FAQ

What is the American Default Research MCP server?

The American Default Research MCP server is a Model Context Protocol implementation that lets AI agents like Claude, Cursor, and ChatGPT read and write American Default Research data through a standardized interface. Willow hosts and governs this server so enterprises can roll it out without a security review backlog.

How is Willow's American Default Research MCP server different from the official one?

The official American Default Research MCP server is scoped to a single user's account and does not include enterprise governance. Willow's version adds SSO, RBAC, audit logging, shadow AI detection, and centralized control over which actions agents can take across the entire org.

Which AI clients work with the American Default Research MCP server?

Claude Desktop, Claude Code, Cursor, ChatGPT, VS Code with MCP support, n8n, and any custom agent built with OpenAI Agents SDK, LangChain, Vercel AI SDK, or Anthropic SDK.

Is the American Default Research MCP server secure? How does Willow handle authentication?

Every call runs behind your existing SSO (Okta, Azure AD). Per-user OAuth scopes the agent to exactly what that user can do in American Default Research, nothing more. No credentials reach the LLM. Every action writes to an audit trail.

Can I limit which American Default Research actions agents can take?

Yes. Willow lets you scope agents to specific actions, specific projects, or specific environments. Toggle actions on or off in the dashboard, or enforce policy via infrastructure-as-code through GitHub.

How do I detect shadow American Default Research MCP servers in my org?

Willow's browser extension and discovery service surface unmanaged MCP servers, skills, and AI agents across the org. If a developer installed an unapproved American Default Research MCP locally, you'll see it.

What does the American Default Research MCP server cost?

Pricing depends on org size and deployment model (SaaS, dedicated cloud, self-host). See withwillow.ai/pricing or contact sales for a quote.

How do I install the American Default Research MCP server with Willow?

Install via the Willow Connect Panel in one click, or paste the JSON snippet above into your Claude Desktop, Cursor, or Claude Code config. SSO and RBAC inherit from your existing Willow setup.