PropSWOT MCP Server

PropSWOT is the AI operational intelligence layer for property management. Connect your property portfolio — appliances, work orders, vendors, and maintenance history — to any AI agent that supports MCP.

"Your AI assistant. Your property system. No replacement required."

What This Server Does

PropSWOT MCP turns an AI agent into a fully-briefed property management assistant. Instead of guessing, the agent can:

• Look up the appliance at a unit (make, model, warranty status, age)
• Pull the 5 most recent work orders for that unit
• Generate safe tenant troubleshooting steps (English and Spanish)
• Check which vendors are available and ranked for the issue
• Create a work order with a two-step confirmation
• Assign a vendor and send the tenant an SMS

All 17 tools are org-scoped — an agent with your API key only sees your portfolio.

Quick Start

1. Get your API key

Log in to PropSWOT → Settings → MCP Keys → Create a key with read scope.

2. Connect to Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "propswot": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://pm.propswot.com/api/mcp"],
      "env": {
        "MCP_HEADER_X_MCP_KEY": "your-api-key-here"
      }
    }
  }
}

Or using the Authorization header:

{
  "mcpServers": {
    "propswot": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://pm.propswot.com/api/mcp"],
      "env": {
        "MCP_HEADER_AUTHORIZATION": "Bearer your-api-key-here"
      }
    }
  }
}

3. Try it

Ask Claude: "What needs attention at my properties today?"

Server Details

Tools

Read Tools (any valid key)

Write Tools (write scope — require two-step confirmation)

Admin Tools (admin scope)

Two-Step Confirmation (Write Safety)

All write tools use a propose → confirm pattern to prevent accidental mutations:

1. Call the tool without confirmation_id → receive a pending_confirmation response with a confirmation_id
2. Re-call the tool with the confirmation_id to execute

Confirmations expire after 5 minutes.

Example Conversation

User: My tenant at 123 Main St Unit 4B says the fridge isn't cooling.

Agent calls: lookup_appliance { property_address: "123 Main St", unit_number: "4B", appliance_type: "refrigerator" }
→ LG LRMVS3006S, installed 2019, warranty expired 2022, age 6 years

Agent calls: get_vendor_suggestions { issue_description: "refrigerator not cooling", property_address: "123 Main St" }
→ Top suggestion: City Appliance Repair (9.2/10, 0 callbacks in last 12 jobs)

Agent calls: create_work_order { property_address: "123 Main St", unit_number: "4B", issue_description: "Refrigerator not cooling — LG LRMVS3006S, 6 years old, warranty expired" }
→ confirmation_id: abc-123, summary shown to PM

PM confirms → work order created, vendor assigned, tenant notified

API Key Scopes

Create and manage keys at Settings → MCP Keys in your PropSWOT dashboard.

Rate Limits

• Default: 60 requests/minute per key
• Contact support for higher limits

Links

• Dashboard: https://pm.propswot.com
• Docs: https://pm.propswot.com/resources/propswot-mcp-for-property-management
• Claude Desktop Guide: https://pm.propswot.com/resources/connect-propswot-mcp-to-claude
• Discovery JSON: https://pm.propswot.com/.well-known/mcp.json
• Support: support@propswot.com

Use Cases

• Property managers using Claude or ChatGPT who want their AI to know their actual portfolio
• PM developers building AI workflows for their clients
• Proptech builders who need a structured MCP interface to property management data without building PMS integrations from scratch

PropSWOT is the AI operational intelligence layer above your PMS — not a replacement for AppFolio or Buildium. Your accounting stays where it is.