Rentalot Server

MCP server for the Rentalot API. Manage rental properties, contacts, showings, conversations, and more from any AI assistant.

Setup

Claude Code

claude mcp add rentalot -e RENTALOT_API_KEY=ra_your_key -- npx -y @rentalot/mcp-server

Codex (OpenAI)

codex mcp add --env RENTALOT_API_KEY=ra_your_key -- npx -y @rentalot/mcp-server

Gemini CLI

gemini mcp add --transport stdio rentalot -- npx -y @rentalot/mcp-server

Then add the env var to ~/.gemini/settings.json:

{
  "mcpServers": {
    "rentalot": {
      "command": "npx",
      "args": ["-y", "@rentalot/mcp-server"],
      "env": { "RENTALOT_API_KEY": "ra_your_key" }
    }
  }
}

Claude Desktop / Cursor / Windsurf

All three use the same JSON format — just different file paths:

{
  "mcpServers": {
    "rentalot": {
      "command": "npx",
      "args": ["-y", "@rentalot/mcp-server"],
      "env": {
        "RENTALOT_API_KEY": "ra_your_key"
      }
    }
  }
}

OpenCode

Add to ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "rentalot": {
      "type": "local",
      "command": ["npx", "-y", "@rentalot/mcp-server"],
      "environment": { "RENTALOT_API_KEY": "ra_your_key" },
      "enabled": true
    }
  }
}

Get Your API Key

1. Go to Rentalot API Keys
2. Click Create API Key
3. Copy the key (starts with ra_)

Authentication

You can provide your API key in two ways. Environment variables take priority over the config file.

Option A: Config file (recommended)

Save your key once and every MCP client picks it up automatically — no need to set RENTALOT_API_KEY in each client's config:

mkdir -p ~/.config/rentalot
cat > ~/.config/rentalot/config.yaml << 'EOF'
api_key: ra_your_key
EOF
chmod 600 ~/.config/rentalot/config.yaml

Then register the server without any env var:

# Claude Code
claude mcp add rentalot -- npx -y @rentalot/mcp-server

# Codex
codex mcp add -- npx -y @rentalot/mcp-server

Option B: Environment variable

Pass RENTALOT_API_KEY in your MCP client config (shown in the setup examples above). This overrides the config file.

Config file reference (~/.config/rentalot/config.yaml):

# Required
api_key: ra_your_key

# Optional — defaults to https://rentalot.ai
# base_url: http://localhost:3000

Respects $XDG_CONFIG_HOME — if set, looks for $XDG_CONFIG_HOME/rentalot/config.yaml instead.

Resolution order: RENTALOT_API_KEY env var > api_key in config file

AI Agent Skill

This project ships a SKILL.md following the Agent Skills open standard. Install it so your coding agent knows all 65 tools, common workflows, and API patterns.

Quick install with skills CLI (by Vercel Labs):

npx skills add ariel-frischer/rentalot-mcp

# Global — available in all projects
mkdir -p ~/.claude/skills/rentalot-mcp
curl -fsSL https://raw.githubusercontent.com/ariel-frischer/rentalot-mcp/main/.skills/default/SKILL.md \
  -o ~/.claude/skills/rentalot-mcp/SKILL.md

# Project-local — checked into this repo only
mkdir -p .claude/skills/rentalot-mcp
curl -fsSL https://raw.githubusercontent.com/ariel-frischer/rentalot-mcp/main/.skills/default/SKILL.md \
  -o .claude/skills/rentalot-mcp/SKILL.md

# Global
mkdir -p ~/.codex/skills/rentalot-mcp
curl -fsSL https://raw.githubusercontent.com/ariel-frischer/rentalot-mcp/main/.skills/default/SKILL.md \
  -o ~/.codex/skills/rentalot-mcp/SKILL.md

# Project-local
mkdir -p .codex/skills/rentalot-mcp
curl -fsSL https://raw.githubusercontent.com/ariel-frischer/rentalot-mcp/main/.skills/default/SKILL.md \
  -o .codex/skills/rentalot-mcp/SKILL.md

Detailed API Skill

For deeper API reference (full field lists, status enums, webhook events), there's also a comprehensive skill at skills/rentalot/SKILL.md. Symlink it for Claude Code:

ln -s "$(pwd)/skills/rentalot" ~/.claude/skills/rentalot

Then invoke with /rentalot in any Claude Code session.

Tools (65)

Resources

• docs://api-reference — Full API reference (authentication, rate limits, pagination, errors, all resource schemas)

Development

bun install
bun run build      # Compile TypeScript
bun run dev        # Run with --watch (hot reload)
bun run lint       # ESLint
bun run typecheck  # tsc --noEmit
bun run test:e2e   # E2E test all 65 tools against local dev server

License

MIT