Repository avatar
Search & Data Extraction
v0.1.0
active

noticewire

io.github.CloudCorpRecords/noticewire

ABC and receivership legal-notice feed, notice archive search and WARN plant-closure events.

Documentation

noticewire

When a business winds down, the first public trace is often a legal notice, not a press release. noticewire is a local forwarding client for the hosted Distress ABC MCP service: it answers tools/list locally from the captured tool definitions and forwards every call to the service, returning the answers exactly as the service sends them back.

The three tools here are the free reads over published legal-notice and public-report data. One is a live feed of state assignment-for-benefit-of-creditors (ABC) and receivership notices. One searches the wind-down notice archive by keyword. One lists recent WARN-Act plant-closure and mass-layoff events. No person is screened or scored, nothing is sent anywhere, and no payment exists anywhere in this surface.

Labelled subset: 3 of 5 captured tools

The upstream capture enumerates 5 tools. Two are deliberately not built, served, registered or offered anywhere in this package:

  • abc_asset_map — omitted. Its own captured description prices the full map at $0.50 USDC via x402 pay-per-call; only a free preview is free.
  • warn_liquidation_map — omitted. Same x402 pricing: the full map settles $0.50 USDC; only a free preview is free.

A pay-per-call tool is not built. The three kept tools form an independently useful free core on their own.

The tools

  • abc_distress_feed — The live feed of state ABC and receivership public legal notices: notice type, the distressed entity where parseable, case number, claim/sale date and link. Optional limit (default 40). No required parameters.
  • abc_find_notices — Keyword search over the wind-down legal-notice archive: a notice type, a legal phrase such as "assignment for benefit of creditors", or a company name. keyword is required; optional limit (default 15).
  • warn_plant_deaths — Recent WARN-Act plant-death events (mass layoffs and plant closures) from public reports, each with whether the employer has a live Colorado UCC collateral map and honest nulls where collateral is in a state not yet covered. Optional limit (default 25). No required parameters.

Install and run

As an MCP server via npm:

npx -y @reneturcios/noticewire mcp

MCP client configuration:

{
  "mcpServers": {
    "noticewire": {
      "command": "npx",
      "args": ["-y", "@reneturcios/noticewire", "mcp"]
    }
  }
}

As a container:

docker run -i ghcr.io/cloudcorprecords/noticewire
docker run --rm ghcr.io/cloudcorprecords/noticewire abc_distress_feed '{}'

CLI

One binary serves both the command line and the MCP server. Each tool is a subcommand taking a single JSON string with that tool's arguments:

noticewire abc_distress_feed '{"limit":10}'
noticewire abc_find_notices '{"keyword":"receivership"}'
noticewire warn_plant_deaths '{}'
noticewire --version

Exit codes: 0 when the forwarded call succeeds, 1 when the upstream result is an error, and 2 for usage problems such as an unknown subcommand or a malformed JSON argument.

Configuration

  • DISTRESSABC_MCP_URL — Overrides the upstream endpoint. The default is the pinned hosted endpoint, https://abc.dropwatchhq.com/mcp. (The override variable is a reconstruction added by this rebuild.)

The upstream registry record declares no headers, so no authentication header is ever sent; the tool surface was captured keyless.

Upstream failures — a JSON-RPC error from the service, a non-2xx response, an unreadable body, or a request that fails outright — are reported to the caller as an error result whose text starts with noticewire error:.

How forwarding works

The first forwarded call opens a session: an initialize request (protocol version 2025-03-26), followed by a notifications/initialized notification, then the tools/call itself. If the service answers the initialize request with an Mcp-Session-Id header, that value is carried on every later request, and the open session is reused for the rest of the process. Replies are accepted either as plain JSON or as server-sent events. Successful results pass through verbatim, including any isError flag and any extra fields the service includes.

Development

npm install
npm run build   # tsc -> dist/ (dist/cli.js is the bin)
npm test        # tsx --test test/*.test.ts — stubbed upstream, no network
npm run dev     # run the CLI from source

The test suite checks the served tool list against the captured subset (all 3 kept tools, deep-equal, in order, with no titles invented and no required key added to the two tools that carry none), asserts the two omitted x402 tools are absent at registry, MCP-layer and CLI level, exercises the session handshake and its reuse, verifies that no Authorization header is ever sent under any environment, and verifies that arguments go upstream untouched and results come back untouched.

License

MIT — see LICENSE. Copyright (c) 2026 Rene Turcios.

NPM
@reneturcios/noticewire
Install Command
npm install @reneturcios/noticewire
Runtime: npx
OCI
ghcr.io/cloudcorprecords/noticewire:0.1.0
Install Command
docker pull ghcr.io/cloudcorprecords/noticewire:0.1.0:undefined
Runtime: docker