Metadata-Version: 2.4
Name: landcheckup-mcp
Version: 0.1.0
Summary: MCP server for Land Checkup (landcheckup.com) public parcel and town land-record API
License: MIT
Project-URL: Homepage, https://landcheckup.com
Project-URL: Get an API key, https://landcheckup.com/pro
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"

# landcheckup-mcp

MCP (Model Context Protocol) server for [landcheckup.com](https://landcheckup.com) (`api.landcheckup.com`), providing structured parcel and town land-record lookups over stdio JSON-RPC 2.0.

Each parcel report returns measured, dated facts on the lot's own outline—water and sewer service, flooding and wet ground, ground for building, contamination records, zoning, state land rules, preserved land, soils, road frontage, and tax/building records—without scores, verdicts, or owner names.

## Requirements

- Python 3.11+
- A Land Checkup API key (`LANDCHECKUP_API_KEY`, formatted as `lck_...`), bought on [landcheckup.com/pro](https://landcheckup.com/pro); the key is shown on the confirmation page

## Installation

Install from PyPI (pipx or uv keep it in its own environment):

```bash
pipx install landcheckup-mcp
# or
uv tool install landcheckup-mcp
# or
pip install landcheckup-mcp
```

Verify the CLI is available:

```bash
landcheckup-mcp --help
```

## Configuration

| Environment variable | Required | Default | Description |
|---|---|---|---|
| `LANDCHECKUP_API_KEY` | Yes | — | API key sent via the `X-API-Key` request header |
| `LANDCHECKUP_API_URL` | No | `https://api.landcheckup.com` | Base URL for the Land Checkup API |

## Client setup

### Claude Desktop

Add this to your `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`, Windows: `%APPDATA%\Claude\claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "landcheckup": {
      "command": "landcheckup-mcp",
      "env": {
        "LANDCHECKUP_API_KEY": "lck_your_api_key_here"
      }
    }
  }
}
```

### Cursor

Add this to `.cursor/mcp.json` in your project or `~/.cursor/mcp.json` globally:

```json
{
  "mcpServers": {
    "landcheckup": {
      "command": "landcheckup-mcp",
      "env": {
        "LANDCHECKUP_API_KEY": "lck_your_api_key_here"
      }
    }
  }
}
```

### Claude Code

Register the server with the Claude Code CLI:

```bash
claude mcp add landcheckup \
  -e LANDCHECKUP_API_KEY=lck_your_api_key_here \
  -- landcheckup-mcp
```

Or add `.mcp.json` at the root of your project:

```json
{
  "mcpServers": {
    "landcheckup": {
      "command": "landcheckup-mcp",
      "env": {
        "LANDCHECKUP_API_KEY": "lck_your_api_key_here"
      }
    }
  }
}
```

If running directly from a local virtualenv without installing globally, point `"command"` to `"/path/to/.venv/bin/python"` with `"args": ["-m", "landcheckup_mcp"]` (or `"/path/to/.venv/bin/landcheckup-mcp"`).

## Available tools

| Tool | Description |
|---|---|
| `check_parcel_by_address` | Submit a parcel report by street address, wait for completion, and return key facts, structured JSON, and the report URL. |
| `check_parcel_by_number` | Submit a parcel report by parcel number and state (with optional county or municipality), wait for completion, and return key facts and the report URL. |
| `compare_parcels` | Check up to 25 parcels (by address or parcel number) and return a markdown comparison table alongside structured JSON. |
| `get_town_summary` | Fetch published town or county land-record summary figures for a state and town slug. |
| `get_api_usage` | Check your current API key tier, billing month, usage count, monthly quota, and remaining calls. |

## Development & testing

Run the offline test suite (mocked HTTP transport, no external network access required):

```bash
python -m pytest -q mcp/tests
```
