Skip to content

MCP-README.md

Latest commit

 

History

History
169 lines (140 loc) · 4.02 KB

MCP-README.md

File metadata and controls

169 lines (140 loc) · 4.02 KB

DealFlow MCP Integration

Overview

DealFlow now supports Model Context Protocol (MCP), allowing AI assistants to directly interact with the property analysis platform.

✅ What's Enabled

1. Elegant Soft Grey Design

  • Replaced black/orange theme with sophisticated soft grey gradients
  • Indigo/purple accent colors (#6366f1, #8b5cf6)
  • White cards with subtle shadows
  • Professional, clean aesthetic

2. Google API Removed

  • Uninstalled react-google-autocomplete
  • No external API dependencies for address input
  • Standard text inputs for property information

3. MCP Server Integration

DealFlow now has a fully functional MCP server that exposes three powerful tools:

Available MCP Tools:

analyze_property

  • Analyzes real estate investments with AI-powered insights
  • Returns financial metrics + AI analysis
  • Parameters: address, city, state, zipCode, purchasePrice, monthlyRent

get_market_data

  • Retrieves real-time market sentiment and demographics
  • Parameters: city, state
  • Returns market trends, demographics, risk factors

compare_properties

  • Compares multiple properties side-by-side
  • Ranks by ROI
  • Returns best deal recommendation

🚀 Using the MCP Server

Start the MCP Server:

cd C:\Users\timud\Documents\dealflow
node server/mcp-server.js

MCP Configuration File:

Located at mcp-config.json - Configure this in your AI assistant's MCP settings.

Example MCP Request:

{
  "method": "call_tool",
  "params": {
    "tool": "analyze_property",
    "arguments": {
      "address": "123 Main St",
      "city": "Austin",
      "state": "TX",
      "zipCode": "78701",
      "purchasePrice": 350000,
      "monthlyRent": 2500
    }
  }
}

Example Response:

{
  "success": true,
  "property": {
    "address": "123 Main St",
    "city": "Austin",
    "state": "TX"
  },
  "financialMetrics": {
    "monthlyNumbers": {
      "cashFlow": 234.56,
      "rent": 2500,
      "mortgage": 1876.44
    },
    "metrics": {
      "roi": 8.5,
      "capRate": 6.2,
      "cashOnCashReturn": 7.8
    },
    "recommendation": {
      "verdict": "GOOD",
      "reason": "Positive cash flow with solid returns"
    }
  },
  "aiInsights": {
    "ultraThink": {
      "investmentGrade": "B+",
      "finalVerdict": "BUY - Good entry point",
      "whyInvest": [
        "Positive monthly cash flow",
        "Growing Austin market",
        "Strong rental demand"
      ],
      "whyNotInvest": [
        "Property taxes rising",
        "Competition from new builds"
      ]
    },
    "marketSentiment": {
      "trend": "Hot",
      "outlook": "Bullish"
    },
    "demographics": {
      "population": "990,000",
      "medianIncome": "$75,000"
    }
  }
}

🎨 Design Colors

Primary Gradient: linear-gradient(135deg, #6366f1 0%, #8b5cf6 100%)

  • Indigo to Purple gradient for headings and buttons

Background: linear-gradient(135deg, #f5f7fa 0%, #e8ecef 100%)

  • Soft grey gradient for page backgrounds

Cards: #ffffff with box-shadow: 0 4px 20px rgba(0, 0, 0, 0.08)

  • Clean white cards with subtle shadows

Text Colors:

  • Primary: #374151 (dark grey)
  • Secondary: #6b7280 (medium grey)
  • Accent: #6366f1 (indigo)

📊 AI Integration

Groq AI: Llama 3.3 70B for ultra-think analysis Hugging Face: Available for additional ML models No Google APIs: Self-contained AI analysis

🔧 Environment Variables

GROQ_API_KEY=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
HUGGINGFACE_API_KEY=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

🌐 URLs

💡 Features

✅ Elegant soft grey design ✅ No Google API dependencies ✅ Full MCP protocol support ✅ AI-powered property analysis ✅ Market sentiment analysis ✅ Demographics research ✅ Property comparison ✅ Export to JSON/TXT ✅ Side-by-side comparison view

Generated by DealFlow v2.0 - MCP Enabled