Start with a location
Most data tools need a location. Your assistant first callsresolve_location or resolve_radius_location to turn a place name, postcode or drawn area into a location token, then passes that token to the data tools.
Location tokens are tied to your account and saved, so your assistant can reuse the same area later in a conversation, or in a new one, without looking it up again. They don’t expire.
Choose the right area
A place name can match more than one kind of area. For example, “Lambeth” is a London borough and part of a postcode district name.- When an area’s name matches your words exactly, that area wins. “Lambeth” resolves to the London Borough of Lambeth, not the “South Lambeth SW8” postcode district.
- When the same name matches areas at more than one level, the call returns an error that lists each candidate with its
geography_typeandcode. Your assistant then callsresolve_locationagain for the one you mean. - For a borough, council or ward, say so in your question. Your assistant passes
geography_typeaslocal_authorityorward. - If you know the ONS code, such as
E09000022for Lambeth, your assistant can pass it ascode. Acodetakes precedence over a name.
geography_type to one of these levels:
A full postcode resolves as
postcode_unit. You can’t ask for postcode_unit as a geography type. Give the full postcode as the place name instead.
An area found by name, postcode or code comes back with its name and code. Where known, it also has its geography_type and approximate area_km2. Check these before you rely on figures for the area.
If nothing matches, the error suggests checking the spelling, trying another geography_type, or passing the ONS code as code.
Landmarks and drawn areas
Some place names aren’t a postcode or a known area, such as “Mile End Tube Station”.resolve_location looks these up as landmarks. The result includes centroid, center_name and center_source.
- If the result also has
bounding_box, the token covers that landmark’s area. Your assistant can pass it straight to data tools. bounding_boxis[west, south, east, north], in longitude and latitude.- If the result has no
bounding_box, the token is a single point. Data tools don’t accept a point. - For a point, your assistant calls
resolve_radius_locationwith a radius. It passes the token aslocation_token, or thecentroidas coordinates. It then uses the new catchment token with data tools. - To control the catchment, say how far in your question, such as “within one mile of Mile End Tube Station”.
custom_geometry must be a Polygon or MultiPolygon. Data tools reject Point and other non-area geometries; use resolve_radius_location to build an area around a point.
Prices, rents and market trends
Listing photos
Ask your assistant to show you the photos for a listing it has found withsearch_comparables. It passes that listing’s images to render_property_images.
- If your assistant supports MCP Apps, the photos appear in the conversation. With more than one photo, you get previous and next arrows and a counter.
- If it doesn’t, you get the photo links as text instead.
- A carousel is easiest to look through with about 3 to 8 photos. Longer lists still work, one photo at a time.
- Showing photos doesn’t use any of your monthly allowance.
Planning and development
Land and ownership
Area insights
EPC certificates by UPRN
If you already know the UPRNs of the homes you’re interested in, ask your assistant to look up their EPC certificates. It passes them tosearch_epc_certificates as uprns.
- You can look up at most 200 UPRNs in one call. For a longer portfolio, your assistant splits the list and calls again.
- A UPRN lookup doesn’t take a location or lodgement dates. To search an area, your assistant uses a location token with
date_fromanddate_toinstead. - UPRNs with no matching certificate come back in
unmatched_uprns. - A UPRN in
unmatched_uprnsmeans no certificate has been matched to that home. It doesn’t always mean the home has no EPC. - Each certificate returned counts towards your monthly allowance.
Demographic indicators
Ask for one indicator when you want that series. Ask for an area overview when you want the five axes together (get_demographics_summary). Census indicators use a single census snapshot date. Time series need a start date and an end date. Income and affordability default to the last three years. Broadband includes the UK national benchmark. Each of these counts as one series on your allowance.
Compare an area with a benchmark
Ask whether an area is above or below the national or regional average. Your assistant passesbenchmark to get_crime_trends, get_education or get_homelessness.
nationalcompares the area with England and Wales.regioncompares the area with the region that contains it. The result doesn’t name the region.- Without
benchmark, you get the area figures only.
benchmark block. Its scope says what the area is compared with, and its unit says how the values are measured.
Crime rates exist only for high, mid and low categories. You can’t combine
benchmark with sub_category. If you ask for both, you get this error: sub_category cannot be combined with benchmark: per-1,000 rates are by high, mid, or low category only. Use category, or omit benchmark.
If the benchmark lookup fails, the call returns an error instead of the area figures. Ask again, or ask without the comparison.
You ask: “How do qualification levels in Croydon compare with England and Wales?”
Your assistant calls get_education for Croydon CR with benchmark set to national. An excerpt of the result:
Broad analytical questions
For questions that cut across several datasets, your assistant can ask REalyse to build an analytical report.
These two tools work from place names rather than location tokens, so your assistant describes the area in words when it uses them.
Account and data freshness
Tips for better answers
- Name the area clearly. A postcode or a well-known place name works better than a vague description.
- Say “borough”, “council” or “ward” when you mean one, so your assistant resolves that level.
- Say what period you’re interested in, such as “since January 2025” or “over the last three years”.
- Ask your assistant to check
get_dataset_update_datesif you need to know how current the figures are. - Large searches use more of your allowance. See Usage limits.
What MCP does not include
MCP does not cover every dataset and filter in REalyse Core. Data coverage lists the gaps, including official Land Registry documents and valuation requests. Distressed-asset data is not available.generate_data_report answers broad questions through a separate analytical service. It does not fill those gaps.