Get a composite multi-hazard risk score (0-100) for any location on Earth. Combines 8 independent geophysical hazard models: earthquake, volcano, tsunami, seismic site amplification, sinkhole, weather, flood, and landslide. Returns risk level (LOW/MODERATE/HIGH/CRITICAL), dominant hazard, and component breakdown. Use for insurance underwriting, real estate due diligence, supply chain risk, site selection, or any location-based risk assessment.
Get ML-predicted earthquake risk for a location. Returns risk score (0-100), probability of M4+ event within 30 days, historical seismicity, and nearest fault distance. Uses 51 features including seismic velocity change (dv/v) from ambient noise interferometry.
Get volcano eruption risk for a location. Returns alert level (NORMAL/ADVISORY/WATCH/WARNING), risk score, nearest volcano name and distance. Uses StackingClassifier with 100% test accuracy.
Get tsunami exposure risk for a coastal location. Returns risk score (0-100), nearest tsunami source zone, estimated travel time, historical events, and evacuation recommendation. Uses StackingClassifier with 24 features.
Get sinkhole risk for a location using the Ghost Network system. Combines 7 physics precursors (groundwater, InSAR, gravity, LiDAR, EM anomaly, rail vibration, WiFi tilt) with 5 weather triggers. 93.8% accuracy on real Florida sinkhole events. Critical for Florida property insurance and real estate transactions.
Get landslide susceptibility for a location using LiDAR-derived slope analysis, soil moisture, precipitation history, and geological factors. Returns susceptibility score (0-100), slope class, and contributing factors.
Get wildfire risk for a location. Combines vegetation density, drought index, wind conditions, historical fire perimeters, and WUI (wildland-urban interface) proximity. Returns risk score, fire weather index, and defensible space rating.
Get comprehensive weather and severe weather risk for a location. Includes current conditions, severe weather alerts (NWS), tornado/hail reports (SWDI), flood forecasts (GloFAS), and soil moisture. Covers the full weather threat picture from 5 free sources.
Get flood risk and river stage forecasts for a location. Combines NOAA NWPS river gauge data, GloFAS global flood forecasts, and FEMA flood zone data. Returns flood stage, exceedance probability, and risk level.
Get historical weather data for a location from ERA5 reanalysis (1940-present). Returns temperature, precipitation, wind, soil moisture trends over decades. Use for climate trend analysis, baseline comparisons, and actuarial modeling.
Get insurance-specific property risk scoring with NAIC peril codes, vulnerability curves, and premium adjustment factors. Built for P&C insurance underwriting workflows. Returns per-peril scores for earthquake, flood, wildfire, sinkhole, wind, and multi-peril.
Score up to 100 properties in a single request. Returns per-property GeoRisk scores, dominant hazards, and portfolio-level aggregates (PML, concentration risk, diversification benefit). Use for portfolio underwriting, acquisition due diligence, or reinsurance placement.
Get catastrophe bond pricing analytics. Calculates expected loss, attachment/exhaustion probability, and risk-adjusted spread for a parametric cat bond covering a geographic region. Supports earthquake, hurricane, flood, and multi-peril structures.
{"lat": {"type": "number", "description": "Center latitude of coverage area", "required": true}, "lon": {"type": "number", "description": "Center longitude of coverage area", "required": true}, "peril
/api/v1/insurance/cat-bond-pricing
POST
$1.50/query
muni_bond_risk
Assess natural hazard risk for municipal bond underwriting. Returns hazard exposure score, infrastructure vulnerability, fiscal resilience rating, and risk-adjusted spread recommendation for a municipality.
{"lat": {"type": "number", "description": "Latitude of municipality", "required": true}, "lon": {"type": "number", "description": "Longitude of municipality", "required": true}}
/api/v1/muni-bond/score
POST
$0.75/query
natural_hazard_disclosure
Generate a natural hazard disclosure report for real estate transactions. Covers earthquake fault zones, flood zones, fire hazard severity zones, landslide areas, and environmental hazards. Required in many US states for property sales.
Assess long-term climate migration risk for a location. Combines current hazard exposure with climate trajectory projections under IPCC SSP scenarios. Returns a 0-100 migration pressure score, top climate drivers, and projected risk change over 10/20/30 years. Use for mortgage risk, real estate investment, and relocation planning.
Rank the best relocation destinations based on climate resilience. Returns top 10 US cities with lowest multi-hazard exposure, strongest economic indicators, and best climate trajectory. Use for corporate relocation, real estate development, or personal planning.
Climate-adjusted mortgage risk assessment. Evaluates how climate change will affect property value and default probability over a 15-30 year mortgage term. Returns climate risk premium, stranded asset probability, and insurance availability forecast.
Verify if a parametric insurance trigger condition has been met. Checks real-time data from 28+ authoritative sources (USGS, NOAA, NASA) against user-defined thresholds. Supports earthquake magnitude, wind speed, rainfall accumulation, flood stage, and volcanic alert triggers. Returns triggered (yes/no) with evidence from source data. Compatible with Chainlink oracle for on-chain settlement.
Generate a comprehensive location risk report aggregating all platform data: GeoRisk score, natural hazards, weather risk, flood zones, environmental factors, soil/geology, and historical events. Use for real estate due diligence, site selection, or insurance.
Get NEHRP seismic site classification (A-F) for a location based on Vs30 (shear-wave velocity). Returns site class, amplification factor, liquefaction probability, and design spectrum parameters. Essential for structural engineering and building code compliance.
Get the current status of the Planetary Early Warning System (PEWS). Returns active alerts, recent validated events, data feed health, and global risk summary across all 14 monitoring feeds.
{}
/api/v1/pews/status
GET
$0.05/query
earthquake_regions
List all supported earthquake monitoring regions with bounds, historical seismicity rates, and current alert status. Use to discover which regions are available for prediction queries.
{}
/api/v1/earthquake/regions
GET
free
data_connectors
List all 25 data connectors with their status, update frequency, and available endpoints. Shows which data sources are active and their last successful fetch time.
{}
/api/v1/data/connectors
GET
free
real_estate_ground_truth
Score any property for subsurface and surface geohazard risk. Fuses Ghost Network sinkhole risk, liquefaction, InSAR subsidence, flood, seismic amplification, landslide, climate migration pressure, and severe weather into a single A+ to F grade with insurance cost estimate. What Zillow/Redfin cannot provide.
Predict water main break risk at any location using 8 physics-based drivers: drought-to-wet soil transition (the #1 cause), soil saturation, freeze-thaw cycling, barometric pressure anomalies, groundwater trends, subsidence, pipe material and age. Returns risk score, primary driver, and 7-day forecast.
Get an instant insurance underwriting decision for any property. Fuses GeoRisk 8-component scoring, per-peril vulnerability curves, construction type and age factors, climate migration, and Ghost Network sinkhole intelligence. Returns APPROVE/APPROVE_WITH_CONDITIONS/REFER_TO_SENIOR/DECLINE with premium recommendations and PML estimates.
Get calibrated probability for geophysical event questions. Supports earthquake (M3-M7+, 11 regions), volcano (6 volcanoes), tsunami (6 zones), severe weather, and flood predictions. Uses Poisson model with ML risk modifiers and CalibratedClassifierCV. Returns Polymarket/Kalshi/Chainlink-compatible formats with SHA-256 tamper-proof prediction hashing.
Get a composite water stress score (0-100) for any location. Combines 6 data-driven components: groundwater depletion rate, streamflow anomaly, drought severity, water quality (conductance), infrastructure age, and demand pressure. Integrates Ghost Network ROMP wells for aquifer-level corroboration. Use for municipal water planning, agricultural risk, insurance, and drought monitoring.
Calculate the probability of 2+ simultaneous natural hazards at a location. Uses 28 empirically-calibrated pairwise correlation factors across all 8 GeoRisk components (earthquake, volcano, tsunami, etc). Returns top 5 compound scenarios, joint probabilities, and compound multiplier. Optional Monte Carlo mode with 10K simulations for tail risk.
Calculate the rate of climate zone migration in km/decade for any location. Returns temperature velocity, precipitation velocity, growing season shift, and analog city matching ('Phoenix 2050 = Riyadh today'). Based on NOAA CDO 150K+ station historical records and IPCC AR6 warming projections.
Score grid reliability from water-energy cross-correlation. Combines hydropower capacity (streamflow vs generation threshold), solar/wind generation potential, thermal cooling water adequacy, and temperature-driven demand pressure. Returns nexus score, per-component breakdown, and grid stress level. Use for energy sector risk, utility planning, and infrastructure resilience assessment.
Get ML-predicted induced seismicity risk for a mining or oil/gas injection site. Returns risk score (0-100), probability of M2+ event, injection-seismicity correlation. Covers Oklahoma, Alberta, Mexico, and 12 other known induced seismicity zones.
Get tailings dam stability score for a mining site. Combines satellite InSAR deformation, weather loading, dam characteristics, and construction method risk. Returns stability score (0-100) with GISTM-aligned recommendations.
Assess critical infrastructure exposure to natural hazards using OpenStreetMap. Returns hospitals, fire stations, schools, power substations, building inventory, road network, and vulnerability-weighted exposure score (0-100) for any location.
Search for free high-resolution (0.3-0.5m) Maxar satellite imagery available for disaster events near a location. Returns event catalog, scene counts, pre/post-event availability, and resolution. Imagery released during declared disasters (hurricanes, earthquakes, floods, wildfires).
Fetch energy commodity prices and rig counts from FRED: WTI crude oil, Henry Hub natural gas, regular gasoline, and Baker Hughes rig count. Useful for energy market context, induced seismicity correlation, and water-energy nexus analysis.
Create LangChain StructuredTool instances from these definitions. Each tool should POST to the corresponding api_endpoint with the args_schema parameters. Or use: from deepmap_ai import DeepMapToolkit
Base Url
https://www.deepmapai.com
Pip Install
pip install deepmap-ai (coming soon)
Raw JSON
{
"tools": [
{
"name": "georisk_score",
"description": "Get a composite multi-hazard risk score (0-100) for any location on Earth. Combines 8 independent geophysical hazard models: earthquake, volcano, tsunami, seismic site amplification, sinkhole, weather, flood, and landslide. Returns risk level (LOW/MODERATE/HIGH/CRITICAL), dominant hazard, and component breakdown. Use for insurance underwriting, real estate due diligence, supply chain risk, site selection, or any location-based risk assessment.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude (-90 to 90)",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude (-180 to 180)",
"required": true
},
"radius_km": {
"type": "number",
"description": "Search radius in km (default 100)",
"required": false
}
},
"api_endpoint": "/api/v1/georisk/score",
"api_method": "POST",
"pricing": "$0.50/query"
},
{
"name": "earthquake_risk",
"description": "Get ML-predicted earthquake risk for a location. Returns risk score (0-100), probability of M4+ event within 30 days, historical seismicity, and nearest fault distance. Uses 51 features including seismic velocity change (dv/v) from ambient noise interferometry.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
},
"radius_km": {
"type": "number",
"description": "Search radius in km (default 200)",
"required": false
}
},
"api_endpoint": "/api/v1/earthquake/predict",
"api_method": "POST",
"pricing": "$0.25/query"
},
{
"name": "volcano_risk",
"description": "Get volcano eruption risk for a location. Returns alert level (NORMAL/ADVISORY/WATCH/WARNING), risk score, nearest volcano name and distance. Uses StackingClassifier with 100% test accuracy.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
}
},
"api_endpoint": "/api/v1/volcano/predict",
"api_method": "POST",
"pricing": "$0.25/query"
},
{
"name": "tsunami_risk",
"description": "Get tsunami exposure risk for a coastal location. Returns risk score (0-100), nearest tsunami source zone, estimated travel time, historical events, and evacuation recommendation. Uses StackingClassifier with 24 features.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
}
},
"api_endpoint": "/api/v1/tsunami/predict",
"api_method": "POST",
"pricing": "$0.25/query"
},
{
"name": "sinkhole_risk",
"description": "Get sinkhole risk for a location using the Ghost Network system. Combines 7 physics precursors (groundwater, InSAR, gravity, LiDAR, EM anomaly, rail vibration, WiFi tilt) with 5 weather triggers. 93.8% accuracy on real Florida sinkhole events. Critical for Florida property insurance and real estate transactions.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
}
},
"api_endpoint": "/api/v1/ghost-network/weather-correlation",
"api_method": "POST",
"pricing": "$0.25/query"
},
{
"name": "landslide_risk",
"description": "Get landslide susceptibility for a location using LiDAR-derived slope analysis, soil moisture, precipitation history, and geological factors. Returns susceptibility score (0-100), slope class, and contributing factors.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
}
},
"api_endpoint": "/api/v1/lidar/predict/landslide",
"api_method": "POST",
"pricing": "$0.25/query"
},
{
"name": "wildfire_risk",
"description": "Get wildfire risk for a location. Combines vegetation density, drought index, wind conditions, historical fire perimeters, and WUI (wildland-urban interface) proximity. Returns risk score, fire weather index, and defensible space rating.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
}
},
"api_endpoint": "/api/v1/wildfire/risk",
"api_method": "POST",
"pricing": "$0.25/query"
},
{
"name": "weather_context",
"description": "Get comprehensive weather and severe weather risk for a location. Includes current conditions, severe weather alerts (NWS), tornado/hail reports (SWDI), flood forecasts (GloFAS), and soil moisture. Covers the full weather threat picture from 5 free sources.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
}
},
"api_endpoint": "/api/v1/weather/context",
"api_method": "POST",
"pricing": "$0.10/query"
},
{
"name": "flood_forecast",
"description": "Get flood risk and river stage forecasts for a location. Combines NOAA NWPS river gauge data, GloFAS global flood forecasts, and FEMA flood zone data. Returns flood stage, exceedance probability, and risk level.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
}
},
"api_endpoint": "/api/v1/weather/flood-forecast",
"api_method": "POST",
"pricing": "$0.15/query"
},
{
"name": "weather_historical",
"description": "Get historical weather data for a location from ERA5 reanalysis (1940-present). Returns temperature, precipitation, wind, soil moisture trends over decades. Use for climate trend analysis, baseline comparisons, and actuarial modeling.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
},
"start_year": {
"type": "integer",
"description": "Start year (1940-present)",
"required": false
},
"end_year": {
"type": "integer",
"description": "End year",
"required": false
}
},
"api_endpoint": "/api/v1/weather/historical",
"api_method": "POST",
"pricing": "$0.25/query"
},
{
"name": "insurance_property_score",
"description": "Get insurance-specific property risk scoring with NAIC peril codes, vulnerability curves, and premium adjustment factors. Built for P&C insurance underwriting workflows. Returns per-peril scores for earthquake, flood, wildfire, sinkhole, wind, and multi-peril.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
},
"property_type": {
"type": "string",
"description": "residential, commercial, or industrial",
"required": false
},
"insured_value": {
"type": "number",
"description": "Insured value in USD",
"required": false
}
},
"api_endpoint": "/api/v1/insurance/property-score",
"api_method": "POST",
"pricing": "$0.50/query"
},
{
"name": "insurance_portfolio_batch",
"description": "Score up to 100 properties in a single request. Returns per-property GeoRisk scores, dominant hazards, and portfolio-level aggregates (PML, concentration risk, diversification benefit). Use for portfolio underwriting, acquisition due diligence, or reinsurance placement.",
"args_schema": {
"locations": {
"type": "array",
"description": "Array of {lat, lon, property_type, insured_value} objects (max 100)",
"required": true
}
},
"api_endpoint": "/api/v1/insurance/portfolio-batch",
"api_method": "POST",
"pricing": "$2.00/batch"
},
{
"name": "cat_bond_pricing",
"description": "Get catastrophe bond pricing analytics. Calculates expected loss, attachment/exhaustion probability, and risk-adjusted spread for a parametric cat bond covering a geographic region. Supports earthquake, hurricane, flood, and multi-peril structures.",
"args_schema": {
"lat": {
"type": "number",
"description": "Center latitude of coverage area",
"required": true
},
"lon": {
"type": "number",
"description": "Center longitude of coverage area",
"required": true
},
"peril": {
"type": "string",
"description": "earthquake, hurricane, flood, or multi_peril",
"required": true
},
"coverage_radius_km": {
"type": "number",
"description": "Coverage radius in km",
"required": false
},
"attachment_point": {
"type": "number",
"description": "Attachment point in USD",
"required": false
}
},
"api_endpoint": "/api/v1/insurance/cat-bond-pricing",
"api_method": "POST",
"pricing": "$1.50/query"
},
{
"name": "muni_bond_risk",
"description": "Assess natural hazard risk for municipal bond underwriting. Returns hazard exposure score, infrastructure vulnerability, fiscal resilience rating, and risk-adjusted spread recommendation for a municipality.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude of municipality",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude of municipality",
"required": true
}
},
"api_endpoint": "/api/v1/muni-bond/score",
"api_method": "POST",
"pricing": "$0.75/query"
},
{
"name": "natural_hazard_disclosure",
"description": "Generate a natural hazard disclosure report for real estate transactions. Covers earthquake fault zones, flood zones, fire hazard severity zones, landslide areas, and environmental hazards. Required in many US states for property sales.",
"args_schema": {
"lat": {
"type": "number",
"description": "Property latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Property longitude",
"required": true
},
"state": {
"type": "string",
"description": "US state code (e.g., CA, FL)",
"required": false
}
},
"api_endpoint": "/api/v1/nhd-report/generate",
"api_method": "POST",
"pricing": "$5.00/report"
},
{
"name": "climate_migration_score",
"description": "Assess long-term climate migration risk for a location. Combines current hazard exposure with climate trajectory projections under IPCC SSP scenarios. Returns a 0-100 migration pressure score, top climate drivers, and projected risk change over 10/20/30 years. Use for mortgage risk, real estate investment, and relocation planning.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
},
"horizon_years": {
"type": "integer",
"description": "Projection horizon: 10, 20, or 30 years",
"required": false
}
},
"api_endpoint": "/api/v1/climate-migration/score",
"api_method": "POST",
"pricing": "$0.50/query"
},
{
"name": "climate_migration_destinations",
"description": "Rank the best relocation destinations based on climate resilience. Returns top 10 US cities with lowest multi-hazard exposure, strongest economic indicators, and best climate trajectory. Use for corporate relocation, real estate development, or personal planning.",
"args_schema": {
"lat": {
"type": "number",
"description": "Current location latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Current location longitude",
"required": true
},
"budget_tier": {
"type": "string",
"description": "low, medium, or high cost of living",
"required": false
}
},
"api_endpoint": "/api/v1/climate-migration/destinations",
"api_method": "POST",
"pricing": "$0.75/query"
},
{
"name": "mortgage_climate_risk",
"description": "Climate-adjusted mortgage risk assessment. Evaluates how climate change will affect property value and default probability over a 15-30 year mortgage term. Returns climate risk premium, stranded asset probability, and insurance availability forecast.",
"args_schema": {
"lat": {
"type": "number",
"description": "Property latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Property longitude",
"required": true
},
"loan_term_years": {
"type": "integer",
"description": "Mortgage term (15 or 30)",
"required": false
},
"property_value": {
"type": "number",
"description": "Property value in USD",
"required": false
}
},
"api_endpoint": "/api/v1/climate-migration/mortgage-risk",
"api_method": "POST",
"pricing": "$0.50/query"
},
{
"name": "parametric_trigger_check",
"description": "Verify if a parametric insurance trigger condition has been met. Checks real-time data from 28+ authoritative sources (USGS, NOAA, NASA) against user-defined thresholds. Supports earthquake magnitude, wind speed, rainfall accumulation, flood stage, and volcanic alert triggers. Returns triggered (yes/no) with evidence from source data. Compatible with Chainlink oracle for on-chain settlement.",
"args_schema": {
"trigger_type": {
"type": "string",
"description": "earthquake, flood, wind, or volcano",
"required": true
},
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
},
"threshold": {
"type": "number",
"description": "Trigger threshold (e.g., magnitude 5.0)",
"required": true
},
"hours": {
"type": "integer",
"description": "Lookback window in hours (default 24)",
"required": false
}
},
"api_endpoint": "/api/v1/chainlink/oracle",
"api_method": "POST",
"pricing": "$0.50/query"
},
{
"name": "location_report",
"description": "Generate a comprehensive location risk report aggregating all platform data: GeoRisk score, natural hazards, weather risk, flood zones, environmental factors, soil/geology, and historical events. Use for real estate due diligence, site selection, or insurance.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
},
"tier": {
"type": "string",
"description": "Report tier: quick ($5), standard ($25), premium ($50)",
"required": false
}
},
"api_endpoint": "/api/v1/location-report",
"api_method": "POST",
"pricing": "$5-$50/query"
},
{
"name": "seismic_site_class",
"description": "Get NEHRP seismic site classification (A-F) for a location based on Vs30 (shear-wave velocity). Returns site class, amplification factor, liquefaction probability, and design spectrum parameters. Essential for structural engineering and building code compliance.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
}
},
"api_endpoint": "/api/v1/predict/seismic-risk",
"api_method": "POST",
"pricing": "$0.25/query"
},
{
"name": "pews_status",
"description": "Get the current status of the Planetary Early Warning System (PEWS). Returns active alerts, recent validated events, data feed health, and global risk summary across all 14 monitoring feeds.",
"args_schema": {},
"api_endpoint": "/api/v1/pews/status",
"api_method": "GET",
"pricing": "$0.05/query"
},
{
"name": "earthquake_regions",
"description": "List all supported earthquake monitoring regions with bounds, historical seismicity rates, and current alert status. Use to discover which regions are available for prediction queries.",
"args_schema": {},
"api_endpoint": "/api/v1/earthquake/regions",
"api_method": "GET",
"pricing": "free"
},
{
"name": "data_connectors",
"description": "List all 25 data connectors with their status, update frequency, and available endpoints. Shows which data sources are active and their last successful fetch time.",
"args_schema": {},
"api_endpoint": "/api/v1/data/connectors",
"api_method": "GET",
"pricing": "free"
},
{
"name": "real_estate_ground_truth",
"description": "Score any property for subsurface and surface geohazard risk. Fuses Ghost Network sinkhole risk, liquefaction, InSAR subsidence, flood, seismic amplification, landslide, climate migration pressure, and severe weather into a single A+ to F grade with insurance cost estimate. What Zillow/Redfin cannot provide.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
},
"property_type": {
"type": "string",
"description": "single_family, multi_family, commercial, condo",
"required": false
},
"property_value_usd": {
"type": "number",
"description": "Property value for insurance estimate",
"required": false
}
},
"api_endpoint": "/api/v1/real-estate/ground-truth",
"api_method": "POST",
"pricing": "$2.00/property"
},
{
"name": "water_main_break_risk",
"description": "Predict water main break risk at any location using 8 physics-based drivers: drought-to-wet soil transition (the #1 cause), soil saturation, freeze-thaw cycling, barometric pressure anomalies, groundwater trends, subsidence, pipe material and age. Returns risk score, primary driver, and 7-day forecast.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
},
"pipe_material": {
"type": "string",
"description": "cast_iron, ductile_iron, pvc, hdpe, concrete, steel",
"required": false
},
"pipe_age_years": {
"type": "number",
"description": "Age of pipe in years",
"required": false
}
},
"api_endpoint": "/api/v1/infrastructure/water-main/risk",
"api_method": "POST",
"pricing": "$1.00/query"
},
{
"name": "ai_underwriter_decision",
"description": "Get an instant insurance underwriting decision for any property. Fuses GeoRisk 8-component scoring, per-peril vulnerability curves, construction type and age factors, climate migration, and Ghost Network sinkhole intelligence. Returns APPROVE/APPROVE_WITH_CONDITIONS/REFER_TO_SENIOR/DECLINE with premium recommendations and PML estimates.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
},
"property_type": {
"type": "string",
"description": "single_family, commercial, industrial",
"required": false
},
"construction_type": {
"type": "string",
"description": "wood_frame, steel_frame, reinforced_concrete, masonry",
"required": false
},
"construction_year": {
"type": "number",
"description": "Year built",
"required": false
},
"replacement_value_usd": {
"type": "number",
"description": "Replacement value",
"required": true
},
"perils_requested": {
"type": "array",
"description": "List of perils: earthquake, flood, sinkhole, wind, wildfire, all",
"required": false
}
},
"api_endpoint": "/api/v1/insurance/underwrite/decision",
"api_method": "POST",
"pricing": "$2.00/decision"
},
{
"name": "construction_preclearance",
"description": "Pre-clearance assessment for construction sites. Evaluates subsurface karst dissolution, groundwater depth, sinkhole proximity, liquefaction, subsidence, bearing capacity, seismic design category, and surface hazards. Returns CLEAR/CONDITIONAL/RESTRICTED/FAIL grade with foundation recommendations and estimated cost savings vs blind drilling.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
},
"structure_type": {
"type": "string",
"description": "residential, commercial, industrial, infrastructure, high_rise",
"required": false
},
"foundation_type": {
"type": "string",
"description": "shallow, deep, mat, pile, drilled_shaft",
"required": false
},
"stories": {
"type": "number",
"description": "Number of stories",
"required": false
}
},
"api_endpoint": "/api/v1/construction/preclearance",
"api_method": "POST",
"pricing": "$5.00/assessment"
},
{
"name": "prediction_market_oracle",
"description": "Get calibrated probability for geophysical event questions. Supports earthquake (M3-M7+, 11 regions), volcano (6 volcanoes), tsunami (6 zones), severe weather, and flood predictions. Uses Poisson model with ML risk modifiers and CalibratedClassifierCV. Returns Polymarket/Kalshi/Chainlink-compatible formats with SHA-256 tamper-proof prediction hashing.",
"args_schema": {
"hazard_type": {
"type": "string",
"description": "earthquake, volcano, tsunami, severe_weather, flood",
"required": true
},
"region": {
"type": "string",
"description": "Region or volcano name",
"required": false
},
"magnitude_threshold": {
"type": "number",
"description": "Min magnitude (earthquakes)",
"required": false
},
"time_horizon_days": {
"type": "number",
"description": "Prediction window in days",
"required": false
},
"lat": {
"type": "number",
"description": "Latitude (for weather/flood)",
"required": false
},
"lon": {
"type": "number",
"description": "Longitude (for weather/flood)",
"required": false
}
},
"api_endpoint": "/api/v1/predictions/market/oracle",
"api_method": "POST",
"pricing": "$0.50/query"
},
{
"name": "event_replay",
"description": "Replay any geophysical event with full forensic reconstruction. 5-phase replay: pre-event conditions (weather, groundwater, seismicity), event impact (PGA, MMI, damage), post-event assessment (aftershock risk, follow-up hazards), chronological timeline, and prediction verification (did we predict this?). Auto-detect mode finds recent events near any location.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
},
"event_date": {
"type": "string",
"description": "ISO date of event (default: auto-detect recent)",
"required": false
},
"event_type": {
"type": "string",
"description": "earthquake, volcano, flood, sinkhole",
"required": false
},
"usgs_event_id": {
"type": "string",
"description": "USGS event ID for direct lookup",
"required": false
}
},
"api_endpoint": "/api/v1/replay/event",
"api_method": "POST",
"pricing": "$25.00/replay"
},
{
"name": "water_stress_score",
"description": "Get a composite water stress score (0-100) for any location. Combines 6 data-driven components: groundwater depletion rate, streamflow anomaly, drought severity, water quality (conductance), infrastructure age, and demand pressure. Integrates Ghost Network ROMP wells for aquifer-level corroboration. Use for municipal water planning, agricultural risk, insurance, and drought monitoring.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
}
},
"api_endpoint": "/api/v1/water-stress/score",
"api_method": "POST",
"pricing": "$0.50/query"
},
{
"name": "compound_risk_score",
"description": "Calculate the probability of 2+ simultaneous natural hazards at a location. Uses 28 empirically-calibrated pairwise correlation factors across all 8 GeoRisk components (earthquake, volcano, tsunami, etc). Returns top 5 compound scenarios, joint probabilities, and compound multiplier. Optional Monte Carlo mode with 10K simulations for tail risk.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
}
},
"api_endpoint": "/api/v1/compound-risk/score",
"api_method": "POST",
"pricing": "$1.00/query"
},
{
"name": "bridge_failure_risk",
"description": "Predict bridge failure risk using 8 physics-based drivers: scour depth (HEC-18), seismic vulnerability, condition deterioration, flood overtopping, freeze-thaw cycling, subsidence, traffic overload, and age corrosion. Returns per-driver risk scores, composite risk, and inspection recommendations.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude of bridge",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude of bridge",
"required": true
},
"nbi_condition": {
"type": "number",
"description": "NBI condition rating 0-9 (default 5)",
"required": false
},
"bridge_age_years": {
"type": "number",
"description": "Bridge age in years (default 40)",
"required": false
}
},
"api_endpoint": "/api/v1/infrastructure/bridge/risk",
"api_method": "POST",
"pricing": "$1.00/query"
},
{
"name": "climate_velocity",
"description": "Calculate the rate of climate zone migration in km/decade for any location. Returns temperature velocity, precipitation velocity, growing season shift, and analog city matching ('Phoenix 2050 = Riyadh today'). Based on NOAA CDO 150K+ station historical records and IPCC AR6 warming projections.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
},
"target_year": {
"type": "number",
"description": "Target year for analog matching (default 2050)",
"required": false
}
},
"api_endpoint": "/api/v1/climate-velocity/velocity",
"api_method": "POST",
"pricing": "$0.75/query"
},
{
"name": "water_energy_nexus",
"description": "Score grid reliability from water-energy cross-correlation. Combines hydropower capacity (streamflow vs generation threshold), solar/wind generation potential, thermal cooling water adequacy, and temperature-driven demand pressure. Returns nexus score, per-component breakdown, and grid stress level. Use for energy sector risk, utility planning, and infrastructure resilience assessment.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude",
"required": true
}
},
"api_endpoint": "/api/v1/energy/water-nexus/score",
"api_method": "POST",
"pricing": "$0.75/query"
},
{
"name": "induced_seismicity_risk",
"description": "Get ML-predicted induced seismicity risk for a mining or oil/gas injection site. Returns risk score (0-100), probability of M2+ event, injection-seismicity correlation. Covers Oklahoma, Alberta, Mexico, and 12 other known induced seismicity zones.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude (-90 to 90)",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude (-180 to 180)",
"required": true
},
"radius_km": {
"type": "number",
"description": "Search radius in km (default 100)",
"required": false
}
},
"api_endpoint": "/api/v1/mining/induced-seismicity",
"api_method": "POST",
"pricing": "$1.00/query"
},
{
"name": "tailings_dam_risk",
"description": "Get tailings dam stability score for a mining site. Combines satellite InSAR deformation, weather loading, dam characteristics, and construction method risk. Returns stability score (0-100) with GISTM-aligned recommendations.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude (-90 to 90)",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude (-180 to 180)",
"required": true
},
"radius_km": {
"type": "number",
"description": "Search radius in km (default 50)",
"required": false
}
},
"api_endpoint": "/api/v1/mining/tailings-risk",
"api_method": "POST",
"pricing": "$2.00/query"
},
{
"name": "flare_emissions",
"description": "Detect oil/gas flares and estimate methane emissions for ESG scoring using NASA VIIRS Nightfire satellite data. Returns flare count, radiative power, estimated CH4/CO2e emissions (tonnes/year), and ESG score (0-100).",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude (-90 to 90)",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude (-180 to 180)",
"required": true
},
"radius_km": {
"type": "number",
"description": "Search radius in km (default 50)",
"required": false
},
"days_back": {
"type": "number",
"description": "Days of history (default 7, max 30)",
"required": false
}
},
"api_endpoint": "/api/v1/emissions/flare-detection",
"api_method": "POST",
"pricing": "$0.50/query"
},
{
"name": "infrastructure_exposure",
"description": "Assess critical infrastructure exposure to natural hazards using OpenStreetMap. Returns hospitals, fire stations, schools, power substations, building inventory, road network, and vulnerability-weighted exposure score (0-100) for any location.",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude (-90 to 90)",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude (-180 to 180)",
"required": true
},
"radius_km": {
"type": "number",
"description": "Search radius in km (default 5, max 10)",
"required": false
},
"hazard_type": {
"type": "string",
"description": "Hazard type: earthquake, flood, wildfire, or all (default all)",
"required": false
}
},
"api_endpoint": "/api/v1/infrastructure/osm/exposure-analysis",
"api_method": "POST",
"pricing": "$0.50/query"
},
{
"name": "disaster_satellite_imagery",
"description": "Search for free high-resolution (0.3-0.5m) Maxar satellite imagery available for disaster events near a location. Returns event catalog, scene counts, pre/post-event availability, and resolution. Imagery released during declared disasters (hurricanes, earthquakes, floods, wildfires).",
"args_schema": {
"lat": {
"type": "number",
"description": "Latitude (-90 to 90)",
"required": true
},
"lon": {
"type": "number",
"description": "Longitude (-180 to 180)",
"required": true
},
"radius_km": {
"type": "number",
"description": "Search radius in km (default 100)",
"required": false
},
"days_back": {
"type": "number",
"description": "Days of history to search (default 365)",
"required": false
}
},
"api_endpoint": "/api/v1/replay/satellite-imagery",
"api_method": "POST",
"pricing": "$0.25/query"
},
{
"name": "energy_economic_indicators",
"description": "Fetch energy commodity prices and rig counts from FRED: WTI crude oil, Henry Hub natural gas, regular gasoline, and Baker Hughes rig count. Useful for energy market context, induced seismicity correlation, and water-energy nexus analysis.",
"args_schema": {
"series_id": {
"type": "string",
"description": "FRED series: DCOILWTICO, DHHNGSP, GASREGW, or RIGS (default all)",
"required": false
}
},
"api_endpoint": "/api/v1/data/economic/series/{series_id}",
"api_method": "GET",
"pricing": "free"
}
],
"tool_count": 41,
"usage": {
"instruction": "Create LangChain StructuredTool instances from these definitions. Each tool should POST to the corresponding api_endpoint with the args_schema parameters. Or use: from deepmap_ai import DeepMapToolkit",
"base_url": "https://www.deepmapai.com",
"pip_install": "pip install deepmap-ai (coming soon)"
}
}