TN Trustee MCP

Read-only MCP access to public Tennessee property-tax information.

The project is in Phase 1. It currently provides configuration, normalized data contracts, SQLite persistence, a command shell, and an MCP STDIO server shell with zero registered tools. It does not yet contact TennesseeTrustee.org.

Requirements

• Python 3.12 or later

• uv

• An operator contact string for the descriptive user agent

Related MCP server: Overture Maps MCP

Setup

uv python install 3.12
uv sync --extra dev
Copy-Item .env.example .env

Replace operator@example.com in .env with a monitored contact address.

Initialize the local database:

uv run tn-trustee-mcp db init

List configured entities without contacting the source:

uv run tn-trustee-mcp entities list

Start the Phase 1 MCP shell:

uv run tn-trustee-mcp serve

Development checks

uv run ruff check .
uv run ruff format --check .
uv run mypy
uv run pytest
uv run python -m build

Project reference

See assessment.md for the current phase, implemented components, open questions, validation baseline, and next action.

Every delivered repository change must update CHANGELOG.md, assessment.md, and this README. The changelog records what changed. The assessment provides a quick current-state reference. The README must stay aligned with the current setup, behavior, scope, and operator instructions.

Current scope

• Cheatham County and Stewart County configuration only

• HTTPS query parameter routes through tennesseetrustee.org

• Public, read-only property-tax information

• Local SQLite cache and future snapshot storage

Search behavior and HTML parsing are intentionally absent until the Phase 2 source inspection is complete.

Safety

The server must never access cart, checkout, or payment endpoints. It must never submit payments, bypass authentication or CAPTCHA, disable certificate validation, or perform bulk owner-name harvesting. See SECURITY.md and Docs/COMPLIANCE.md.

License

See LICENSE.