conveyancing-mcp-server

MCP server providing UK residential conveyancing tools for AI assistants. Helps first-time buyers and homeowners understand stamp duty, title registers, property searches, surveys, leasehold terms, and transaction progress.

Why

Buying a house in England involves ~15 weeks of opaque legal process and jargon-heavy documents. This server gives Claude (or any MCP-compatible assistant) the domain tools to actually help.

Tools

Tool	What it does
estimate_stamp_duty	SDLT/LBTT/LTT calculator — England, Scotland, Wales (April 2025 rates)
check_lease_terms	Flag concerning leasehold clauses — ground rent, lease length, service charge
explain_search_result	Plain English + severity for local authority, environmental, drainage searches
explain_survey_issue	Translate surveyor jargon with RICS condition ratings, cost estimates, and actions
parse_title_register	Analyse title register entries or raw HMLR text — charges, restrictions, easements
track_transaction_status	Map updates/emails to conveyancing stages with next steps and timeline
estimate_total_costs	Itemised cost breakdown — stamp duty, solicitor, searches, survey, mortgage, LR fees
analyse_lease_document	AI-powered lease analysis using MCP sampling — extracts and checks key terms
plan_my_purchase	Interactive purchase planner with MCP elicitation — timeline, costs, checklist
get_price_history	HMLR Price Paid data — recent sales near a postcode (free, no API key)
lookup_title	HMLR Business Gateway title lookup (requires API key)

Resources

URI	What it provides
conveyancing://process-stages	11 stages from instruction to post-completion
conveyancing://process-stages/{n}	Individual stage detail by number (1–11)
conveyancing://search-types	Standard search types, costs, turnaround, and coverage
conveyancing://search-types/{type}	Individual search type detail
conveyancing://sdlt-rates	Current SDLT bands, FTB relief, surcharges
conveyancing://sdlt-rates/{buyer_type}	SDLT rates for a specific buyer type
conveyancing://lbtt-rates	Scottish LBTT rates and bands
conveyancing://ltt-rates	Welsh LTT rates and bands
conveyancing://tenure-types	Freehold vs leasehold vs commonhold comparison
conveyancing://survey-defects	Common defect categories with severity and cost ranges
conveyancing://survey-defects/{category}	Individual defect category detail
conveyancing://scotland/process-stages	Scottish conveyancing stages (missive-based)
conveyancing://scotland/search-types	Scottish property search types
conveyancing://wales/process-stages	Welsh conveyancing differences

Prompts

Prompt	What it generates
first_time_buyer_briefing	Full briefing: timeline, costs, milestones, pitfalls
pre_exchange_checklist	Everything to confirm before exchange of contracts
solicitor_instruction_letter	Letter to instruct a solicitor on a purchase

Quick Start

# Install from PyPI
pip install conveyancing-mcp-server

# Or with uvx (no install needed)
uvx conveyancing-mcp

# Or install from source for development
pip install -e ".[dev]"

# Run tests
pytest

# Run the server
conveyancing-mcp
# or: python -m conveyancing_mcp.server

Example

A first-time buyer asks about stamp duty on a £350,000 purchase:

Input:

{
  "tool": "estimate_stamp_duty",
  "arguments": {
    "purchase_price": 350000,
    "first_time_buyer": true
  }
}

Output:

{
  "purchase_price": 350000,
  "buyer_type": "first-time buyer",
  "additional_property": false,
  "base_tax": 2500,
  "additional_property_surcharge": 0,
  "total_stamp_duty": 2500,
  "effective_rate_percent": 0.71,
  "country": "England & Northern Ireland",
  "note": "SDLT rates from 1 April 2025. Temporary higher nil-rate bands (Sep 2022–Mar 2025) have reverted."
}

The £2,500 comes from: £300,000 at 0% (FTB nil-rate band) + £50,000 at 5% = £2,500.

Claude Desktop Config

{
  "mcpServers": {
    "conveyancing": {
      "command": "uvx",
      "args": ["conveyancing-mcp"]
    }
  }
}

Or if installed via pip:

{
  "mcpServers": {
    "conveyancing": {
      "command": "conveyancing-mcp"
    }
  }
}

Status

Supports England & Northern Ireland (SDLT), Scotland (LBTT), and Wales (LTT).

SDLT rates verified against GOV.UK as of March 2026.

License

MIT