Warn Firehose

by sendkamal

154 downloads

Not rated

GitHub

Other

About

Six unified labor market datasets via MCP. Search WARN Act layoffs (all 50 US states), H-1B/LCA visa petitions, SEC 8-K restructuring filings, bankruptcy cases, DOL unemployment claims, and JOLTS labor turnover. 10 tools including company risk scoring, talent pipeline analysis,

Details

Author: sendkamal
Downloads: 154
Categories: Other

- Unified access to six labor market datasets.
- 10 built‑in tools (risk scoring, pipeline analysis, etc.).
- Covers all 50 US states for WARN Act layoffs.
- Combines visa petitions, restructuring filings, and bankruptcy cases.
- Includes DOL unemployment claims and JOLTS labor turnover.
- Free tier: 25 calls per day, no key required.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Warn Firehose

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Use Warn Firehose as a standard MCP server. No installation steps or specific commands are detailed in the README; the server is consumed via any MCP client. A free tier is available (25 calls per day, no authentication key needed) – simply connect and start querying the six datasets.

`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_)

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

`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

`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

`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

`get_stats`

Get overall statistics about the WARN Firehose database.

`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

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

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

`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

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

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

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

Claude Desktop / Cursor

McpServers

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

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