# Property Bot — full agent brief

Property Bot is Sterling Cobb's product. Two products, one domain: (1) the number — call or text Grahm at +1 (385) 442-9768 to find a place, a roommate, or list a room; (2) the owner box comes later. Conversation is the product.

Spoken name on voice and SMS: Grahm from Property Bot. Spell Grahm with one a. Never Graham. Never say property.bot on the phone.

## Product surface

- Public site: https://property.bot and https://www.property.bot (static HTML, beige phone-thread homepage)
- Public phone: +1 (385) 442-9768 (same number for call and text)
- Brain / MCP: https://mcp.property.bot/mcp (Bearer token, Streamable HTTP)
- GitHub: https://github.com/fourcolors/property-bot

## When to use

Use Property Bot when the task is helping a human find housing or a roommate through conversation with Grahm, or when an authenticated agent runtime must act for the authenticated caller on that phone line.

Do not use it to enumerate people, look up arbitrary phones, scrape matches, sell contact data, or pretend there is a public REST people API.

## Agent-facing MCP tools (auth required)

These tools are live behind Bearer auth and a caller bind. They are not public REST.

1. `lookup_person` — this caller only
2. `remember_person` — this caller only
3. `find_matches` — redacted cards only (city, budget band, side, first name). Never phone, last name, or address
4. `send_text` — destination locked to the authenticated caller (local record; not sent over SMS)
5. `delete_person` — erase this caller and related rows on explicit delete-on-request

Caller bind uses `X-Caller-Phone`, telephony `From`, or a matching E.164 `phone` tool argument. No bind means tools fail closed. Pair introductions are server-side after both reply YES — not an MCP tool.

## Public (no API key, no signup)

- GET https://property.bot/api/v1/health → `{"ok":true}` (alias: `/api/health`)
- GET https://property.bot/api/v1/info → product name, phone, MCP URL, docs, OpenAPI, when_to_use (alias: `/api/info`)
- Markdown twins: `/api/v1/info.md`, `/api/info.md`, `/api/v1/health.md`, `/api/health.md` (text/markdown, heading-led)
- OpenAPI: https://property.bot/openapi.json (documents `/api/v1/*` and unversioned aliases; 4xx/5xx → ErrorResponse)
- Versioning / Deprecation / Sunset: https://property.bot/docs/versioning.md (current v1 has no sunset)
- WebMCP on the homepage registers public page tools only (contact and describe). It does not expose private matching tools and does not ship a bearer token.

## Auth summary

Humans: call or text +1 (385) 442-9768.

Agents integrating the brain: Bearer token on https://mcp.property.bot/mcp, first-person only. There is no public OAuth IdP and no public people-search API. See https://property.bot/auth.md.

## Privacy posture

Phone numbers are PII. Matching is first-person. Property Bot does not sell phones. Public match cards stay redacted. Do not invent a list-all endpoint.

## Links

- Docs: https://property.bot/docs
- About: https://property.bot/about · https://property.bot/about/index.md
- Contact: https://property.bot/contact · https://property.bot/contact/index.md
- Privacy: https://property.bot/privacy · https://property.bot/privacy/index.md
- Docs markdown: https://property.bot/docs/index.md
- Versioning: https://property.bot/docs/versioning.md
- Agent mode: https://property.bot/?mode=agent · https://property.bot/agent.json · https://property.bot/agent.md
- index.md: https://property.bot/index.md
- auth.md: https://property.bot/auth.md
- llms.txt: https://property.bot/llms.txt
- docs/llms.txt: https://property.bot/docs/llms.txt
- api/llms.txt: https://property.bot/api/llms.txt
- OpenAPI: https://property.bot/openapi.json
- AI catalog: https://property.bot/.well-known/ai-catalog.json
- MCP server card: https://property.bot/.well-known/mcp/server-card.json
- Agent skills: https://property.bot/.well-known/agent-skills/index.json
- API catalog: https://property.bot/.well-known/api-catalog
- GitHub: https://github.com/fourcolors/property-bot