A property hunting assistant built with assistant-ui and Mastra, enhanced with MCP (Model Context Protocol) server capabilities.
This project uses a Mastra agent powered by OpenAI to help you find and manage property searches.
-
OpenAI API Key: Sign up at platform.openai.com and create an API key
-
Environment Variables: Create a
.envfile (copy from .env.example) in the project root:
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
RESEND_API_KEY=re_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # Optional: For email capabilities
SENDER_EMAIL_ADDRESS=sender.address@your-domain.com # Optional: Verified email address to send email from
MELO_API_KEY="your_api_key_here" # Optional: For property search in Francenpm install
npm run dev
# or
pnpm install
pnpm devOpen http://localhost:3000 to start chatting with your property hunting agent.
This property hunter agent's capabilities are extendend by connecting MCP servers. Each server provides specialized tools that the agent can use autonomously.
The Resend MCP Server enables your agent to compose and send emails directly using the Resend email API.
What the agent can do:
- Send plain text and HTML emails
- Schedule emails for future delivery
- Add CC and BCC recipients
- Configure reply-to addresses
- List Resend audiences
Example prompts:
"Send an email to john@example.com with the top 3 properties I'm interested in from our conversation."
"Draft and send a professional email to the property agent requesting a viewing for the apartment on 5th Avenue next Tuesday at 2 PM."
"Schedule an email to remind me tomorrow morning about following up with the landlord of that Brooklyn loft."
This MCP server is deployed and ready to use - no local installation required!
Step 1: Get your Resend API Key:
- Create a free account at resend.com
- Create an API Key
- (Optional) Verify your domain to send to any email address
Step 2: Add your Resend API key and sender email to .env:
RESEND_API_KEY=re_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
SENDER_EMAIL_ADDRESS=your-email@example.com # The email address you want to send fromNote: Your sender email must be verified in Resend.
The server is already configured in mastra/mcp/mcpClient.ts and will automatically connect when you provide the API key.
The Property Search MCP Server enables your agent to search for real estate properties in France using the Melo (notif.immo) API.
What the agent can do:
- Search for apartments and houses for sale or rent
- Filter by price range, surface area, and location
- Search by French zip codes
- Filter by number of bedrooms
- Calculate and filter by price per square meter
- Sort results by price, price per meter, or recently updated
- Paginate through search results
Example prompts:
"Find apartments for sale in Paris 11th arrondissement with at least 2 bedrooms under 500,000€"
"Show me houses for rent in Paris with a minimum of 80m² surface area"
"Search for properties in the 75018 zip code sorted by price per meter"
This MCP server is deployed and ready to use - no local installation required!
Step 1: Get your Melo API Key:
Obtain a Melo API key from notif.immo.
Step 2: Add your Melo API key to .env:
MELO_API_KEY="your_api_key_here"The server is already configured in mastra/mcp/mcpClient.ts and will automatically connect when you provide the API key.
property-hunter/
├── app/ # Next.js app directory
│ ├── api/chat/ # Chat API route
│ └── assistant.tsx # Main assistant UI component
├── components/ # UI components
│ └── assistant-ui/ # Assistant-specific components
├── mastra/ # Mastra agent configuration
│ ├── agents/ # Agent definitions
│ └── mcp/ # MCP client configuration
└── .env.local # Environment variables (create this)