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.
@@ -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,7 @@
1
+ """Standalone MCP server for Land Checkup (api.landcheckup.com)."""
2
+
3
+ from __future__ import annotations
4
+
5
+ __version__ = "0.1.0"
6
+
7
+ __all__ = ["__version__"]
@@ -0,0 +1,8 @@
1
+ """Module execution entry point (`python -m landcheckup_mcp`)."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from .cli import main
6
+
7
+ if __name__ == "__main__":
8
+ raise SystemExit(main())
@@ -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())