Metadata-Version: 2.5
Name: scotlis-mcp
Version: 1.0.0
Summary: MCP server exposing ScotLIS (Registers of Scotland) property price search
Project-URL: Repository, https://github.com/Dart120/scotlis-mcp
Author-email: Dart120 <irenitemi81@gmail.com>
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.13
Requires-Dist: mcp[cli]<2,>=1.6.0
Description-Content-Type: text/markdown

# scotlis-mcp

An MCP server exposing [ScotLIS](https://scotlis.ros.gov.uk) (Registers of Scotland) property price search as a tool Claude can call directly.

Given a UK postcode, it returns every registered title at that address with its sale date, price (or non-monetary reason, e.g. a gift between family members), and a link to the property summary.

Only covers Scotland, and only titles on the Land Register — older properties still on the Sasine Register may show no price.

## Use as a standalone CLI

```bash
python3 scotlis_prices.py "EH1 1RE"
python3 scotlis_prices.py "EH1 1RE" --sort price --desc
python3 scotlis_prices.py "EH1 1RE" --format csv > prices.csv
python3 scotlis_prices.py "EH1 1RE" --format json
```

## Install as a Claude Desktop extension (one click, macOS only for now)

Download `scotlis-mcp.mcpb` from the [latest release](https://github.com/Dart120/scotlis-mcp/releases/latest), then double-click it, or drag it into the Claude Desktop window, or use **Settings > Extensions > Advanced settings > Install Extension…**.

This bundle embeds its own Python 3.13 runtime, so it works even if your Mac's system Python is older. It's currently built for macOS only — see [Build the extension bundle](#build-the-extension-bundle) to build one for another platform.

## Use as an MCP server in Claude Desktop (manual config)

Requires [uv](https://docs.astral.sh/uv/).

```bash
git clone https://github.com/Dart120/scotlis-mcp.git
cd scotlis-mcp
uv sync
```

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json
{
  "mcpServers": {
    "scotlis-prices": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/scotlis-mcp", "run", "server.py"]
    }
  }
}
```

Restart Claude Desktop, and Claude will be able to call `search_property_prices` for any UK postcode.

## Build the extension bundle

```bash
uv sync
npm install -g @anthropic-ai/mcpb
cp -R .venv venv   # bundles a real, self-contained interpreter — not a symlink
mcpb pack . scotlis-mcp.mcpb
```

## Disclaimer

Unofficial tool, not affiliated with Registers of Scotland. Queries ScotLIS's public search form directly — be a good citizen and don't hammer it.
