Metadata-Version: 2.4
Name: ndi-mcp-server
Version: 1.0.2
Summary: AI-powered commercial real estate deal search, comp lookup, and property scoring for the Northeast US via MCP
Project-URL: Homepage, https://northeastdealintel.com/agent-api.html
Project-URL: Repository, https://github.com/CREIntel/ndi-mcp-server
Project-URL: Documentation, https://github.com/CREIntel/ndi-mcp-server/blob/main/README.md
Project-URL: Bug Tracker, https://github.com/CREIntel/ndi-mcp-server/issues
Author-email: Northeast Deal Intel <dave@northeastdealintel.com>
License: MIT
License-File: LICENSE
Keywords: 1031-exchange,commercial-real-estate,comps,cre,mcp,model-context-protocol,northeast,property-data,real-estate
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# NDI MCP Server

<!-- mcp-name: io.github.CREIntel/ndi-mcp-server -->

**AI-powered commercial real estate intelligence for the Northeast US — via the Model Context Protocol.**

Use this server to give Claude, Cursor, Windsurf, or any MCP client direct access to:

- **14,000+ AI-scored active listings** across CT, MA, NJ, NY, PA, RI, NH, VT, ME
- **100,000+ closed sale comps** with price/SF and cap rate benchmarks
- **Institutional-grade deal scoring** — 4-lens framework used by professional investors
- **Sell probability signals** — predict which sellers are motivated to transact
- **1031 exchange matching** — find qualified replacement properties by criteria

Built by [Northeast Deal Intel](https://northeastdealintel.com).

---

## Quick Start

### Install

```bash
pip install ndi-mcp-server
```

### Get an API Key

Sign up at [northeastdealintel.com/agent-api.html](https://northeastdealintel.com/agent-api.html).  
Agent Starter tier ($49/mo) unlocks all 8 tools.

### Configure Claude Desktop

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

```json
{
  "mcpServers": {
    "northeast-deal-intel": {
      "command": "ndi-mcp-server",
      "env": {
        "NDI_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### Configure Cursor / Windsurf

Add to `.cursor/mcp.json` or `.windsurf/mcp.json`:

```json
{
  "mcpServers": {
    "northeast-deal-intel": {
      "command": "ndi-mcp-server",
      "env": {
        "NDI_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

---

## Available Tools

| Tool | Description | Tier Required |
|------|-------------|---------------|
| `search_deals` | Search active listings by state, type, score, price, cap rate | Free |
| `get_deal` | Full deal detail with AI scoring breakdown + sell signal | Free |
| `get_market_benchmarks` | Cap rate & price/SF benchmarks from closed comps | Free |
| `get_market_summary` | Active listings, score distribution, top submarkets | Free |
| `find_1031_candidates` | Find 1031-qualified replacement properties | Free |
| `search_comps` | Search 100K+ closed transactions | Agent Starter ($49/mo) |
| `get_sell_signal` | Sell probability for any listed property | Agent Starter ($49/mo) |
| `score_deal` | Submit any deal for AI scoring (not in our DB) | Agent Pro ($149/mo) |

---

## Example Prompts

Once connected, try asking Claude or Cursor:

- *"Find industrial deals in Connecticut scoring above 7.5 with cap rates over 7%"*
- *"Pull comps for multifamily sales in Hartford County in the last 12 months"*
- *"I have $2.5M in a 1031 exchange — find qualified replacement properties in the Northeast"*
- *"Score this deal: 5,000 SF retail in Stamford CT asking $1.2M at 6.8% cap"*
- *"Which CT industrial listings show the highest sell probability right now?"*

---

## API Tiers

| Tier | Price | Tools |
|------|-------|-------|
| Free | $0 | search_deals, get_deal, benchmarks, summary, 1031 matching |
| Agent Starter | $49/mo | + search_comps, get_sell_signal, owner lookup |
| Agent Pro | $149/mo | + score_deal (score any property), full comp access |

[Get your API key →](https://northeastdealintel.com/agent-api.html)

---

## License

MIT — see [LICENSE](LICENSE)

## Links

- [Documentation](https://northeastdealintel.com/agent-api.html)
- [GitHub](https://github.com/CREIntel/ndi-mcp-server)
- [Get API Key](https://northeastdealintel.com/agent-api.html)
