GetMovely
Search homes for sale and off-market, sold prices, EPC, stamp duty: 25m homes in England and Wales.
Should I use this
Quality & Safety
Findings (1)
- LOWin street_price_per_m2
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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": {
"getmovely": {
"url": "https://getmovely.co.uk/mcp"
}
}
}Remote endpoints
https://getmovely.co.uk/mcpstreamable-httpWhat it can do
Tool inventory
Tools (24)
🟢search_addresses(query, sale_pairs, response_likelihood, sort, page, ...)
Find homes in England and Wales by street, postcode, town or address. Each row has the home's last sale, freehold or leasehold, whether it is owner-occupied, whether it is listed for sale, and its response likelihood (High = listed for sale and owner-occupied, Medium = owner-occupied, Unknown = no record). Filter with `response_likelihood` to answer "which homes on this street are owner-occupied and for sale", or sort by it. Returns 20 per page (`limit`, up to 60), newest sale first by default. If the street name exists in several places the answer lists the places as `streets` instead of rows; ask the person which one, then search again with the town or postcode. When nothing matches exactly the answer says so (`exact_match` false) and gives at most ten of the nearest names, which may be in other towns: Scotland and Northern Ireland are not covered.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Street, postcode, outcode, town or full address, as a person would type it: 'Merton Road, SW19', 'BS7 8', 'Ash Street, Salford M6', '41 Denning Road NW3'.",
"maxLength": 160,
"minLength": 2,
"title": "Query",
"type": "string"
},
"sale_pairs": {
"anyOf": [
{
"items": {
"type": "string"
},
"maxItems": 6,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter to homes whose sale history contains these sales, each as 'price:year', e.g. ['450000:2019']. This is how to find the exact address behind a listing or an advert that shows past sales.",
"title": "Sale Pairs"
},
"response_likelihood": {
"anyOf": [
{
"enum": [
"High",
"Medium",
"Unknown",
"Owner on GetMovely"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Only homes with this response likelihood. 'High' = listed for sale and owner-occupied (the homes where a letter reaches an owner who is selling). 'Medium' = owner-occupied, not listed for sale. 'Unknown' = no public record that the owner lives there. 'Owner on GetMovely' = the owner has claimed the address. Leave out for all homes.",
"title": "Response Likelihood"
},
"sort": {
"default": "recent",
"description": "'recent' newest sale first (default); 'likelihood' High first, then Medium, then the rest; 'price_desc' / 'price_asc' by last sale price; 'addr' by address.",
"enum": [
"recent",
"likelihood",
"price_desc",
"price_asc",
"addr"
],
"title": "Sort",
"type": "string"
},
"page": {
"default": 1,
"description": "Page number; `limit` addresses per page.",
"maximum": 60,
"minimum": 1,
"title": "Page",
"type": "integer"
},
"limit": {
"default": 20,
"description": "Addresses per page: 20 by default, up to 60. Ask for fewer when one home is wanted.",
"maximum": 60,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"required": [
"query"
],
"title": "search_addressesArguments"
}🟢get_address(akey)
One home's card, the quick answer to "is this house for sale" and "does the owner live there": full address, last sale, freehold or leasehold, whether it is owner-occupied (from its Energy Performance Certificate), whether it is listed for sale (with the portal, the agent and the link to the advert), its response likelihood (High = listed for sale and owner-occupied), and the link that opens a letter to its owner on GetMovely.
Input Schema
{
"type": "object",
"properties": {
"akey": {
"description": "Address key from search_addresses (hex string).",
"maxLength": 64,
"minLength": 8,
"pattern": "^[a-f0-9]+$",
"title": "Akey",
"type": "string"
}
},
"required": [
"akey"
],
"title": "get_addressArguments"
}🟢address_report(akey)
Everything GetMovely knows about one home in one call. `home` gives the facts in brief: freehold or leasehold, whether it is owner-occupied (from its Energy Performance Certificate), whether it is listed for sale, and its response likelihood (High = listed for sale and owner-occupied). `tiles` is the nine-part report the website shows: sold-price history, building type and size, energy rating with costs and improvements, local market (price per m2 nearby), area price trend, market history (asking price, time on the market, the agent and the link to the advert when it is for sale), nearby essentials, recorded crime and air quality. `contact_owner_url` opens a letter to its owner. About 15 KB: use get_address, sale_history, energy_performance or price_check when one part is enough. Limited to 60 reports per hour per caller, a limit sale_history, energy_performance, price_check and compare_homes share.
Input Schema
{
"type": "object",
"properties": {
"akey": {
"description": "Address key from search_addresses (hex string).",
"maxLength": 64,
"minLength": 8,
"pattern": "^[a-f0-9]+$",
"title": "Akey",
"type": "string"
}
},
"required": [
"akey"
],
"title": "address_reportArguments"
}🟢street_price_per_m2(akey)
Recent Land Registry sales near one home with their EPC floor area, as pounds per square metre and per square foot by year. Scope is the home's own postcode when it has enough sized sales, otherwise the whole street; `scope` says which. Market-value (category A) sales only.
Input Schema
{
"type": "object",
"properties": {
"akey": {
"description": "Address key from search_addresses (hex string).",
"maxLength": 64,
"minLength": 8,
"pattern": "^[a-f0-9]+$",
"title": "Akey",
"type": "string"
}
},
"required": [
"akey"
],
"title": "street_price_per_m2Arguments"
}🟢price_trends(outcode, property_type, factor)
What freehold or leasehold, new build or resale, energy rating and floor area are worth per square metre in one postcode district, for one property type (D detached, S semi-detached, T terraced, F flat), by whole calendar year, against the national picture. Property type is always held constant because it is the confounder that makes the naive comparison lie. Every figure is a median of at least a minimum number of sales; no per-address data. For a plain summary of a district across all its property types use area_overview.
Input Schema
{
"type": "object",
"properties": {
"outcode": {
"description": "Postcode district (outcode) such as 'SW19', 'BS7', 'M6'. A full postcode is accepted; only the district is used.",
"maxLength": 8,
"minLength": 2,
"title": "Outcode",
"type": "string"
},
"property_type": {
"default": "T",
"enum": [
"D",
"S",
"T",
"F"
],
"title": "Property Type",
"type": "string"
},
"factor": {
"default": "all",
"enum": [
"all",
"tenure",
"newbuild",
"epc",
"size"
],
"title": "Factor",
"type": "string"
}
},
"required": [
"outcode"
],
"title": "price_trendsArguments"
}🟢whats_nearby(akey, radius_m, closest, n, akeys)
Train, tram and ferry stops, bus stops, primary and secondary schools, cafes and restaurants, pubs, takeaways, supermarkets, parks and play areas around a home, from official open data, within 100 m to 2 km: for each kind the count, the nearest one and its distance. Pass `closest` with a kind to get the nearest N of that kind instead, however far (the way to ask "how far is the station" for a rural home). To compare many homes, pass up to 50 keys in `akeys` and get one row per home in `homes`: never call this once per home.
Input Schema
{
"type": "object",
"properties": {
"akey": {
"anyOf": [
{
"description": "Address key from search_addresses (hex string).",
"maxLength": 64,
"minLength": 8,
"pattern": "^[a-f0-9]+$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Address key of one home, from search_addresses. Give this or `akeys`.",
"title": "Akey"
},
"radius_m": {
"default": 800,
"description": "Radius in metres, 100 to 2000.",
"maximum": 2000,
"minimum": 100,
"title": "Radius M",
"type": "integer"
},
"closest": {
"anyOf": [
{
"enum": [
"rail_station",
"tram_metro",
"bus_stop",
"ferry",
"school_primary",
"school_secondary",
"cafe_restaurant",
"pub_bar",
"takeaway",
"supermarket",
"park",
"playground"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Instead of counts within the radius, list the N closest places of this one kind (expanding rings up to 16 km).",
"title": "Closest"
},
"n": {
"default": 10,
"description": "How many closest places, with `closest`: 10 by default, up to 25 for one home; at most 3 per home with `akeys`.",
"maximum": 25,
"minimum": 1,
"title": "N",
"type": "integer"
},
"akeys": {
"anyOf": [
{
"items": {
"description": "Address key from search_addresses (hex string).",
"maxLength": 64,
"minLength": 8,
"pattern": "^[a-f0-9]+$",
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Several homes in one call, up to 50 address keys: use this instead of calling once per home, for example for every home recent_sales or search_homes_for_sale returned.",
"title": "Akeys"
}
},
"title": "whats_nearbyArguments"
}🟢tenure_check(query)
Whether homes matching an address are freehold or leasehold, from the tenure recorded on the latest Land Registry sale of each exact address, with that sale's date. Up to 12 candidates; null tenure means no recorded sale with a tenure. Matching is by text: when `fuzzy` is true or the rows are not the address asked for, use search_addresses, whose rows carry `tenure_at_last_sale` for the exact home.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Address or street with postcode, e.g. '12 Church Lane, BS7 8AB'.",
"maxLength": 160,
"minLength": 3,
"title": "Query",
"type": "string"
}
},
"required": [
"query"
],
"title": "tenure_checkArguments"
}🟢house_age(query)
The construction age band of homes matching an address, from the Energy Performance Certificate, with what that era means for the construction, plus the first recorded sale year as corroboration and the property type. Up to 12 candidates.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Address or street with postcode.",
"maxLength": 160,
"minLength": 3,
"title": "Query",
"type": "string"
}
},
"required": [
"query"
],
"title": "house_ageArguments"
}🟢sale_history(akey)
Every recorded sale of one home since 1995, from HM Land Registry price paid data: price, month and year, the price per square metre each sale works out at on the home's current EPC floor area, and the change from the first sale to the last. The short answer to "what did this house sell for"; address_report has the rest.
Input Schema
{
"type": "object",
"properties": {
"akey": {
"description": "Address key from search_addresses (hex string).",
"maxLength": 64,
"minLength": 8,
"pattern": "^[a-f0-9]+$",
"title": "Akey",
"type": "string"
}
},
"required": [
"akey"
],
"title": "sale_historyArguments"
}🟢energy_performance(akey)
A home's Energy Performance Certificate in plain terms: rating and score now and the rating it could reach, modelled running costs a year for heating, hot water and lighting, carbon dioxide, which parts of the building are weak (walls, roof, windows), and the assessor's own list of improvements with their indicative costs. Costs are the assessor's model at the prices of the certificate's date, not bills.
Input Schema
{
"type": "object",
"properties": {
"akey": {
"description": "Address key from search_addresses (hex string).",
"maxLength": 64,
"minLength": 8,
"pattern": "^[a-f0-9]+$",
"title": "Akey",
"type": "string"
}
},
"required": [
"akey"
],
"title": "energy_performanceArguments"
}🟢price_check(akey, price_gbp)
Is a price in line? Works out the price per square metre from the home's EPC floor area and sets it against three things: what homes of the same type sold for per square metre in the same postcode district in the latest whole year, with the quartiles; recent sales on the home's own street or postcode; and the home's own last sale moved by the district's change since. Also gives the price range the district's quartiles imply for this floor area. Arithmetic on public medians, not a valuation, and the answer carries the caveats to pass on. Shares the address report's limit of 60 an hour per caller.
Input Schema
{
"type": "object",
"properties": {
"akey": {
"description": "Address key from search_addresses (hex string).",
"maxLength": 64,
"minLength": 8,
"pattern": "^[a-f0-9]+$",
"title": "Akey",
"type": "string"
},
"price_gbp": {
"anyOf": [
{
"maximum": 100000000,
"minimum": 10000,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "The price to check, in pounds: an asking price, an offer, a valuation. Leave out to get what the district's prices imply for a home this size (and, when the home is advertised for sale, to check its asking price).",
"title": "Price Gbp"
}
},
"required": [
"akey"
],
"title": "price_checkArguments"
}🟢negotiation_brief(akey)
The evidence a buyer brings to an offer on one home that is advertised for sale: the asking price now, every change to it GetMovely has seen on the advert (with dates and the total cut), how long it has been on the market, the asking price per square metre against what the same type of home sold for in the postcode district, against recent sales on the street, and against the home's own last sale moved by the district's change since, then the points that follow, in plain sentences. Evidence, not a valuation or advice on what to offer. For a home that is not on the market use price_check. Shares the address report's limit of 60 an hour per caller.
Input Schema
{
"type": "object",
"properties": {
"akey": {
"description": "Address key from search_addresses (hex string).",
"maxLength": 64,
"minLength": 8,
"pattern": "^[a-f0-9]+$",
"title": "Akey",
"type": "string"
}
},
"required": [
"akey"
],
"title": "negotiation_briefArguments"
}🟢compare_homes(akeys)
Two to four homes side by side, one row each: type and floor area, tenure, last sale and its price per square metre, energy rating and modelled running cost, what the street has sold for recently, the district trend, whether it is owner-occupied, whether it is listed for sale and its response likelihood (High = both), the nearest supermarket, primary school, station and park, recorded crime and air quality. Each row links its own report and the page that opens a letter to its owner. Counts as one address report per home against the 60 an hour limit.
Input Schema
{
"type": "object",
"properties": {
"akeys": {
"description": "Two to four address keys from search_addresses.",
"items": {
"description": "Address key from search_addresses (hex string).",
"maxLength": 64,
"minLength": 8,
"pattern": "^[a-f0-9]+$",
"type": "string"
},
"maxItems": 4,
"minItems": 2,
"title": "Akeys",
"type": "array"
}
},
"required": [
"akeys"
],
"title": "compare_homesArguments"
}🟢find_address_from_sale_history(area, sales, match)
Property portals often hide the house number but show the home's past sale prices. HM Land Registry records every sale by exact address, so the sale history identifies the home: give the area and the sales, get the address or addresses that match. One match is the answer. Several means add another sale or a tighter area. None means check the year (portals show the year the sale completed) or widen the area. The returned `akey` works with every per-address tool.
Input Schema
{
"type": "object",
"properties": {
"area": {
"description": "Where the listing says the home is: a street with its district ('Merton Road, SW19'), a postcode or its first half ('SW19 1'), or a town.",
"maxLength": 160,
"minLength": 2,
"title": "Area",
"type": "string"
},
"sales": {
"description": "Past sales shown on the listing, each as 'price:year' in pounds, for example ['450000:2019', '310000:2012']. More sales narrow it faster.",
"items": {
"type": "string"
},
"maxItems": 6,
"minItems": 1,
"title": "Sales",
"type": "array"
},
"match": {
"default": "any",
"description": "'any' (default): the home has these sales, possibly among others. 'last': the newest sale given is the home's most recent sale. 'only': the home has exactly these sales and no others.",
"enum": [
"any",
"last",
"only"
],
"title": "Match",
"type": "string"
}
},
"required": [
"area",
"sales"
],
"title": "find_address_from_sale_historyArguments"
}🟢area_overview(outcode)
What homes sell for in one postcode district, for every property type sold there (detached, semi-detached, terraced, flats): the latest whole year's median price per square metre with its quartiles and number of sales, the change since the series began in 2015, and the year in progress against the same months a year earlier. Use compare_areas to set districts against each other and price_trends for what tenure, energy rating or size are worth within one.
Input Schema
{
"type": "object",
"properties": {
"outcode": {
"description": "Postcode district such as 'SW19', 'BS7', 'M6'. A full postcode is accepted; only the district is used.",
"maxLength": 8,
"minLength": 2,
"title": "Outcode",
"type": "string"
}
},
"required": [
"outcode"
],
"title": "area_overviewArguments"
}🟢compare_areas(outcodes, property_type, floor_area_m2)
Two to six postcode districts side by side for one property type: latest whole year's median price per square metre with quartiles and sales, change since 2015, the year in progress against the same months a year earlier and, when a floor area is given, what that many square metres cost at each district's median. Property type is held constant because comparing a district of flats with a district of houses compares the mix, not the place.
Input Schema
{
"type": "object",
"properties": {
"outcodes": {
"description": "Two to six postcode districts, for example ['SW19', 'BS7', 'M20'].",
"items": {
"type": "string"
},
"maxItems": 6,
"minItems": 2,
"title": "Outcodes",
"type": "array"
},
"property_type": {
"default": "T",
"description": "One type, held constant across the districts: D detached, S semi-detached, T terraced, F flat.",
"enum": [
"D",
"S",
"T",
"F"
],
"title": "Property Type",
"type": "string"
},
"floor_area_m2": {
"anyOf": [
{
"maximum": 600,
"minimum": 15,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional floor area to price at each district's median, for example 100.",
"title": "Floor Area M2"
}
},
"required": [
"outcodes"
],
"title": "compare_areasArguments"
}🟢district_statistics(district)
GetMovely's published research for one local authority district, with England and Wales alongside: the share of homes that are leasehold (houses and flats separately), how many years pass between sales of the same home and the share not sold for 20 years or more, the share of purchases resold within two years, and how big homes are (median floor area, by property type and built form). Districts are named as HM Land Registry and the EPC register name them; an unclear name returns the candidates. For prices use area_overview, which works by postcode district.
Input Schema
{
"type": "object",
"properties": {
"district": {
"description": "A local authority district in England or Wales by name: 'Bristol', 'Camden', 'Merton', 'Leeds', 'Cardiff'. 'London' gives Greater London as a whole and 'England and Wales' the national figures.",
"maxLength": 80,
"minLength": 2,
"title": "District",
"type": "string"
}
},
"required": [
"district"
],
"title": "district_statisticsArguments"
}🟢search_homes_for_sale(area, max_price_gbp, min_price_gbp, min_bedrooms, max_bedrooms, ...)
Homes currently advertised for sale in an area of England or Wales, by criteria: "find me a 3-bed under £400k in BS7", "flats over 60 m2 in Wimbledon". Filter by asking price, bedrooms, property type and floor area; and, for adverts GetMovely has matched to an exact address, by freehold or leasehold, energy rating and whether the owner lives there. Each row has the asking price, bedrooms, type, floor area, price per square metre, when it was listed and days on the market, the portal, agent and link to the advert, and for a matched home its address key, response likelihood and the link that opens a letter to its owner. 20 a page; `total` is every advert that fits. Adverts are re-read regularly, so a brand-new listing can be missing.
Input Schema
{
"type": "object",
"properties": {
"area": {
"description": "Where to look: a postcode district ('BS7'), a full postcode ('SW19 1AB'), a town ('Wimbledon'), or a street with its district or town ('Elm Road, BS7').",
"maxLength": 160,
"minLength": 2,
"title": "Area",
"type": "string"
},
"max_price_gbp": {
"anyOf": [
{
"maximum": 1000000000,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Highest asking price in pounds.",
"title": "Max Price Gbp"
},
"min_price_gbp": {
"anyOf": [
{
"maximum": 1000000000,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Lowest asking price in pounds.",
"title": "Min Price Gbp"
},
"min_bedrooms": {
"anyOf": [
{
"maximum": 20,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Min Bedrooms"
},
"max_bedrooms": {
"anyOf": [
{
"maximum": 20,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Max Bedrooms"
},
"property_type": {
"anyOf": [
{
"enum": [
"house",
"flat",
"detached",
"semi-detached",
"terraced",
"bungalow"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "From the advert's own words. 'house' is any house including bungalows; 'flat' includes apartments and maisonettes; 'terraced' includes end of terrace.",
"title": "Property Type"
},
"min_floor_area_m2": {
"anyOf": [
{
"maximum": 2000,
"minimum": 10,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Smallest floor area in square metres. Adverts with no floor area on record are left out.",
"title": "Min Floor Area M2"
},
"tenure": {
"anyOf": [
{
"enum": [
"freehold",
"leasehold"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "As recorded at the home's last sale. Only adverts matched to an exact address can be filtered this way.",
"title": "Tenure"
},
"epc_ratings": {
"anyOf": [
{
"items": {
"enum": [
"A",
"B",
"C",
"D",
"E",
"F",
"G"
],
"type": "string"
},
"maxItems": 7,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Energy ratings to keep, for example ['A','B','C']. Only adverts matched to an exact address.",
"title": "Epc Ratings"
},
"owner_occupied": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True: only homes whose Energy Performance Certificate records them as owner-occupied (response likelihood High). Only adverts matched to an exact address.",
"title": "Owner Occupied"
},
"sort": {
"default": "newest",
"description": "'newest' advert first (default), by asking price, by asking price per square metre (lowest first), or largest first.",
"enum": [
"newest",
"price_asc",
"price_desc",
"price_per_m2",
"largest"
],
"title": "Sort",
"type": "string"
},
"page": {
"default": 1,
"description": "Page number, 20 homes a page.",
"maximum": 50,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
"required": [
"area"
],
"title": "search_homes_for_saleArguments"
}🟢find_homes_not_for_sale(area, property_type, min_floor_area_m2, max_floor_area_m2, tenure, ...)
Homes that are NOT advertised for sale, by criteria: the homes a buyer could write to. "Which houses on this street could I write to", "owner-occupied houses over 120 m2 in BS7 that last sold before 2005". Filter by property type, floor area, freehold or leasehold, energy rating, when and for how much the home last sold, and whether the owner lives there. Each row has the address, type, floor area, energy rating, last sale and its price per square metre, whether it is owner-occupied, its response likelihood, and `contact_owner_url`, the link that opens a letter to that home's owner on GetMovely. Most property servers list only what is on the market; this one searches the homes that are not. 20 a page.
Input Schema
{
"type": "object",
"properties": {
"area": {
"description": "Where to look: a postcode district ('BS7'), a full postcode ('SW19 1AB'), a town ('Wimbledon'), or a street with its district or town ('Elm Road, BS7'). A town of more than four postcode districts must be narrowed to a district.",
"maxLength": 160,
"minLength": 2,
"title": "Area",
"type": "string"
},
"property_type": {
"anyOf": [
{
"enum": [
"house",
"flat",
"bungalow",
"maisonette"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "From the home's Energy Performance Certificate, which does not say detached, semi-detached or terraced.",
"title": "Property Type"
},
"min_floor_area_m2": {
"anyOf": [
{
"maximum": 2000,
"minimum": 10,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Min Floor Area M2"
},
"max_floor_area_m2": {
"anyOf": [
{
"maximum": 2000,
"minimum": 10,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Max Floor Area M2"
},
"tenure": {
"anyOf": [
{
"enum": [
"freehold",
"leasehold"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "As recorded at the home's last sale, so homes with no recorded sale are left out.",
"title": "Tenure"
},
"epc_ratings": {
"anyOf": [
{
"items": {
"enum": [
"A",
"B",
"C",
"D",
"E",
"F",
"G"
],
"type": "string"
},
"maxItems": 7,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Energy ratings to keep, for example ['E','F','G'] for homes that need work.",
"title": "Epc Ratings"
},
"last_sold_before_year": {
"anyOf": [
{
"maximum": 2100,
"minimum": 1996,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Last sold before this year: long-held homes. Homes with no recorded sale since 1995 are included too unless no_recorded_sale says otherwise.",
"title": "Last Sold Before Year"
},
"last_sold_after_year": {
"anyOf": [
{
"maximum": 2100,
"minimum": 1995,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Last sold in or after this year.",
"title": "Last Sold After Year"
},
"no_recorded_sale": {
"anyOf": [
{
"enum": [
"include",
"only",
"exclude"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Homes with no sale on record since 1995 (held longest of all): 'only' those, or 'exclude' them.",
"title": "No Recorded Sale"
},
"min_last_sale_price_gbp": {
"anyOf": [
{
"maximum": 1000000000,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Min Last Sale Price Gbp"
},
"max_last_sale_price_gbp": {
"anyOf": [
{
"maximum": 1000000000,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Max Last Sale Price Gbp"
},
"owner_occupied": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True: only homes whose Energy Performance Certificate records them as owner-occupied (response likelihood Medium), where a letter reaches the owner.",
"title": "Owner Occupied"
},
"sort": {
"default": "owner_occupied_first",
"description": "'owner_occupied_first' (default, the website's order), 'longest_held' oldest last sale first, 'recent' newest sale first, by last sale price, or largest floor area first.",
"enum": [
"owner_occupied_first",
"longest_held",
"recent",
"price_asc",
"price_desc",
"largest"
],
"title": "Sort",
"type": "string"
},
"page": {
"default": 1,
"description": "Page number, 20 homes a page.",
"maximum": 50,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
"required": [
"area"
],
"title": "find_homes_not_for_saleArguments"
}🟢recent_sales(area, property_type, sold_from, sold_to, min_price_gbp, ...)
What sold in an area, newest first: "what sold near here this year", "flats sold in SW19 since January for under £500k". HM Land Registry price paid data for a postcode district, postcode, street or small town, filtered by property type, date range, price range, floor area, tenure and new build. Each sale has the address, price, date, type, freehold or leasehold, and the price per square metre where the home has a floor area on its Energy Performance Certificate. Market-value sales only. Sales reach the register two weeks to two months after completion, so the last few weeks are always incomplete. For one home's own history use sale_history.
Input Schema
{
"type": "object",
"properties": {
"area": {
"description": "Where to look: a postcode district ('BS7'), a full postcode ('SW19 1AB'), a town ('Wimbledon'), or a street with its district or town ('Elm Road, BS7'). A town of more than six postcode districts must be narrowed to a district.",
"maxLength": 160,
"minLength": 2,
"title": "Area",
"type": "string"
},
"property_type": {
"anyOf": [
{
"enum": [
"D",
"S",
"T",
"F"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "D detached, S semi-detached, T terraced, F flat (the Land Registry's own classes).",
"title": "Property Type"
},
"sold_from": {
"anyOf": [
{
"maxLength": 10,
"pattern": "^\\d{4}(-\\d{2}-\\d{2})?$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Earliest sale date, 'YYYY-MM-DD', or a year ('2026' means from 1 January 2026).",
"title": "Sold From"
},
"sold_to": {
"anyOf": [
{
"maxLength": 10,
"pattern": "^\\d{4}(-\\d{2}-\\d{2})?$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Latest sale date, 'YYYY-MM-DD', or a year ('2025' means to 31 December 2025).",
"title": "Sold To"
},
"min_price_gbp": {
"anyOf": [
{
"maximum": 1000000000,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Min Price Gbp"
},
"max_price_gbp": {
"anyOf": [
{
"maximum": 1000000000,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Max Price Gbp"
},
"min_floor_area_m2": {
"anyOf": [
{
"maximum": 2000,
"minimum": 10,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Only sales of homes at least this big. Needs a floor area on an Energy Performance Certificate; with this filter the total is not counted.",
"title": "Min Floor Area M2"
},
"tenure": {
"anyOf": [
{
"enum": [
"freehold",
"leasehold"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "As recorded on the sale.",
"title": "Tenure"
},
"new_build": {
"anyOf": [
{
"enum": [
"only",
"exclude"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "New-build sales only, or leave them out.",
"title": "New Build"
},
"page": {
"default": 1,
"description": "Page number, 20 sales a page.",
"maximum": 50,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
"required": [
"area"
],
"title": "recent_salesArguments"
}🟢stamp_duty(price_gbp, country, buyer, non_uk_resident)
How much stamp duty: Stamp Duty Land Tax for a home in England, Land Transaction Tax for one in Wales, for a home mover, a first-time buyer or an additional property, with the tax in each band and the other two buyer cases beside it. Uses the residential rates published on GOV.UK and gov.wales, quoted in `sources` with the date they were read. An estimate for a standard purchase of one freehold or existing leasehold home by individuals: shared ownership, new leases with rent, companies, mixed-use property and linked purchases follow other rules, and the official calculator is linked in the answer.
Input Schema
{
"type": "object",
"properties": {
"price_gbp": {
"description": "Purchase price in pounds.",
"maximum": 1000000000,
"minimum": 1,
"title": "Price Gbp",
"type": "integer"
},
"country": {
"default": "England",
"description": "Where the home is. England uses Stamp Duty Land Tax; Wales uses Land Transaction Tax.",
"enum": [
"England",
"Wales"
],
"title": "Country",
"type": "string"
},
"buyer": {
"default": "home_mover",
"description": "'home_mover': replacing a main home, the standard rates. 'first_time': every buyer is a first-time buyer. 'additional': the buyer will own more than one home after the purchase (second home, buy to let).",
"enum": [
"home_mover",
"first_time",
"additional"
],
"title": "Buyer",
"type": "string"
},
"non_uk_resident": {
"default": false,
"description": "Buyer is not a UK resident (adds 2% in England).",
"title": "Non Uk Resident",
"type": "boolean"
}
},
"required": [
"price_gbp"
],
"title": "stamp_dutyArguments"
}🟢draft_letter(akey, letter_text)
Hand a letter the person has agreed with you to GetMovely. Returns `letter_url`: a link that opens the letter composer for that home on getmovely.co.uk with the text already filled in, where the person reads it, can edit it, and sends it themselves (free; sending needs a free account, and GetMovely prints and posts it). Nothing is sent and nothing is stored by this call: the text travels inside the link. Checks the website's letter rules first (200 words, 1,400 characters) and says what to fix if the text breaks them. Draft with the person first; the guide 'letter-to-homeowner-asking-to-buy-house' says what a good letter contains.
Input Schema
{
"type": "object",
"properties": {
"akey": {
"description": "Address key from search_addresses (hex string).",
"maxLength": 64,
"minLength": 8,
"pattern": "^[a-f0-9]+$",
"title": "Akey",
"type": "string"
},
"letter_text": {
"description": "The message the person has agreed, as plain text: what goes in the body of the letter. No address block, date or sign-off name is needed; GetMovely lays the letter out.",
"maxLength": 6000,
"minLength": 1,
"title": "Letter Text",
"type": "string"
}
},
"required": [
"akey",
"letter_text"
],
"title": "draft_letterArguments"
}🟢search_guides(query)
GetMovely's plain-English guides to buying and selling homes in England and Wales: contacting an owner directly and the law on it, buying or selling without an estate agent, finding who owns a property or the address behind a listing, how often sales fall through, speeding a sale up, best and final offers, stopping unwanted letters. Returns the closest guides with a one-paragraph summary and the questions each answers; read_guide gives the full text with its sources.
Input Schema
{
"type": "object",
"properties": {
"query": {
"anyOf": [
{
"maxLength": 160,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "What the person wants to know, in plain words: 'is it legal to write to a homeowner', 'who owns the freehold', 'how many house sales fall through'. Leave out to list every guide.",
"title": "Query"
}
},
"title": "search_guidesArguments"
}🟢read_guide(slug)
The full text of one GetMovely guide as Markdown, with the questions it answers, the primary sources it cites (GOV.UK, HM Land Registry, the ICO, The Property Ombudsman and others) and the date it was last updated. General information, not legal advice. Cite the guide's `url` when you use it.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"description": "Guide slug from search_guides, for example 'is-it-legal-to-write-to-a-homeowner'.",
"maxLength": 120,
"minLength": 3,
"pattern": "^[a-z0-9-]+$",
"title": "Slug",
"type": "string"
}
},
"required": [
"slug"
],
"title": "read_guideArguments"
}Community
Evidence