Triggers automated workflows via webhooks for maintenance status changes and vendor escalations, allowing for extended automation such as emailing vendors or generating reports.
Connects to the Twilio API to facilitate sending WhatsApp notifications to tenants, supporting features like ticket acknowledgment and scheduling updates.
Provides capabilities to send automated tenant updates and maintenance notifications via WhatsApp using various message templates for acknowledgments, delays, and resolutions.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP PropTechEscalate the leaking water heater in unit 4C to a plumber and notify the tenant"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP PropTech — Property Maintenance Automation
A production-ready Model Context Protocol (MCP) server that lets a Claude-powered agent orchestrate your full property maintenance workflow — built on top of an existing n8n + WhatsApp automation system.
┌─────────────────────────────────────────────────────────┐
│ Claude Agent / Desktop │
└────────────────────────┬────────────────────────────────┘
│ MCP (stdio / SSE)
┌────────────────────────▼────────────────────────────────┐
│ MCP PropTech Maintenance Server │
│ │
│ get_open_tickets update_maintenance_status │
│ notify_tenant escalate_to_vendor │
└──────┬──────────────────────────────────┬───────────────┘
│ │
┌──────▼──────┐ ┌────────▼──────────┐
│ Ticket DB │ │ Integrations │
│ (in-memory │ │ ┌─────────────┐ │
│ → Postgres │ │ │ n8n │ │
│ in prod) │ │ │ Webhooks │ │
└─────────────┘ │ ├─────────────┤ │
│ │ Twilio │ │
│ │ WhatsApp │ │
│ └─────────────┘ │
└───────────────────┘Tools
Tool | Description |
| Query tickets filtered by status, priority, category, property |
| Drive tickets through the lifecycle with audit notes |
| Send WhatsApp messages via 5 templates (acknowledgement, scheduled, update, resolved, delay) |
| Assign vendor, trigger n8n workflow, notify tenant in one call |
Quick start
# 1. Install dependencies
npm install
# 2. Configure environment
cp .env.example .env
# Fill in ANTHROPIC_API_KEY, Twilio creds, n8n webhook URLs
# 3. Run the agent (single pass over the ticket queue)
npm run agent
# 4. Run as a daemon (checks every 5 minutes)
npm run agent:dev -- --daemonClaude Desktop integration
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"proptech-maintenance": {
"command": "npx",
"args": ["tsx", "/absolute/path/to/MCPPropTech/src/mcp-server/index.ts"],
"env": {
"ANTHROPIC_API_KEY": "sk-ant-...",
"TWILIO_ACCOUNT_SID": "AC...",
"TWILIO_AUTH_TOKEN": "...",
"TWILIO_WHATSAPP_FROM": "whatsapp:+14155238886",
"N8N_WEBHOOK_MAINTENANCE": "https://your-n8n.com/webhook/maintenance",
"N8N_WEBHOOK_ESCALATE": "https://your-n8n.com/webhook/escalate"
}
}
}
}Then from Claude Desktop you can say things like:
"Show me all open emergency tickets"
"Escalate the burst pipe in unit 3B to a plumber"
"Send Marcus in 7A a WhatsApp update on his AC ticket"
Architecture
MCP Server (src/mcp-server/)
The server runs over stdio (for Claude Desktop / agent SDK) and exposes the
four tools above. Swap StdioServerTransport for SSEServerTransport to serve
over HTTP for remote deployments.
Ticket Store (src/data/)
An in-memory store with 6 seed tickets covering every status and priority.
Replace TicketStore internals with a Postgres/Supabase/Airtable adapter for
production — the tool handlers only call the store interface.
n8n Integration (src/integrations/n8n.ts)
Fires webhooks to two n8n endpoints:
Maintenance webhook — on every status change and tenant notification
Escalation webhook — when a vendor is assigned
Your n8n workflows handle the rest: emailing vendors, updating spreadsheets, creating calendar invites, sending owner reports.
WhatsApp / Twilio (src/integrations/whatsapp.ts)
Uses the Twilio API to send WhatsApp messages. Gracefully falls back to simulation mode (console logging) when credentials are not set — perfect for demos and local development.
Claude Agent (src/agent/maintenance-agent.ts)
A full agentic loop using @anthropic-ai/sdk that:
Connects to the MCP server via
StdioClientTransportFetches available tools and converts them to the Anthropic tool format
Runs an agentic loop until Claude stops calling tools
Logs each tool call and result to the console
Lifecycle state machine
open ──→ in_progress ──→ resolved ──→ closed
│ │ ↑
│ └──→ awaiting_tenant
│ │
└──→ escalated ←────┘
│
└──→ in_progress / resolvedEnvironment variables
Variable | Required | Description |
| Agent only | Claude API key |
| Optional | Twilio account SID for WhatsApp |
| Optional | Twilio auth token |
| Optional | Sender WhatsApp number |
| Optional | n8n status-change webhook URL |
| Optional | n8n vendor escalation webhook URL |
| Optional | n8n API key (if required by your instance) |
| Optional | JSON map overriding default vendor directory |
| Optional | Daemon poll interval (default: 300000 = 5 min) |