---
title: property.bot API, OpenAPI, and MCP
description: Developer map for the property.bot public API, OpenAPI, auth, MCP, CLI, AGENTS.md, and Agent Plugins plugin.json.
canonical: https://property.bot/developers.md
last-updated: 2026-09-08
---

# property.bot API, OpenAPI, and MCP

Developer and coding-agent entry for property.bot. Humans stay on WhatsApp first (last-4 …0663); voice/SMS is secondary (last-4 …1919). This page maps the public **API**, **OpenAPI** document, auth contract, and **MCP** surfaces.

## property.bot API (public, keyless GET)

- [GET /api/v1/health](https://property.bot/api/v1/health) · alias [/api/health](https://property.bot/api/health)
- [GET /api/v1/info](https://property.bot/api/v1/info) · alias [/api/info](https://property.bot/api/info)

Product facts only. No public people-search API. No public writes.

## OpenAPI

- Spec: [https://property.bot/openapi.json](https://property.bot/openapi.json)

## Auth

- Contract: [https://property.bot/auth.md](https://property.bot/auth.md)
- Public REST: no API key
- Product MCP: WorkOS OAuth + linked phone (Bearer). Do not ungate.

## MCP (two surfaces)

- Multi-surface map: [/mcp.json](https://property.bot/mcp.json) · [/.well-known/mcp-servers.json](https://property.bot/.well-known/mcp-servers.json) · [/agent-plugins/mcp.json](https://property.bot/agent-plugins/mcp.json)
- Product brain: [https://mcp.property.bot/mcp](https://mcp.property.bot/mcp) · [product server card](https://property.bot/.well-known/mcp/product-server-card.json) · [well-known mcp.json](https://property.bot/.well-known/mcp.json)
- Docs MCP (public): [https://property.bot/mcp/docs](https://property.bot/mcp/docs) · [server card](https://property.bot/.well-known/mcp/server-card.json) · [docs-server-card.json](https://property.bot/.well-known/mcp/docs-server-card.json)

## npm SDK + CLI

Package mirror: [/packages/property-bot/package.json](https://property.bot/packages/property-bot/package.json) (homepage https://property.bot · repository https://github.com/fourcolors/property-bot-grok-plugin)

```bash
npm i property-bot
npx property-bot info
npx property-bot health
# import { getInfo, checkHealth } from "property-bot"
```

Registry publish after merge is owned by Sterling.

## GitHub · AGENTS.md · plugin.json

Public plugin repo (Ora probes first): [https://github.com/fourcolors/property-bot-grok-plugin](https://github.com/fourcolors/property-bot-grok-plugin)

- Agent rules: [AGENTS.md](https://github.com/fourcolors/property-bot-grok-plugin/blob/main/AGENTS.md) · site mirror [/AGENTS.md](https://property.bot/AGENTS.md)
- Agent Plugins: [plugin.json](https://github.com/fourcolors/property-bot-grok-plugin/blob/main/plugin.json) · site mirror [/plugin.json](https://property.bot/plugin.json) · [/mcp.json](https://property.bot/mcp.json) · [/agent-plugins/](https://property.bot/agent-plugins/)
- Also: `mcp.json`, `skills/`
- Application source (`fourcolors/property-bot`) remains private; discovery does not require it.

## Skills (skills.sh)

Index: [https://property.bot/.well-known/agent-skills/index.json](https://property.bot/.well-known/agent-skills/index.json)

Register from a machine with npm (human / Sterling — do not burn publish tokens in CI):

```bash
npx skills add https://property.bot/.well-known/agent-skills/index.json
```

## Web Bot Auth directory

Public JWKS (Ed25519) at [/.well-known/http-message-signatures-directory](https://property.bot/.well-known/http-message-signatures-directory). Content-Type `application/http-message-signatures-directory+json`.

## More

- [Agent mode](https://property.bot/?mode=agent) · [agent.json](https://property.bot/agent.json) · [llms.txt](https://property.bot/llms.txt) · [docs](https://property.bot/docs)