# io.github.APProj/warn-mcp (mcpb · warn-mcp.mcpb)

Search 61,345+ US WARN Act layoff notices: 48 states, back to 1988, rebuilt daily. No API key.

- Trust score: 43/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-21

## Components

- mcpb · `warn-mcp.mcpb`: 43/100 (this document), [markdown](https://verifymcp.io/servers/approj-warn-mcp/https-github-com-apventureengine-warn-mcp-releases-download-v0-2-4-warn-mcp-mcpb.md), [page](https://verifymcp.io/servers/approj-warn-mcp/https-github-com-apventureengine-warn-mcp-releases-download-v0-2-4-warn-mcp-mcpb)

## Channel facts

- Registry: `mcpb`
- Package: `https://github.com/APVentureEngine/warn-mcp/releases/download/v0.2.4/warn-mcp.mcpb`
- Version: `0.2.4`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-21.

- **Supply Chain Security**: 13/100
  - Malware scan not yet available for this package.
  - Known CVEs could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
  - No install/post-install scripts declared.
  - Dependency health could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 1 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 68/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1282 tokens (~213/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 6 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 7 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

- Download bundle: `https://github.com/APVentureEngine/warn-mcp/releases/download/v0.2.4/warn-mcp.mcpb`

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-20 (score 43)

First indexed and scored.

## MCP tools (6)

### `search_layoff_notices` (~290 tokens)

Search US WARN Act mass-layoff notices across 48 states, 1988 to today, by employer name, state, date range and minimum headcount (filters combine with AND; at least one is required). Returns matched_notices, matched_workers_affected and up to `limit` notices, newest notice_date first, each with id, state, company, location, employees_affected, notice_date, effective_date, notice_type and first_seen. Read-only, no key. For only the newest ~14 days use latest_layoff_notices; for one employer's whole record use employer_layoff_history.

Input parameters:

- `company` (string): Employer name, matched on WHOLE WORDS (case-insensitive), e.g. 'united airlines'. Every word you give must appear as a complete word in the filed name, so 'ford' will NOT return 'Stanford Health Care…
- `limit` (integer): Max notices returned, 1-200 (default 25).
- `min_employees` (integer): Only notices affecting at least this many workers.
- `since` (string): Earliest notice_date, YYYY-MM-DD.
- `state` (string): Two-letter state code, e.g. 'CA'.
- `until` (string): Latest notice_date, YYYY-MM-DD.

### `latest_layoff_notices` (~124 tokens)

The rolling feed of newly published WARN notices (the last ~14 days as the agencies posted them), newest notice_date first, optionally one state. Use this for 'what layoffs were announced recently'. Returns count_in_window plus up to `limit` notices in the same row shape as search_layoff_notices; for older dates or an employer filter use search_layoff_notices instead.

Input parameters:

- `limit` (integer): Max notices returned, 1-200 (default 25).
- `state` (string): Two-letter state code to filter to.

### `employer_layoff_history` (~197 tokens)

Every WARN notice one employer has filed, in any covered state, back to 1988: notice count, total workers affected, states, first and latest activity. Returns employers_matched, `employers` (up to 10 distinct canonical names, most workers affected first) and notices_for_best_match (up to `limit` notices of the top employer, newest notice_date first). For a date- or state-bounded question use search_layoff_notices.

Input parameters:

- `company` (string, required): Employer name, matched on WHOLE WORDS (case-insensitive), e.g. 'united airlines'. Every word you give must appear as a complete word in the filed name, so 'ford' will NOT return 'Stanford Health Care…
- `limit` (integer): Max individual notices returned, 1-200 (default 25).

### `state_layoff_totals` (~145 tokens)

Monthly WARN notice counts and workers affected. With no state, returns a national leaderboard by state in `series` (grouped_by=state, most workers affected first); with a state, the month-by-month `series` for it (grouped_by=month, oldest first). Optionally restrict to one four-digit year. `totals` carries overall notices and workers for the selection; notices without a published headcount count 0 workers. Aggregates only — use search_layoff_notices for the notices.

Input parameters:

- `state` (string): Two-letter state code.
- `year` (string): Four-digit year, e.g. '2026'.

### `agency_revisions` (~432 tokens)

Change log of the dataset itself: what differed between consecutive daily builds of the WARN notice table, since 2026-08-31. Each change is one of 'amended' (a tracked field of an existing notice changed — employees_affected, effective_date, location, notice_type, company, notice_date), 'row_absent' (a notice stopped appearing) or 'row_returned' (an absent notice came back). A change can come from the state agency amending or withdrawing a notice OR from an improvement to this project's parser; the log records the observation, never the cause, and cause_class labels only what is mechanically distinguishable (field_populated, field_cleared, format_only, value_changed, unknown). Filters combine with AND. Returns matched_changes, by_change_type, by_cause_class, log_covers_from/to, and up to `limit` changes newest observed_date first, each with id, state, company, notice_date, change_type, cause_class, field, old_value, new_value. Not a search for notices: use search_layoff_notices for notices and employer_layoff_history for one employer's full record.

Input parameters:

- `change_type` (string): Exactly one of 'amended', 'row_absent', 'row_returned'. Omit for all three.
- `company` (string): Employer name, matched on WHOLE WORDS (case-insensitive), e.g. 'united airlines'. Every word you give must appear as a complete word in the filed name, so 'ford' will NOT return 'Stanford Health Care…
- `limit` (integer): Max changes returned, 1-200 (default 25). matched_changes always reports the full count.
- `since` (string): Earliest observed_date (the build date on which the change was seen), YYYY-MM-DD. The log starts 2026-08-31; earlier dates return everything.
- `state` (string): Two-letter state code, e.g. 'CA'.

### `dataset_status` (~50 tokens)

Freshness and coverage of the dataset itself: when it was last rebuilt, which states are flagged stale, the license, and the raw endpoints. Call this before quoting a number so you can attribute it correctly.

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/approj-warn-mcp/https-github-com-apventureengine-warn-mcp-releases-download-v0-2-4-warn-mcp-mcpb#diagnostics

## Score history

- 2026-09-21: 43
- 2026-09-20: 43

## Common questions

### What is the io.github.APProj/warn-mcp server?

io.github.APProj/warn-mcp is listed in the public MCP registry as io.github.APProj/warn-mcp. Search 61,345+ US WARN Act layoff notices: 48 states, back to 1988, rebuilt daily. No API key. This page covers its MCPB bundle (https://github.com/APVentureEngine/warn-mcp/releases/download/v0.2.4/warn-mcp.mcpb).

### Is the io.github.APProj/warn-mcp server safe to use?

io.github.APProj/warn-mcp scores 43 out of 100 on VerifyMCP. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.APProj/warn-mcp server expose?

io.github.APProj/warn-mcp exposes 6 tools: search_layoff_notices, latest_layoff_notices, employer_layoff_history, state_layoff_totals, agency_revisions, dataset_status. Their descriptions and schemas cost roughly 1,238 tokens of context every time the server is loaded.

### What licence is the io.github.APProj/warn-mcp server under?

io.github.APProj/warn-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- Repository: https://github.com/APVentureEngine/warn-mcp
- Website: https://approjects-warn-act-notices.static.hf.space/
- Changelog RSS feed: https://verifymcp.io/servers/approj-warn-mcp/https-github-com-apventureengine-warn-mcp-releases-download-v0-2-4-warn-mcp-mcpb.xml
- Changelog JSON feed: https://verifymcp.io/servers/approj-warn-mcp/https-github-com-apventureengine-warn-mcp-releases-download-v0-2-4-warn-mcp-mcpb.json
- HTML version of this page: https://verifymcp.io/servers/approj-warn-mcp/https-github-com-apventureengine-warn-mcp-releases-download-v0-2-4-warn-mcp-mcpb