iHuus Neighborhood Intelligence

License: MIT MCP Compatible API AI Pro plan

Ready-to-use Model Context Protocol (MCP) extensions for building AI-powered neighborhood analysis agents. Connect Gemini CLI or Claude Desktop to remote MCP servers that provide walkability scores, school ratings, flood risk, air quality, demographics, and more for any address (CA/TX for now) — no backend code required.

Documentation · Plans & Pricing

Sample neighborhood report generated by Claude Desktop using iHuus tools

---

Prerequisites

Requirement	Details
iHuus API key	API AI Pro plan required — get one at ihuus.com/pricing
Gemini CLI	For extensions under gemini/ — install guide
Claude Desktop	For the bundle under claude/ — download

---

Quick Start

Claude Desktop — no clone needed:

1. Download ihuus-neighborhood-intelligence.mcpb and open it.
2. Paste your iHuus API key when prompted.

Gemini CLI — clone and link:

git clone https://github.com/ihuus/mcp.git
cd mcp

export IHUUS_API_KEY=your_key_here      # https://ihuus.com/pricing
export GEMINI_API_KEY=your_key_here     # https://aistudio.google.com/apikey

gemini extensions link gemini/full
gemini

---

Extension Coverage

Domain	Tools	Coverage
Demographics	Insurance coverage · Ideological lean · Age profile	CA and TX
Environment	Noise levels · Industrial proximity · Air quality	CA and TX
Risk	Flood safety · Fire risk	Flood: CA and TX · Fire: CA only
Schools	School search · District lookup · School detail	CA and TX
Vibe	Walkability · Privacy · Visual appeal · Dog friendliness · Urban–rural	CA and TX
Geospatial	Address geocoding (used automatically by all tools)	CA and TX

• Gemini CLI — per-domain extensions or a full all-in-one extension
• Claude Desktop — single MCPB bundle with all domains included

Data availability: All tools currently cover California and Texas. Fire risk covers California only (CALFIRE).

---

Repository Structure

.
├── .env.example           # Auth template — copy to .env and fill in your keys
├── gemini/                # Gemini CLI extensions
│   ├── demographics/
│   ├── environment/
│   ├── full/              # All domains in one extension
│   ├── risk/
│   ├── schools/
│   └── vibe/
└── claude/                # Claude Desktop MCP bundle
    └── desktop/           # One-click .mcpb installer
        ├── manifest.json
        ├── server/        # Node.js stdio proxy
        └── ihuus-neighborhood-intelligence.mcpb

---

Gemini CLI — Getting Started

See gemini/README.md for detailed setup instructions.

# Link the full extension (all domains)
gemini extensions link gemini/full

# Start a session — tools are loaded automatically
gemini

---

Claude Desktop — Getting Started

See claude/README.md for detailed setup instructions.

1. Download ihuus-neighborhood-intelligence.mcpb and open it — Claude Desktop shows an install dialog.
2. Paste your iHuus API key when prompted.
3. Verify the extension is enabled under Settings → extensions list.

---

Authentication

All extensions authenticate via your iHuus API key (Bearer $IHUUS_API_KEY).

• Gemini CLI — set IHUUS_API_KEY as an environment variable in your shell.
• Claude Desktop — paste your key during MCPB bundle install. It's stored securely on your machine.

Get your API key →

---

More Resources

• Full API Documentation
• Plans & Pricing
• iHuus Website
• Model Context Protocol Specification

---

Feedback

This repository does not accept external pull requests at this time. For feedback, bug reports, or feature requests, please email [email protected].