Connect your AI assistant to UK housing data in minutes. Register for an API key, point your MCP client at our hosted endpoint, and start querying EPCs, social housing stock, house prices, rental statistics, and more.
Three steps. No installation required.
Add the OpenHousing.AI endpoint to your client configuration.
Add to your claude_desktop_config.json:
{
"mcpServers": {
"openhousing": {
"type": "url",
"url": "https://openhousing.ai/sse/",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Add to .mcp.json in your project root:
{
"mcpServers": {
"openhousing": {
"type": "url",
"url": "https://openhousing.ai/sse/",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
For any MCP-compatible client, use these endpoints:
MCP Endpoint: https://openhousing.ai/mcp/ SSE Endpoint: https://openhousing.ai/sse/ Header: Authorization: Bearer YOUR_API_KEY
Every request to the MCP endpoint must be authenticated
All requests require an API key passed as an HTTP header:
Authorization: Bearer YOUR_API_KEY
10 tools across 3 official UK government data sources
Search for Energy Performance Certificates in England and Wales. Accepts postcodes in any format, fuzzy local authority name matching.
| Parameter | Type | Description | |
|---|---|---|---|
| postcode | string | optional | UK postcode (e.g. "SW1A 1AA") |
| address | string | optional | Street address or partial match |
| local_authority | string | optional | Local authority name or ONS code |
| energy_band | string | optional | EPC rating band (A–G) |
| property_type | string | optional | house, flat, bungalow, maisonette |
| from_date | string | optional | Lodgement date from (YYYY-MM-DD) |
| to_date | string | optional | Lodgement date to (YYYY-MM-DD) |
| max_results | integer | optional | Results to return (default 25, max 5000) |
Retrieve full EPC history for a specific property by its Unique Property Reference Number.
| Parameter | Type | Description | |
|---|---|---|---|
| uprn | string | required | UPRN (up to 12 digits) |
Aggregated EPC statistics for a local authority. Computes band distribution, property type breakdown, average efficiency scores, and MEES compliance metrics.
| Parameter | Type | Description | |
|---|---|---|---|
| local_authority | string | required | Local authority name or code |
| tenure | string | optional | social, private-rented, owner-occupied |
| group_by | string | optional | energy_band, property_type, construction_age |
Search social housing stock data from the RSH Statistical Data Return.
| Parameter | Type | Description | |
|---|---|---|---|
| provider_name | string | optional | Registered provider name (partial match) |
| local_authority | string | optional | Local authority name or code |
| year | integer | optional | Reporting year (default latest) |
Comprehensive profile of a registered social housing provider including stock breakdown, rents, vacancies, RTB sales, and geographic spread.
| Parameter | Type | Description | |
|---|---|---|---|
| provider_name | string | required | Provider name (fuzzy match) |
Compare key metrics across 2–5 registered providers side by side.
| Parameter | Type | Description | |
|---|---|---|---|
| providers | list[string] | required | List of 2–5 provider names |
| metrics | list[string] | optional | stock, rents, vacancies, rtb_sales |
House price indices, average prices, and annual change for any UK location.
| Parameter | Type | Description | |
|---|---|---|---|
| location | string | required | Local authority, region, or country |
| from_date | string | optional | Start date (YYYY-MM) |
| to_date | string | optional | End date (YYYY-MM) |
| property_type | string | optional | detached, semi-detached, terraced, flat |
Private rental market statistics — monthly rents, percentiles, bedroom breakdown.
| Parameter | Type | Description | |
|---|---|---|---|
| location | string | required | Local authority, region, or country |
| bedrooms | integer | optional | Number of bedrooms (1–4+) |
Housing affordability ratios — house price to earnings, median and lower quartile.
| Parameter | Type | Description | |
|---|---|---|---|
| location | string | required | Local authority name |
| measure | string | optional | median or lower_quartile (default median) |
New build starts, completions, and net additional dwellings by tenure type.
| Parameter | Type | Description | |
|---|---|---|---|
| location | string | required | Local authority, region, or country |
| tenure | string | optional | market, affordable_rent, social_rent, shared_ownership |
Every tool response includes structured data with a _meta block for provenance
All tool responses include a _meta block containing the data source, licence,
attribution text, and the timestamp the data was retrieved. This ensures your AI assistant
can cite sources accurately.
{
"results": [
{
"address": "10 DOWNING STREET, LONDON, SW1A 2AA",
"current_energy_rating": "D",
"current_energy_efficiency": 58,
"potential_energy_rating": "B",
"property_type": "House",
"built_form": "Mid-Terrace",
"total_floor_area": 1345.0,
"lodgement_date": "2023-04-12"
}
],
"total_count": 1,
"_meta": {
"source": "EPC Open Data API",
"licence": "Open Government Licence v3.0",
"attribution": "Contains data from the Energy Performance of Buildings Register, DLUHC",
"retrieved_at": "2026-03-29T14:23:01Z"
}
}
Built-in context and prompt templates available to MCP clients
MCP resources provide static reference data that AI assistants can read for context.
Pre-built prompt templates that guide the AI through common housing data workflows.
Designed for interactive AI assistant use, not bulk data extraction
| Limit | Value | Notes |
|---|---|---|
| Requests per minute | 60 | Per API key |
| Requests per day | 5,000 | Per API key |
| Max results per query | 5,000 | For search_epc; other tools return single records |
| Concurrent connections | 5 | Per API key |
Rate-limited responses return HTTP 429 with a Retry-After header.
Abuse or automated scraping may result in key revocation.