# InvestorLift MCP MCP

> InvestorLift automates real estate deal sourcing by connecting your AI agent directly to a live marketplace API. Use this MCP to list thousands of off-market deals, instantly analyze property data against your custom investment rules, and send direct messages to sellers—all without leaving your chat window.

## Overview
- **Category:** real-estate
- **Price:** Free
- **Tags:** real-estate-investing, deal-sourcing, off-market-deals, investment-property, marketplace

## Description

Managing real estate investments means constantly sifting through listings and talking to wholesalers, which is usually a massive headache. With this connector, you tell your agent what criteria matter (e.g., single-family homes in Florida with 12% ROI), and it handles the rest. You can ask the system to pull all available deals matching those exact parameters, or dig into specific properties for deep data insights. Need to talk to a seller about a deal? Just tell your agent to send a message; no need to copy names or log into another portal. This whole setup is managed through Vinkius's catalog, giving your AI client access to the entire toolset right where you work.

## Tools

### list_deals
Searches the marketplace to list all available properties based on geographical location and price filters.

### get_buy_box
Retrieves the current investment parameters and criteria set for your purchasing goals.

### get_deal
Fetches detailed data, including metadata and pricing, for a single specific property listing.

### send_message
Sends a direct, contextual message from you to a seller about a specific property deal.

### update_buy_box
Changes or sets new investment criteria (like target ROI or zip codes) that the system uses for filtering deals.

## Prompt Examples

**Prompt:** 
```
List all available deals in Houston, Texas with a maximum price of $300,000.
```

**Response:** 
```
I've found 3 deals in Houston under $300k. One is a 3-bed fixer-upper (ID: 55432) for $245,000. Would you like more details on any of these?
```

**Prompt:** 
```
What are my current investment criteria in my buy box?
```

**Response:** 
```
Your current buy box is set to target Single Family homes in Florida and Georgia with a minimum ROI of 12% and a price range between $150k and $450k.
```

**Prompt:** 
```
Send a message to the seller of deal 98765 saying I am interested in a cash offer.
```

**Response:** 
```
Message sent successfully to the seller of deal 98765. I've let them know you're interested in making a cash offer.
```

## Capabilities

### Source Available Deals
List available properties in a specific area by applying filters for location and maximum price.

### Analyze Specific Properties
Retrieve detailed information, including pricing and metadata, for any single property ID.

### Set Investment Criteria
Update your personal buying criteria—like target ROI or preferred zip codes—so the AI knows what to look for next.

### Check Current Buy Box
Retrieve and confirm the precise investment rules the system is currently using for filtering deals.

### Communicate with Sellers
Send a direct, contextual message to any seller regarding a specific deal ID.

## Use Cases

### Need to find deals in a new zip code.
I want to see every available property in Phoenix, AZ under $400k. Agent: Use `list_deals` for Phoenix, filtering by max price $400k. The agent returns 12 potential listings with key stats.

### The target ROI changed mid-week.
My investment goals shifted from 8% ROI to 15%. Agent: Use `update_buy_box` and set the minimum ROI to 15%. Now, any subsequent deal search will automatically filter out properties that don't meet this new threshold.

### Need details on a specific property ID.
I saw Deal ID 98765. What are the full specs and pricing? Agent: Use `get_deal` with ID 98765. The agent provides deep metadata, helping me decide if I need more information.

### Found a good listing but need to talk to the seller.
I'm interested in Deal ID 1234 and want to know about cash offers. Agent: Use `send_message` for deal 1234, stating I am ready for a cash offer. The agent sends the message immediately.

## Benefits

- You never have to manually filter listings again. Just ask your agent to use `list_deals` and specify the location and price range, and you get a clean list of options right in your chat window.
- Forget guessing if your investment criteria are up to date. Use `get_buy_box` to instantly confirm the system's current rules for ROI or property type before you even start searching.
- If you find a promising deal, you don't have to switch apps to ask questions. Using `send_message` sends a contextual message directly to the seller from your workflow.
- Need to pivot your strategy? Instead of manually changing spreadsheets, calling `update_buy_box` instantly adjusts all future searches and analyses to match your new target criteria.
- Analyzing data for one property shouldn't be a hassle. The agent can use `get_deal` to pull all the deep metrics you need on a specific listing without leaving the conversation.

## How It Works

The bottom line is that you treat property sourcing and negotiation like any other conversation with your AI client, eliminating the need for manual platform logins.

1. Subscribe to this MCP and enter your InvestorLift API Key.
2. Your AI agent connects the credentials and verifies access to the marketplace data.
3. You prompt your agent with a request (e.g., 'Find deals in Miami under $500k'), and it executes the search using `list_deals`.

## Frequently Asked Questions

**How do I find deals in a certain area using list_deals?**
You prompt the agent with your location and price limits. The system uses `list_deals` to search the marketplace, giving you all properties that match those filters.

**What does get_buy_box do for my investment criteria?**
It immediately tells you what rules your agent is currently using. This is useful because it confirms whether or not you need to run `update_buy_box` first.

**Can I analyze a deal without knowing the ID? (get_deal)**
No, `get_deal` requires a specific property ID. You must first use `list_deals` to get a list and then select an ID to run the detailed analysis.

**If I change my investment rules, do I need to re-run anything? (update_buy_box)**
After running `update_buy_box`, you should immediately run `get_buy_box` afterward. This confirms the new parameters are active and ready for use in future searches.

**What is required to authenticate my account before running any tool, like list_deals?**
You must provide a valid InvestorLift API Key during setup. This key authorizes your AI client to access the marketplace tools. If the connection fails, always check your credentials first.

**If I use get_deal for an ID that is invalid or expired, what kind of error do I receive?**
The tool returns a specific 'Deal Not Found' status instead of crashing. Your agent can then read this structured response and notify you immediately that the property data isn't available.

**Are there rate limits when calling list_deals repeatedly in a single session?**
Yes, standard API usage quotas apply to prevent abuse. The system monitors your calls and will prompt you if you approach your daily limit. Check the documentation for specific quota details.

**Are there character limits or restrictions when I use send_message?**
Messages must be reasonably concise, typically within 500 characters. The system filters out spam and highly restricted content types before sending it to the seller.

**How can I filter real estate deals by a specific city and price range?**
You can use the `list_deals` tool. Simply provide parameters like `city`, `min_price`, and `max_price` to narrow down the marketplace results to your specific needs.

**Can I update my investment criteria so the AI finds better matches?**
Yes! Use the `update_buy_box` tool to send a JSON object containing your updated criteria. This helps the system align deal discovery with your investment strategy.

**Is it possible to contact a seller directly through the AI?**
Absolutely. Use the `send_message` tool by providing the `deal_id` and your message text. The AI will deliver your inquiry to the seller regarding that specific property.