@rephelper/mcp-server

MCP server for REP Helper — let AI agents manage real estate activities and properties for IRS REP (Real Estate Professional) qualification tracking.

Prerequisites

• Node.js 20+ — download

• REP Helper Elite account — rephelper.ai

• API token — Create one in REP Helper → Settings → API Tokens

Quick Start

1. Create an API Token

In the REP Helper app, go to Settings → API Tokens → Create Token. Grant the permissions you need (e.g., activities read/create, properties read). Copy the token — it's shown only once.

2. Configure Your AI Client

Add the following to your client's MCP configuration:

Claude Desktop — Edit claude_desktop_config.json:

{
  "mcpServers": {
    "rephelper": {
      "command": "npx",
      "args": ["-y", "@rephelper/mcp-server"],
      "env": {
        "REPHELPER_API_TOKEN": "rh_live_your_token_here"
      }
    }
  }
}

Claude Code — Edit .claude/settings.json or use the /mcp command:

{
  "mcpServers": {
    "rephelper": {
      "command": "npx",
      "args": ["-y", "@rephelper/mcp-server"],
      "env": {
        "REPHELPER_API_TOKEN": "rh_live_your_token_here"
      }
    }
  }
}

Cursor — Edit .cursor/mcp.json:

{
  "mcpServers": {
    "rephelper": {
      "command": "npx",
      "args": ["-y", "@rephelper/mcp-server"],
      "env": {
        "REPHELPER_API_TOKEN": "rh_live_your_token_here"
      }
    }
  }
}

3. Start Using It

Ask your AI assistant to manage your real estate activities:

"Log 2 hours of property management for 123 Main St today"

"Show me all my activities from last week"

"Add a new long-term rental property at 456 Oak Ave, Austin, TX 78701"

Available Tools

Activities

Properties

Activity Categories

• Management & Operations

• Maintenance & Repairs

• Development & Construction

• Acquisition & Brokerage

• Administrative & Compliance

Evidence Files

When creating or updating activities, you can attach evidence files from your local filesystem:

• Supported formats: JPEG, PNG, WebP, PDF

• Maximum 3 files per activity

• Maximum 10MB per file

Example: "Log a maintenance activity and attach the receipt from /Users/me/Downloads/receipt.jpg"

Trips

Associate up to 3 trips with an activity. Trip travel time is automatically added to the activity duration.

Environment Variables

API Documentation

Interactive API docs are available at api.rephelper.ai/docs.

The OpenAPI spec is available at api.rephelper.ai/openapi.yaml.

Troubleshooting

"REPHELPER_API_TOKEN environment variable is required"

• Make sure you added the env block to your MCP config with your token.

"Token is invalid or not found"

• Double-check your token value. It should start with rh_live_.

• The token may have been revoked — create a new one in REP Helper.

"Permission denied: Token lacks X permission"

• Your token doesn't have the required permission. Edit the token in REP Helper → API Tokens to add it.

"API access requires an Elite subscription"

• API tokens are available on the Elite plan. Upgrade at rephelper.ai.

"Rate limited: Too many requests"

• Wait a moment and try again. Limits: 60 reads/min, 30 writes/min, 5 deletes/min.

License

MIT