geotap-mcp-server 1.2.0 → 1.2.1

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/geotap-mcp-server.svg)](https://www.npmjs.com/package/geotap-mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-**One API for 28+ US federal environmental and infrastructure data sources.**
+**One API for 37 US federal environmental and infrastructure data sources.**
 
 GeoTap aggregates data from FEMA, USGS, EPA, NOAA, USDA, USFWS, DOT, Census, and more into a single REST API. This repository contains:
 
@@ -131,18 +131,54 @@ Every response includes:
 curl "https://geotapdata.com/api/v1/geocode?address=456+Oak+Ave+Houston+TX"
 ```
 
+#### Quick Start: Query an Address (Recommended)
+
+The fastest way to get environmental data — geocode + query in one call:
+
+```bash
+# One call: geocodes address + returns flood zone, soils, wetlands, contamination
+curl "https://geotapdata.com/api/v1/query-address?address=123+Main+St+Houston+TX"
+
+# With specific layers
+curl "https://geotapdata.com/api/v1/query-address?address=123+Main+St+Houston+TX&layers=flood_zones,soil_map_units"
+```
+
+Response includes plain-English `_interpretation` fields:
+```json
+{
+  "properties": {
+    "zone": "AE",
+    "_interpretation": "High-risk flood zone with base flood elevations determined. Flood insurance required."
+  }
+}
+```
+
+#### Point Query (by coordinates)
+
+```bash
+# What's at this exact point? (properties only, no geometry — always <5KB)
+curl "https://geotapdata.com/api/v1/spatial/point?lat=30.267&lng=-97.743&layers=flood_zones,wetlands"
+```
+
 #### Spatial Queries
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/spatial/near?lat={lat}&lng={lng}&radius={km}` | Query all layers near a point |
-| POST | `/spatial/in-polygon` | Query all layers within a polygon |
+| GET | `/query-address?address=...` | **Geocode + point query in one call (recommended)** |
+| GET | `/spatial/point?lat=...&lng=...` | Point-in-polygon query (properties only, with interpretations) |
+| GET | `/spatial/near?lat={lat}&lng={lng}&radius={km}` | Query layers near a point |
+| POST | `/spatial/in-polygon` | Query layers within a polygon |
 | POST | `/spatial/summary` | Feature counts per layer (fast) |
 | GET | `/spatial/bbox?bbox={w,s,e,n}` | Query layers in a bounding box |
 
+**`geometry` parameter** — available on `/near`, `/bbox`, `/in-polygon`, and `/layers/:name/features`:
+- `geometry=none` — strips all coordinates (smallest response, best for LLM consumers)
+- `geometry=simplified` — reduces coordinate density
+- `geometry=full` — complete geometry (default)
+
 ```bash
-# All environmental data within 0.5 km of a point
-curl "https://geotapdata.com/api/v1/spatial/near?lat=34.05&lng=-118.25&radius=0.5"
+# All environmental data within 0.5 km of a point (no geometry for smaller response)
+curl "https://geotapdata.com/api/v1/spatial/near?lat=34.05&lng=-118.25&radius=0.5&geometry=none"
 
 # Specific layers only
 curl "https://geotapdata.com/api/v1/spatial/near?lat=34.05&lng=-118.25&radius=0.5&layers=flood_zones,wetlands,soil_map_units"
@@ -154,7 +190,8 @@ curl -X POST "https://geotapdata.com/api/v1/spatial/in-polygon" \
     "polygon": {
       "type": "Polygon",
       "coordinates": [[[-97.75,30.26],[-97.74,30.26],[-97.74,30.27],[-97.75,30.27],[-97.75,30.26]]]
-    }
+    },
+    "geometry": "none"
   }'
 ```
 
@@ -492,21 +529,30 @@ With API key:
 - *"What permits do I need to build near this stream?"*
 - *"Export this data as a shapefile"*
 
-### Available Tools (83)
+### Available Tools (85)
+
+**Core tools (start here):**
+- **query_address** — Geocode + environmental query in one call. Returns properties with plain-English interpretations. (<5KB response)
+- **identify_features_at_point** — Same as above but for lat/lng coordinates
+- **get_rainfall_data** — NOAA Atlas 14 precipitation data
+- **get_environmental_summary** — Quick feature counts per layer
+- **geocode_address** — Convert address to coordinates
 
 <details>
-<summary>Spatial Queries (4)</summary>
+<summary>All Spatial Queries (6)</summary>
 
-- **get_environmental_data_for_area** — Query all 28+ data sources within a polygon
-- **get_environmental_data_near_point** — Query all data sources near a lat/lng point
+- **query_address** — Geocode + point query in one call (recommended starting tool)
+- **identify_features_at_point** — Point-in-polygon query (properties only, no geometry)
+- **get_environmental_data_for_area** — Query all 37 data sources within a polygon (supports geometry=none)
+- **get_environmental_data_near_point** — Query all data sources near a lat/lng point (supports geometry=none)
 - **get_environmental_summary** — Quick feature counts per layer for an area
-- **get_environmental_data_in_bbox** — Query data within a bounding box
+- **get_environmental_data_in_bbox** — Query data within a bounding box (supports geometry=none)
 </details>
 
 <details>
 <summary>Data Layers (3)</summary>
 
-- **list_data_layers** — List all 28+ available data sources
+- **list_data_layers** — List all 37 available data sources
 - **get_layer_details** — Get metadata about a specific layer
 - **get_layer_features** — Get features from a specific data layer
 </details>
@@ -687,7 +733,7 @@ With API key:
 - Water quality impairment assessment (EPA ATTAINS 303(d) list)
 
 ### AI-Powered Research
-- Natural language queries across 28+ federal databases
+- Natural language queries across 37 federal databases
 - Automated environmental screening reports
 - Cross-agency data correlation and analysis
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "geotap-mcp-server",
-  "version": "1.2.0",
-  "description": "MCP server for GeoTap — access 28+ US federal environmental and infrastructure data sources from Claude, Cursor, and other AI tools",
+  "version": "1.2.1",
+  "description": "MCP server for GeoTap — access 37 US federal environmental and infrastructure data sources from Claude, Cursor, and other AI tools",
   "type": "module",
   "main": "src/index.js",
   "bin": {

package/src/index.js

@@ -10,8 +10,8 @@ import { toolSources } from './sources.js';
 const server = new McpServer({
   name: 'geotap',
   version: '1.2.0',
-  description: 'Access 28+ US federal environmental and infrastructure data sources. Query flood zones, wetlands, soils, rainfall, watersheds, water quality, endangered species, elevation, land use, and more for any location in the United States.',
-  instructions: `You have access to GeoTap, which provides real-time data from 28+ US federal agencies (FEMA, USGS, NOAA, EPA, NRCS, USFWS, USACE, and more).
+  description: 'Access 37 US federal environmental and infrastructure data sources. Query flood zones, wetlands, soils, rainfall, watersheds, water quality, endangered species, elevation, land use, and more for any location in the United States.',
+  instructions: `You have access to GeoTap, which provides real-time data from 37 US federal agencies (FEMA, USGS, NOAA, EPA, NRCS, USFWS, USACE, and more).
 
 START HERE — CORE TOOLS (use these for 90% of queries):
 1. query_address — Geocode + environmental lookup in ONE call. Always start here when user gives an address.

package/src/sources.js

@@ -71,8 +71,8 @@ export const toolSources = {
   get_environmental_data_in_bbox: MULTI_SOURCE,
 
   // ── Data Layers ──
-  list_data_layers: [{ agency: 'GeoTap', dataset: 'Layer Catalog (28+ federal sources)', url: 'https://geotap.us' }],
-  get_layer_details: [{ agency: 'GeoTap', dataset: 'Layer Catalog', url: 'https://geotap.us' }],
+  list_data_layers: [{ agency: 'GeoTap', dataset: 'Layer Catalog (37 federal sources)', url: 'https://geotapdata.com' }],
+  get_layer_details: [{ agency: 'GeoTap', dataset: 'Layer Catalog', url: 'https://geotapdata.com' }],
   get_layer_features: MULTI_SOURCE,
 
   // ── Rainfall & Precipitation ──
@@ -141,7 +141,7 @@ export const toolSources = {
   // ── Monitoring Stations ──
   find_monitoring_stations: [...src(AGENCIES.USGS, 'nwis'), { agency: 'NOAA', dataset: 'Tide Stations, Weather Stations', url: 'https://tidesandcurrents.noaa.gov/' }],
   search_stations: [...src(AGENCIES.USGS, 'nwis'), { agency: 'NOAA', dataset: 'Tide Stations, Weather Stations', url: 'https://tidesandcurrents.noaa.gov/' }],
-  get_station_types: [{ agency: 'GeoTap', dataset: 'Station Type Configuration', url: 'https://geotap.us' }],
+  get_station_types: [{ agency: 'GeoTap', dataset: 'Station Type Configuration', url: 'https://geotapdata.com' }],
 
   // ── Gage Intelligence: Gauged ──
   get_flood_frequency_analysis: [...src(AGENCIES.USGS, 'nwis'), { agency: 'USGS', dataset: 'Bulletin 17C Guidelines', url: 'https://pubs.usgs.gov/tm/04/b05/tm4b5.pdf' }],
@@ -171,22 +171,22 @@ export const toolSources = {
   get_site_analysis_status: MULTI_SOURCE,
   generate_constraints_report: MULTI_SOURCE,
   get_constraints_report_status: MULTI_SOURCE,
-  get_constraints_config: [{ agency: 'GeoTap', dataset: 'Constraints Configuration', url: 'https://geotap.us' }],
+  get_constraints_config: [{ agency: 'GeoTap', dataset: 'Constraints Configuration', url: 'https://geotapdata.com' }],
   generate_developability_report: MULTI_SOURCE,
-  get_developability_config: [{ agency: 'GeoTap', dataset: 'Developability Configuration', url: 'https://geotap.us' }],
+  get_developability_config: [{ agency: 'GeoTap', dataset: 'Developability Configuration', url: 'https://geotapdata.com' }],
 
   // ── Export ──
-  get_export_options: [{ agency: 'GeoTap', dataset: 'Export Configuration', url: 'https://geotap.us' }],
+  get_export_options: [{ agency: 'GeoTap', dataset: 'Export Configuration', url: 'https://geotapdata.com' }],
   export_data: MULTI_SOURCE,
-  get_export_status: [{ agency: 'GeoTap', dataset: 'Export Job Status', url: 'https://geotap.us' }],
+  get_export_status: [{ agency: 'GeoTap', dataset: 'Export Job Status', url: 'https://geotapdata.com' }],
 
   // ── Utilities ──
   geocode_address: [
     { agency: 'Census Bureau', dataset: 'Census Geocoder', url: 'https://geocoding.geo.census.gov/' },
     { agency: 'OpenStreetMap', dataset: 'Photon / Nominatim Geocoder', url: 'https://photon.komoot.io/' },
   ],
-  check_api_status: [{ agency: 'GeoTap', dataset: 'API Health Check', url: 'https://geotap.us' }],
-  check_specific_api_status: [{ agency: 'GeoTap', dataset: 'API Health Check', url: 'https://geotap.us' }],
+  check_api_status: [{ agency: 'GeoTap', dataset: 'API Health Check', url: 'https://geotapdata.com' }],
+  check_specific_api_status: [{ agency: 'GeoTap', dataset: 'API Health Check', url: 'https://geotapdata.com' }],
   get_firm_panels: src(AGENCIES.FEMA, 'nfhl'),
   get_huc_watersheds: src(AGENCIES.USGS, 'wbd'),
   get_huc_watershed_by_code: src(AGENCIES.USGS, 'wbd'),

package/src/tools.js

@@ -40,7 +40,7 @@ export const tools = [
   },
   {
     name: 'get_environmental_data_for_area',
-    description: `Query all available US federal environmental and infrastructure data within a geographic area (polygon). Returns features from 28+ data sources. WARNING: responses can be very large (100KB-2MB+) in urban areas with full geometry. ALWAYS set geometry="none" unless the user specifically needs coordinates. Specify layers to reduce response size. For simple "what's at this location?" questions, use query_address or identify_features_at_point instead — they're faster and return <5KB.`,
+    description: `Query all available US federal environmental and infrastructure data within a geographic area (polygon). Returns features from 37 data sources. WARNING: responses can be very large (100KB-2MB+) in urban areas with full geometry. ALWAYS set geometry="none" unless the user specifically needs coordinates. Specify layers to reduce response size. For simple "what's at this location?" questions, use query_address or identify_features_at_point instead — they're faster and return <5KB.`,
     parameters: {
       polygon: z.object({
         type: z.literal('Polygon'),
@@ -95,7 +95,7 @@ export const tools = [
   // ═══════════════════════════════════════════════════════════════════
   {
     name: 'list_data_layers',
-    description: `List all available environmental and infrastructure data layers in GeoTap. Returns the full catalog of 28+ data sources with their names, descriptions, and data providers. Use this tool when someone asks "what data do you have?" or "what sources are available?" or wants to know what types of environmental data can be queried. Includes layers from FEMA, USGS, EPA, NOAA, USDA, USFWS, DOT, Census, and more.`,
+    description: `List all available environmental and infrastructure data layers in GeoTap. Returns the full catalog of 37 data sources with their names, descriptions, and data providers. Use this tool when someone asks "what data do you have?" or "what sources are available?" or wants to know what types of environmental data can be queried. Includes layers from FEMA, USGS, EPA, NOAA, USDA, USFWS, DOT, Census, and more.`,
     parameters: {},
     endpoint: '/layers',
     method: 'GET'