Metadata-Version: 2.4
Name: uk-property-mcp
Version: 1.0.1
Summary: UK property data MCP server — Land Registry, Rightmove, EPC, rental yields, stamp duty, Companies House.
License-Expression: MIT
Keywords: buy-to-let,claude,epc,fastmcp,land-registry,mcp,model-context-protocol,property-data,property-investment,rental-yield,rightmove,uk,uk-property
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: anyio>=4.0.0
Requires-Dist: fastmcp>=3.2.4
Requires-Dist: httpx>=0.27.0
Requires-Dist: prometheus-client>=0.20.0
Requires-Dist: property-shared>=1.6.1
Description-Content-Type: text/markdown

# uk-property-mcp

UK property data MCP server for AI hosts (Claude, ChatGPT). Wraps Land Registry, Rightmove, EPC, rental yields, stamp duty, and Companies House into 13 tools.

## Install

```bash
pip install uk-property-mcp
```

Or with uvx (no install required):

```bash
uvx uk-property-mcp
```

## Connect

### Claude Code / Claude Desktop (stdio)

Add to `.mcp.json`:

```json
{
  "mcpServers": {
    "property": {
      "command": "uvx",
      "args": ["uk-property-mcp"]
    }
  }
}
```

### Claude.ai (remote)

`https://uk-property-mcp.fly.dev/mcp`

## Tools

| Tool | Description |
|------|-------------|
| `property_report` | Full data pull — comps + EPC + yield + market (needs street address + postcode) |
| `property_comps` | Land Registry comparable sales with EPC-enriched price/sqft |
| `ppd_transactions` | Transaction search by postcode, address, date range, or price |
| `property_yield` | Gross rental yield (PPD sales + Rightmove rentals) |
| `rental_analysis` | Rental market stats, optional yield from purchase price |
| `property_epc` | EPC certificate lookup |
| `rightmove_search` | Rightmove listings for sale or rent |
| `rightmove_listing` | Full details for a specific Rightmove listing |
| `property_blocks` | Block-buy opportunities (buildings with multiple flat sales) |
| `stamp_duty` | SDLT calculator with all surcharges |
| `planning_search` | Local council planning portal URL |
| `company_search` | Companies House search by name |
| `company_profile` | Full Companies House record by company number |

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `EPC_API_EMAIL` | EPC tools | EPC Register API email |
| `EPC_API_KEY` | EPC tools | EPC Register API key |
| `COMPANIES_HOUSE_API_KEY` | company_* tools | Companies House API key (free at developer.company-information.service.gov.uk) |
| `RIGHTMOVE_DELAY_SECONDS` | No | Rate limit delay (default 0.6s) |
| `PORT` | No | HTTP port when self-hosting (default 8080) |

Copy `.env.example` to `.env` and fill in credentials.

## Architecture

`uk-property-mcp` depends on [`property-shared`](https://pypi.org/project/property-shared/) for all business logic (`property_core`). This package is a thin [FastMCP](https://github.com/jlowin/fastmcp) wrapper: 13 async tools, lazy imports, `anyio.to_thread.run_sync` for sync calls.

For structured investment reports that chain these tools, see [bouch.dev/products](https://bouch.dev/products).
