mcpField
L
LienDeadline

LienDeadline

Remote
liendeadline.comLegal & Government1Updated today

About LienDeadline

LienDeadline is an MCP server for US construction material suppliers that calculates preliminary-notice and mechanics-lien deadlines from job facts, with citations to the governing statutes. It also provides lien guides for every state and DC, and flags unsupported or incomplete cases for review rather than supplying a date.

Key features

  1. 01Notice and lien deadlines from delivery dates
  2. 02Statute citations for calculated dates
  3. 03Review flags for unsupported or incomplete cases
  4. 04Lien guides for all 50 states and DC
  5. 05Supplier questions for supported cases

Use cases

  1. 01Check notice deadlines for a supplier’s deliveries
  2. 02Verify lien filing dates against cited statutes
  3. 03Review lien rules for a particular state

MCP support

MCP clients can access hosted tools and public state guides at the server endpoint, or run the server locally. Supplier discovery and calculations require a customer key; public guide lookups do not.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://mcp.liendeadline.com/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Packages
npmliendeadline-mcp0.5.5

Tools

5
ParameterTypeRequiredDescription
statestringYesTwo-letter code of the state where the project is located, e.g. "FL", "KS", "TX"; any state or DC is accepted. Decides which event questions apply.
hired_byenumYesWho ordered the materials from the supplier: the owner, a contractor or a subcontractor.owner | contractor | subcontractor
project_typeenumYesPrivate commercial, private residential, or public (public projects always need review).commercial | residential | public
last_delivery_datestringNoDate of the final delivery, YYYY-MM-DD, not earlier than first_delivery_date. Required when deliveries_complete is true.
deliveries_completebooleanYestrue when the final delivery has happened (then last_delivery_date is required); false while deliveries are ongoing, which returns awaiting_final_delivery for the lien date.
first_delivery_datestringYesDate materials were first delivered (first furnishing), YYYY-MM-DD. Not an invoice date.
kansas_extension_statusenumNoKansas only: was a statutory lien-period extension filed and mailed? no permits the ordinary lien baseline; yes, unknown or omitted requires qualified review.yes | no | unknown
florida_termination_datestringNoFlorida only: contract or notice-of-commencement termination date, YYYY-MM-DD, not earlier than first_delivery_date. Supply only with florida_termination_status=yes; a lien date still requires qualified review.
florida_final_payment_datestringNoFlorida only: owner final-payment date, YYYY-MM-DD, not earlier than first_delivery_date. Supply only with florida_final_payment_status=yes.
florida_termination_statusenumNoFlorida only: was the original contract or notice of commencement terminated? no permits the lien baseline; yes, unknown or omitted requires qualified lien review.yes | no | unknown
florida_final_payment_statusenumNoFlorida only: did the owner make final payment to the contractor? unknown when not verified. For suppliers not hired by the owner, unknown, omitted, or yes without florida_final_payment_date makes preliminary notice review_required.yes | no | unknown

Details

From the project README

LienDeadline: mechanics lien and notice deadlines for AI assistants

Listed in Claude's Connectors directory Listed in the official MCP Registry npm version Glama score MIT license

LienDeadline MCP server

Ask your AI assistant when your preliminary notice and mechanics lien deadlines fall, and get the statute behind every date. This MCP server connects Claude, ChatGPT, Cursor, VS Code and any other MCP client to LienDeadline, the deadline engine for US construction material suppliers. There is nothing to install: add one URL.

Quick start · What you can ask · Coverage · Tools · Privacy · liendeadline.com

Why LienDeadline

Miss a preliminary notice or a lien filing deadline and a supplier can lose its lien rights on the job, and with them the leverage to get paid. The rules change with the state, the project type and who hired you. LienDeadline turns your delivery dates into those deadlines and shows its work.

  • Deadlines from delivery dates. Preliminary notice and lien filing deadlines from your first and last delivery and a few yes, no or unknown questions.
  • The statute behind every date. Each deadline cites its source, so your team and your counsel can check it.
  • Never a guessed date. Missing facts, states that aren't covered yet and public projects come back as "needs review", with the reason.
  • Lien guides for all 50 states and DC. Rule summaries, deadline tables and common questions, with statute citations.
  • Safe by design. Supplier discovery and calculations require a caller customer key; completed calculations consume plan allowance. Public guides need no account or key. Nothing sends notices, files liens or makes payments.

Quick start

Connecting to the hosted server and using public guides needs no install, account or key:

https://mcp.liendeadline.com/mcp

The no-authentication connection settings below cover the transport and public guides. Supplier discovery and calculations require the caller's dedicated customer key through the client's approved credential settings. Discovery does not consume calculation allowance; completed calculations do.

ClientHow to add it
Claude (web, desktop, mobile)Open LienDeadline in Claude's Connectors directory and connect it.
Claude Codeclaude mcp add --transport http liendeadline https://mcp.liendeadline.com/mcp
CursorInstall in Cursor
VS CodeInstall in VS Code
ChatGPTOpen Plugins, select + → Add custom MCP server, paste the URL above and choose No authentication.
Codex CLIcodex mcp add liendeadline --url https://mcp.liendeadline.com/mcp
Any MCP clientStreamable HTTP at the URL above, no authentication.

Want your agent to ask the right questions too? The LienDeadline agent skill (GitHub) teaches it which facts to collect. The Claude Code plugin adds the skill and this server in one step:

claude plugin marketplace add LienDeadline/skills
claude plugin install liendeadline@liendeadline
Run it locally instead (npm, stdio)

The local server needs Node.js 22.22 or newer and serves every tool, including the two customer API tools. It ships npm-shrinkwrap.json, so npx installs the exact dependency versions each release was tested with.

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

Claude Code:

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

Codex CLI:

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

Cursor, Windsurf and other mcpServers clients:

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

VS Code (.vscode/mcp.json):

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

What you can ask

A Florida supplier asks for its deadlines; LienDeadline returns the Notice to Owner deadline, Sep 17, 2026, under Fla. Stat. § 713.06(2)(a), and the claim of lien deadline, Dec 9, 2026, under Fla. Stat. § 713.08(5)

Try asking:

  • "We delivered to a Florida commercial job for a subcontractor from Aug 3 to Sep 10, 2026. No final payment, no termination. When are our notice and lien deadlines?"
  • "Same job, but I don't know whether the owner made final payment. What can you tell me?"
  • "Walk me through Texas mechanics lien rules for a material supplier and cite the statutes."
  • "Which states do you have lien guides for? Show me Georgia's."

Coverage

WhatWhereNeeds
Calculated supplier deadlinesFlorida and Kansas private projectsCustomer key; plan allowance for calculations
More states (v3 tools)Added as each state's reviewed rules are released. Until then, the v3 tools return an error and no date.Customer key; plan allowance for calculations
Lien guidesAll 50 states and DCNothing
Invoice-based deadlines51 jurisdictionsA customer API key

When LienDeadline can't calculate a date, because of a public project, a state that isn't covered or a fact you don't know, it returns review_required with the reason instead of a date.

How it works

  1. You ask your AI assistant about a job.
  2. The assistant calls LienDeadline's tools over MCP with the state, the dates and your answers.
  3. LienDeadline applies that state's rules and returns each deadline with its statute, or "needs review" with the reason.
  4. Before showing a supplier deadline, the server checks that the result echoes exactly the facts you sent. A mismatch is reported as an error, never as a date.

Tools

ToolWhat it doesKey
calculate_supplier_deadlinesPreliminary notice and lien filing deadlines from delivery dates and yes, no or unknown event answersCustomer
get_supplier_questionsWhether v3 covers a state, project type and hiring relationship, with its questions, sources and rule versionsCustomer
calculate_supplier_deadlines_v3Deadlines from the facts gathered with get_supplier_questionsCustomer
get_state_lien_guideOne state's lien guide: rules, statute citations, deadline table and FAQsNone
list_state_lien_guidesEvery guide (50 states and DC) with its code, title and slugNone
calculate_lien_deadlineInvoice-based deadlines (local server only)Customer
list_supported_statesJurisdictions the invoice calculation accepts (local server only)Customer

Inputs, outputs and statuses are in the tool reference.

Privacy and safety

  • Account usage. Supplier calculations require a customer key and consume plan allowance. Hosted callers send their own Authorization: Bearer <key> on each request; local callers set LIENDEADLINE_API_KEY. The hosted server never uses a service-wide key. State guides remain public.
  • What's sent. The facts you give (state, dates, project type, who hired you and your yes, no or unknown answers) go to the LienDeadline API to calculate. Guide lookups send only a state code.
  • Hosted server. Its logs record the method, status and response time of each request, never your inputs. Google Cloud's own request log also records the URL, client IP address and user agent. The server may count usage anonymously in PostHog: tool name, success, duration and client family, with no inputs, results or IP addresses.
  • Local server. It has no telemetry of its own.

Details: LienDeadline privacy policy.

Not legal advice

Results are educational baselines calculated from published state rules. Statutes change and every project is different, so verify critical deadlines with counsel before relying on them. LienDeadline is not a law firm and does not file anything on your behalf.

Links

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.