> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ihuus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# iHuus Neighborhood Intelligence

> High-performance data context layer for the AI era.

<Note>
  **Early Access:** iHuus currently covers **California**, **Texas**, and **Florida**. We
  are actively expanding to more states: check back regularly for coverage updates.
</Note>

Building a chat interface is easy, but grounding it in physical reality is hard.
Neighborhood data is scattered across petabytes of satellite imagery, noise rasters, and
disjointed civic records. Feeding raw, unstructured civic data into LLMs inevitably leads
to hallucinations and trust issues, especially when navigating strict Fair Housing Act
(FHA) laws.

**iHuus bridges the gap between raw physical-world data and agent-ready intelligence.** We
process, normalize, and synthesize complex geospatial data into a proprietary architecture
built specifically for the AI era, so your engineering team can focus on building user
experiences instead of GIS pipelines.

<Tip>
  **See it live:** Explore our Neighborhood Intelligence Index on the interactive map at
  [map.ihuus.com](https://map.ihuus.com/) without writing a single line of code.
</Tip>

***

## Two Ways to Integrate

<CardGroup cols={2}>
  <Card title="REST API" icon="bolt" href="/api-reference/schools-&-ratings/schools-and-ratings">
    Query our high-performance spatial index directly. Get credible, FHA-compliant,
    hyperlocal data in milliseconds: school ratings, noise levels, flood risk, and more.
  </Card>

  <Card title="MCP Servers" icon="robot" href="/guides/mcp">
    Plug Neighborhood Intelligence directly into AI agents via the Model Context Protocol.
    Structured for agentic reasoning, not hallucinations. Pre-built extensions for Claude
    Desktop and Gemini CLI available on [GitHub](https://github.com/ihuus/mcp).
  </Card>
</CardGroup>

***

## Intelligence Dimensions

Every score is returned on a **0–255 scale** with a human-readable semantic description,
ready for both programmatic use and LLM consumption.

### Schools & Ratings

Search for K-12 schools and districts by geographic coordinates. Results include distance,
level, ratings, and district metadata sourced from federal NCES datasets. Use the
[Geocode endpoint](/api-reference/tools/geocode-a-single-address) to convert addresses to
coordinates first.

<CardGroup cols={2}>
  <Card title="Schools and Ratings" icon="school" href="/api-reference/schools-&-ratings/schools-and-ratings">
    Find the closest schools to any lat/lon, with ratings, distance, and district info.
  </Card>

  <Card title="School Districts" icon="map" href="/api-reference/schools-&-ratings/school-districts">
    Look up all overlapping school districts (Unified, Elementary, Secondary) at a
    location, including district-level ratings, rating summaries, and vintage year.
  </Card>
</CardGroup>

<Tip>
  All coordinate-based endpoints work seamlessly with AI agents. Our [Geocode
  tool](/api-reference/tools/geocode-a-single-address) lets LLMs convert addresses to
  coordinates automatically, so no extra integration work is needed.
</Tip>

### Vibe

Captures the qualitative feel of a neighborhood: how private, walkable, visually
appealing, dog-friendly, or urban/rural it is.

<CardGroup cols={3}>
  <Card title="Privacy" icon="eye-slash" href="/api-reference/vibe/privacy-index-score">
    Seclusion based on density, lot sizes, tree cover, and visibility.
  </Card>

  <Card title="Walkability" icon="person-walking" href="/api-reference/vibe/walkability-score">
    Sidewalks, intersection density, and proximity to amenities.
  </Card>

  <Card title="Visual Appeal" icon="paintbrush" href="/api-reference/vibe/visual-appeal-score">
    Architectural character, landscaping, and streetscape quality.
  </Card>

  <Card title="Dog Friendliness" icon="dog" href="/api-reference/vibe/dog-friendliness-score">
    Parks, trails, off-leash areas, and pet-friendly businesses.
  </Card>

  <Card title="Urban-Rural" icon="city" href="/api-reference/vibe/urban-rural-index-score">
    Dense urban core to open countryside, classified from overhead imagery.
  </Card>

  <Card title="Liveliness" icon="party-horn" href="/api-reference/vibe/liveliness-score">
    Activity level and density of social destinations, from quiet enclaves to urban
    hotspots.
  </Card>
</CardGroup>

### Environment

Quantifies the physical environment: acoustic comfort, air quality, and proximity to
industrial or hazardous sites.

<CardGroup cols={3}>
  <Card title="Noise Levels" icon="volume-high" href="/api-reference/environment/noise-levels-score">
    Federal noise modelling for road, railroad, and aviation sources.
  </Card>

  <Card title="Air Quality" icon="wind" href="/api-reference/environment/air-quality-score">
    AQI consistency derived from OpenAQ monitoring stations.
  </Card>

  <Card title="Industrial Proximity" icon="industry" href="/api-reference/environment/industrial-proximity-score">
    EPA hazard data, Superfund sites, and industrial POI density.
  </Card>
</CardGroup>

### Demographics

Population-level indicators derived from US Census Bureau data and voting records.

<CardGroup cols={3}>
  <Card title="Insurance Coverage" icon="shield-heart" href="/api-reference/demographics/health-insurance-coverage">
    Share of residents with health insurance coverage.
  </Card>

  <Card title="Ideological Lean" icon="scale-balanced" href="/api-reference/demographics/ideological-lean-score">
    Conservative-to-liberal spectrum from Census and voting data.
  </Card>

  <Card title="Population Profile" icon="users" href="/api-reference/demographics/population-age-profile">
    Age distribution from young-adult-skewing to senior-skewing.
  </Card>
</CardGroup>

### Risk

Natural hazard exposure derived from FEMA and CALFIRE authoritative datasets. Lower scores
indicate higher risk.

<CardGroup cols={2}>
  <Card title="Flood Risk" icon="house-flood-water" href="/api-reference/risk/flood-risk-score">
    FEMA flood zone designations from coastal high-hazard to minimal risk.
  </Card>

  <Card title="Fire Risk" icon="fire" href="/api-reference/risk/fire-risk-score">
    CALFIRE severity zones (California). Severe to no-risk classification.
  </Card>
</CardGroup>

### Tools

Utility endpoints to support agentic workflows and data processing.

<CardGroup cols={2}>
  <Card title="Geocode Address" icon="location-dot" href="/api-reference/tools/geocode-a-single-address">
    Convert a free-text address into lat/lon coordinates. Built for single-shot agentic
    use.
  </Card>
</CardGroup>

***

## Why Build with iHuus?

<CardGroup cols={3}>
  <Card title="Ship in Days, Not Months" icon="rocket">
    Skip the GIS pipeline. Structured, plug-and-play neighborhood data so you can focus on
    your product.
  </Card>

  <Card title="Zero Hallucinations" icon="check-double">
    Every response includes raw scores and human-readable descriptions, so your LLMs pass
    accurate context, not guesses.
  </Card>

  <Card title="FHA-Safe by Design" icon="scale-balanced">
    Pre-processed indices deliver actionable insights without crossing into protected
    demographic territory.
  </Card>
</CardGroup>

***

## Authentication

All endpoints require a Bearer token issued on your
[account dashboard](https://map.ihuus.com/account):

| Method           | Header                          | Description                                                                      |
| ---------------- | ------------------------------- | -------------------------------------------------------------------------------- |
| **Bearer Token** | `Authorization: Bearer <token>` | Your API token issued on your [account dashboard](https://map.ihuus.com/account) |

***

## Quick Start

Make your first API call in seconds. This example finds the closest schools to a location
in San Jose, CA:

```bash theme={null}
curl -G "https://api.ihuus.com/v1/schools/search/school-ratings" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d lat=37.3382 \
  -d lon=-121.8863 \
  -d limit=3
```

***

## Get Started

<CardGroup cols={2}>
  <Card title="MCP Quickstart" icon="robot" href="/guides/mcp">
    Connect iHuus to your AI agents via the Model Context Protocol.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/schools-&-ratings/schools-and-ratings">
    Explore all REST endpoints, parameters, and response schemas.
  </Card>
</CardGroup>

***

## Need Help?

<Card title="Contact Support" icon="envelope" href="mailto:support@ihuus.com">
  Questions about your API token, billing, or integration? Email us at
  **[support@ihuus.com](mailto:support@ihuus.com)** and we'll get back to you shortly.
</Card>