Proppely MCP

Connect now

# Claude Code
claude mcp add --transport http proppely https://www.proppely.com/api/v1/mcp

# Codex — official marketplace plugin
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, then complete OAuth.

# Codex / Cursor — manual MCP config
{
  "type": "streamable-http",
  "url": "https://www.proppely.com/api/v1/mcp",
  "auth": "oauth"
}

# OpenClaw
openclaw mcp add proppely \
  --url https://www.proppely.com/api/v1/mcp \
  --transport streamable-http \
  --auth oauth \
  --oauth-scope "mcp:read mcp:write mcp:propose"
openclaw mcp login proppely

Do not paste passwords or API tokens into chat. Approve scopes in the browser when your client opens OAuth consent. Codex users can install the official marketplace plugin.

Tool catalog (public, no auth)

After OAuth, staff roles receive ~290 tools with full schemas via tools/list. Browse names and risk tiers without connecting:

https://proppely.com/.well-known/mcp-tool-catalog.json

Machine-readable

• https://proppely.com/llms.txt
• https://proppely.com/ai.txt
• https://proppely.com/.well-known/mcp.json

Full specification

# 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