Contract Lily
UK tenancy and employment rule checks: deposits, notice, rent increases, holiday and minimum wage.
Should I use this
Quality & Safety
A
Findings (6)
- LOWTool 'check_notice_period' description lacks action verbin check_notice_period
- LOWTool 'check_scottish_rent_increase_notice' name length outside 3-30 rangein check_scottish_rent_increase_notice
- LOWTool 'check_welsh_rent_increase_notice' name length outside 3-30 rangein check_welsh_rent_increase_notice
- LOWTool 'check_northern_ireland_rent_increase_notice' name length outside 3-30 rangein check_northern_ireland_rent_increase_notice
- LOWTool 'get_tenancy_agreement_review_link' name length outside 3-30 rangein get_tenancy_agreement_review_link
- LOWTool 'get_employment_contract_review_link' name length outside 3-30 rangein get_employment_contract_review_link
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~4,876Tokens (tool definitions)
~3.9 KBTypical response size
Significant attention impact (3.81% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"contract-lily": {
"url": "https://api.contractlily.com/mcp"
}
}
}Remote endpoints
https://api.contractlily.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢check_deposit_cap(depositAsked, nation, rent, rentPeriod)
Work out the most a landlord or agent can ask for as a tenancy deposit and a holding deposit, from the rent, in any UK nation, and optionally check a deposit the user was asked for. England limits both; Wales limits the holding deposit; Scotland and Northern Ireland limit the tenancy deposit.
Input Schema
{
"type": "object",
"properties": {
"depositAsked": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "The tenancy deposit the landlord or agent asked for, in pounds, if the user gave one."
},
"nation": {
"enum": [
"england",
"wales",
"scotland",
"northern-ireland"
],
"type": "string",
"description": "The UK nation the home is in."
},
"rent": {
"type": "number",
"minimum": 0.01,
"maximum": 1000000,
"description": "The rent for one rent period, in pounds, for example 1200 or 950.50."
},
"rentPeriod": {
"enum": [
"four_weeks",
"month",
"week"
],
"type": "string",
"description": "How often the rent falls due."
}
},
"required": [
"nation",
"rent",
"rentPeriod"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"depositAsked": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"verdict": {
"enum": [
"within",
"over",
"unclear",
"unchecked"
],
"type": "string"
}
},
"required": [
"amount",
"verdict"
]
},
{
"type": "null"
}
]
},
"lawAsAt": {
"type": "string"
},
"limits": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"enum": [
"tenancy deposit",
"holding deposit"
],
"type": "string"
},
"law": {
"type": "string"
},
"overAbove": {
"type": "string"
},
"upTo": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"law",
"overAbove",
"upTo",
"url"
]
}
},
"nation": {
"enum": [
"england",
"wales",
"scotland",
"northern-ireland"
],
"type": "string"
},
"page": {
"type": "string"
},
"rent": {
"type": "string"
}
},
"required": [
"depositAsked",
"lawAsAt",
"limits",
"nation",
"page",
"rent"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢check_notice_period(given, nation, party, period, rentDueDate, ...)
Work out the least notice that ends a periodic private tenancy, and the earliest end date it can name, in any UK nation, whether the tenant or the landlord gives it. It also says when a landlord cannot end the tenancy by notice at all (England) or must apply to a tribunal (Scotland).
Input Schema
{
"type": "object",
"properties": {
"given": {
"type": "string",
"format": "date",
"description": "The day the notice is given, as YYYY-MM-DD. In Scotland, the day the other side receives it."
},
"nation": {
"enum": [
"england",
"wales",
"scotland",
"northern-ireland"
],
"type": "string",
"description": "The UK nation the home is in."
},
"party": {
"enum": [
"tenant",
"landlord"
],
"type": "string",
"description": "Who gives the notice."
},
"period": {
"enum": [
"four_weeks",
"month",
"week"
],
"type": "string",
"description": "How often the rent falls due."
},
"rentDueDate": {
"type": "string",
"format": "date",
"description": "For weekly or four-weekly rent: a day rent fell due, such as the last due date, as YYYY-MM-DD; rent periods repeat every 7 or 28 days from it. Leave it out only if they repeat from the day the tenancy started."
},
"rentDueDay": {
"type": "integer",
"minimum": 1,
"maximum": 31,
"description": "For monthly rent: the day of the month rent falls due, such as 1 or 31. Leave it out only if it is the day of the month the tenancy started."
},
"tenancyStart": {
"type": "string",
"format": "date",
"description": "The day the tenancy, or in Wales the occupation contract, began, as YYYY-MM-DD."
}
},
"required": [
"given",
"nation",
"party",
"period",
"tenancyStart"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"answer": {
"oneOf": [
{
"type": "object",
"properties": {
"earliestEnd": {
"type": "string",
"format": "date"
},
"kind": {
"const": "notice"
},
"minimum": {
"type": "string"
}
},
"required": [
"earliestEnd",
"kind",
"minimum"
]
},
{
"type": "object",
"properties": {
"earliestEnd": {
"type": "string",
"format": "date"
},
"givenFrom": {
"type": "string",
"format": "date"
},
"kind": {
"const": "too-early"
}
},
"required": [
"earliestEnd",
"givenFrom",
"kind"
]
},
{
"type": "object",
"properties": {
"kind": {
"const": "no-notice-to-quit"
}
},
"required": [
"kind"
]
},
{
"type": "object",
"properties": {
"days": {
"enum": [
28,
84
],
"type": "number"
},
"kind": {
"const": "notice-to-leave"
},
"tribunalFrom": {
"type": "string",
"format": "date"
}
},
"required": [
"days",
"kind",
"tribunalFrom"
]
}
]
},
"explanation": {
"type": "array",
"items": {
"type": "string"
}
},
"lawAsAt": {
"type": "string"
},
"nation": {
"enum": [
"england",
"wales",
"scotland",
"northern-ireland"
],
"type": "string"
},
"page": {
"type": "string"
},
"party": {
"enum": [
"tenant",
"landlord"
],
"type": "string"
}
},
"required": [
"answer",
"explanation",
"lawAsAt",
"nation",
"page",
"party"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢check_rent_increase_notice(history, lastIncrease, period, prescribedForm, served, ...)
Check a section 13 rent increase notice for an assured periodic tenancy in England, served from 1 May 2026: whether the new rent's start date meets each date rule and the notice is on the prescribed form, and the earliest the new rent could start. England only; it does not judge whether the new rent is fair.
Input Schema
{
"type": "object",
"properties": {
"history": {
"enum": [
"none",
"increased",
"unknown"
],
"type": "string",
"description": "Whether the rent has gone up before after a section 13 notice or a tribunal decision: none, increased (give lastIncrease), or unknown."
},
"lastIncrease": {
"type": "string",
"format": "date",
"description": "If the rent went up before, the day that increase took effect, as YYYY-MM-DD."
},
"period": {
"enum": [
"four_weeks",
"month",
"week"
],
"type": "string",
"description": "How often the rent falls due."
},
"prescribedForm": {
"enum": [
"yes",
"no",
"unsure"
],
"type": "string",
"description": "Whether the notice is on the government's prescribed form for a section 13 notice."
},
"served": {
"type": "string",
"format": "date",
"description": "The day the tenant received the notice, as YYYY-MM-DD."
},
"starts": {
"type": "string",
"format": "date",
"description": "The day the notice says the new rent starts, as YYYY-MM-DD."
},
"tenancyStart": {
"type": "string",
"format": "date",
"description": "The day the first rent period of the tenancy began, as YYYY-MM-DD."
}
},
"required": [
"history",
"period",
"prescribedForm",
"served",
"starts",
"tenancyStart"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"certainlyFrom": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
]
},
"checks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"outcome": {
"enum": [
"met",
"not-met",
"unsure"
],
"type": "string"
},
"rule": {
"enum": [
"notice",
"period",
"sinceStart",
"sinceLastIncrease",
"form"
],
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"outcome",
"rule",
"text"
]
}
},
"earliest": {
"type": "string",
"format": "date"
},
"earliestStart": {
"type": "string"
},
"lawAsAt": {
"type": "string"
},
"page": {
"type": "string"
}
},
"required": [
"certainlyFrom",
"checks",
"earliest",
"earliestStart",
"lawAsAt",
"page"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢check_scottish_rent_increase_notice(history, lastIncrease, prescribedForm, received, starts)
Check a landlord's rent-increase notice for a private residential tenancy in Scotland, outside a rent control area: whether it gives at least three months' notice, whether the rent has already gone up in the 12 months before, and whether it is on the prescribed form; when the new rent can start, and the last day to refer it to a rent officer. Scotland only; it does not judge whether the new rent is fair.
Input Schema
{
"type": "object",
"properties": {
"history": {
"enum": [
"none",
"increased",
"unknown"
],
"type": "string",
"description": "Whether the rent has gone up before: none, increased (give lastIncrease), or unknown."
},
"lastIncrease": {
"type": "string",
"format": "date",
"description": "If the rent went up before, the day that increase took effect, as YYYY-MM-DD. If a rent officer or the tribunal set it, the day the landlord’s notice would have taken effect."
},
"prescribedForm": {
"enum": [
"yes",
"no",
"unsure"
],
"type": "string",
"description": "Whether the notice is on the prescribed rent-increase notice form."
},
"received": {
"type": "string",
"format": "date",
"description": "The day the tenant received the notice, as YYYY-MM-DD."
},
"starts": {
"type": "string",
"format": "date",
"description": "The day the notice says the new rent starts, as YYYY-MM-DD."
}
},
"required": [
"history",
"prescribedForm",
"received",
"starts"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"checks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"outcome": {
"enum": [
"met",
"not-met",
"unsure"
],
"type": "string"
},
"rule": {
"enum": [
"notice",
"sinceLastIncrease",
"form"
],
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"outcome",
"rule",
"text"
]
}
},
"earliestAllowed": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
]
},
"lawAsAt": {
"type": "string"
},
"page": {
"type": "string"
},
"referBy": {
"type": "string",
"format": "date"
},
"summary": {
"type": "string"
},
"takesEffect": {
"type": "string",
"format": "date"
}
},
"required": [
"checks",
"earliestAllowed",
"lawAsAt",
"page",
"referBy",
"summary",
"takesEffect"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢check_welsh_rent_increase_notice(history, lastIncrease, prescribedForm, received, starts)
Check a landlord's notice of a new rent for a periodic standard occupation contract in Wales: whether the new rent starts at least two months after the notice is given, whether it comes at least a year after the last increase, and whether it is on form RHW12; and the earliest the new rent can start. Wales only; it does not judge whether the new rent is fair.
Input Schema
{
"type": "object",
"properties": {
"history": {
"enum": [
"none",
"increased",
"unknown"
],
"type": "string",
"description": "Whether the rent has gone up before: none, increased (give lastIncrease), or unknown."
},
"lastIncrease": {
"type": "string",
"format": "date",
"description": "If the rent went up before, the day that increase took effect, as YYYY-MM-DD."
},
"prescribedForm": {
"enum": [
"yes",
"no",
"unsure"
],
"type": "string",
"description": "Whether the notice is on form RHW12, the Welsh Government form for a notice of variation of rent."
},
"received": {
"type": "string",
"format": "date",
"description": "The day the contract-holder was given the notice, as YYYY-MM-DD."
},
"starts": {
"type": "string",
"format": "date",
"description": "The day the notice says the new rent starts, as YYYY-MM-DD."
}
},
"required": [
"history",
"prescribedForm",
"received",
"starts"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"checks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"outcome": {
"enum": [
"met",
"not-met",
"unsure"
],
"type": "string"
},
"rule": {
"enum": [
"notice",
"sinceLastIncrease",
"form"
],
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"outcome",
"rule",
"text"
]
}
},
"earliestAllowed": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
]
},
"lawAsAt": {
"type": "string"
},
"page": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"checks",
"earliestAllowed",
"lawAsAt",
"page",
"summary"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢check_northern_ireland_rent_increase_notice(history, lastIncrease, received, starts, tenancyStart, ...)
Check a landlord's rent increase notice, given from 1 April 2025, for a private tenancy in Northern Ireland other than a controlled tenancy (do not use it for a controlled tenancy, which has different rules): whether it is in writing, whether the new rent starts at least three months after the notice is given, and whether it comes at least 12 months after the tenancy began and the last increase; and when the new rent can start. Northern Ireland only; it does not judge whether the new rent is fair.
Input Schema
{
"type": "object",
"properties": {
"history": {
"enum": [
"none",
"increased",
"unknown"
],
"type": "string",
"description": "Whether the rent has gone up before: none, increased (give lastIncrease), or unknown."
},
"lastIncrease": {
"type": "string",
"format": "date",
"description": "If the rent went up before, the day that increase took effect, as YYYY-MM-DD."
},
"received": {
"type": "string",
"format": "date",
"description": "The day the tenant was given the notice, as YYYY-MM-DD; from 1 April 2025."
},
"starts": {
"type": "string",
"format": "date",
"description": "The day the notice says the new rent starts, as YYYY-MM-DD."
},
"tenancyStart": {
"type": "string",
"format": "date",
"description": "The day the tenancy was granted, as YYYY-MM-DD."
},
"written": {
"enum": [
"yes",
"no",
"unsure"
],
"type": "string",
"description": "Whether the notice is in writing; an email, text or other electronic message counts."
}
},
"required": [
"history",
"received",
"starts",
"tenancyStart",
"written"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"checks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"outcome": {
"enum": [
"met",
"not-met",
"unsure"
],
"type": "string"
},
"rule": {
"enum": [
"notice",
"sinceLastIncrease",
"form"
],
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"outcome",
"rule",
"text"
]
}
},
"earliestAllowed": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
]
},
"lawAsAt": {
"type": "string"
},
"page": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"checks",
"earliestAllowed",
"lawAsAt",
"page",
"summary"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢check_statutory_notice(given, nation, started)
Work out the least notice the law requires to end employment in any UK nation, from the employer and from the employee, from the start date and the day notice is given. A contract can require more notice, never less.
Input Schema
{
"type": "object",
"properties": {
"given": {
"type": "string",
"format": "date",
"description": "The day notice is given, as YYYY-MM-DD."
},
"nation": {
"enum": [
"england",
"wales",
"scotland",
"northern-ireland"
],
"type": "string",
"description": "The UK nation where the employee mainly works."
},
"started": {
"type": "string",
"format": "date",
"description": "The day the employee started working for the employer, as YYYY-MM-DD."
}
},
"required": [
"given",
"nation",
"started"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"employeeWeeks": {
"type": "number"
},
"employerWeeks": {
"type": "number"
},
"law": {
"type": "string"
},
"lawAsAt": {
"type": "string"
},
"page": {
"type": "string"
},
"years": {
"type": "number"
}
},
"required": [
"employeeWeeks",
"employerWeeks",
"law",
"lawAsAt",
"page",
"years"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢check_holiday_entitlement(daysPerWeek, nation)
Work out the statutory minimum paid holiday a year, in days, for a worker who works a set number of days a week, in any UK nation: 5.6 weeks, at most 28 days, which may include bank holidays.
Input Schema
{
"type": "object",
"properties": {
"daysPerWeek": {
"type": "number",
"minimum": 0.5,
"maximum": 7,
"description": "The days the worker works each week, such as 5 or 2.5."
},
"nation": {
"enum": [
"england",
"wales",
"scotland",
"northern-ireland"
],
"type": "string",
"description": "The UK nation where the worker mainly works."
}
},
"required": [
"daysPerWeek",
"nation"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"days": {
"type": "number"
},
"law": {
"type": "string"
},
"lawAsAt": {
"type": "string"
},
"page": {
"type": "string"
}
},
"required": [
"days",
"law",
"lawAsAt",
"page"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢check_minimum_wage(age, apprentice, date, hourlyPence, pastSchoolAge)
Check whether an hourly rate of pay meets the UK minimum wage for the worker’s age, and apprenticeship, on a date from 1 April 2024, and give the rate that applies.
Input Schema
{
"type": "object",
"properties": {
"age": {
"type": "integer",
"minimum": 13,
"maximum": 100,
"description": "The worker’s age."
},
"apprentice": {
"enum": [
"no",
"first-year",
"later-year"
],
"type": "string",
"description": "Whether the worker is an apprentice, and if so whether in the first year of the apprenticeship."
},
"date": {
"type": "string",
"format": "date",
"description": "The day the pay is for, as YYYY-MM-DD."
},
"hourlyPence": {
"type": "integer",
"minimum": 0,
"description": "The pay for an hour, in pence."
},
"pastSchoolAge": {
"type": "boolean",
"description": "Whether the worker is over compulsory school age (past the school-leaving day of the year they turn 16)."
}
},
"required": [
"age",
"apprentice",
"date",
"hourlyPence",
"pastSchoolAge"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"answer": {
"oneOf": [
{
"type": "object",
"properties": {
"band": {
"enum": [
"national-living-wage",
"18-to-20",
"under-18",
"apprentice"
],
"type": "string"
},
"from": {
"type": "string"
},
"hourlyPence": {
"type": "number"
},
"kind": {
"const": "rate"
},
"meets": {
"type": "boolean"
}
},
"required": [
"band",
"from",
"hourlyPence",
"kind",
"meets"
]
},
{
"type": "object",
"properties": {
"kind": {
"const": "not-entitled"
}
},
"required": [
"kind"
]
}
]
},
"lawAsAt": {
"type": "string"
},
"page": {
"type": "string"
}
},
"required": [
"answer",
"lawAsAt",
"page"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_tenancy_agreement_review_link
Get the link to a full Contract Lily review of a UK tenancy agreement, and what it covers: whether reviews are open, the nations, what the report includes, the files it accepts and the price. Use it when the user wants their whole agreement checked; it doesn't upload anything.
Input Schema
{
"type": "object",
"properties": {},
"required": [],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"documents": {
"anyOf": [
{
"type": "object",
"properties": {
"kinds": {
"type": "array",
"items": {
"type": "string"
}
},
"maxDocuments": {
"type": "number"
},
"maxMegabytes": {
"type": "number"
}
},
"required": [
"kinds",
"maxDocuments",
"maxMegabytes"
]
},
{
"type": "null"
}
]
},
"includes": {
"type": "array",
"items": {
"type": "string"
}
},
"nations": {
"type": "array",
"items": {
"type": "string"
}
},
"open": {
"type": "boolean"
},
"price": {
"type": "string"
},
"pricing": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"documents",
"includes",
"nations",
"open",
"price",
"pricing",
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_employment_contract_review_link
Get the link to a full Contract Lily review of a UK employment contract, offer letter or written statement, and what it covers: whether employment reviews are open, the nations, what the report includes, the files it accepts and the price. Use it when the user wants their whole contract checked; it doesn't upload anything.
Input Schema
{
"type": "object",
"properties": {},
"required": [],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"documents": {
"anyOf": [
{
"type": "object",
"properties": {
"kinds": {
"type": "array",
"items": {
"type": "string"
}
},
"maxDocuments": {
"type": "number"
},
"maxMegabytes": {
"type": "number"
}
},
"required": [
"kinds",
"maxDocuments",
"maxMegabytes"
]
},
{
"type": "null"
}
]
},
"includes": {
"type": "array",
"items": {
"type": "string"
}
},
"nations": {
"type": "array",
"items": {
"type": "string"
}
},
"open": {
"type": "boolean"
},
"price": {
"type": "string"
},
"pricing": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"documents",
"includes",
"nations",
"open",
"price",
"pricing",
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence
Recent observations
verifiedversion not recorded11 tools