# FloodPulse

> FloodPulse is a climate hazard risk API for US addresses: one call returns FEMA flood zone, wildfire hazard potential, NOAA heat history, and a composite risk score.

Base URL: https://floodpulse.waltsoft.net/v1 — authenticate with the header X-API-Key: <your AWS Marketplace key (mp_...)>, or pay $0.02 per call with x402 (USDC on Base or Solana) and no key.

## Endpoints
- GET https://floodpulse.waltsoft.net/v1/flood?address=1001+Texas+Ave,+Houston,+TX: FEMA flood zone and annual probability for a US address
- GET https://floodpulse.waltsoft.net/v1/wildfire?address=1001+Texas+Ave,+Houston,+TX: USFS wildfire hazard potential for a US address
- GET https://floodpulse.waltsoft.net/v1/heat?address=1001+Texas+Ave,+Houston,+TX: Historical heat percentile from NOAA nClimGrid (contiguous US only)
- GET https://floodpulse.waltsoft.net/v1/report?address=1001+Texas+Ave,+Houston,+TX: Full multi-hazard climate risk report (flood, wildfire, heat, composite)
- GET https://floodpulse.waltsoft.net/v1/compare?addresses=1001+Texas+Ave+Houston+TX|123+Main+St+Austin+TX: Side-by-side multi-hazard comparison of two US addresses

## Agent access
- MCP (Amazon Bedrock AgentCore Gateway): https://waltsoft-marketplace-gateway-xncyjgs1uh.gateway.bedrock-agentcore.us-east-1.amazonaws.com/mcp — tools: floodpulse___getFloodRisk(address, lat, lon, api_key), floodpulse___getWildfireRisk(address, lat, lon, api_key), floodpulse___getHeatRisk(address, lat, lon, api_key), floodpulse___getFullReport(address, lat, lon, api_key), floodpulse___compareAddresses(addresses, api_key)
- A2A agent card: https://floodpulse.waltsoft.net/.well-known/agent-card.json (JSON-RPC endpoint https://waltsoft-marketplace-gateway-xncyjgs1uh.gateway.bedrock-agentcore.us-east-1.amazonaws.com/a2a-gw/floodpulse)

## Docs
- [OpenAPI 3 schema](https://floodpulse.waltsoft.net/openapi.json)
- [Agent guide](https://floodpulse.waltsoft.net/agents.md)
- [Full reference](https://floodpulse.waltsoft.net/llms-full.txt)
- [Buy on AWS Marketplace](https://aws.amazon.com/marketplace/search/results?searchTerms=Waltsoft%20FloodPulse)