liendeadline-mcp
<a href="https://liendeadline.com/mcp?utm_source=github&utm_medium=readme&utm_campaign=liendeadline-mcp"><picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/LienDeadline/liendeadline-mcp/main/assets/readme/hero-dark.svg">
<img alt="LienDeadline: mechanics lien and notice deadlines for AI assistants" src="https://raw.githubusercontent.com/LienDeadline/liendeadline-mcp/main/assets/readme/hero-light.svg" width="100%">
</picture></a>
<p align="center">
<a href="https://claude.ai/directory/connectors/liendeadline"><img alt="Listed in Claude's Connectors directory" src="https://img.shields.io/badge/Claude-Connectors_directory-D97757"></a>
<a href="https://registry.modelcontextprotocol.io/?q=liendeadline"><img alt="Listed in the official MCP Registry" src="https://img.shields.io/badge/MCP_Registry-listed-205E4E"></a>
<a href="https://www.npmjs.com/package/liendeadline-mcp"><img alt="npm version" src="https://img.shields.io/npm/v/liendeadline-mcp?color=205E4E"></a>
<a href="https://glama.ai/mcp/servers/LienDeadline/liendeadline-mcp"><img alt="Glama score" src="https://glama.ai/mcp/servers/LienDeadline/liendeadline-mcp/badges/score.svg"></a>
<a href="https://github.com/LienDeadline/liendeadline-mcp/blob/main/LICENSE"><img alt="MIT license" src="https://img.shields.io/badge/license-MIT-blue"></a>
</p>
[](https://mcprush.com/to/liendeadline-mcp?ref=badge)
**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](https://liendeadline.com/?utm_source=github&utm_medium=readme&utm_campaign=liendeadline-mcp), the deadline engine for US construction material suppliers.
There is nothing to install: add one URL.
<p align="center">
<a href="#quick-start"><b>Quick start</b></a> ·
<a href="#what-you-can-ask">What you can ask</a> ·
<a href="#coverage">Coverage</a> ·
<a href="#tools">Tools</a> ·
<a href="#privacy-and-safety">Privacy</a> ·
<a href="https://liendeadline.com">liendeadline.com</a>
</p>
## 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.
- **Coverage for your exact project.** Check any US state or DC, project type, and hiring
relationship. For supported scopes, use the returned questions to confirm delivery dates and
other facts that can affect notice and lien deadlines.
- **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 and unsupported project scopes 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.
<a name="hosted-endpoint"></a>
## 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.
| Client | How to add it |
| --- | --- |
| **Claude** (web, desktop, mobile) | Open [LienDeadline in Claude's Connectors directory](https://claude.ai/directory/connectors/liendeadline) and connect it. |
| **Claude Code** | `claude mcp add --transport http liendeadline https://mcp.liendeadline.com/mcp` |
| **Cursor** | [](https://cursor.com/en/install-mcp?name=liendeadline&config=eyJ1cmwiOiJodHRwczovL21jcC5saWVuZGVhZGxpbmUuY29tL21jcCJ9) |
| **VS Code** | [](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522liendeadline%2522%252C%2522type%2522%253A%2522http%2522%252C%2522url%2522%253A%2522https%253A%252F%252Fmcp.liendeadline.com%252Fmcp%2522%257D) |
| **ChatGPT** | Open **Plugins**, select **+** → **Add custom MCP server**, paste the URL above and choose **No authentication**. |
| **Codex CLI** | `codex mcp add liendeadline --url https://mcp.liendeadline.com/mcp` |
| **Any MCP client** | Streamable HTTP at the URL above. Public guides need no authentication; supplier tools need a customer key. |
Want your agent to ask the right questions too? The
[LienDeadline agent skill](https://liendeadline.com/agent-skill?utm_source=github&utm_medium=readme&utm_campaign=liendeadline-mcp) ([GitHub](https://github.com/LienDeadline/skills)) teaches it which facts to collect.
The Claude Code plugin adds the skill and this server in one step:
```bash
claude plugin marketplace add LienDeadline/skills
claude plugin install liendeadline@liendeadline
```
<details>
<summary><b>Run it locally instead (npm, stdio)</b></summary>
The local server needs Node.js 22.22 or newer and serves every tool, including the two
[customer API tools](https://github.com/LienDeadline/liendeadline-mcp/blob/main/docs/CUSTOMER-API.md). 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](https://github.com/LienDeadline/liendeadline-mcp/releases/latest) and open it.
**Claude Code:**
```bash
claude mcp add liendeadline -- npx -y liendeadline-mcp
```
**Codex CLI:**
```bash
codex mcp add liendeadline -- npx -y liendeadline-mcp
```
**Cursor, Windsurf and other `mcpServers` clients:**
```json
{
"mcpServers": {
"liendeadline": { "command": "npx", "args": ["-y", "liendeadline-mcp"] }
}
}
```
**VS Code** (`.vscode/mcp.json`):
```json
{
"servers": {
"liendeadline": { "type": "stdio", "command": "npx", "args": ["-y", "liendeadline-mcp"] }
}
}
```
</details>
## What you can ask
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/LienDeadline/liendeadline-mcp/main/assets/readme/example-dark.svg">
<img alt="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)" src="https://raw.githubusercontent.com/LienDeadline/liendeadline-mcp/main/assets/readme/example-light.svg" width="100%">
</picture>
Try asking:
- "What facts do you need to check supplier deadlines for a Maryland commercial project where
the owner hired us directly?"
- "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
| What | Where | Needs |
| --- | --- | --- |
| Supplier discovery and calculations (v3) | Check any US state or DC with `get_supplier_questions`. Dates depend on the exact scope and confirmed facts. | Customer key. Discovery uses no calculation allowance. Completed calculations consume allowance. |
| Delivery-event baselines (v2) | Florida and Kansas private projects | Customer key; completed calculations consume allowance |
| Lien guides | All 50 states and DC | Nothing |
| Invoice-based deadlines | 51 jurisdictions | A [customer API key](https://github.com/LienDeadline/liendeadline-mcp/blob/main/docs/CUSTOMER-API.md) |
The [website calculator](https://liendeadline.com/calculator) and the v3 tools use the API's
current reviewed rules. Start with discovery for the exact project. Supported private scopes
can produce dates after the relevant facts are confirmed. Public projects and unsupported scopes
require qualified review. Unresolved facts can also leave individual deadlines under review.
An unavailable reviewed source returns an error.
## How it works
1. You ask your AI assistant about a job.
2. The assistant checks coverage and asks which facts apply to the project.
3. LienDeadline evaluates the confirmed facts against the discovered rules. Each calculated
deadline includes its sources. Unresolved outcomes include 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
| Tool | What it does | Key |
| --- | --- | --- |
| `calculate_supplier_deadlines` | Legacy v2 baselines for Florida and Kansas private projects | Customer |
| `get_supplier_questions` | Whether v3 covers a state, project type and hiring relationship, with its questions, sources and rule versions | Customer |
| `calculate_supplier_deadlines_v3` | Deadlines from the facts gathered with `get_supplier_questions` | Customer |
| `get_state_lien_guide` | One state's lien guide: rules, statute citations, deadline table and FAQs | None |
| `list_state_lien_guides` | Every guide (50 states and DC) with its code, title and slug | None |
| `calculate_lien_deadline` | Invoice-based deadlines (local server only) | Customer |
| `list_supported_states` | Jurisdictions the invoice calculation accepts (local server only) | Customer |
Inputs, outputs and statuses are in the [tool reference](https://github.com/LienDeadline/liendeadline-mcp/blob/main/docs/TOOLS.md).
## Privacy and safety
- **Account usage.** Supplier discovery and calculations require a customer key. Discovery uses
no calculation allowance; completed calculations 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, including tool name, success, duration, client
family and a goal from a fixed list. The telemetry excludes tool inputs, results and IP addresses.
- **Local server.** It has no telemetry of its own.
Details: [LienDeadline privacy policy](https://liendeadline.com/privacy).
## 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
- **Website:** [liendeadline.com](https://liendeadline.com/?utm_source=github&utm_medium=readme&utm_campaign=liendeadline-mcp), with a [setup guide for this server](https://liendeadline.com/mcp?utm_source=github&utm_medium=readme&utm_campaign=liendeadline-mcp)
- **Agent skill and plugins:** [liendeadline.com/agent-skill](https://liendeadline.com/agent-skill?utm_source=github&utm_medium=readme&utm_campaign=liendeadline-mcp) and [LienDeadline/skills](https://github.com/LienDeadline/skills)
- **Support:** [support@liendeadline.com](mailto:support@liendeadline.com) or
[liendeadline.com/contact](https://liendeadline.com/contact)
- **Terms of service:** [liendeadline.com/terms](https://liendeadline.com/terms)
- **Privacy policy:** [liendeadline.com/privacy](https://liendeadline.com/privacy)
- **Help center:** [liendeadline.com/help](https://liendeadline.com/help)
- **Security:** report issues privately as described in
[SECURITY.md](https://github.com/LienDeadline/liendeadline-mcp/blob/main/SECURITY.md)
- **Contributing and development:** [CONTRIBUTING.md](https://github.com/LienDeadline/liendeadline-mcp/blob/main/CONTRIBUTING.md)
- **License:** [MIT](https://github.com/LienDeadline/liendeadline-mcp/blob/main/LICENSE)
TDQS
Scored across 7 tools
Three tools compute lien/notice deadlines — calculate_supplier_deadlines (legacy, FL/KS only), calculate_supplier_deadlines_v3, and calculate_lien_deadline (invoice-date based) — and their boundaries are only clear after reading long descriptions, so misselection is likely. The state tools (list_state_lien_guides, list_supported_states, get_state_lien_guide) are better separated but still share near-identical naming roots. Descriptions do disambiguate once read, preventing a lower score.
All tools follow a consistent snake_case verb_noun pattern (list_*, get_*, calculate_*). The only real deviation is the versioned calculate_supplier_deadlines_v3 sitting alongside an unsuffixed legacy calculate_supplier_deadlines, which is slightly asymmetric. Otherwise readable and predictable.
Seven tools is a good scoped size for a lien-deadline domain. There is some redundancy — a legacy calculator coexisting with a v3 calculator, and a list/get pair plus a separate supported-states list. Not a sizing problem, just mild duplication.
The surface covers editorial guides (list + get), supported-jurisdiction discovery, v3 question discovery then calculation, and a simple invoice-based calculator — a coherent lifecycle for read-only deadline advice, with no writes by design. Minor gaps: no batch/multi-invoice calculation and no explicit way to enumerate states with calculated baselines versus editorial coverage, forcing agents to probe.