
Statute-cited lien and notice deadlines for material suppliers; lien guides for 50 states and DC.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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. Available 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. The Florida final-payment answer holds the notice for suppliers not hired by the owner. 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. Requires a customer key and consumes one plan calculation unit. No project is saved, notice sent or lien filed. Not legal advice.
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.
Who ordered the materials from the supplier: the owner, a contractor or a subcontractor.
Private commercial, private residential, or public (public projects always need review).
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.
Date materials were first delivered (first furnishing), YYYY-MM-DD. Not an invoice date.
Date of the final delivery, YYYY-MM-DD, not earlier than first_delivery_date. Required when deliveries_complete is true.
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 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 only: owner final-payment date, YYYY-MM-DD, not earlier than first_delivery_date. Supply only with florida_final_payment_status=yes.
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 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.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
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. Available 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. The Florida final-payment answer holds the notice for suppliers not hired by the owner. 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. Requires a customer key and consumes one plan calculation unit. No project is saved, notice sent or lien filed. Not legal advice.
| Argument | Type | Description |
|---|---|---|
| state* | string | 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* | string | Who ordered the materials from the supplier: the owner, a contractor or a subcontractor. |
| project_type* | string | Private commercial, private residential, or public (public projects always need review). |
| last_delivery_date | string | Date of the final delivery, YYYY-MM-DD, not earlier than first_delivery_date. Required when deliveries_complete is true. |
| deliveries_complete* | boolean | 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* | string | Date materials were first delivered (first furnishing), YYYY-MM-DD. Not an invoice date. |
| kansas_extension_status | string | 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 | string | 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 | string | 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 | string | 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 | string | Florida 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. |
{
"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. For suppliers not hired by the owner, unknown, omitted, or yes without florida_final_payment_date makes preliminary notice review_required."
}
}
}Evaluates supplier-events-v3 project facts against the exact discovered rule and question identities. Returns independent notice and lien outcomes with sources and an exact nested input echo. When RI discovery asks ri_mailed_within_200_days after ri_mailed=yes, confirm whether mailing occurred within 200 days of first delivery. No, Unknown or omitted confirmation requires review; recording alone does not establish a 40-day target. Only calculated outcomes contain calculated deadline dates. Report every candidate_deadlines entry with its ID, date and sources under the API explanation. For NH review fallbacks, first_furnishing is a conservative checkpoint and final_furnishing is informational pending contract grouping and qualifying completion; passing the first checkpoint does not itself establish expiry. A calculated contract_completion outcome uses only the returned deadline, without substituting the first checkpoint or recomputing a date. Review candidates do not establish filing deadlines, completion or scheduled reminders. An optional preliminary_notice.notice_duties collection contains independently required named notices, each with its own calculated date, explanation and sources; the legacy preliminary date is only their earliest summary. Report every validated duty without inferring duties from candidates or treating one notice as satisfying all duties. A separate optional preliminary_notice.planned_notice_targets collection contains qualified intent planning targets with their target dates, assumed filing dates, full ten- or thirty-day intervals, explanations and sources. Planning targets do not establish statutory expirations, actual filing, notice completion or scheduled notifications. An optional verified action_by is a Conservative action date planning target under qualified review; the statutory deadline and countdown remain unresolved, with explanation, sources and warnings. Optional recurring_notice_facts supplies actual Tennessee furnished months or New Hampshire account records. Tennessee recurring_notice_periods cover entered periods only, including paid and unknown states; known unpaid duties remain independent. New Hampshire recurring_notice_checkpoints are advisory check-ins with unresolved legal status, not legal deadlines, service, completion or scheduled reminders; they do not reset earlier gaps. Never infer intervening months or blanket completion. Stale identities return 409, unavailable reviewed sources return 503. Requires a customer key and consumes one plan calculation unit. No project is saved, notice sent or lien filed.
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.
| Argument | Type | Description |
|---|---|---|
| state* | string | Two-letter US state or DC code, e.g. "TX"; case-insensitive. |
{
"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."
}
}
}Returns the current supplier-events-v3 scope support, jurisdiction-specific yes/no/unknown event questions, date policies, optional recurring_notice_intake descriptor, sources and exact rule/question identities for a material supplier. Requires a customer key; no delivery dates needed. Discovery does not consume calculation quota. A 503 means the reviewed source is unavailable. Approval of research alone does not activate a scope.
| Argument | Type | Description |
|---|---|---|
| state* | string | Project jurisdiction: state or DC. |
| hired_by* | string | |
| project_type* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"state",
"project_type",
"hired_by"
],
"properties": {
"state": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Project jurisdiction: state or DC."
},
"hired_by": {
"enum": [
"owner",
"contractor",
"subcontractor"
],
"type": "string"
},
"project_type": {
"enum": [
"commercial",
"residential",
"public"
],
"type": "string"
}
}
}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.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}| Argument | Type | Description |
|---|
| state* | string | Project jurisdiction: state or DC. |
| events* | object | Discovered event IDs only; missing means unknown. Date only for yes and only where the question permits it. Invoice dates are not furnishing dates. |
| hired_by* | string | |
| project_type* | string | |
| rules_source* | object | Exact rules_source from discovery for this scope. |
| questions_identity* | object | Exact questions_identity from discovery. |
| recurring_notice_facts | any | Only when discovery returns a matching recurring_notice_intake descriptor. Actual recurring facts only: Tennessee entered furnished months with unpaid and retainage-only answers, or New Hampshire actual written accounts with coverage and supplied dates. Omission retains legacy behavior; unknown answers require review. Do not infer intervening months or actual notice from a plan. NH actual owner notice belongs in the discovered nh_owner_notice_given event. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"state",
"project_type",
"hired_by",
"rules_source",
"questions_identity",
"events"
],
"properties": {
"state": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Project jurisdiction: state or DC."
},
"events": {
"type": "object",
"description": "Discovered event IDs only; missing means unknown. Date only for yes and only where the question permits it. Invoice dates are not furnishing dates.",
"propertyNames": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,79}$"
},
"additionalProperties": {
"type": "object",
"required": [
"answer"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"answer": {
"enum": [
"yes",
"no",
"unknown"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"hired_by": {
"enum": [
"owner",
"contractor",
"subcontractor"
],
"type": "string"
},
"project_type": {
"enum": [
"commercial",
"residential",
"public"
],
"type": "string"
},
"rules_source": {
"type": "object",
"required": [
"schema_version",
"source_version",
"source_hash",
"reviewed_commit",
"supplier_engine_version",
"implementation_manifest_hash"
],
"properties": {
"source_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"schema_version": {
"enum": [
"state-rules-v1",
"state-rules-v2"
],
"type": "string"
},
"source_version": {
"type": "string"
},
"reviewed_commit": {
"type": "string",
"pattern": "^[0-9a-f]{40}$"
},
"supplier_engine_version": {
"type": "string"
},
"implementation_manifest_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
}
},
"description": "Exact rules_source from discovery for this scope.",
"additionalProperties": false
},
"questions_identity": {
"type": "object",
"required": [
"questions_version",
"question_set_hash"
],
"properties": {
"question_set_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"questions_version": {
"type": "string",
"const": "supplier-questions-v1"
}
},
"description": "Exact questions_identity from discovery.",
"additionalProperties": false
},
"recurring_notice_facts": {
"oneOf": [
{
"type": "object",
"required": [
"version",
"kind",
"months"
],
"properties": {
"kind": {
"type": "string",
"const": "tn_monthly_nonpayment"
},
"months": {
"type": "array",
"items": {
"type": "object",
"required": [
"month",
"unpaid",
"retainage_only"
],
"properties": {
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
},
"unpaid": {
"enum": [
"yes",
"no",
"unknown"
],
"type": "string"
},
"retainage_only": {
"enum": [
"yes",
"no",
"unknown"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 1
},
"version": {
"type": "string",
"const": "supplier-recurring-facts-v1"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"version",
"kind",
"accounts"
],
"properties": {
"kind": {
"type": "string",
"const": "nh_written_account"
},
"version": {
"type": "string",
"const": "supplier-recurring-facts-v1"
},
"accounts": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"covered_through",
"supplied_date"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,79}$"
},
"supplied_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"covered_through": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"additionalProperties": false
},
"maxItems": 16
}
},
"additionalProperties": false
}
],
"description": "Only when discovery returns a matching recurring_notice_intake descriptor. Actual recurring facts only: Tennessee entered furnished months with unpaid and retainage-only answers, or New Hampshire actual written accounts with coverage and supplied dates. Omission retains legacy behavior; unknown answers require review. Do not infer intervening months or actual notice from a plan. NH actual owner notice belongs in the discovered nh_owner_notice_given event."
}
}
}