NJ Realtor MCP — Frontier Edition

A production-grade Model Context Protocol server for NJ real estate agents.
20 tools. 15+ data sources. Crawl4AI web crawling. Deep research mode. Full NJ-specific intelligence.

What This Does

Claude gains 20 native tools covering the full NJ real estate workflow:

Related MCP server: NDI-MCP-Server

Data Sources (Full Map)

MLS / Listing Data

Public Records (NJ-Specific)

Neighborhood Intelligence

Market & Financial

Transit / Commute

Communications & Calendar

Quick Start

Prerequisites

• Docker + Docker Compose

• Node.js 20+

• API keys (see .env.example)

1. Clone and configure

git clone <repo>
cd nj-realtor-mcp
cp .env.example .env
# Edit .env with your API keys

2. Start the full stack

cd docker
docker compose up -d

This starts:

• PostgreSQL 16 with pgvector + PostGIS (geo queries + semantic search)

• Redis (caching + job queue)

• Crawl4AI (async browser-based crawler with anti-bot mode)

• MCP Server (the 20 tools)

• Cron service (background data sync)

3. Initialize the database

docker exec nj_realtor_db psql -U realtor -d nj_realtor -f /docker-entrypoint-initdb.d/01_schema.sql
node scripts/seed_nj_zips.js   # seeds all NJ ZIP codes with county, transit, tax rate data

4. Seed MLS data

node scripts/seed_crawl.js   # queues initial crawl jobs for NJ listings

5. Register with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "nj-realtor": {
      "command": "node",
      "args": ["/path/to/nj-realtor-mcp/src/index.js"],
      "env": {
        "POSTGRES_URL": "postgresql://realtor:pass@localhost:5432/nj_realtor",
        "REDIS_URL": "redis://localhost:6379",
        "CRAWL4AI_URL": "http://localhost:11235"
      }
    }
  }
}

Example Claude Conversations

Property Due Diligence

"Run deep research on 47 Oak Avenue, Rumson NJ 07760"

Claude will: pull price history, run CMA, check permits/liens, assess flood risk, analyze commute to NYC, pull school district data, check for rent control (not applicable for SFR), and synthesize into a full due diligence report.

Buyer Matching

"I have a new buyer, Sarah Chen, looking for a 3-4BR under $750k in Monmouth County with good schools and under 60 min train to NYC. Set up alerts."

Claude will: save buyer profile, search active listings, rank by match score, send initial SMS with top 5 matches, and enable ongoing alerts for new listings.

Investment Analysis

"Analyze 22 Main St, Asbury Park NJ as a rental investment. Purchase price $620k."

Claude will: estimate market rent (Asbury Park has strong rental demand + rent control), run full NOI/cap rate/cash-on-cash analysis, flag NJ's high property tax rate, check for rent control, and calculate 5-year IRR.

Market Report

"Give me a market pulse for Monmouth County for the last 30 days"

Claude will: pull median prices, DOM, inventory, list-to-sold ratios, YoY changes, and write a 3-sentence market narrative for your newsletter.

Listing Copy

"Draft a listing for 8 Harbor View Dr, Sea Bright NJ. Highlights: oceanfront, fully renovated, elevator, 4BR, $3.2M."

Claude will: generate MLS description (500 words), Instagram caption, Facebook post, and 5 key feature bullets — all optimized for waterfront luxury segment.

NJ-Specific Intelligence

This MCP was built with deep NJ market knowledge baked in:

• Property taxes: NJ has the highest effective rate in the US (avg 2.23%). Every valuation and investment analysis explicitly accounts for this.

• Flood risk: Post-Hurricane Sandy, flood zone classification is critical for NJ coastal/shore properties (Ocean, Monmouth, Atlantic counties especially). We integrate FEMA + NJ DEP + sea level rise projections.

• School districts: NJ's #1 buyer decision factor. We integrate NJ DOE District Factor Groups (A through J), NJSLA scores, and GreatSchools ratings.

• NJ Transit: Door-to-door commute time to NYC Penn Station is a core value driver. We compute actual train journey times for 163 NJ rail stations.

• Rent control: ~100 NJ municipalities have rent control. Every investment analysis flags this automatically.

• 565 municipalities: Each has its own tax rate, zoning rules, and permit system. Our tax lookup normalizes across all of them.

• Mansion tax: NJ imposes a 1% mansion tax on residential sales over $1M. Our mortgage and investment calculators include this.

• Landlord-tenant law: NJ is tenant-friendly (Anti-Eviction Act). Investment analyses note this risk.

Architecture

Claude Desktop
    │
    ▼ MCP (stdio)
NJ Realtor MCP Server (Node.js)
    │
    ├── PostgreSQL 16 + pgvector + PostGIS
    │       ├── properties table (MLS + ATTOM merged)
    │       ├── sales_history (deed records)
    │       ├── tax_assessments (NJ MOD-IV)
    │       ├── permits_liens (NJ Courts + municipal)
    │       ├── market_stats (pre-aggregated)
    │       ├── clients (buyer profiles + alert criteria)
    │       └── crawl_jobs (queue for background crawling)
    │
    ├── Redis (6hr TTL cache for CMAs, neighborhood reports)
    │
    └── Crawl4AI (Docker, Playwright-based)
            ├── Zillow property pages
            ├── NJ county tax/deed portals (20 counties)
            ├── NJ Courts lis pendens search
            ├── NJ Flood Mapper
            ├── Apartments.com rental listings
            ├── NJ Transit schedule pages
            └── SpotCrime crime data

Roadmap

• Matterport 3D tour integration (auto-generate for listed properties)

• NJ short-term rental ordinance tracker (Airbnb viability by municipality)

• HOA document analyzer (AI reads CC&Rs and flags red flags)

• Contractor permit history (who pulled permits, licensed/unlicensed work)

• Solar potential analysis (NJ has strong solar incentives — SREC program)

• 1031 exchange tracker (identify replacement properties meeting exchange criteria)

• MLS listing auto-publish (post approved listings directly to GSMLS)

• Offer analysis tool (compare multiple offers with net-to-seller calculation)

• Property condition report parser (AI reads inspection reports, extracts issues)

• NJ ANCHOR benefit calculator (NJ property tax relief program for homeowners)