Āina Atlas MCP

An MCP server that exposes my live Āina Atlas Hawaii property pipeline as Claude tools. Ask Claude about any Hawaii address or TMK and it can pull the real parcel record — zoning, lava/tsunami/FEMA flood hazards, ahupuaʻa context, ADU eligibility, AVM, tax-appeal window — and draft an AI property brief.

It wraps the real, publicly-callable /atlas/* endpoints on my "aina-atlas" data API (no key required for lookups), and composes the brief locally via the Anthropic API. Every field returned is whatever the live API returns — nothing is fabricated.

Honest scope line: this wraps my live Āina Atlas property pipeline. The lookup tools hit the production data API directly. The brief is drafted by Claude from that real parcel data, reusing the same Hawaii-property-analyst prompt as my web product.

Tools

Tool	Input	What it does	Backing
resolve_address	address or tmk	Resolve a Hawaii address (or TMK) to a Tax Map Key	GET /atlas/geocode + GET /atlas/parcels/bbox + GET /atlas/search (public)
lookup_parcel	address or tmk	Full structured parcel record	GET /atlas/search + GET /atlas/parcel/{tmk} (public, no key)
generate_property_brief	address or tmk	Parcel lookup → Claude-drafted brief (summary, snapshot, watch-outs, actions, deep links)	lookup_parcel data → Anthropic Messages API
compare_parcels	a, b (each an address or TMK)	Two parcels side by side + a key-field diff	Two lookup_parcel calls

lookup_parcel, resolve_address, and compare_parcels work with no API key. generate_property_brief needs ANTHROPIC_API_KEY.

What the parcel record includes

The lookup_parcel response is the live free-tier Āina Atlas JSON, including: tmk, island, address, acres, owner, land_value, building_value, has_homeowner_exemption, zoning (code, land_use), hazards (lava, tsunami_evac, fema_flood), hawaiian_context (ahupuaa, moku, mokupuni, gis_acres), slope (elevation, slope %, classification, aspect, solar exposure), native_plants, tax_appeal (county appeal window + deadline), nearby_places, county_links, centroid, geometry (rings), adu (eligibility, max unit size, notes), ocean_view, shoreline, soil, rainfall, conservation, wildfire, property_tax, zoning_rules, avm, and deed_link.

Install

cd aina-atlas-mcp
npm install
npm run build        # compiles src/ -> build/index.js
cp .env.example .env # then fill in ANTHROPIC_API_KEY for the brief tool

Quick smoke test from the shell (lists the tools over stdio — no key needed):

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"cli","version":"0"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | node build/index.js

Add to Claude Desktop

Edit claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "aina-atlas": {
      "command": "node",
      "args": ["/Users/johnthomasair/code/aina-atlas-mcp/build/index.js"],
      "env": {
        "AINA_BASE_URL": "https://addressapi.portofcams.com",
        "ANTHROPIC_API_KEY": "sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Use an absolute path to build/index.js. Restart Claude Desktop; the aina-atlas tools appear in the tools menu. Leave ANTHROPIC_API_KEY out if you only want the lookup tools (the brief tool will return a clear "needs ANTHROPIC_API_KEY" error).

Demo prompts

• "What are the flood and lava-zone risks at 500 Ala Moana Blvd, Honolulu?" — calls lookup_parcel, reads hazards.fema_flood / hazards.lava.
• "Give me an Āina Atlas property brief for TMK 121010042." — calls generate_property_brief.
• "Compare TMK 121010042 and 121010015 — zoning, value, and ADU eligibility." — calls compare_parcels.
• "What ahupuaʻa is this parcel in, and is it ADU-eligible?" — lookup_parcel, reads hawaiian_context.ahupuaa and adu.

Configuration

Env var	Required	Default	Purpose
AINA_BASE_URL	no	https://addressapi.portofcams.com	Āina Atlas data API base
ANTHROPIC_API_KEY	for brief only	—	Drafts the property brief
AINA_BRIEF_MODEL	no	claude-opus-4-8	Model for the brief
AINA_API_KEY	no	—	Optional paid-tier bearer (unlocks paid surfaces; not needed for the lookup tools)

Architecture notes / TODO

• Why the brief is composed here instead of wrapping the server's brief endpoint: the data API exposes the public brief route POST /api/bluewave/property-brief, but it is broken in production — its internal parcel lookup calls /api/parcel and /api/search, while the live data API only serves /atlas/parcel and /atlas/search, so every request returns "parcel not found" (verified live). This server therefore wraps the working /atlas/parcel data and drafts the brief itself, reusing that endpoint's real system prompt. TODO (server-side, not this repo): a one-line path fix in routers/bluewave_property_brief.py (/api/parcel→/atlas/parcel, /api/search→/atlas/search) would restore the upstream endpoint; this MCP could then optionally call it directly.
• Paid report PDF (GET /atlas/report/{tmk}) and the insurance-brief preview (/api/insurebrief/*) are intentionally not exposed as tools: the report is a binary PDF behind a paywall (402), and the insurebrief proxy currently 404s against the live data-API build (its /atlas/insurebrief/* routes aren't deployed yet — verified). Both are TODOs pending real, callable backing.

License

MIT