LienDeadline MCP server

liendeadline-mcp

MCP server for US mechanics lien and preliminary notice deadlines, built on the LienDeadline API.

Give it a supplier's delivery dates and project facts, and it returns the preliminary notice and lien filing deadlines with their statute sources and warnings.

Coverage

supplier rules have been reviewed so far. No key needed. For other states, public projects, or when a relevant Florida payment/termination or Kansas extension answer is missing or unknown, the affected deadline is review_required (needs legal review) instead of a guessed date.

• Lien guides: all 50 states and DC. No key needed.
• Calculated supplier deadlines: Florida and Kansas private projects, the states whose

• Customer invoice calculation: 51 jurisdictions, with a LienDeadline customer API key.

Tools

Every tool is read-only: none of them sends notices, files liens or makes payments.

Install

Requires Node.js 22 or newer. The server runs locally over stdio. The package ships npm-shrinkwrap.json, so npx installs the exact dependency versions each release was tested with. It is listed in the official MCP Registry as io.github.LienDeadline/liendeadline-mcp.

Claude Desktop: download liendeadline-mcp-.mcpb from the latest release and open it.

Claude Code:

claude mcp add liendeadline -- npx -y liendeadline-mcp

Claude Desktop, Cursor, Windsurf and other clients that use an mcpServers JSON config:

{
  "mcpServers": {
    "liendeadline": {
      "command": "npx",
      "args": ["-y", "liendeadline-mcp"]
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "liendeadline": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "liendeadline-mcp"]
    }
  }
}

OpenAI Codex CLI:

codex mcp add liendeadline -- npx -y liendeadline-mcp

For agent instructions that pair with these tools, see the LienDeadline agent skill, which is also packaged as a Claude Code plugin that installs this server.

Example

calculatesupplierdeadlines with a Florida commercial project where a subcontractor ordered the materials, deliveries ran from 2026-08-03 to 2026-09-10, and the owner confirms neither final payment nor termination occurred:

Shortened. The full README is on GitHub.