关于 Tektolo
Tektolo 为美国租赁住房运营提供规则驱动、附带来源的工具,可从物业检查结果生成周转估算,并按州规则结算押金。它面向房东、运营人员及集成这些流程的软件,结果由版本化规则确定。
主要功能
- 01根据退租检查生成维修周转范围
- 02按美国州及适用城市规则结算押金
- 03列出扣款、退款及潜在罚金
- 04为金额和结论附上来源
- 05通过网页、MCP 或 REST 使用
适用场景
- 01将退租检查结果整理为供应商可执行的维修范围
- 02核算押金退款期限、扣款和利息
- 03生成逐项列明的押金结算声明
MCP 相关
提供无需账户的 MCP 服务,地址为 https://tektolo.com/mcp,使用 Streamable HTTP。物业周转和押金结算工具也可通过 REST 调用。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://tektolo.com/mcpclaude mcp add --transport http com-tektolo-capabilities https://tektolo.com/mcp{"mcpServers":{"com-tektolo-capabilities":{"type":"http","url":"https://tektolo.com/mcp"}}}在 Cursor 中打开{"servers":{"com-tektolo-capabilities":{"type":"http","url":"https://tektolo.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-tektolo-capabilities":{"type":"http","url":"https://tektolo.com/mcp"}}}{"mcpServers":{"com-tektolo-capabilities":{"serverUrl":"https://tektolo.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
5| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| city | string | 否 | 城市;适用时用于城市规则叠加(例如 'Chicago')。可选。 |
| as_of | string | 否 | 用于判断截止日期状态的今天日期(YYYY-MM-DD)。默认为今天(UTC);如需结果可重复,请提供此值。 |
| audit | boolean | 否 | 同时返回运行记录以及输入/结果哈希值(审计跟踪)。默认为 false。 |
| state | string | 是 | 美国州的 2 字母代码(例如 'CA');也接受州名。 |
| returned | object | 否 | 房东目前已退还的金额及退还时间。提供此项后,时效性结果会说明退款和逐项明细声明是否按时,以及逾期天数。 |
| furnished | boolean | 否 | 该单元为带家具出租(加利福尼亚州 AB 12 之前:3 个月;堪萨斯州:1.5 个月;特拉华州:无上限)。 |
| deductions | array | 否 | 你打算扣除的项目(租户可填写房东列出的项目)。明确提供空列表表示不扣款(这会决定较短的无扣款期限,例如蒙大拿州 10 天、阿拉斯加州 14 天);尚不确定时请省略。 |
| move_in_on | string | 否 | 租赁开始日期(YYYY-MM-DD)。用于计算利息;物品使用年限未知时,也用于计算折旧。 |
| vacated_on | string | 是 | 租户搬出并交还占有权的日期(YYYY-MM-DD)。 |
| client_refs | object | 否 | 你自己的引用 ID(例如 unit_id、job_id)。会原样返回,绝不用于其他用途。 |
| deposit_usd | any | 是 | 持有的保证金金额,单位为美元。 |
| lease_end_on | string | 否 | 租约原定结束日期(YYYY-MM-DD);若与租赁实际结束日期不同(提前解约),则填写此项。损失租金和解约费用计算至此日期;截止期限不受其影响(以 tenancy_ended_on 为准,否则以搬出日期为准;原定结束日期仅作为较晚的备选日期)。 |
| serve_pinned | boolean | 否 | 可选,与 expect_ruleset 搭配使用。即使规则已变更,也可要求我们根据你指定版本的规则集及其已签名的 bundle 作答;结果会在 served_from_bundle 中说明。我们会拒绝超过 12 个月的版本、已被后续更正或法律变更替代的适用于你所在州的版本,或没有对应 bundle 的版本。默认为 false:规则发生任何变更时,调用都会失败。 |
| tenancy_type | enum | 否 | written_lease 或 at_will(缅因州 6033(2):书面协议的期限最长为 30 天;随意租赁最长为 21 天;马萨诸塞州 15B(4):随意租赁为搬出后 30 天,书面租约为租约结束后 30 天)。如果省略此项,且搬出日期早于 tenancy_ended_on,则较早的(at-will)日期优先,另一个日期会列出。written_lease | at_will |
| documentation | object | 否 | 你持有的证明材料;未知的字段请省略。 |
| building_units | integer | 否 | 楼内单元数量。部分利息规则取决于此数值(纽约州 6+、伊利诺伊州 25+)。 |
| expect_ruleset | string | 否 | 可选。你所依据的规则集版本;结果会在 provenance.ruleset_version 中携带该版本(例如 'sd-2026.11.14'),也可提供其 sha256: 哈希。如果规则发生变更,调用会失败(不计算任何内容,也不收费),并说明当前生效的规则,以便你按自己的计划升级。省略此项则按当前规则作答。 |
| owner_occupied | boolean | 否 | 房东居住在该楼内(缅因州、新罕布什尔州、新泽西州和芝加哥对小型自住楼宇设有豁免;需结合 building_units)。 |
| small_landlord | boolean | 否 | 加利福尼亚州 AB 12 小房东(自然人或由自然人组成的 LLC,最多拥有两处房产、总计最多四个单元;不适用于军人):押金上限为两个月租金。 |
| pet_deposit_usd | any | 否 | deposit_usd 中属于宠物押金的部分(在 Missouri、Alabama、North Dakota 和 Saint Paul 不计入上限;在 Hawaii 和 Alaska 可在上限之外额外收取,最高为一个月租金;在 Kansas 最高为半个月租金,在 Nebraska 最高为四分之一个月租金)。 |
| monthly_rent_usd | any | 否 | 用于检查押金上限的月租金。 |
| prepaid_rent_usd | any | 否 | 除首月外预付的租金,与 deposit_usd 分开持有。在 AK、AZ、CA、CT、MD、MI 和 NY 计入上限;在 CT、MA(末月租金)、MD 和 Chicago 需计息;在 Minneapolis 会将押金上限降至半个月租金。 |
| tenancy_ended_on | string | 否 | 租赁关系实际结束的日期(YYYY-MM-DD):租约到期日,或更早的终止日或被接受的退租日。以租赁关系结束日为起点计算的期限均使用此日期。如果租客在租约到期前搬离,请将预定到期日作为 lease_end_on(旧版调用方曾将其传入此字段,仍然有效:期限将从该日期起算;若具体情况表明搬出日期更早,则也会将其作为替代日期)。 |
| tenant_abandoned | boolean | 否 | 租客弃置了房屋或被驱逐(Maryland 8-203(h):期限从租客提出书面要求时起算;Washington 59.18.280:从房东得知此事时起算;Louisiana 9:3251(C):一个月规则不适用)。留空时:根据 tenant_gave_proper_notice: false 推断;若搬出日期早于 tenancy_ended_on,则以较早的弃置期限为准,并列出另一个日期。 |
| contractor_needed | boolean | 否 | 损坏金额超过押金,需要第三方承包商处理,并且你已及时以书面形式说明(Virginia、West Virginia:额外延长 15 天)。 |
| lease_return_days | integer | 否 | 租约规定的退还期限(天),仅适用于法律允许租约自行规定期限的情况(Colorado 最长 60 天、Idaho 最长 30 天、Maine 可规定更短期限)。 |
| lease_term_months | integer | 否 | 租约期限(月数;按月租赁时为 0)。Delaware 的上限适用于一年或更长的租约;New Mexico 的上限适用于较短的租约。 |
| statement_sent_on | string | 否 | 你寄出(或送达)明细清单的日期(YYYY-MM-DD)。根据此日期判断清单是否按时或逾期;仅凭 documentation.itemized_statement 无法判断。 |
| demand_received_on | string | 否 | 收到租客押金请求的日期(YYYY-MM-DD;在 Oklahoma 须为书面请求,在 Maryland 8-203(h) 须通过一类邮件送达)。Arizona、Kansas、Oklahoma、South Carolina 和 Mississippi 从该日期起算期限。 |
| tenant_age_60_plus | boolean | 否 | 有年满 60 岁的人居住在该房屋内(New Hampshire 540-A:5, I:自住物业豁免不适用于该房屋)。tenant_age_62_plus 为 true 时,意味着此项为 true。 |
| tenant_age_62_plus | boolean | 否 | 租客年满 62 岁(Connecticut:押金上限为一个月租金)。 |
| new_tenant_rent_usd | any | 否 | 新租客支付的月租金(需同时提供 new_tenant_moved_in_on):按重叠日期收到的租金会抵扣这些日期所申报的租金。 |
| third_party_managed | boolean | 否 | 第三方收费管理该房屋或代收租金。 |
| claim_notice_sent_on | string | 否 | 你寄出押金索赔意向书面通知的日期(YYYY-MM-DD)。Florida(须在终止后 30 天内)和 District of Columbia(须在 45 天内):余额应在通知后 30 天内支付;逾期通知不计。 |
| deposit_collected_on | string | 否 | 收取押金的日期(YYYY-MM-DD);默认值为 move_in_on。California(AB 12,自 2024-07-01 起)和 Colorado 的上限取决于此日期。 |
| landlord_units_owned | integer | 否 | 房东总共拥有的出租房屋数量(Arkansas 为 5 套或以下,Georgia 为 10 套或以下;若 third_party_managed 为 true,可能符合豁免条件)。 |
| interest_paid_through | string | 否 | 截至此日期已向租客支付或贷记的利息(年度支付规则:San Francisco、Los Angeles、Berkeley、Connecticut、Massachusetts 等):利息从此日期起计算。 |
| interest_rate_percent | any | 否 | 押金账户实际支付的年利率,适用于法律规定按银行利率计息的情况(New Jersey、North Dakota、New Hampshire、New York、Pennsylvania、Portland),或规定利率上限的情况(Massachusetts:5% 或银行较低利率)。未提供此值时,银行利率利息未知。Illinois 765 ILCS 715 使用 IDFPR 发布的利率。 |
| new_tenant_moved_in_on | string | 否 | 新租客搬入日期(YYYY-MM-DD),仅当房屋已重新出租时填写。West Virginia 和 Wisconsin 可据此提前结束期限;从该日期起的租金索赔不可追回(重新出租减损)。 |
| rent_ordinance_covered | boolean | 否 | 该单元受该市租金条例(洛杉矶 RSO、伯克利租金条例)管辖。仅在此情况下才需支付押金利息;未知:金额显示在退款旁边,而非包含在退款中。 |
| tenant_gave_proper_notice | boolean | 否 | 已提交符合法规要求的终止通知(阿拉斯加:未扣除损坏费用时为 14 天,而非 30 天)。 |
| lease_signed_or_renewed_on | string | 否 | 当前租约签署或最近一次续签的日期(YYYY-MM-DD)。佐治亚州(2024-07-01)和马里兰州(2024-10-01)的上限适用于此日期起签订的租约;默认值为 move_in_on,并提示之后续签可能适用新上限。 |
| nonstandard_provision_signed | boolean | 否 | 威斯康星州:租户签署了单独的 NONSTANDARD RENTAL PROVISIONS 文件,其中涵盖该项收费(ATCP 134.06(3)(b));false 表示此类收费“不允许”。 |
| forwarding_address_received_on | string | 否 | 收到租户书面转寄地址的日期(YYYY-MM-DD)。多个州会从该日期开始计算或暂停期限(德克萨斯州、康涅狄格州、艾奥瓦州、明尼苏达州)。 |
| tenant_gave_forwarding_address | boolean | 否 | 如果租户从未以书面形式提供转寄地址,则为 false(不只是“尚未知晓”)。此时,伊利诺伊州、宾夕法尼亚州、俄亥俄州、特拉华州、南卡罗来纳州和新罕布什尔州免除房东的处罚责任。forwarding_address_received_on 会隐含设为 true。 |
详细介绍
Tektolo 技能和连接器
Agent 技能、Claude Code 插件和 Tektolo 的公共 API 契约。Tektolo 为现实世界的运营工作提供基于规则、注明来源的工具:你提交结构化输入,系统应用有版本管理的规则,并返回附带来源且经过核验的答案。相同的发现结果始终会得到相同的答案。如果工具读取你的笔记或文档,AI 模型会将其转化为发现结果,但绝不会设定数值;答案会列出读取的每项发现结果,供你核查。每个工具都可以通过三种方式使用:在网页上使用、通过 MCP 在 AI 助手中使用,或通过 REST 使用。
本仓库仅包含说明和公共元数据。引擎和规则表运行于 tektolo.com。这里的每个文件每天都会由 scripts/sync.py 从实时网站同步。
工具
| 工具 | 功能 | MCP 工具 | 链接 |
|---|---|---|---|
| 房屋周转估价 | 将退房检查结果转化为带价格、可直接交由供应商执行的整备工作范围。 | property_turnover_quick_estimate、property_turnover_scope、property_turnover_issue_codes | 网页工具 · 参考资料 · 技能 |
| 押金结算 | 根据州(以及适用城市)的规则结算美国租赁押金:退还期限、评估的每项扣款(允许的类别、折旧、证明文件)、应付利息、退款、罚款风险,以及附有每项金额依据的明细清单草稿。 | deposit_settlement_settle、deposit_settlement_rules | 网页工具 · 参考资料 · 技能 |
定价:所有工具均可免费试用。Agent 和软件每天可免费调用 20 次,之后每次调用 $0.02。部分工具将新增付费功能。详情:https://tektolo.com/pricing
在 AI 助手中使用
MCP 服务地址为 https://tektolo.com/mcp。它使用可流式传输的 HTTP,无需账号。若要在 Claude 或 ChatGPT 的共享服务后使用自己的免费额度,请在 tektolo.com/connect-your-ai 获取个人连接器 URL。
Claude Code:安装插件,其中包含相关技能和 MCP 服务:
claude plugin marketplace add tektolo/skills
claude plugin install tektolo@tektolo
或者仅连接该服务:
claude mcp add --transport http tektolo https://tektolo.com/mcp
适用于任何可读取 SKILL.md 的 Agent 的技能(Claude Code、Codex、Cursor、Gemini CLI、Copilot 等):
npx skills add tektolo/skills
**Claude、ChatGPT、Cursor、VS Code:**使用上方的 URL 添加自定义连接器。分步说明见 tektolo.com/connect-your-ai。
**OpenClaw:**这两项技能也已发布在 ClawHub 上,名称为 @tektolo。
通过 REST 使用
每个 MCP 工具也都是普通的 JSON 端点。 contract/openapi.json 对这些端点进行了说明,而 contract/catalog.json 列出了每项操作及其架构、定价、隐私说明和规则集哈希。可用的请求正文见 examples/:
curl -sS https://tektolo.com/v1/deposit-settlement/settle \
-H 'content-type: application/json' \
-d @examples/deposit-settlement/settle/california_carpet.json
仓库内容
| 路径 | 内容 |
|---|---|
skills/<tool>/SKILL.md | Agent 技能(开放的 SKILL.md 格式) |
plugins/tektolo/ | Claude Code 插件:包含相同的技能以及 .mcp.json |
.claude-plugin/marketplace.json | 将本仓库设为 Claude Code 插件市场 |
contract/ | catalog.json、openapi.json、MCP 服务卡片和 llms.txt,均为已发布版本 |
examples/ | 从目录中摘取的请求正文 |
反馈与联系
如需报告错误结果或建议添加工具,请访问 tektolo.com/contact,或发送邮件至 [email protected]。也欢迎在本仓库提交 Issue。
许可证
本仓库中的技能、示例和文档均采用 MIT-0 许可(参见 LICENSE)。使用 Tektolo 服务须遵守其使用条款和隐私政策。结果是依据引用规则得出的估算,不构成法律建议(免责声明)。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。