# LOCIQ Property Intelligence API

## What it does
Nationwide US property data with presence detection, portfolio/LLC clustering,
and business-to-property linking. Query by address, coordinates, owner, or area.
~13M parcels across MT, ID, WA, NC, NE; Flathead County (MT) is the reference
implementation with full Tier 1+2 enrichment.

## API
Base URL:    https://api.lociq.ai
Auth:        Bearer token, `Authorization: Bearer lq_(live|test)_<64 hex>`
Free key:    POST /auth/signup — https://lociq.ai/signup
Paid:        POST /auth/checkout (starter / pro / enterprise) → Stripe
Docs:        https://docs.lociq.ai
OpenAPI:     https://api.lociq.ai/openapi.json

## MCP server
URL:         https://mcp.lociq.ai
Endpoint:    POST /mcp (Streamable HTTP transport)
Manifest:    https://mcp.lociq.ai/.well-known/mcp.json
Tools:       find_property, get_property_details, find_properties_in_area,
             find_businesses_nearby, get_area_stats, get_area_aggregate,
             get_owner_portfolio, find_related_properties, get_cluster,
             find_llc_properties, find_vacant_commercial, detect_changes,
             find_activity_signals
Tier policy: connection requires any tier; relationship + intelligence tools
             require Pro and return a structured `requires_upgrade` payload
             when called by a free-tier key.

## Example queries
- What businesses operate at 123 Main St, Kalispell MT?
- Who owns this property and what else do they own?
- Vacant commercial properties in Phoenix with >1 acre
- Residential properties owned by LLCs in Charlotte
- Properties whose presence tier changed in the last 30 days

## Tiers
- free       — 100 requests/month, 10 RPM, search + presence + basic detail
- starter    — 5,000/month, 30 RPM, properties + buildings + per-property detail
- pro        — 50,000/month, 60 RPM, relationships + clusters + LLC + vacant
- enterprise — 500,000/month, 120 RPM, all of the above

## Data accuracy
LOCIQ property data is assembled from public records and third-party
datasets. It may be incomplete, stale, or wrong, and should not be the
sole basis for legal, financial, or real-estate decisions. Where results
carry confidence scores, presence tiers, or coverage indicators, weight
your conclusions by them rather than treating the data as settled fact.

## Acceptable use
LOCIQ is a research and intelligence API. Don't use it to harass individuals,
to build a doxxing service, or to circumvent fair-housing laws. Compliance is
the caller's responsibility.