landcheckup-mcp 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- landcheckup_mcp-0.1.0/PKG-INFO +129 -0
- landcheckup_mcp-0.1.0/README.md +116 -0
- landcheckup_mcp-0.1.0/landcheckup_mcp/__init__.py +7 -0
- landcheckup_mcp-0.1.0/landcheckup_mcp/__main__.py +8 -0
- landcheckup_mcp-0.1.0/landcheckup_mcp/cli.py +42 -0
- landcheckup_mcp-0.1.0/landcheckup_mcp/client.py +443 -0
- landcheckup_mcp-0.1.0/landcheckup_mcp/protocol.py +291 -0
- landcheckup_mcp-0.1.0/landcheckup_mcp/tools.py +855 -0
- landcheckup_mcp-0.1.0/landcheckup_mcp.egg-info/PKG-INFO +129 -0
- landcheckup_mcp-0.1.0/landcheckup_mcp.egg-info/SOURCES.txt +17 -0
- landcheckup_mcp-0.1.0/landcheckup_mcp.egg-info/dependency_links.txt +1 -0
- landcheckup_mcp-0.1.0/landcheckup_mcp.egg-info/entry_points.txt +2 -0
- landcheckup_mcp-0.1.0/landcheckup_mcp.egg-info/requires.txt +4 -0
- landcheckup_mcp-0.1.0/landcheckup_mcp.egg-info/top_level.txt +1 -0
- landcheckup_mcp-0.1.0/pyproject.toml +32 -0
- landcheckup_mcp-0.1.0/setup.cfg +4 -0
- landcheckup_mcp-0.1.0/tests/test_client.py +239 -0
- landcheckup_mcp-0.1.0/tests/test_protocol.py +260 -0
- landcheckup_mcp-0.1.0/tests/test_tools.py +624 -0
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: landcheckup-mcp
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: MCP server for Land Checkup (landcheckup.com) public parcel and town land-record API
|
|
5
|
+
License: MIT
|
|
6
|
+
Project-URL: Homepage, https://landcheckup.com
|
|
7
|
+
Project-URL: Get an API key, https://landcheckup.com/pro
|
|
8
|
+
Requires-Python: >=3.11
|
|
9
|
+
Description-Content-Type: text/markdown
|
|
10
|
+
Requires-Dist: httpx>=0.27
|
|
11
|
+
Provides-Extra: dev
|
|
12
|
+
Requires-Dist: pytest>=8.0; extra == "dev"
|
|
13
|
+
|
|
14
|
+
# landcheckup-mcp
|
|
15
|
+
|
|
16
|
+
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.
|
|
17
|
+
|
|
18
|
+
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.
|
|
19
|
+
|
|
20
|
+
## Requirements
|
|
21
|
+
|
|
22
|
+
- Python 3.11+
|
|
23
|
+
- 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
|
|
24
|
+
|
|
25
|
+
## Installation
|
|
26
|
+
|
|
27
|
+
Install from PyPI (pipx or uv keep it in its own environment):
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
pipx install landcheckup-mcp
|
|
31
|
+
# or
|
|
32
|
+
uv tool install landcheckup-mcp
|
|
33
|
+
# or
|
|
34
|
+
pip install landcheckup-mcp
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Verify the CLI is available:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
landcheckup-mcp --help
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## Configuration
|
|
44
|
+
|
|
45
|
+
| Environment variable | Required | Default | Description |
|
|
46
|
+
|---|---|---|---|
|
|
47
|
+
| `LANDCHECKUP_API_KEY` | Yes | — | API key sent via the `X-API-Key` request header |
|
|
48
|
+
| `LANDCHECKUP_API_URL` | No | `https://api.landcheckup.com` | Base URL for the Land Checkup API |
|
|
49
|
+
|
|
50
|
+
## Client setup
|
|
51
|
+
|
|
52
|
+
### Claude Desktop
|
|
53
|
+
|
|
54
|
+
Add this to your `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`, Windows: `%APPDATA%\Claude\claude_desktop_config.json`):
|
|
55
|
+
|
|
56
|
+
```json
|
|
57
|
+
{
|
|
58
|
+
"mcpServers": {
|
|
59
|
+
"landcheckup": {
|
|
60
|
+
"command": "landcheckup-mcp",
|
|
61
|
+
"env": {
|
|
62
|
+
"LANDCHECKUP_API_KEY": "lck_your_api_key_here"
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Cursor
|
|
70
|
+
|
|
71
|
+
Add this to `.cursor/mcp.json` in your project or `~/.cursor/mcp.json` globally:
|
|
72
|
+
|
|
73
|
+
```json
|
|
74
|
+
{
|
|
75
|
+
"mcpServers": {
|
|
76
|
+
"landcheckup": {
|
|
77
|
+
"command": "landcheckup-mcp",
|
|
78
|
+
"env": {
|
|
79
|
+
"LANDCHECKUP_API_KEY": "lck_your_api_key_here"
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
### Claude Code
|
|
87
|
+
|
|
88
|
+
Register the server with the Claude Code CLI:
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
claude mcp add landcheckup \
|
|
92
|
+
-e LANDCHECKUP_API_KEY=lck_your_api_key_here \
|
|
93
|
+
-- landcheckup-mcp
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
Or add `.mcp.json` at the root of your project:
|
|
97
|
+
|
|
98
|
+
```json
|
|
99
|
+
{
|
|
100
|
+
"mcpServers": {
|
|
101
|
+
"landcheckup": {
|
|
102
|
+
"command": "landcheckup-mcp",
|
|
103
|
+
"env": {
|
|
104
|
+
"LANDCHECKUP_API_KEY": "lck_your_api_key_here"
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
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"`).
|
|
112
|
+
|
|
113
|
+
## Available tools
|
|
114
|
+
|
|
115
|
+
| Tool | Description |
|
|
116
|
+
|---|---|
|
|
117
|
+
| `check_parcel_by_address` | Submit a parcel report by street address, wait for completion, and return key facts, structured JSON, and the report URL. |
|
|
118
|
+
| `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. |
|
|
119
|
+
| `compare_parcels` | Check up to 25 parcels (by address or parcel number) and return a markdown comparison table alongside structured JSON. |
|
|
120
|
+
| `get_town_summary` | Fetch published town or county land-record summary figures for a state and town slug. |
|
|
121
|
+
| `get_api_usage` | Check your current API key tier, billing month, usage count, monthly quota, and remaining calls. |
|
|
122
|
+
|
|
123
|
+
## Development & testing
|
|
124
|
+
|
|
125
|
+
Run the offline test suite (mocked HTTP transport, no external network access required):
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
python -m pytest -q mcp/tests
|
|
129
|
+
```
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
# landcheckup-mcp
|
|
2
|
+
|
|
3
|
+
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.
|
|
4
|
+
|
|
5
|
+
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.
|
|
6
|
+
|
|
7
|
+
## Requirements
|
|
8
|
+
|
|
9
|
+
- Python 3.11+
|
|
10
|
+
- 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
|
|
11
|
+
|
|
12
|
+
## Installation
|
|
13
|
+
|
|
14
|
+
Install from PyPI (pipx or uv keep it in its own environment):
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
pipx install landcheckup-mcp
|
|
18
|
+
# or
|
|
19
|
+
uv tool install landcheckup-mcp
|
|
20
|
+
# or
|
|
21
|
+
pip install landcheckup-mcp
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
Verify the CLI is available:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
landcheckup-mcp --help
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Configuration
|
|
31
|
+
|
|
32
|
+
| Environment variable | Required | Default | Description |
|
|
33
|
+
|---|---|---|---|
|
|
34
|
+
| `LANDCHECKUP_API_KEY` | Yes | — | API key sent via the `X-API-Key` request header |
|
|
35
|
+
| `LANDCHECKUP_API_URL` | No | `https://api.landcheckup.com` | Base URL for the Land Checkup API |
|
|
36
|
+
|
|
37
|
+
## Client setup
|
|
38
|
+
|
|
39
|
+
### Claude Desktop
|
|
40
|
+
|
|
41
|
+
Add this to your `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`, Windows: `%APPDATA%\Claude\claude_desktop_config.json`):
|
|
42
|
+
|
|
43
|
+
```json
|
|
44
|
+
{
|
|
45
|
+
"mcpServers": {
|
|
46
|
+
"landcheckup": {
|
|
47
|
+
"command": "landcheckup-mcp",
|
|
48
|
+
"env": {
|
|
49
|
+
"LANDCHECKUP_API_KEY": "lck_your_api_key_here"
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### Cursor
|
|
57
|
+
|
|
58
|
+
Add this to `.cursor/mcp.json` in your project or `~/.cursor/mcp.json` globally:
|
|
59
|
+
|
|
60
|
+
```json
|
|
61
|
+
{
|
|
62
|
+
"mcpServers": {
|
|
63
|
+
"landcheckup": {
|
|
64
|
+
"command": "landcheckup-mcp",
|
|
65
|
+
"env": {
|
|
66
|
+
"LANDCHECKUP_API_KEY": "lck_your_api_key_here"
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### Claude Code
|
|
74
|
+
|
|
75
|
+
Register the server with the Claude Code CLI:
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
claude mcp add landcheckup \
|
|
79
|
+
-e LANDCHECKUP_API_KEY=lck_your_api_key_here \
|
|
80
|
+
-- landcheckup-mcp
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Or add `.mcp.json` at the root of your project:
|
|
84
|
+
|
|
85
|
+
```json
|
|
86
|
+
{
|
|
87
|
+
"mcpServers": {
|
|
88
|
+
"landcheckup": {
|
|
89
|
+
"command": "landcheckup-mcp",
|
|
90
|
+
"env": {
|
|
91
|
+
"LANDCHECKUP_API_KEY": "lck_your_api_key_here"
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
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"`).
|
|
99
|
+
|
|
100
|
+
## Available tools
|
|
101
|
+
|
|
102
|
+
| Tool | Description |
|
|
103
|
+
|---|---|
|
|
104
|
+
| `check_parcel_by_address` | Submit a parcel report by street address, wait for completion, and return key facts, structured JSON, and the report URL. |
|
|
105
|
+
| `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. |
|
|
106
|
+
| `compare_parcels` | Check up to 25 parcels (by address or parcel number) and return a markdown comparison table alongside structured JSON. |
|
|
107
|
+
| `get_town_summary` | Fetch published town or county land-record summary figures for a state and town slug. |
|
|
108
|
+
| `get_api_usage` | Check your current API key tier, billing month, usage count, monthly quota, and remaining calls. |
|
|
109
|
+
|
|
110
|
+
## Development & testing
|
|
111
|
+
|
|
112
|
+
Run the offline test suite (mocked HTTP transport, no external network access required):
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
python -m pytest -q mcp/tests
|
|
116
|
+
```
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
"""CLI entry point for the Land Checkup MCP stdio server."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import argparse
|
|
6
|
+
from typing import Sequence
|
|
7
|
+
|
|
8
|
+
from . import __version__
|
|
9
|
+
from .client import ClientConfig, LandCheckupClient
|
|
10
|
+
from .protocol import serve_stdio
|
|
11
|
+
from .tools import create_server
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
def build_parser() -> argparse.ArgumentParser:
|
|
15
|
+
parser = argparse.ArgumentParser(
|
|
16
|
+
prog="landcheckup-mcp",
|
|
17
|
+
description="Run the Land Checkup MCP server over stdio JSON-RPC 2.0.",
|
|
18
|
+
)
|
|
19
|
+
parser.add_argument(
|
|
20
|
+
"--version",
|
|
21
|
+
action="version",
|
|
22
|
+
version=f"%(prog)s {__version__}",
|
|
23
|
+
)
|
|
24
|
+
parser.add_argument(
|
|
25
|
+
"--api-url",
|
|
26
|
+
default=None,
|
|
27
|
+
help="Override LANDCHECKUP_API_URL (default: https://api.landcheckup.com).",
|
|
28
|
+
)
|
|
29
|
+
return parser
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
def main(argv: Sequence[str] | None = None) -> int:
|
|
33
|
+
parser = build_parser()
|
|
34
|
+
args = parser.parse_args(list(argv) if argv is not None else None)
|
|
35
|
+
config = ClientConfig.from_env(api_url=args.api_url)
|
|
36
|
+
with LandCheckupClient(config) as client:
|
|
37
|
+
server = create_server(client)
|
|
38
|
+
return serve_stdio(server)
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
if __name__ == "__main__":
|
|
42
|
+
raise SystemExit(main())
|