WARN Firehose — Labor Market Intelligence

Official12 toolsLive

by sendkamal

WARN layoffs, H-1B/LCA visas, SEC 8-K, bankruptcies, DOL claims & JOLTS for all 50 US states.

io.github.sendkamal/warn-firehose (MCP Server)

The io.github.sendkamal/warn-firehose MCP server provides information focused on WARN layoffs, H-1B/LCA visas, SEC 8-K disclosures, bankruptcies, and DOL claims and JOLTS coverage across all 50 US states. It is organized as a toolset with 12 tools for querying this topic set.

🛠️ Key Features

WARN layoffs monitoring
H-1B and LCA visas
SEC 8-K coverage
Bankruptcies
DOL claims and JOLTS for all 50 US states
12 available tools

🚀 Use Cases

Tracking WARN-related layoffs
Investigating visa-related signals (H-1B/LCA)
Reviewing SEC 8-K items
Monitoring bankruptcies
Checking DOL claims and JOLTS trends by state

⚡ Developer Benefits

Topic-focused dataset spanning multiple regulatory and market areas
Consistent coverage across all 50 US states
Tool-based integration with 12 tools

Captured live from the server via tools/list.

authenticate

Authenticate with your WARN Firehose API key. Returns your tier and access level. Args: api_key: Your WARN Firehose API key (starts with wf_)

Parameters1

api_key

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "title": "Api Key",
      "type": "string"
    }
  },
  "required": [
    "api_key"
  ],
  "title": "authenticateArguments"
}

get_pricing

Return WARN Firehose pricing tiers, included tools, and signup URLs. Use this when the user asks about pricing, hits a rate limit, or wants to upgrade. Returns tier prices, daily call limits, included datasets, and direct signup links so the user can act immediately.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "get_pricingArguments"
}

search_layoffs

Search WARN Act layoff notices by company name, city, or keyword. Args: query: Search term (company name, city, etc.) state: Optional 2-letter state code to filter (e.g. CA, TX, NY) limit: Max results to return (default 20, max 100) api_key: Optional API key for higher rate limits

Parameters4

query	string	required
state	any	optional
limit	integer	optional
api_key	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_layoffsArguments"
}

get_state_summary

Get a summary of WARN Act layoff data for a specific US state. Args: state: Two-letter state code (e.g. CA, TX, NY, FL) api_key: Optional API key for higher rate limits

Parameters2

state	string	required
api_key	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "title": "State",
      "type": "string"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "required": [
    "state"
  ],
  "title": "get_state_summaryArguments"
}

get_recent_layoffs

Get the most recent WARN Act layoff notices. Args: days: Look back this many days (default 30) state: Optional state filter (2-letter code) limit: Max results (default 25, max 100) api_key: Optional API key for higher rate limits

Parameters4

days	integer	optional
state	any	optional
limit	integer	optional
api_key	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "default": 30,
      "title": "Days",
      "type": "integer"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "title": "get_recent_layoffsArguments"
}

get_stats

Get overall statistics about the WARN Firehose database.

Parameters1

api_key

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "title": "get_statsArguments"
}

get_company_layoffs

Get all WARN Act layoff notices for a specific company. Args: company: Company name to search for (partial match supported) api_key: Optional API key for higher rate limits

Parameters2

company	string	required
api_key	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "company": {
      "title": "Company",
      "type": "string"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "required": [
    "company"
  ],
  "title": "get_company_layoffsArguments"
}

get_talent_pipeline

Find available talent from recent layoffs, cross-referenced with LCA visa roles. Shows what occupations/skills each laid-off company was hiring for. Useful for recruiters targeting skilled workers from recently laid-off companies. Requires Starter tier or higher. Get your API key at warnfirehose.com/account Args: state: Optional 2-letter state code days: Look back this many days (default 90) limit: Max results (default 15, max 50) api_key: Your WARN Firehose API key (Starter tier required)

Parameters4

state	any	optional
days	integer	optional
limit	integer	optional
api_key	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "days": {
      "default": 90,
      "title": "Days",
      "type": "integer"
    },
    "limit": {
      "default": 15,
      "title": "Limit",
      "type": "integer"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "title": "get_talent_pipelineArguments"
}

get_risk_signal

Get companies ranked by composite distress signal across all datasets. Combines WARN layoff volume/recency, SEC restructuring filings, bankruptcy filings, and H-1B denial rates into a single risk score. Levels: Critical (7+), Elevated (4-6), Moderate (2-3), Low (1). Requires Starter tier or higher. Get your API key at warnfirehose.com/account Args: state: Optional 2-letter state code to filter min_score: Minimum risk score (default 3) limit: Max results (default 15, max 50) api_key: Your WARN Firehose API key (Starter tier required)

Parameters4

state	any	optional
min_score	integer	optional
limit	integer	optional
api_key	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "min_score": {
      "default": 3,
      "title": "Min Score",
      "type": "integer"
    },
    "limit": {
      "default": 15,
      "title": "Limit",
      "type": "integer"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "title": "get_risk_signalArguments"
}

get_market_pulse

Get a single-call market snapshot across all 6 datasets. Returns: WARN stats (30d trend), top industries, at-risk companies, LCA/H-1B counts, DOL claims, SEC filings, bankruptcies, JOLTS snapshot. Args: api_key: Optional API key for higher rate limits

Parameters1

api_key

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "title": "get_market_pulseArguments"
}

get_state_intelligence

Get a unified state profile combining all 6 datasets for a US state. Returns WARN notices, LCA petitions, H-1B approvals/denials, DOL claims, bankruptcy matches, JOLTS data, and a composite distress score. Requires Pro tier or higher. Get your API key at warnfirehose.com/account Args: state_code: Two-letter state abbreviation (e.g. CA, TX, NY) api_key: Your WARN Firehose API key (Pro tier required)

Parameters2

state_code	string	required
api_key	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "state_code": {
      "title": "State Code",
      "type": "string"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "required": [
    "state_code"
  ],
  "title": "get_state_intelligenceArguments"
}

export_records

Export WARN records in bulk. Requires Pro tier or higher. Returns up to 500 records with full field details. For CSV/Parquet downloads, use the REST API at /api/export/. Get your API key at warnfirehose.com/account Args: api_key: Your WARN Firehose API key (Pro tier required) state: Optional 2-letter state code filter company: Optional company name filter (partial match) days: Look back this many days (default 90, max 730) limit: Max records to return (default 100, max 500)

Parameters5

api_key	string	required
state	any	optional
company	any	optional
days	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "title": "Api Key",
      "type": "string"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "company": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company"
    },
    "days": {
      "default": 90,
      "title": "Days",
      "type": "integer"
    },
    "limit": {
      "default": 100,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "api_key"
  ],
  "title": "export_recordsArguments"
}

Install

Tools (12)

authenticateget_pricingsearch_layoffsget_state_summaryget_recent_layoffsget_statsget_company_layoffsget_talent_pipeline

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://warnfirehose.com/mcp/

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "warn-firehose": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://warnfirehose.com/mcp/"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.sendkamal/warn-firehose (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

authenticate

get_pricing

search_layoffs

get_state_summary

get_recent_layoffs

get_stats

get_company_layoffs

get_talent_pipeline

get_risk_signal

get_market_pulse

get_state_intelligence

export_records

Install

Remote endpoint

Related servers