Metadata-Version: 2.4
Name: vicpropertycheck
Version: 0.1.1
Summary: Victorian property due diligence — MCP server, CLI, and skill backend (planning, bushfire, crime, housing, facilities)
Author-email: Roger Liu <zichengliu0226@gmail.com>
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.13.2
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.25.0
Requires-Dist: pydantic>=2.12.5
Requires-Dist: httpx>=0.28.1
Requires-Dist: shapely>=2.0.6
Requires-Dist: pyproj>=3.7.0
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: structlog>=24.4.0
Requires-Dist: aiosqlite>=0.20.0
Requires-Dist: tenacity>=9.0.0
Requires-Dist: typing-extensions>=4.12.2
Requires-Dist: email-validator>=2.2.0
Requires-Dist: uvicorn>=0.40.0
Requires-Dist: starlette>=0.50.0
Requires-Dist: sse-starlette>=2.1.0
Provides-Extra: dev
Requires-Dist: pytest<8.3,>=8.2.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
Requires-Dist: pytest-cov>=6.0.0; extra == "dev"
Requires-Dist: black>=24.10.0; extra == "dev"
Requires-Dist: isort>=5.13.2; extra == "dev"
Requires-Dist: flake8>=7.1.1; extra == "dev"
Requires-Dist: mypy>=1.13.0; extra == "dev"
Requires-Dist: pylint>=3.3.2; extra == "dev"
Requires-Dist: pylint-pydantic>=0.3.2; extra == "dev"
Requires-Dist: pylint-pytest>=1.1.8; extra == "dev"
Requires-Dist: pre-commit>=4.0.1; extra == "dev"

# vicpropertycheck

Victorian (Australia) property due diligence — three things in one Python package:

1. **MCP server** (`vic-property-mcp`) — exposes property tools to MCP-aware clients.
2. **CLI** (`vic-property`) — same tools as subcommands, for shell/script use.
3. **Skill backend** — drives the `vic-property-check` Claude Code skill (see `skill/SKILL.md`).

All three share the same providers, cache, and config:

- VicMap Planning ArcGIS (zones + overlays)
- VicMap Bushfire ArcGIS (BMO, prone areas)
- OpenStats (suburb crime + housing)
- Google Maps (geocoding + nearby places) — direct API key or hosted proxy with Firebase sign-in

## Install

```bash
pipx install vicpropertycheck
```

This puts `vic-property-mcp` (server) and `vic-property` (CLI) on your `PATH`.

## CLI quick start

```bash
# VIC government APIs need no auth — these work out of the box:
vic-property planning  --lat -37.8113 --lon 144.9737
vic-property bushfire  --lat -37.8113 --lon 144.9737
vic-property crime     --suburb "Melbourne"

# Google-backed commands need either:
#   (a) export GOOGLE_MAPS_API_KEY=...     (self-hosted)
#   (b) vic-property login                 (paste blob from vicpropertycheck.com.au/skill-auth)
vic-property summarize --address "1 Spring St, Melbourne VIC 3000" --pretty
```

Every subcommand emits one JSON object on stdout. Errors come back as
`{"error": "...", "code": "..."}` with a non-zero exit code.

## MCP server

```bash
vic-property-mcp                            # stdio transport (default)
VIC_PROPERTY_TRANSPORT__MODE=http vic-property-mcp   # HTTP on :8080
```

Configuration uses the `VIC_PROPERTY_` env-var prefix; see `.env.example`.

## Skill

Drop `skill/` into `~/.claude/skills/vic-property-check/`. See `skill/INSTALL.md` for the
full install + auth walkthrough.

## License

MIT.
