关于 LienDeadline
LienDeadline 是面向美国建筑材料供应商的 MCP 服务,可根据项目事实计算初步通知和机械留置权期限,并附上法规依据。它还提供覆盖 50 个州及哥伦比亚特区的指南;对不支持或信息不足的情况会要求复核,而不猜测日期。
主要功能
- 01根据交付日期计算通知和留置权期限
- 02为计算日期提供法规引用
- 03对不支持或信息不足的情况标记复核
- 04提供 50 个州及哥伦比亚特区指南
- 05为受支持的项目收集所需信息
适用场景
- 01核对供应商交付对应的通知期限
- 02依据法规引用确认留置权申请日期
- 03查询特定州的留置权规则
MCP 相关
MCP 客户端可通过服务端点使用托管工具和公开州指南,也可在本地运行该服务。供应商查询和期限计算需要客户密钥,公开指南查询无需密钥。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.liendeadline.com/mcpclaude mcp add --transport http liendeadline-liendeadline https://mcp.liendeadline.com/mcp{"mcpServers":{"liendeadline-liendeadline":{"type":"http","url":"https://mcp.liendeadline.com/mcp"}}}在 Cursor 中打开{"servers":{"liendeadline-liendeadline":{"type":"http","url":"https://mcp.liendeadline.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"liendeadline-liendeadline":{"type":"http","url":"https://mcp.liendeadline.com/mcp"}}}{"mcpServers":{"liendeadline-liendeadline":{"serverUrl":"https://mcp.liendeadline.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
5| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| state | string | 是 | 项目所在州的两字母代码,例如 "FL"、"KS"、"TX";任何州或 DC 均可接受。此参数决定适用哪些事件问题。 |
| hired_by | enum | 是 | 向供应商订购材料的一方:业主、承包商或分包商。owner | contractor | subcontractor |
| project_type | enum | 是 | 私人商业项目、私人住宅项目或公共项目(公共项目始终需要审核)。commercial | residential | public |
| last_delivery_date | string | 否 | 最终交付日期,格式为 YYYY-MM-DD,不得早于 first_delivery_date。deliveries_complete 为 true 时必填。 |
| deliveries_complete | boolean | 是 | 最终交付已完成时为 true(此时必须提供 last_delivery_date);交付仍在进行时为 false,此时留置权日期将返回 awaiting_final_delivery。 |
| first_delivery_date | string | 是 | 材料首次交付(首次供货)的日期,格式为 YYYY-MM-DD。不是发票日期。 |
| kansas_extension_status | enum | 否 | 仅限堪萨斯州:是否已提交并邮寄法定留置权期限延长申请?no 表示适用普通留置权基准;yes、unknown 或省略均需要专业审核。yes | no | unknown |
| florida_termination_date | string | 否 | 仅限佛罗里达州:合同或开工通知的终止日期,格式为 YYYY-MM-DD,不得早于 first_delivery_date。仅在 florida_termination_status=yes 时提供;留置权日期仍需专业审核。 |
| florida_final_payment_date | string | 否 | 仅限佛罗里达州:业主最终付款日期,格式为 YYYY-MM-DD,不得早于 first_delivery_date。仅在 florida_final_payment_status=yes 时提供。 |
| florida_termination_status | enum | 否 | 仅限佛罗里达州:原始合同或开工通知是否已终止?no 表示适用留置权基准;yes、unknown 或省略均需要专业留置权审核。yes | no | unknown |
| florida_final_payment_status | enum | 否 | 仅限佛罗里达州:业主是否已向承包商支付最终款项?未经核实则为 unknown。对于未受业主聘用的供应商,如果为 unknown、未提供,或为 yes 但未提供 florida_final_payment_date,则 preliminary notice 的状态为 review_required。yes | no | unknown |
详细介绍
询问 AI 助手初步通知和机械留置权的截止日期,并了解每个日期背后的法规。 此 MCP 服务将 Claude、ChatGPT、Cursor、VS Code 及其他任何 MCP 客户端连接到 LienDeadline,这是面向美国建筑材料供应商的期限计算引擎。 无需安装任何内容:添加一个 URL 即可。
快速开始 · 可以询问什么 · 覆盖范围 · 工具 · 隐私 · liendeadline.com
为什么选择 LienDeadline
如果错过初步通知或留置权申请期限,供应商可能会失去该项目上的留置权利,进而失去争取付款的筹码。相关规则会因州、项目类型以及雇用你的对象而异。LienDeadline 根据你的交付日期计算这些期限,并展示计算依据。
- 根据交付日期计算期限。 根据首次和末次交付日期,以及几个是、否或未知的问题,计算初步通知和留置权申请期限。
- 每个日期背后的法规。 每项期限都会注明来源,方便你的团队和法律顾问核查。
- 绝不猜测日期。 对于缺失的信息、尚未覆盖的州以及公共项目,系统会返回“需要审核”及其原因。
- 覆盖全部 50 个州和哥伦比亚特区的留置权指南。 包含规则摘要、期限表和常见问题,并附有法规引用。
- 从设计上确保安全。 供应商查询和期限计算需要调用方的客户密钥;完成计算会消耗套餐额度。公开指南无需账户或密钥。系统不会发送通知、申请留置权或处理付款。
快速开始
连接到托管服务并使用公开指南,无需安装、账户或密钥:
https://mcp.liendeadline.com/mcp
以下无需身份验证的连接设置涵盖传输方式和公开指南。供应商发现和计算需要调用方通过客户端获批的凭据设置提供专属客户密钥。发现操作不会消耗计算额度;已完成的计算会消耗额度。
| 客户端 | 添加方式 |
|---|---|
| Claude(网页、桌面、移动端) | 在 Claude 的连接器目录中打开 LienDeadline 并连接。 |
| Claude Code | claude mcp add --transport http liendeadline https://mcp.liendeadline.com/mcp |
| Cursor | |
| VS Code | |
| ChatGPT | 打开 Plugins,选择 + → Add custom MCP server,粘贴上面的 URL 并选择 No authentication。 |
| Codex CLI | codex mcp add liendeadline --url https://mcp.liendeadline.com/mcp |
| 任何 MCP 客户端 | 使用上面的 URL 通过 Streamable HTTP 连接,无需身份验证。 |
希望你的 Agent 也能提出恰当的问题?LienDeadline Agent 技能(GitHub)会教它需要收集哪些事实。 Claude Code 插件可一步添加该技能和此服务:
claude plugin marketplace add LienDeadline/skills
claude plugin install liendeadline@liendeadline
改为在本地运行(npm,stdio)
本地服务需要 Node.js 22.22 或更高版本,并提供所有工具,包括这两个客户 API 工具。它随附 npm-shrinkwrap.json,因此 npx 会安装每个版本经测试使用的确切依赖版本。
Claude Desktop: 从最新版本下载 liendeadline-mcp-<version>.mcpb 并打开。
Claude Code:
claude mcp add liendeadline -- npx -y liendeadline-mcp
Codex CLI:
codex mcp add liendeadline -- npx -y liendeadline-mcp
Cursor、Windsurf 和其他 mcpServers 客户端:
{
"mcpServers": {
"liendeadline": { "command": "npx", "args": ["-y", "liendeadline-mcp"] }
}
}
VS Code(.vscode/mcp.json):
{
"servers": {
"liendeadline": { "type": "stdio", "command": "npx", "args": ["-y", "liendeadline-mcp"] }
}
}
你可以提出的问题
试着这样提问:
- “我们从 2026 年 8 月 3 日到 9 月 10 日,为佛罗里达州一个商业项目的分包商交付了材料。尚未收到尾款,也没有终止合同。我们的通知和留置权截止日期是什么时候?”
- “同一个项目,但我不知道业主是否已支付尾款。你能告诉我什么?”
- “请介绍德克萨斯州针对材料供应商的机械留置权规则,并引用相关法规。”
- “你们有哪些州的留置权指南?给我看看乔治亚州的。”
覆盖范围
| 内容 | 适用范围 | 要求 |
|---|---|---|
| 计算供应商截止日期 | 佛罗里达州和堪萨斯州的私人项目 | 客户密钥;套餐中包含计算额度 |
| 更多州(v3 工具) | 随着各州经审核的规则发布而添加。在此之前,v3 工具会返回错误,不提供日期。 | 客户密钥;套餐中包含计算额度 |
| 留置权指南 | 全部 50 个州和哥伦比亚特区 | 无 |
| 基于发票的截止日期 | 51 个司法管辖区 | 客户 API 密钥 |
如果 LienDeadline 无法计算日期,例如因为项目属于公共项目、所在州尚未覆盖,或你不知道某项事实,它会返回 review_required 和原因,而不是日期。
工作原理
- 你向 AI 助手询问某个项目。
- 助手通过 MCP 调用 LienDeadline 的工具,并提供州、日期和你的回答。
- LienDeadline 根据该州的规则进行计算,并返回各项截止日期及其法规依据;如果需要审核,则会说明原因。
- 在显示供应商截止日期之前,服务会检查结果是否与提交的事实完全一致。如果不一致,则会报告错误,绝不会返回日期。
工具
| 工具 | 功能 | 密钥 |
|---|---|---|
calculate_supplier_deadlines | 根据交付日期以及对事件问题的肯定、否定或未知回答,计算初步通知和留置权登记截止日期 | 客户 |
get_supplier_questions | 查询 v3 是否覆盖某个州、项目类型和雇佣关系,并获取相关问题、来源和规则版本 | 客户 |
calculate_supplier_deadlines_v3 | 根据通过 get_supplier_questions 收集的事实计算截止日期 | 客户 |
get_state_lien_guide | 获取一个州的留置权指南:规则、法规引文、截止日期表和常见问题 | 无 |
list_state_lien_guides | 列出所有指南(50 个州和哥伦比亚特区),以及各自的代码、标题和 slug | 无 |
calculate_lien_deadline | 根据发票计算截止日期(仅限本地服务) | 客户 |
list_supported_states | 列出发票计算支持的司法管辖区(仅限本地服务) | 客户 |
输入、输出和状态详见工具参考。
隐私与安全
- 账户用量。 供应商计算需要客户密钥,并会消耗套餐额度。托管服务调用方每次请求都需自行发送
Authorization: Bearer <key>;本地调用方需设置LIENDEADLINE_API_KEY。托管服务绝不会使用全服务共用的密钥。州指南仍然公开。 - 发送的内容。 你提供的事实(州、日期、项目类型、雇用你的人,以及你的肯定、否定或未知回答)会发送至 LienDeadline API 以进行计算。查询指南时只会发送州代码。
- 托管服务。 其日志会记录每次请求的方法、状态和响应时间,不会记录你的输入。Google Cloud 自身的请求日志还会记录 URL、客户端 IP 地址和用户代理。服务可能会在 PostHog 中匿名统计用量:工具名称、成功状态、耗时和客户端类型,不包含输入、结果或 IP 地址。
- 本地服务。 不会自行收集遥测数据。
详情请参阅:LienDeadline 隐私政策。
非法律建议
结果是根据已公布的州规则计算的教育性基准。法规会有变化,而且每个项目都各不相同,因此在依赖关键截止日期之前,请向法律顾问核实。LienDeadline 不是律师事务所,也不会代表你提交任何文件。
链接
- 网站: liendeadline.com,以及此服务的设置指南
- Agent 技能和插件: liendeadline.com/agent-skill 和 LienDeadline/skills
- 支持: [email protected] 或 liendeadline.com/contact
- 服务条款: liendeadline.com/terms
- 隐私政策: liendeadline.com/privacy
- 帮助中心: liendeadline.com/help
- 安全: 按照 SECURITY.md 中的说明私下报告问题
- 贡献和开发: CONTRIBUTING.md
- 许可证: MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。