MCP / Agents
Connect AI agents to your property data using the Model Context Protocol
What is MCP?
The Model Context Protocol is an open standard for connecting AI agents to external data. Instead of building custom integrations for each AI tool, MCP provides a single connection point.
Once connected, your AI agent can read your property data, pull financial reports, send tenant messages, and more — all through conversation.
Works with your agent
Connect any MCP-compatible agent or automation tool — one server, every workflow.
What can your agent do?
Ask in plain English. Your agent calls the right MCP tool — here are examples across all 10 domains.
Properties & Units
Lists properties and computes occupancy.
Tenants
Pulls tenants and filters by overdue balance.
Leases
Filters active leases by end date.
Financial
Builds a cash-flow summary for the period.
Maintenance
Returns open requests, oldest first.
Messages
Sends a message to each overdue tenant.
Calendar
Lists scheduled charges, deadlines, and events.
Workflows
Reports workflow step progress.
Webhooks
Subscribes a webhook to the maintenance_request.created event.
Bring Your Own Model
No lock-in. No extra charges. Use the agent you already pay for.
Switch anytime
Claude today, GPT tomorrow, a local model next year. The MCP standard works with all of them — your data and workflows stay the same.
No extra AI charges
You pay your AI provider directly — we never charge extra for connecting your own agent.
Your data, your model
Your property data goes to the model you choose — not through an embedded AI layer you can't audit or control.
Platforms like Buildium embed their own AI and charge for it in higher tiers. We stay out of the AI business — you bring the intelligence, we provide the deterministic, auditable system of record.
Quick Setup
Two steps to connect your AI agent:
Create an API Token
Add the MCP Server
Paste this configuration into your AI agent. Replace YOUR_TOKEN_HERE with the token from step 1.
{
"mcpServers": {
"landlord-app": {
"url": "https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}Your agent discovers available tools automatically. Just ask in plain language — R "What's my vacancy rate?", R "Show overdue balances", or W "Send a message to the tenant in unit 3B."
Setup by Agent
These badges show each tool's own plan requirements — they are separate from your Marula Landlord OS subscription.
Chat Assistants
Connect your AI chat assistant to manage properties through conversation.
ChatGPT Paid
Works in the ChatGPT desktop app and at chatgpt.com in your browser. Requires OpenAI's ChatGPT Plus plan or higher — this is OpenAI's paid tier, separate from your Marula Landlord OS plan.
- Go to Settings → Connected Tools
- Click Add Tool → MCP Server
- Enter the server URL:
https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/ - Add the Authorization header with your Bearer token
Claude Free
Claude has several products that connect to MCP servers. Choose the one you're using. Anthropic's Claude Free tier supports 1 custom connector; Claude Pro for unlimited. These are Anthropic's plans, separate from your Marula Landlord OS plan.
Claude.ai Browser
Use this if you chat with Claude at claude.ai in your browser.
- Go to Settings → Connectors
- Click Add custom connector
- Enter the server URL:
https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/ - Complete authentication with your Bearer token
Claude Chat Desktop App
Use this if you chat with Claude in the desktop app's conversation view.
- Go to Settings → Connectors
- Click Add custom connector
- Enter the server URL:
https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/ - Complete authentication with your Bearer token
Custom Connectors sync between claude.ai and the desktop app — configure in either place.
Claude Code CLI · Desktop · VS Code · JetBrains
Use this if you use Claude Code — the standalone CLI, a Claude Code session in the desktop app, or the VS Code / JetBrains extensions.
Add it with a single command:
claude mcp add --transport http landlord-app \
https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/ \
--header "Authorization: Bearer YOUR_TOKEN_HERE"Or create a .mcp.json file in your project root:
{
"mcpServers": {
"landlord-app": {
"type": "http",
"url": "https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}Run /mcp to verify the connection shows landlord-app · ✓ connected.
Claude Cowork Desktop App
Use this if you use collaborative Cowork sessions in the Claude desktop app.
Cowork sessions use the same Custom Connectors as Claude Chat. Configure once in Settings → Connectors and the tools are available in both Chat and Cowork.
Google Gemini Free
Works at gemini.google.com (requires Google's Gemini Advanced, a paid Google plan) or Google AI Studio (free for developers, from Google).
- Open gemini.google.com
- Go to Settings → Extensions
- Add a new MCP extension with the server URL:
https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/ - Enter your Bearer token for authentication
Microsoft Copilot Paid
Works at copilot.microsoft.com, in Windows, and in Microsoft 365 apps. Requires a Microsoft Copilot subscription (Copilot Pro, M365 Copilot, or Copilot Enterprise) — Microsoft's paid plans, separate from your Marula Landlord OS plan.
- Open copilot.microsoft.com or the Copilot app
- Go to Settings → Plugins or Connections
- Add a new MCP connection with the server URL:
https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/ - Enter your Bearer token for authentication
Grok Paid
Works at grok.com and in the X (Twitter) app. Requires a paid Grok subscription from xAI — separate from your Marula Landlord OS plan.
- Open grok.com
- Go to Settings → Connections or Tools
- Add a new MCP server with the URL:
https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/ - Enter your Bearer token for authentication
Perplexity Paid
Works at perplexity.ai and in the Perplexity mobile app. Requires Perplexity Pro or higher — Perplexity's paid plan, separate from your Marula Landlord OS plan.
- Open perplexity.ai
- Go to Settings → MCP Servers or Connections
- Add a new server with the URL:
https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/ - Enter your Bearer token for authentication
Coding Assistants
For developers and power users who work in code editors.
Cursor Free
- Open Settings → MCP
- Click Add new MCP server
- Enter the server URL and your Bearer token
VS Code (Copilot) Free
- Open your VS Code
settings.json(Ctrl+Shift+P → "Preferences: Open User Settings (JSON)") - Add the MCP server under the
"mcp.servers"key - Restart VS Code — Copilot Chat will discover the tools automatically
Other MCP Clients
Any MCP-compatible client can connect using the server URL and Bearer token. The server supports Streamable HTTP transport — the standard for remote MCP servers. Refer to your client's documentation for where to add remote MCP server configurations.
Workflow Automation
Automate property management tasks with no-code workflow engines. The MCP server uses standard HTTP — any tool that can send JSON-RPC POST requests can call it.
n8n Free
n8n has a built-in MCP Client node that connects directly to MCP servers. The MCP Client node is available on all n8n plans, including n8n's free self-hosted tier — separate from your Marula Landlord OS plan.
- Add an MCP Client node to your workflow
- Set the server URL:
https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/ - Add a header credential with
Authorization: Bearer YOUR_TOKEN_HERE - The node will discover all available tools automatically
Use it with an AI Agent node to build workflows like "every Monday, summarize overdue balances and email me a report."
Make Paid
Make has a dedicated MCP Client module that connects to remote MCP servers and auto-discovers tools. Requires a paid Make plan — Make's pricing, separate from your Marula Landlord OS plan.
- Add an MCP Client module to your scenario
- Set the server URL:
https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/ - Choose Token authentication and enter your Bearer token
- Make will load all available tools automatically — pick one from the dropdown
Build scenarios like "when a new tenant is added in my CRM, check their balance here."
Zapier Beta
Zapier has a dedicated MCP Client integration that connects to remote MCP servers. The MCP Client is currently in Beta.
- In your Zapier dashboard, go to Apps → + Add connection
- Search for MCP Client and select it
- Enter the server URL:
https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/ - Select Streamable HTTP transport
- Choose No for OAuth, then enter your Bearer token
Once connected, tools from your landlord app appear as actions in the Zap editor.
Pipedream Free
Pipedream supports connecting to remote MCP servers via its MCP client SDK. Pipedream's free development mode covers testing; Pipedream's paid plan is needed for production — separate from your Marula Landlord OS plan.
- Create a Pipedream project and generate an API key
- Use the MCP client SDK to connect:
https://landlord-edge-staging.landlord-app.workers.dev/api/mcp/ - Add the
Authorization: Bearer YOUR_TOKEN_HEREheader - Call
session.list_tools()to discover available tools
Build workflows like "sync new tenants to a Google Sheet" or "alert Slack when rent is overdue."
Works with your automation stack
Subscribe to 11 event types with HMAC-signed delivery, or drive workflows from the MCP server. Build custom pipelines in N8N, Make, Zapier, Pipedream, or any HTTP-capable tool.
- Rent & payments — rent.charged, payment.received
- Leases — lease.created, lease.finalized, lease.terminated
- Maintenance — maintenance_request.created, maintenance_request.updated
- Custom — HMAC-signed delivery to any HTTPS endpoint
Test Your Connection
After setting up any agent above, try these prompts to verify it works. Start simple, then try complex queries.
List my propertiesCalls one read tool. Works on every plan, including Free.
Give me a portfolio overviewCalls several read tools and combines the results. Works on every plan.
Send a message to the tenant in unit 3BRequires a read-write token (Starter+ plan). You'll be asked to confirm before the action executes.
Available Tools
Once connected, your AI agent can use these tools:
Properties & Units
R List & view
W Create & update
Tenants
R Info, balances, statements
W Create & update
Leases
R Terms, status, tenants
W Charges & payments
Financials
R Income, cash flow, receivables
Maintenance
R View requests
W Update & comment
Messages
R Read messages
W Send messages
Calendar
R Events, dates, deadlines
Workflows
R View progress
W Complete steps
Example Conversations
Here's what talking to your agent looks like once connected:
Access by Plan
Free R
Read-only access
- View properties, units, tenants
- Check balances and lease terms
- Pull financial reports
- View maintenance requests
- Read messages
Starter+ R W
Read + write access
- Everything in Free, plus:
- Create and update tenants
- Send messages
- Update maintenance requests
- Manage leases and units
Security & Transparency
Each API token is scoped to your account only. No cross-tenant access.
Revoke any token from Settings → API Tokens. Takes effect immediately.
MCP requests go through the same authentication, validation, and rate limiting as the web portal.
Our MCP server is deterministic software — it reads and writes your data as instructed. The AI runs entirely in your agent.
Read our full Use of Generative AI disclosure for details on how we handle AI and who is responsible for agent outputs.
Claude and Claude Code are trademarks of Anthropic. ChatGPT is a trademark of OpenAI. Gemini is a trademark of Google. Copilot and Visual Studio Code are trademarks of Microsoft. Grok is a trademark of xAI. Perplexity is a trademark of Perplexity AI. Cursor is a trademark of Anysphere. n8n is a trademark of n8n GmbH. Make is a trademark of Celonis SE. Zapier is a trademark of Zapier, Inc. These names and logos are used for identification purposes only and do not imply endorsement by or affiliation with these companies.