# HtAG Developer Portal

> Australia's most comprehensive property intelligence API platform. 89+ HTTP endpoints, 5 MCP servers, 6 AI agents. The only property MCP server in Australia.

## Overview

HtAG provides programmatic access to Australian property intelligence through three channels:

1. **HTTP API** — 89+ RESTful endpoints covering market analytics, property valuations, spatial data (H3), demographics, economics, and geographic concordance
2. **MCP Servers** — 5 Model Context Protocol servers with 82+ tools, enabling AI assistants (Claude, Perplexity, Cursor, Codex) to query property data via natural language
3. **AI Agents** — 6 turnkey micro-agents for suburb analysis, market cycle timing, suburb comparison, and portfolio assessment

## Docs

- [API Documentation](https://developer.htagai.com/docs)
- [HTTP API Reference](https://developer.htagai.com/docs/rest)
- [MCP Server Guide](https://developer.htagai.com/docs/mcp)
- [MCP Setup Guide](https://developer.htagai.com/docs/mcp/setup)
- [AI Agents](https://developer.htagai.com/docs/agents)
- [Education Hub](https://developer.htagai.com/learn)
- [Pricing](https://developer.htagai.com/pricing)
- [Consulting](https://developer.htagai.com/consulting)

## API Base URLs

- HTTP API: `https://api.htagai.com/v1`
- MCP SSE endpoint: `https://api.htagai.com/mcp/v1/servers/htag/sse`
- MCP Streaming HTTP: `https://api.htagai.com/mcp/v1/servers/htag/mcp`
- Agent executions: `https://agent.htagai.com/micro-agents/agents/{agent-id}/execute`

## Authentication

- HTTP API: `x-api-key` header or Bearer token
- MCP (Claude/Perplexity): OAuth 2.0 with client_id and client_secret
- MCP (Cursor): `x-api-key` header in mcp.json config

## Key API Categories

| Category | Endpoints | Tier |
|----------|-----------|------|
| Address (geocode, environment, demographics, schools, standardise) | 5 | Standard-Premium |
| Property (summary, estimates, market, sold search, CMA) | 5 | Enhanced-Restricted |
| Market Overview (summary, growth, supply, demand, scores, fundamentals, cycle, risk, query, rank) | 15 | Standard-Premium |
| Market Trends (price, rent, yield, growth rates, demand profile) | 5 | Standard-Enhanced |
| Supply-Demand Trends (stock, inventory, DOM, clearance, vacancy, hold period, search index) | 7 | Restricted |
| Demographics (census, business activity, healthcare) | 3 | Standard |
| Economics (CPI factor/adjust/series/latest, cash rate/series) | 6 | Standard |
| Spatial H3 — Price & Rent (median price, rent, yield, years-to-own) | 4 | Enhanced |
| Spatial H3 — Market (DOM, DORM, lot size, age, holding return, discounting, hold period, listed price) | 8 | Enhanced |
| Spatial H3 — Socio-Environmental (IRSD, IRSAD, IER, IEO, public housing, flood, rental, bushfire) | 8 | Enhanced |
| Spatial H3 — Reference (resolutions, boundary, center, parent, children, neighbors) | 6 | Reference |
| Reference (locality, LGA, address keys) | 3 | Reference |
| Concordance (SA2, locality, LGA, postcode, SAL, H3, GCCSA) | 14 | Reference |

## MCP Servers

| Server | Tools | Auth | Description |
|--------|-------|------|-------------|
| Intelligence | 57 | OAuth/API Key | Core property, market, spatial, demographic data |
| Trends | 7 | Internal/Partner | Historical time series |
| Data Analytics | 7 | Internal/Partner | Read-only SQL warehouse |
| Spatial | 6 | OAuth/API Key | H3 hexagonal metrics |
| Docs | 5 | Public | Platform discovery — no auth required |

## AI Agents

| Agent | Status | Description |
|-------|--------|-------------|
| Market Cycle Timing | Live | BUY/HOLD/SELL signals with confidence scoring |
| Suburb Analysis | Live | 8-section comprehensive suburb deep-dive |
| Suburb Comparison | Live | Side-by-side comparison of 2-5 suburbs |
| Portfolio Health | Coming Soon | Loan stress testing, equity, cashflow |
| Portfolio Stress Test | Coming Soon | AI disruption & fuel crisis risk |
| Defence & Counter-Cyclical | Coming Soon | Crisis resilience scoring |

## SDKs

- Python: `pip install htag-sdk`
- TypeScript: `npm install htag-sdk`

## Contact

- Email: dev@htag.com.au
- Phone: +61 (0)2 5563 4415
- Consulting: https://developer.htagai.com/consulting