# Property data for AI agents — Realie

> Nationwide U.S. property records through CLI, MCP, or REST. One API key.

Human-facing page: https://www.realie.ai/agents
Docs index: https://docs.realie.ai/llms.txt
Site overview: https://www.realie.ai/llms.txt

## Auth (required)

1. A human creates an account at https://app.realie.ai/developer
2. Add a payment method in Billing
3. Copy an API key from Usage → API access
4. Agents authenticate with that key (CLI, MCP, or `Authorization: Bearer`)

## Choose an interface

### CLI

Install:

```bash
curl -fsSL https://app.realie.ai/api/cli/install | bash
```

Or: `npm install -g @realie/cli` / `npx @realie/cli --help`

Authenticate (agents / CI):

```bash
realie login --api-key YOUR_API_KEY
```

Or set `REALIE_API_KEY`. Prefer `--json` for machine-readable output.

Example:

```bash
realie lookup --address "504 LAVACA ST" --state TX --county TRAVIS --json
```

CLI docs: https://docs.realie.ai/realie-cli

### MCP

MCP server URL: https://docs.realie.ai/mcp

Claude Code:

```bash
claude mcp add --transport http Realie https://docs.realie.ai/mcp
```

Universal installer:

```bash
npx add-mcp https://docs.realie.ai/mcp
```

MCP docs: https://docs.realie.ai/realie-mcp-server

### REST API

Base: `https://app.realie.ai/api`

Example:

```bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://app.realie.ai/api/public/property/address?address=504%20LAVACA%20ST&state=TX"
```

API docs: https://docs.realie.ai/api-reference/property-data
OpenAPI: https://docs.realie.ai/api-reference/openapi.json

Common endpoints:

- `GET /public/property/search`
- `GET /public/property/address`
- `GET /public/property/location`
- `GET /public/property/owner`
- `GET /public/property/parcelId`
- `GET /public/premium/comparables` (premium)

## Machine-readable resources

- This page: https://www.realie.ai/agents.md
- Site llms.txt: https://www.realie.ai/llms.txt
- Docs llms.txt: https://docs.realie.ai/llms.txt
- Agent skill: https://docs.realie.ai/.well-known/agent-skills/realie/skill.md
- OpenAPI: https://docs.realie.ai/api-reference/openapi.json

## FAQ

**Do I need an account before an agent can use the API?**
Yes. A human provisions the account and API key; agents reuse the key.

**CLI vs MCP vs REST?**
CLI for terminal/shell agent workflows (`--json`). MCP for IDE harnesses. REST when building an app or needing full request control.

**Where should agents read docs?**
Start at https://docs.realie.ai/llms.txt. Individual docs pages are available as Markdown (append `.md` to the URL).