geotap-mcp-server 3.0.0 → 3.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GeoTap
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geotap-mcp-server",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "MCP server for GeoTap — collect comprehensive environmental data from 80+ US federal sources for any site. One tool, all the data.",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

@@ -27,18 +27,43 @@ DATA INCLUDES:
 - Contamination: Superfund, brownfields, USTs, EPA-regulated facilities (RCRA, GHG, FRS)
 - Water: streams, watershed, water quality impairments (ATTAINS), NPDES outfalls, groundwater
 - Hazards: seismic design (ASCE 7-22), earthquakes, wildfires, landslides, coastal vulnerability, NRI
-- Rainfall: NOAA Atlas 14 precipitation frequency data
+- Rainfall: NOAA Atlas 14 precipitation frequency data (IDF curves, design storms)
+- Land cover: NLCD 2021 classification (developed, forest, wetlands, etc.)
+- Elevation: USGS 3DEP (min/max/mean elevation, relief)
 - Infrastructure: hospitals, fire stations, schools, EMS, dams, levees, power plants, airports, railroads, bridges
 - Ecology: species (GBIF), fish habitat, critical habitat, cropland, national forests, BLM lands, historic places
 - Energy: solar potential, utility rates, EV charging stations
-- Demographics: Census ACS (population, income, housing, poverty)
+- Demographics: Census ACS (population, income, housing, poverty, vacancy rates)
 - Protected lands (PAD-US), wild & scenic rivers, sole source aquifers
 
+HOW TO PRESENT RESULTS:
+When you receive completed data, organize your response using these sections (skip sections with no data):
+
+1. **Site Overview** — Location, area, county, state, elevation range, land cover
+2. **Environmental Constraints** — Flood zones, wetlands, soils (drainage class, hydrologic group), impaired waters, critical habitat. Flag any development constraints.
+3. **Contamination & Regulated Sites** — Superfund, brownfields, USTs, NPDES, EPA-regulated facilities within the search radius. Include distances and directions.
+4. **Water Resources** — Streams, watershed (HUC), water quality stations, groundwater wells, Atlas 14 rainfall (cite 2yr/10yr/100yr 24-hour depths).
+5. **Natural Hazards** — Flood risk (FEMA zones), seismic design values, NRI risk index, earthquake history, landslide susceptibility, wildfire history.
+6. **Infrastructure & Services** — Nearby hospitals, fire stations, schools, EMS, dams, airports, bridges. Include counts and distances.
+7. **Demographics & Energy** — Population, median income, housing, solar potential, utility rates.
+8. **Key Findings & Considerations** — Summarize the most important findings. Highlight anything that would affect site development, permitting, or engineering design.
+
+FORMATTING RULES:
+- Use markdown tables for structured data (flood zones, soils, nearby facilities)
+- Bold key values and findings that matter most
+- Always cite the source agency for each data point (e.g., "FEMA NFHL", "NRCS SSURGO", "NOAA Atlas 14")
+- Include distances and cardinal directions for nearby features (e.g., "0.8 miles NW")
+- For Atlas 14 rainfall, present as a compact table: return period × duration
+- For soils, include drainage class and hydrologic soil group — these drive stormwater design
+- Note when a data source was queried but returned no data ("_noData: true") — this is informative (e.g., no Superfund sites nearby is good news)
+- End with a disclaimer: "Data sourced from US federal agencies via GeoTap. Verify critical findings against authoritative sources before making engineering or regulatory decisions."
+
 IMPORTANT:
-- All data from authoritative US federal sources. Always cite the source agency.
+- All data from authoritative US federal sources. Always cite the source agency, not just "GeoTap."
 - Data is for informational purposes. Remind users to verify for engineering/regulatory decisions.
 - Coordinates must be within the United States (including territories).
-- If a data source returns "_noData: true", it was queried but found nothing at that location.`
+- If a data source returns "_noData: true", it was queried but found nothing at that location — mention this where relevant (no contamination nearby is positive).
+- If a data source returns "_error", note that the source was unavailable and the user should check back.`
 });
 
 // ── Tool: collect_site_data ──────────────────────────────────────────
@@ -66,18 +91,21 @@ Data returned covers: flood zones, wetlands, soils, geology, contamination sites
       if (address && !siteGeometry) {
         // Geocode the address first
         const geocodeResult = await callApi('/geocode', 'GET', { address });
-        if (!geocodeResult?.lat || !geocodeResult?.lng) {
+        // API returns { success, results: [{ lat, lon, displayName, source }] }
+        const match = geocodeResult?.results?.[0];
+        if (!match?.lat || !match?.lon) {
           return {
             content: [{ type: 'text', text: JSON.stringify({
               error: true,
-              message: `Could not geocode address: "${address}". Try a more specific address or use lat/lng coordinates.`,
+              message: `Could not geocode address: "${address}". Try a more specific address with city/state, or use lat/lng coordinates directly.`,
+              suggestion: 'Example: { lat: 34.8779, lng: -82.3313 }',
             }, null, 2) }],
             isError: true
           };
         }
         siteGeometry = {
           type: 'Point',
-          coordinates: [geocodeResult.lng, geocodeResult.lat]
+          coordinates: [match.lon, match.lat]
         };
       } else if (lat != null && lng != null && !siteGeometry) {
         siteGeometry = {
@@ -133,7 +161,7 @@ Data returned covers: flood zones, wetlands, soils, geology, contamination sites
 
 server.tool(
   'get_results',
-  `Check the status of a data collection job and retrieve results. Poll every 10 seconds until status is "completed". When complete, returns the full data summary from all 80+ federal sources.`,
+  `Check the status of a data collection job and retrieve results. Poll every 10 seconds until status is "completed". When complete, returns the full data summary from all 80+ federal sources. Present the results to the user following the formatting instructions in the server description.`,
   {
     jobId: z.string().describe('Job ID returned from collect_site_data'),
   },
@@ -141,15 +169,41 @@ server.tool(
     try {
       const result = await callApi(`/site-analysis/data-collect/${encodeURIComponent(params.jobId)}`, 'GET', {});
 
+      const response = { ...result };
+
+      // Add presentation guidance when results are complete
+      if (result.status === 'completed') {
+        response._meta = {
+          sources: '80+ US federal agencies (FEMA, USGS, NOAA, EPA, NRCS, USFWS, USACE, DOE, DOT, CDC, Census, and more)',
+          retrievedAt: new Date().toISOString(),
+          disclaimer: 'Data sourced from US federal agencies via GeoTap. Always verify critical data against authoritative sources before making engineering or regulatory decisions.',
+        };
+        response._presentationGuide = {
+          instructions: 'Present these results to the user in a well-organized report. Follow the formatting instructions in the server description (HOW TO PRESENT RESULTS section).',
+          sections: [
+            'Site Overview (location, area, elevation, land cover)',
+            'Environmental Constraints (flood zones, wetlands, soils, impaired waters)',
+            'Contamination & Regulated Sites (Superfund, brownfields, USTs, NPDES — with distances)',
+            'Water Resources (streams, watershed, water quality, rainfall IDF data)',
+            'Natural Hazards (flood risk, seismic, NRI, earthquakes, wildfires)',
+            'Infrastructure & Services (hospitals, fire stations, schools, dams, bridges)',
+            'Demographics & Energy (Census ACS, solar potential, utility rates)',
+            'Key Findings & Considerations (summarize what matters most for this site)',
+          ],
+          tips: [
+            'Use markdown tables for structured comparisons',
+            'Bold the most critical findings (e.g., site is in a FEMA AE flood zone)',
+            'Cite source agencies, not just GeoTap',
+            'Mention when sources returned no data — "no Superfund sites" is useful info',
+            'End with the disclaimer from _meta',
+          ]
+        };
+      } else {
+        response._instructions = `Job status: ${result.status}. Poll again in 10 seconds until status is "completed".`;
+      }
+
       return {
-        content: [{ type: 'text', text: JSON.stringify({
-          ...result,
-          _meta: {
-            sources: '80+ US federal agencies (FEMA, USGS, NOAA, EPA, NRCS, USFWS, USACE, DOE, DOT, CDC, Census, and more)',
-            retrievedAt: new Date().toISOString(),
-            disclaimer: 'Data sourced from US federal agencies via GeoTap. Always verify critical data against authoritative sources before making engineering or regulatory decisions.',
-          }
-        }, null, 2) }]
+        content: [{ type: 'text', text: JSON.stringify(response, null, 2) }]
       };
     } catch (error) {
       if (error instanceof StructuredApiError) {