Claude — web, desktop, mobile
Claude connects to Proppely as a custom connector. Open Settings → Connectors → Add custom connector, then:
- Name it
Proppely. - Remote MCP server URL:
https://www.proppely.com/api/v1/mcp - Leave OAuth Client ID and OAuth Client Secret blank. Claude identifies itself with its own published client metadata, so there is no credential for you to paste.
- Click Add, then Connect. Sign in to Proppely in the browser window and pick the organization the connection may act on.
The connection is scoped to the organization you choose and to your own role. Tenant and vendor portal logins cannot connect — MCP is for landlord and property-management staff.
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"
}
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
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
claude (custom-connector):
Claude web, desktop, and mobile connect through Settings > Connectors > Add custom connector. Leave the advanced OAuth fields blank — Claude identifies itself with its own published client metadata document, so there is no client id or secret for a user to paste.
- Open Claude > Settings > Connectors > Add custom connector
- Name: Proppely
- Remote MCP server URL: https://www.proppely.com/api/v1/mcp
- Leave OAuth Client ID and OAuth Client Secret empty under Advanced settings — Claude supplies its own
- Click Add, then Connect — Claude opens the Proppely consent page in a browser
- Sign in with a landlord or property-management login at https://www.proppely.com/oauth/authorize, choose the organization, and approve scopes: mcp:read mcp:write mcp:propose
- Tenant and vendor portal logins cannot connect — MCP is staff-only
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
- Get an account: https://proppely.com/demo (workspaces are set up with our team)