MCP Server

LienDeadline

io.github.LienDeadline/liendeadline-mcp
Legal & Compliance Public & reachable MCP 2025-11-25

What this MCP does

Provides state mechanics-lien guidance and calculates supplier preliminary-notice and lien-filing deadlines where supported.

calculate_supplier_deadlines
Calculate supplier notice and lien deadlines
Calculates a construction material supplier's preliminary notice and lien filing deadlines from delivery events (contract supplier-events-v2), for questions that need deadline dates. Reviewed baselines cover Florida and Kansas private projects; other states and public projects return review_required, which is a valid result, not an error. How the parameters depend on each other: last_delivery_date is required when deliveries_complete is true. Florida (FL) takes florida_final_payment_status and florida_termination_status; Kansas (KS) takes kansas_extension_status; these are rejected for other states. Each takes yes, no or unknown: an omitted or unknown answer keeps the affected deadline under review, and a blanket review flag is not accepted. A Florida event date is accepted only with the matching yes answer. Delivery dates are furnishing dates, not invoice dates. Returns JSON with an overall status (calculated or review_required), preliminary_notice and lien_filing (each with its own status: calculated, not_required, review_required or awaiting_final_delivery, plus deadline, days_from_now, description and statute source_url), critical_warnings, statute_citations, an exact echo of the submitted inputs and a disclaimer. Invalid or contradictory facts return an error naming the field before any API call. Public, stateless and read-only: no key needed, nothing is stored, and no notice is sent or lien filed. Not legal advice.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['state', 'first_delivery_date', 'project_type', 'hired_by', 'deliveries_complete'], 'properties': {'state': {'type': 'string', 'pattern': '^[A-Za-z]{2}$', 'description': 'Two-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_by': {'enum': ['owner', 'contractor', 'subcontractor'], 'type': 'string', 'description': 'Who ordered the materials from the supplier: the owner, a contractor or a subcontractor.'}, 'project_type': {'enum': ['commercial', 'residential', 'public'], 'type': 'string', 'description': 'Private commercial, private residential, or public (public projects always need review).'}, 'last_delivery_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Date of the final delivery, YYYY-MM-DD, not earlier than first_delivery_date. Required when deliveries_complete is true.'}, 'deliveries_complete': {'type': 'boolean', 'description': 'true 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_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Date materials were first delivered (first furnishing), YYYY-MM-DD. Not an invoice date.'}, 'kansas_extension_status': {'enum': ['yes', 'no', 'unknown'], 'type': 'string', 'description': 'Kansas only: was a statutory lien-period extension filed and mailed? no permits the ordinary lien baseline; yes, unknown or omitted requires qualified review.'}, 'florida_termination_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Florida 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_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Florida only: owner final-payment date, YYYY-MM-DD, not earlier than first_delivery_date. Supply only with florida_final_payment_status=yes.'}, 'florida_termination_status': {'enum': ['yes', 'no', 'unknown'], 'type': 'string', 'description': 'Florida only: was the original contract or notice of commencement terminated? no permits the lien baseline; yes, unknown or omitted requires qualified lien review.'}, 'florida_final_payment_status': {'enum': ['yes', 'no', 'unknown'], 'type': 'string', 'description': 'Florida only: did the owner make final payment to the contractor? unknown when not verified; omitted or unknown keeps the notice under review, and yes needs florida_final_payment_date for a notice baseline.'}}}
get_state_lien_guide
Get the lien guide for one state
Returns LienDeadline's editorial mechanics lien and preliminary notice guide for one state or DC: rules (rule summary with statute citations), deadline_rows (deadline table), faqs (common questions) and source_url (the guide's web page), roughly 4 KB of JSON. For questions about how a state's lien or notice rules work, why a deadline falls where it does, or which statute applies. An unknown state code returns an error. The guide is an editorial reference, not a calculation: its day counts are summaries, not computed deadlines. Public and read-only; no key needed.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['state'], 'properties': {'state': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'Two-letter US state or DC code, e.g. "TX"; case-insensitive.'}}}
list_state_lien_guides
List all state guides
Lists every published state lien guide in one response, without pagination: count plus state_code, title and slug for all 50 states and DC, in alphabetical order by state name. It lists editorial guides only and does not indicate which states have calculated deadlines. Takes no parameters. Public and read-only; no key needed.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Added
list_state_lien_guides
Oct. 5, 2026, 2:40 a.m.
Added
get_state_lien_guide
Oct. 5, 2026, 2:40 a.m.
Added
calculate_supplier_deadlines
Oct. 5, 2026, 2:40 a.m.