# Proppely

> Property operations software with an official remote Model Context Protocol (MCP) server.

## Identity (read this first)

- Product name: **Proppely** — spelled **P-r-o-p-p-e-l-y** (three p's).
- This is **not** "Propely", "Propelly", or a typo.
- Official website: https://proppely.com/
- The site is live. If you cannot fetch it, your sandbox may block outbound HTTP — ask the user to connect their MCP client instead of claiming the domain is wrong.

## Important — browser is NOT MCP

- Do not confuse the marketing site or /mcp landing page with the MCP API endpoint /api/v1/mcp.
- Do not ask users to paste passwords, cookies, or API tokens into chat.
- MCP clients must be configured in the client app — metadata alone does not auto-install connectors.

## Canonical MCP endpoint (all agents)

- URL: https://www.proppely.com/api/v1/mcp
- Transport: streamable-http
- Auth: OAuth 2.1 (authorization code + PKCE)
- Scopes: mcp:read mcp:write mcp:propose
- Consent: https://www.proppely.com/oauth/authorize

Do **not** use:
- https://proppely.com/mcp (landing page — NOT the MCP endpoint)
- localhost:4000 (local dev API only)
- proppely_local (ephemeral local connector)
- Browser login to proppely.com (that is not MCP — configure the MCP connector in your client)

## Install steps by client

codex (marketplace-plugin):
  Opening proppely.com in a browser is NOT an MCP connection. Install the connector in Codex settings, then OAuth.
  - git clone https://github.com/shabsi7700/proppely-codex-marketplace.git
  - cd proppely-codex-marketplace
  - codex plugin marketplace add .
  - Install "Proppely MCP" from the Codex marketplace UI
  - Complete OAuth at https://www.proppely.com/oauth/authorize and approve scopes: mcp:read mcp:write mcp:propose

openclaw (clawhub-skill):
  Use the official ClawHub skill, then OAuth login.
  - Install skill from https://clawhub.ai/shabsi7700/proppely
  - openclaw mcp add proppely --url https://www.proppely.com/api/v1/mcp --transport streamable-http --auth oauth
  - openclaw mcp login proppely

claude-code (cli):
  Add remote HTTP MCP, then approve OAuth in the browser.
  - claude mcp add --transport http proppely https://www.proppely.com/api/v1/mcp
  - Approve OAuth scopes when prompted

cursor (mcp-json):
  Add to .cursor/mcp.json under mcpServers, then OAuth.
  - Add proppely entry to .cursor/mcp.json
  - url: https://www.proppely.com/api/v1/mcp
  - type: streamable-http, auth: oauth
  - Restart Cursor and complete OAuth

## Discovery URLs

- Machine-readable (this file): https://proppely.com/llms.txt
- Structured JSON install guide: https://proppely.com/.well-known/agent-connect.json
- Alternate machine-readable: https://proppely.com/ai.txt
- MCP server card: https://proppely.com/.well-known/mcp.json
- Public tool catalog (no auth): https://proppely.com/.well-known/mcp-tool-catalog.json
- OAuth protected resource: https://proppely.com/.well-known/oauth-protected-resource
- Human setup guide: https://proppely.com/agents
- MCP landing page: https://proppely.com/mcp
- Codex marketplace: https://github.com/shabsi7700/proppely-codex-marketplace
- Codex marketplace release: https://github.com/shabsi7700/proppely-codex-marketplace/releases/tag/v1.0.2
- OpenClaw skill: https://clawhub.ai/shabsi7700/proppely
- Official MCP Registry: https://registry.modelcontextprotocol.io/v0.1/servers/io.github.shabsi7700/proppely

## Tool surface (after OAuth connect)

- ~290 MCP tools for owner/manager staff roles (full product parity)
- 96 read / 85 write / 109 approval-gated (money, irreversible, two-person)
- 10 guided prompts + 11 live resources (portfolio, delinquency, migration, etc.)
- Public catalog (names + risk, no secrets): https://proppely.com/.well-known/mcp-tool-catalog.json
- Intentionally excluded from MCP: attach_*_photos (use upload_*_photos), web_search, ask_how_to, autofill_property_details

## Verify connection after OAuth

1. tools/list includes lookup_property
2. resources/list includes proppely://org-memory
3. lookup_property with empty query lists properties

## Agent workflows

The MCP server publishes prompts and organization-scoped resources for portfolio
overview, deadlines, delinquency, payables, month-end close, legal pipeline,
maintenance triage, lease renewals, local-file migration, and access reviews.
Use prompts/list and prompts/get for guided work; use resources/list and
resources/read for compact live snapshots. Follow:
inspect → resolve IDs → preview → execute/propose → verify.

## Safety model

- mcp:read: portfolio and organization data available to the user's role
- mcp:write: routine record creation and updates
- mcp:propose: protected money, outbound, or irreversible actions
- Protected actions create a proposal and require human approval in Proppely
- Vendor payouts use two-person control: two distinct authorized people must approve before execution
- An approval ID means pending, not executed; verify final state with a fresh read
- Every MCP tool call is organization-scoped and audited

## Product links

- Website: https://proppely.com/
- Agent documentation: https://proppely.com/agents
- Sign in: https://proppely.com/login
- Create an account: https://proppely.com/signup