PROPUP MCP Server

MCP (Model Context Protocol) server for the PROPUP real estate platform. Gives AI assistants direct access to your propup functionality.

Supports two transport modes:

• Stdio — for local use with Claude Code, Cursor, etc. (API key auth)
• HTTP — for remote use with Claude Desktop, ChatGPT, etc. (OAuth via Keycloak)

Available Tools

Properties

| Tool | Description | |------|-------------| | list_properties | List all your properties | | get_property | Get property details by ID | | search_properties | Search by address, owner, title | | create_property | Create a new property listing | | update_property | Update property fields | | delete_property | Soft-delete a property |

Customers (unified: private, business, contract partners)

| Tool | Description | |------|-------------| | list_customers | List all customers (optionally filter by type) | | get_customer | Get customer details by ID | | search_customers | Search by name, email, phone, company | | create_customer | Create a private, business, or contract partner customer | | update_customer | Update customer fields | | delete_customer | Delete a customer |

Option 1: Remote (Claude Desktop / ChatGPT)

No installation needed. Connect directly from your AI client:

1. Claude Desktop: Click + → Connectors → Add custom connector → enter the MCP server URL (e.g. https://mcp.propup.at/mcp)
2. ChatGPT: Go to Settings → Apps & Connectors → add the MCP server URL

You'll be redirected to the PROPUP login page (Keycloak). After login, the connection is established — no API keys needed.

Option 2: Local (Claude Code / Cursor / IDEs)

1. Get your API key

Go to your PROPUP account: Settings → API Keys → Create

2. Install

npm install -g propup-mcp

Or run directly with npx (no install needed):

npx propup-mcp

3. Configure your AI client

Claude Code

claude mcp add propup -e PROPUP_API_KEY=pk_your_key_here -- npx propup-mcp

Claude Desktop (local)

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):

{
  "mcpServers": {
    "propup": {
      "command": "npx",
      "args": ["propup-mcp"],
      "env": {
        "PROPUP_API_KEY": "pk_your_key_here"
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP configuration following the respective IDE's docs, using the same command and env pattern.

Environment Variables

Stdio mode (local)

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | PROPUP_API_KEY | Yes | - | Your PROPUP API key (starts with pk_) | | PROPUP_BASE_URL | No | https://plattform.propup.at | API base URL (for staging/dev) |

HTTP mode (remote server)

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | MCP_TRANSPORT | Yes | stdio | Set to http to enable HTTP mode | | KEYCLOAK_URL | Yes | - | Keycloak base URL (e.g. https://auth.propup.at) | | KEYCLOAK_REALM | No | PROPUP | Keycloak realm name | | MCP_SERVER_URL | Yes | - | Public URL of this MCP server (e.g. https://mcp.propup.at) | | MCP_PORT | No | 3100 | HTTP server port | | PROPUP_BASE_URL | No | https://plattform.propup.at | API base URL |

Development

# Install dependencies
npm install

# Run in development (stdio)
npm run dev

# Build
npm run build

# Run built version (stdio)
npm start

# Run in HTTP mode
MCP_TRANSPORT=http \
KEYCLOAK_URL=https://auth.propup.at \
MCP_SERVER_URL=https://mcp.propup.at \
npm start

Examples

Once connected, you can ask your AI assistant things like:

• "List all my properties in Wien"
• "Create a new apartment listing at Kärntner Straße 1, 1010 Wien"
• "Find all customers named Mustermann"
• "Create a business customer for Mustermann GmbH"
• "Update the phone number of customer [ID]"
• "Show me the details of property [ID]"