MCP server for UK property data

A worked example

You ask your assistant: "What's the story of 14 Beech Road in Harrogate — has it kept up with the market?" It calls property_details and gets back sale history that already carries its own context: the change since the previous sale, the Bank of England base rate in force at the time, and how far each sale ran ahead of or behind the local market.

{
  "address": "14 Beech Road",
  "bedrooms": 3,
  "listing_type": "sold",
  "postcode": "HG2 8QN",
  "property_type": "semi_detached",
  "sale_history": [
    {
      "base_rate": 4.75,
      "pct_change": null,
      "price": 191000,
      "price_position": null,
      "sold_at": "2004-09-10",
      "vs_market": null
    },
    {
      "base_rate": 0.5,
      "pct_change": 61.78010471204188,
      "price": 309000,
      "price_position": {
        "band": "above",
        "basis": "3-bed semi-detached within 1 km",
        "deviation_pct": 9,
        "n": 34,
        "window_months": 12
      },
      "sold_at": "2016-02-26",
      "vs_market": 11
    },
    {
      "base_rate": 5.0,
      "pct_change": 34.3042071197411,
      "price": 415000,
      "price_position": {
        "band": "in_line",
        "basis": "3-bed semi-detached within 1 km",
        "deviation_pct": -3,
        "n": 41,
        "window_months": 12
      },
      "sold_at": "2023-06-16",
      "vs_market": -6
    }
  ],
  "town": "Harrogate"
}

So the assistant can say: it sold for £415,000 in June 2023, up 34.3% on its 2016 sale — but 6 points behind what the wider local market did over the same years, and into a 5% base rate rather than the 0.5% of the previous sale. That framing is the point of the tool. A raw price list cannot produce it.

The four tools

{
  "count": 2,
  "note": "Every result here is a SOLD record — a past transaction, not a home currently for sale. Do not present these as available listings.",
  "relaxations": [],
  "results": [
    {
      "bedrooms": 3,
      "id": 8412907,
      "listing_type": "sold",
      "price": 372500,
      "property_type": "semi_detached",
      "sale_count": 3,
      "town": "Otley",
      "url": "https://rielty.co.uk/property/22-mill-lane-otley-8412907"
    },
    {
      "bedrooms": 3,
      "id": 8402115,
      "listing_type": "sold",
      "price": 344000,
      "property_type": "terraced",
      "sale_count": 2,
      "town": "Otley",
      "url": "https://rielty.co.uk/property/7-kirk-view-otley-8402115"
    }
  ],
  "returned": 2,
  "unmatched": []
}

{
  "avg_price_12mo": 398450,
  "county": "North Yorkshire",
  "prev_avg_12mo": 389100,
  "price_matrix": {
    "beds": [
      {
        "bucket": "3",
        "n": 604,
        "p25": 288000,
        "p50": 341000,
        "p75": 402500,
        "types": {
          "semi_detached": {
            "n": 291,
            "p50": 332000
          }
        }
      }
    ]
  },
  "sales_12mo": 1842,
  "town": "Harrogate",
  "url": "https://rielty.co.uk/sold-prices/harrogate",
  "yoy_pct": 2.4
}

{
  "based_on_sales": 291,
  "basis": "A statistical estimate from sold prices in this area over the last 12 months — what other homes of that size sold for. It is not an appraisal or a survey, nobody has seen the property, and what any individual home is worth depends on its condition and what has been done to it.",
  "bedrooms": 3,
  "estimate": 332000,
  "property_type": "semi_detached",
  "range_high": 402500,
  "range_low": 288000,
  "reason": null,
  "sales_12mo": 1842,
  "town": "Harrogate",
  "url": "https://rielty.co.uk/house-valuation/harrogate"
}

Install

Claude Code

claude mcp add --transport http rielty https://rielty.co.uk/mcp/v1

Claude Desktop

Settings → Developer → Edit Config, then add rielty to claude_desktop_config.json and restart:

{
  "mcpServers": {
    "rielty": {
      "url": "https://rielty.co.uk/mcp/v1"
    }
  }
}

Cursor

The same block in ~/.cursor/mcp.json (or .cursor/mcp.json for one project).

ChatGPT

In a Developer mode connector, add https://rielty.co.uk/mcp/v1 as an MCP server with no authentication. Availability of custom connectors depends on your ChatGPT plan.

Any MCP client that speaks Streamable HTTP works — there is nothing to install locally and no stdio wrapper needed.

Limits and keys

Anonymous callers are limited per IP address; a RIELTY_API_KEY moves you onto a per-key bucket with higher ceilings. There is an endpoint-wide limit, plus its own bucket for the two most expensive tools.

Getting a key: keys are free, and there is no self-serve signup — one of us mints yours by hand. Email hello@rielty.co.uk with what you are building and roughly what volume you expect, and we will send a key back. Pass it as a bearer token:

Authorization: Bearer RIELTY_API_KEY

FAQ