# chadru/assessor-lookup-public architecture

> Architecture diagram of the GitHub repository chadru/assessor-lookup-public, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chadru/assessor-lookup-public
- Repository: https://github.com/chadru/assessor-lookup-public

## Overview

assessor-lookup serves appraisers searching county assessor records, comparing those records with MLS exports, and optionally producing property-card PDFs. Its CLI and Python API are primary entry points; the MCP server exposes lookup, checking, discovery, and harness operations to agents. The graph preserves county discovery, platform-specific retrieval, registry caching, and regression capabilities. Evidence is limited to the README and indexed excerpts; unsampled module behavior is represented only where documented.

Main entry points: [`assessor_lookup/discovery.py`](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/discovery.py) (County discovery), [`assessor_lookup/checker.py`](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/checker.py) (MLS checker), [`assessor_lookup/__init__.py`](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/__init__.py) (Python API), [`assessor_lookup/cli.py`](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/cli.py) (CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_cli["CLI<br/>[cli.py]"]
  node_python_api["Python API<br/>[__init__.py]"]
  node_mcp["MCP server<br/>[mcp_server.py]"]
end

subgraph group_workflow["Appraisal workflow"]
  node_checker["MLS checker<br/>[checker.py]"]
  node_matching["Candidate matching<br/>[matching.py]"]
  node_card["PDF card renderer<br/>[card.py]"]
  node_network["HTTPS guardrails<br/>[network.py]"]
end

subgraph group_sources["County sources"]
  node_spatialest["Spatialest client<br/>[spatialest.py]"]
  node_eagleweb["EagleWeb client<br/>[eagleweb.py]"]
  node_aumentum["Aumentum client<br/>[aumentum.py]"]
  node_arcgis["ArcGIS primitives<br/>[arcgis.py]"]
  node_adams["Adams driver<br/>[adams.py]"]
  node_arapahoe["Arapahoe driver<br/>[arapahoe.py]"]
  node_statewide["Statewide driver<br/>[statewide.py]"]
end

subgraph group_operations["Coverage and reliability"]
  node_registry[("County registry<br/>[registry.py]")]
  node_discovery["County discovery<br/>[discovery.py]"]
  node_harness["Regression harness<br/>[harness.py]"]
end

node_appraiser(("Appraiser"))
node_agent(("AI agent"))

node_appraiser -->|"runs commands"| node_cli
node_appraiser -->|"calls lookup"| node_python_api
node_agent -->|"uses tools"| node_mcp
node_cli -->|"calls lookup"| node_python_api
node_cli -->|"runs checks"| node_checker
node_cli -->|"discovers counties"| node_discovery
node_cli -->|"renders cards"| node_card
node_python_api -->|"delegates checks"| node_checker
node_python_api -->|"delegates rendering"| node_card
node_mcp -->|"calls lookup"| node_python_api
node_mcp -->|"runs checks"| node_checker
node_mcp -->|"discovers counties"| node_discovery
node_mcp -->|"runs regression"| node_harness
node_checker -->|"resolves county"| node_registry
node_checker -->|"discovers unknowns"| node_discovery
node_checker -.->|"selects candidates"| node_matching
node_checker -->|"creates client"| node_spatialest
node_python_api -.->|"resolves client"| node_registry
node_discovery -->|"validates probes"| node_network
node_discovery -->|"normalizes entries"| node_registry
node_discovery -.->|"probes platform"| node_spatialest
node_discovery -.->|"probes platform"| node_eagleweb
node_discovery -.->|"probes baseline"| node_statewide
node_registry -.->|"caches results"| node_discovery
node_harness -->|"runs lookup checks"| node_checker
node_harness -->|"loads county entries"| node_registry
node_spatialest -.->|"matches candidates"| node_matching
node_eagleweb -->|"matches candidates"| node_matching
node_aumentum -->|"matches candidates"| node_matching
node_spatialest -.->|"guards requests"| node_network
node_eagleweb -->|"guards requests"| node_network
node_aumentum -->|"guards requests"| node_network
node_adams -->|"queries services"| node_arcgis
node_arapahoe -->|"queries services"| node_arcgis
node_statewide -->|"queries services"| node_arcgis
node_arcgis -->|"opens HTTPS"| node_network

click node_cli "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/cli.py"
click node_python_api "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/__init__.py"
click node_mcp "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/mcp_server.py"
click node_checker "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/checker.py"
click node_matching "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/core/matching.py"
click node_card "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/card.py"
click node_registry "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/registry.py"
click node_discovery "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/discovery.py"
click node_harness "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/harness.py"
click node_spatialest "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/platforms/spatialest.py"
click node_eagleweb "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/platforms/eagleweb.py"
click node_aumentum "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/platforms/aumentum.py"
click node_arcgis "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/platforms/arcgis.py"
click node_adams "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/jurisdictions/us/co/adams.py"
click node_arapahoe "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/jurisdictions/us/co/arapahoe.py"
click node_statewide "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/jurisdictions/us/co/statewide.py"
click node_network "https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/core/network.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_python_api,node_mcp toneBlue
class node_checker,node_matching,node_card,node_network toneAmber
class node_spatialest,node_eagleweb,node_aumentum,node_arcgis,node_adams,node_arapahoe,node_statewide toneMint
class node_registry,node_discovery,node_harness toneRose
class node_appraiser,node_agent toneIndigo
```

## Components

### User interfaces

- [CLI](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/cli.py): `assessor_lookup/cli.py`
- [Python API](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/__init__.py): `assessor_lookup/__init__.py`
- [MCP server](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/mcp_server.py): `assessor_lookup/mcp_server.py`

### Appraisal workflow

- [MLS checker](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/checker.py): `assessor_lookup/checker.py`
- [Candidate matching](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/core/matching.py): `assessor_lookup/core/matching.py`
- [PDF card renderer](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/card.py): `assessor_lookup/card.py`
- [HTTPS guardrails](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/core/network.py): `assessor_lookup/core/network.py`

### County sources

- [Spatialest client](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/platforms/spatialest.py): `assessor_lookup/platforms/spatialest.py`
- [EagleWeb client](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/platforms/eagleweb.py): `assessor_lookup/platforms/eagleweb.py`
- [Aumentum client](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/platforms/aumentum.py): `assessor_lookup/platforms/aumentum.py`
- [ArcGIS primitives](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/platforms/arcgis.py): `assessor_lookup/platforms/arcgis.py`
- [Adams driver](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/jurisdictions/us/co/adams.py): `assessor_lookup/jurisdictions/us/co/adams.py`
- [Arapahoe driver](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/jurisdictions/us/co/arapahoe.py): `assessor_lookup/jurisdictions/us/co/arapahoe.py`
- [Statewide driver](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/jurisdictions/us/co/statewide.py): `assessor_lookup/jurisdictions/us/co/statewide.py`

### Coverage and reliability

- [County registry](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/registry.py): `assessor_lookup/registry.py`
- [County discovery](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/discovery.py): `assessor_lookup/discovery.py`
- [Regression harness](https://github.com/chadru/assessor-lookup-public/blob/codex/public-release/assessor_lookup/harness.py): `assessor_lookup/harness.py`

### Other components

- **Appraiser**
- **AI agent**

## Connections

- Appraiser → CLI: runs commands (evidence: `README.md`)
- Appraiser → Python API: calls lookup (evidence: `README.md`)
- AI agent → MCP server: uses tools (evidence: `README.md`)
- CLI → Python API: calls lookup (evidence: `assessor_lookup/cli.py`)
- CLI → MLS checker: runs checks (evidence: `assessor_lookup/cli.py`)
- CLI → County discovery: discovers counties (evidence: `assessor_lookup/cli.py`)
- CLI → PDF card renderer: renders cards (evidence: `assessor_lookup/cli.py`)
- Python API → MLS checker: delegates checks (evidence: `assessor_lookup/__init__.py`)
- Python API → PDF card renderer: delegates rendering (evidence: `assessor_lookup/__init__.py`)
- MCP server → Python API: calls lookup (evidence: `assessor_lookup/mcp_server.py`)
- MCP server → MLS checker: runs checks (evidence: `assessor_lookup/mcp_server.py`)
- MCP server → County discovery: discovers counties (evidence: `assessor_lookup/mcp_server.py`)
- MCP server → Regression harness: runs regression (evidence: `assessor_lookup/mcp_server.py`)
- MLS checker → County registry: resolves county (evidence: `assessor_lookup/checker.py`)
- MLS checker → County discovery: discovers unknowns (evidence: `assessor_lookup/checker.py`)
- MLS checker → Candidate matching: selects candidates
- MLS checker → Spatialest client: creates client (evidence: `assessor_lookup/checker.py`)
- Python API → County registry: resolves client
- County discovery → HTTPS guardrails: validates probes (evidence: `assessor_lookup/discovery.py`)
- County discovery → County registry: normalizes entries (evidence: `assessor_lookup/discovery.py`)
- County discovery → Spatialest client: probes platform
- County discovery → EagleWeb client: probes platform
- County discovery → Statewide driver: probes baseline
- County registry → County discovery: caches results (evidence: `assessor_lookup/discovery.py`)
- Regression harness → MLS checker: runs lookup checks (evidence: `assessor_lookup/harness.py`)
- Regression harness → County registry: loads county entries (evidence: `assessor_lookup/harness.py`)
- Spatialest client → Candidate matching: matches candidates (evidence: `assessor_lookup/platforms/spatialest.py`)
- EagleWeb client → Candidate matching: matches candidates (evidence: `assessor_lookup/platforms/eagleweb.py`)
- Aumentum client → Candidate matching: matches candidates (evidence: `assessor_lookup/platforms/aumentum.py`)
- Spatialest client → HTTPS guardrails: guards requests (evidence: `assessor_lookup/platforms/spatialest.py`)
- EagleWeb client → HTTPS guardrails: guards requests (evidence: `assessor_lookup/platforms/eagleweb.py`)
- Aumentum client → HTTPS guardrails: guards requests (evidence: `assessor_lookup/platforms/aumentum.py`)
- Adams driver → ArcGIS primitives: queries services (evidence: `assessor_lookup/jurisdictions/us/co/adams.py`)
- Arapahoe driver → ArcGIS primitives: queries services (evidence: `assessor_lookup/jurisdictions/us/co/arapahoe.py`)
- Statewide driver → ArcGIS primitives: queries services (evidence: `assessor_lookup/jurisdictions/us/co/statewide.py`)
- ArcGIS primitives → HTTPS guardrails: opens HTTPS (evidence: `assessor_lookup/platforms/arcgis.py`)
