HouseFile UK property licensing checker is an MCP server published by app.housefile, hosted at www.housefile.app. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 4 tools, including check_property_licensing, list_council_schemes, upcoming_licensing_changes, licensing_coverage.
Checks whether a property in England is in a council's selective or HMO licensing scheme
76 connections through 4 shared values. Tap any node.
Looks up a postcode in England in HouseFile’s records of council licensing schemes and returns each scheme in force there, with its dates, fee, source link and the date the records were last verified, plus the national HMO rule. Schemes not in force yet are listed under upcoming. It works to postcode precision, so near a scheme’s edge it says so. Give occupants and households to settle the mandatory HMO test in England.
| Parameter | Type | Description |
|---|---|---|
| postcode * | string | The full UK postcode of the property being checked, in any spacing or case, such as "e8 1dy". Only its first half is kept |
| occupants | integer | How many people live in the property |
| as_of_date | string | YYYY-MM-DD. Defaults to today; at most 24 months ahead |
| households | integer |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
| How many separate households they form |
{
"name": "check_property_licensing",
"title": "Check a property’s licensing",
"description": "Looks up a postcode in England in HouseFile’s records of council licensing schemes and returns each scheme in force there, with its dates, fee, source link and the date the records were last verified, plus the national HMO rule. Schemes not in force yet are listed under upcoming. It works to postcode precision, so near a scheme’s edge it says so. Give occupants and households to settle the mandatory HMO test in England.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"postcode"
],
"properties": {
"postcode": {
"type": "string",
"maxLength": 10,
"minLength": 5,
"description": "The full UK postcode of the property being checked, in any spacing or case, such as \"e8 1dy\". Only its first half is kept"
},
"occupants": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "How many people live in the property"
},
"as_of_date": {
"type": "string",
"description": "YYYY-MM-DD. Defaults to today; at most 24 months ahead"
},
"households": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "How many separate households they form"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"postcode",
"as_of_date",
"council",
"council_gss_code",
"country",
"covered",
"council_address_checker",
"schemes",
"upcoming",
"disclaimer",
"housefile_url"
],
"properties": {
"council": {
"type": [
"string",
"null"
]
},
"country": {
"enum": [
"England",
"Wales",
"Scotland",
"Northern Ireland",
"unknown"
],
"type": "string"
},
"covered": {
"type": "boolean"
},
"schemes": {
"type": "array",
"items": {
"type": "object",
"required": [
"scheme_name",
"scheme_type",
"council",
"applicability",
"condition",
"start_date",
"end_date",
"fee_summary",
"applies_to",
"source_url",
"council_licensing_page",
"last_verified_at",
"confidence",
"precision",
"precision_note",
"note",
"housefile_url"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"council": {
"type": [
"string",
"null"
]
},
"end_date": {
"type": [
"string",
"null"
]
},
"condition": {
"type": [
"string",
"null"
],
"description": "What the answer depends on, where it isn’t settled"
},
"precision": {
"enum": [
"address",
"postcode"
],
"type": "string"
},
"applies_to": {
"type": [
"string",
"null"
]
},
"confidence": {
"anyOf": [
{
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
{
"type": "null"
}
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"start_date": {
"type": [
"string",
"null"
]
},
"fee_summary": {
"type": [
"string",
"null"
]
},
"scheme_name": {
"type": "string"
},
"scheme_type": {
"enum": [
"selective",
"additional_hmo",
"mandatory_hmo",
"council_schemes"
],
"type": "string"
},
"applicability": {
"enum": [
"applies",
"conditional",
"boundary_uncertain",
"does_not_apply",
"not_covered"
],
"type": "string"
},
"housefile_url": {
"type": [
"string",
"null"
]
},
"precision_note": {
"type": [
"string",
"null"
]
},
"last_verified_at": {
"type": [
"string",
"null"
]
},
"council_licensing_page": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"postcode": {
"type": "string"
},
"upcoming": {
"type": "array",
"items": {
"type": "object",
"required": [
"scheme_name",
"scheme_type",
"council",
"stage",
"applicability",
"note",
"expected_start_date",
"end_date",
"summary",
"source_url",
"last_verified_at",
"housefile_url"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"stage": {
"enum": [
"proposed",
"starting_soon"
],
"type": "string"
},
"council": {
"type": "string"
},
"summary": {
"type": "string"
},
"end_date": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"scheme_name": {
"type": "string"
},
"scheme_type": {
"enum": [
"selective",
"additional_hmo",
"mandatory_hmo",
"council_schemes"
],
"type": "string"
},
"applicability": {
"anyOf": [
{
"enum": [
"applies",
"conditional",
"boundary_uncertain",
"does_not_apply",
"not_covered"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Whether the postcode falls in the scheme’s area on our records, as for a scheme in force. Null where no postcode was given"
},
"housefile_url": {
"type": "string"
},
"last_verified_at": {
"type": [
"string",
"null"
]
},
"expected_start_date": {
"type": [
"string",
"null"
],
"description": "Null where the council hasn’t announced a start date"
}
},
"additionalProperties": false
}
},
"as_of_date": {
"type": "string"
},
"disclaimer": {
"type": "string"
},
"housefile_url": {
"type": "string"
},
"council_gss_code": {
"type": [
"string",
"null"
]
},
"council_address_checker": {
"type": [
"string",
"null"
],
"description": "The council’s own address-level lookup, where it has one"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Check a property’s licensing",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Lists a council’s licensing schemes from HouseFile’s records: in force, starting soon, proposed, and ended in the last 12 months, each with its area, dates, fee, source link and last verified date. Takes a council name, part of a name or a GSS code. If several councils match, it returns them to choose from.
| Parameter | Type | Description |
|---|---|---|
| council * | string | A council name, part of one, or its GSS code, such as "Croydon" or "E09000008" |
{
"name": "list_council_schemes",
"title": "List a council’s licensing schemes",
"description": "Lists a council’s licensing schemes from HouseFile’s records: in force, starting soon, proposed, and ended in the last 12 months, each with its area, dates, fee, source link and last verified date. Takes a council name, part of a name or a GSS code. If several councils match, it returns them to choose from.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"council"
],
"properties": {
"council": {
"type": "string",
"maxLength": 100,
"minLength": 2,
"description": "A council name, part of one, or its GSS code, such as \"Croydon\" or \"E09000008\""
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"result",
"query",
"council",
"schemes",
"candidates",
"disclaimer"
],
"properties": {
"query": {
"type": "string"
},
"result": {
"enum": [
"found",
"several_matches",
"not_covered"
],
"type": "string"
},
"council": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"gss_code",
"licensing_page",
"address_checker",
"checked_no_scheme_on",
"housefile_url"
],
"properties": {
"name": {
"type": "string"
},
"gss_code": {
"type": "string"
},
"housefile_url": {
"type": "string"
},
"licensing_page": {
"type": [
"string",
"null"
]
},
"address_checker": {
"type": [
"string",
"null"
]
},
"checked_no_scheme_on": {
"type": [
"string",
"null"
],
"description": "Set when a person checked and found the council runs no scheme"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"schemes": {
"type": "array",
"items": {
"type": "object",
"required": [
"scheme_name",
"legal_name",
"scheme_type",
"stage",
"start_date",
"end_date",
"coverage_type",
"area",
"dates",
"fee_summary",
"applies_to",
"source_url",
"last_verified_at",
"housefile_url"
],
"properties": {
"area": {
"type": "string"
},
"dates": {
"type": "string"
},
"stage": {
"enum": [
"in_force",
"starting_soon",
"proposed",
"ended"
],
"type": "string"
},
"end_date": {
"type": [
"string",
"null"
]
},
"applies_to": {
"type": [
"string",
"null"
]
},
"legal_name": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"start_date": {
"type": [
"string",
"null"
]
},
"fee_summary": {
"type": [
"string",
"null"
]
},
"scheme_name": {
"type": "string"
},
"scheme_type": {
"enum": [
"selective",
"additional_hmo",
"mandatory_hmo",
"council_schemes"
],
"type": "string"
},
"coverage_type": {
"type": "string"
},
"housefile_url": {
"type": "string"
},
"last_verified_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"gss_code",
"housefile_url"
],
"properties": {
"name": {
"type": "string"
},
"gss_code": {
"type": "string"
},
"housefile_url": {
"type": "string"
}
},
"additionalProperties": false
}
},
"disclaimer": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "List a council’s licensing schemes",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}What’s coming: schemes proposed or starting soon, and recent changes to schemes in HouseFile’s records (started, ended, fee, dates or area changed), newest first. Optionally for one council, and for a number of months ahead and back (6 by default, at most 24). For all councils the lists stop at the 15 soonest schemes and the 10 latest changes, with the totals; ask for one council to see all of its own.
| Parameter | Type | Description |
|---|---|---|
| council | string | A council name, part of one, or its GSS code |
| within_months | integer | Months ahead and back to look, 6 by default |
{
"name": "upcoming_licensing_changes",
"title": "Upcoming licensing changes",
"description": "What’s coming: schemes proposed or starting soon, and recent changes to schemes in HouseFile’s records (started, ended, fee, dates or area changed), newest first. Optionally for one council, and for a number of months ahead and back (6 by default, at most 24). For all councils the lists stop at the 15 soonest schemes and the 10 latest changes, with the totals; ask for one council to see all of its own.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"council": {
"type": "string",
"maxLength": 100,
"minLength": 2,
"description": "A council name, part of one, or its GSS code"
},
"within_months": {
"type": "integer",
"maximum": 24,
"minimum": 1,
"description": "Months ahead and back to look, 6 by default"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"result",
"council",
"within_months",
"upcoming",
"upcoming_total",
"recent_changes",
"recent_changes_total",
"note",
"candidates",
"disclaimer"
],
"properties": {
"note": {
"type": "string",
"description": "What the stages mean, and how to see more when a list was cut short"
},
"result": {
"enum": [
"found",
"several_matches",
"not_covered"
],
"type": "string"
},
"council": {
"type": [
"string",
"null"
]
},
"upcoming": {
"type": "array",
"items": {
"type": "object",
"required": [
"scheme_name",
"scheme_type",
"council",
"stage",
"expected_start_date",
"end_date",
"source_url",
"last_verified_at",
"housefile_url"
],
"properties": {
"stage": {
"enum": [
"proposed",
"starting_soon"
],
"type": "string"
},
"council": {
"type": "string"
},
"end_date": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
},
"scheme_name": {
"type": "string"
},
"scheme_type": {
"enum": [
"selective",
"additional_hmo",
"mandatory_hmo",
"council_schemes"
],
"type": "string"
},
"housefile_url": {
"type": "string"
},
"last_verified_at": {
"type": [
"string",
"null"
]
},
"expected_start_date": {
"type": [
"string",
"null"
],
"description": "Null where the council hasn’t announced a start date"
}
},
"additionalProperties": false
},
"description": "Soonest first, then proposals with no start date by council; at most 15 when no council is given"
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"gss_code",
"housefile_url"
],
"properties": {
"name": {
"type": "string"
},
"gss_code": {
"type": "string"
},
"housefile_url": {
"type": "string"
}
},
"additionalProperties": false
}
},
"disclaimer": {
"type": "string"
},
"within_months": {
"type": "number"
},
"recent_changes": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"change",
"scheme_name",
"council",
"stage_now",
"source_url",
"housefile_url"
],
"properties": {
"date": {
"type": "string"
},
"change": {
"type": "string"
},
"council": {
"type": "string"
},
"stage_now": {
"enum": [
"in_force",
"starting_soon",
"proposed",
"ended"
],
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"scheme_name": {
"type": "string"
},
"housefile_url": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Newest first, at most 10 when no council is given"
},
"upcoming_total": {
"type": "number",
"description": "How many schemes are proposed or starting soon; more than listed when the list was cut short"
},
"recent_changes_total": {
"type": "number",
"description": "How many changes there were in the window; more than listed when the list was cut short"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Upcoming licensing changes",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Which councils HouseFile’s records cover: each council with published schemes, with how many, how many are in force and when they were last verified, and the councils checked and found to run none. Use it to tell the user honestly whether their area is covered, and list_council_schemes for one council’s detail.
No parameters.
{
"name": "licensing_coverage",
"title": "Which councils are covered",
"description": "Which councils HouseFile’s records cover: each council with published schemes, with how many, how many are in force and when they were last verified, and the councils checked and found to run none. Use it to tell the user honestly whether their area is covered, and list_council_schemes for one council’s detail.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"councils",
"checked_no_scheme_councils",
"council_count",
"councils_with_schemes",
"checked_no_scheme_count",
"published_scheme_count",
"most_recent_verification",
"note",
"housefile_url"
],
"properties": {
"note": {
"type": "string"
},
"councils": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"published_schemes",
"in_force",
"last_verified"
],
"properties": {
"name": {
"type": "string",
"description": "The council’s short name, as on HouseFile’s pages. list_council_schemes takes it as it is"
},
"in_force": {
"type": "number"
},
"last_verified": {
"type": [
"string",
"null"
]
},
"published_schemes": {
"type": "number"
}
},
"additionalProperties": false
},
"description": "Councils with published schemes. Councils checked and found to run none are in checked_no_scheme_councils"
},
"council_count": {
"type": "number",
"description": "Every council the records cover, with schemes or checked and found to run none"
},
"housefile_url": {
"type": "string"
},
"councils_with_schemes": {
"type": "number"
},
"published_scheme_count": {
"type": "number"
},
"checked_no_scheme_count": {
"type": "number"
},
"most_recent_verification": {
"type": [
"string",
"null"
]
},
"checked_no_scheme_councils": {
"type": "array",
"items": {
"type": "string"
},
"description": "Short names of the councils a person checked and found to run no additional or selective scheme. list_council_schemes gives the date"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Which councils are covered",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Checks whether a property in England falls within a council’s selective or additional HMO licensing scheme, using HouseFile’s records. Call licensing_coverage to see which councils the records cover. With each result, show the user the source link and the "last verified" date. If a council is not covered, tell the user HouseFile holds no records for it, and that this doesn’t mean the council has no scheme. Never tell the user a licence isn’t needed: say what HouseFile’s records indicate. Where a result is near a scheme boundary, send the user to the council’s map. Mandatory HMO licensing depends on how many people and households live in the property, so ask about occupancy if the user hasn’t said. Results are general information, not legal advice: tell the user to confirm with the council before letting.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.