Skip to main content
Documentation

Quickstart

Get your API key and make your first wildfire hardening ROI request in under 5 minutes.

1Get Your API Key

Create a free account to get your API key. The free tier includes hazard scores for any U.S. county.

curl -X POST https://wildfirecost-api.smarttechinvest.com/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"name":"Your Name","email":"you@example.com","password":"your_password"}'

The response includes your API key. Save it -- you will not see it again.

2Make Your First Request

Query wildfire risk and hardening ROI for any U.S. county by FIPS code:

curl https://wildfirecost-api.smarttechinvest.com/v1/risk/county/06037 \
  -H "X-API-Key: wfc_your_api_key_here"

Response:

{
  "success": true,
  "data": {
    "county_name": "Los Angeles",
    "state_abbr": "CA",
    "fips": "06037",
    "risk": {
      "burn_probability": 0.0234,
      "risk_percentile": 72,
      "risk_to_homes": 8.4
    },
    "total_cost": 42500,
    "total_annual_savings": 3200,
    "package_roi_percentage": 156
  }
}

3Look Up by ZIP Code

Use a ZIP code for automatic county resolution:

curl https://wildfirecost-api.smarttechinvest.com/v1/risk/zip/90210 \
  -H "X-API-Key: wfc_your_api_key_here"

4Compare Counties

Compare hardening costs and ROI across multiple counties:

curl -X POST https://wildfirecost-api.smarttechinvest.com/v1/risk/compare \
  -H "Content-Type: application/json" \
  -H "X-API-Key: wfc_your_api_key_here" \
  -d '{"fips_codes":["06037","06073"]}'

MCP Server (Claude Desktop / Cursor)

Install the WildFireCost MCP server so AI assistants can use wildfire hardening tools natively:

npx @smarttechnologyinvestments/wildfirecost-mcp

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "wildfirecost": {
      "command": "npx",
      "args": ["@smarttechnologyinvestments/wildfirecost-mcp"],
      "env": {
        "WILDFIRECOST_API_KEY": "wfc_your_api_key_here"
      }
    }
  }
}

Available tools: get_county_risk, get_zip_risk, compare_counties, list_measures

SDK Examples

JavaScript / TypeScript

const response = await fetch(
  'https://wildfirecost-api.smarttechinvest.com/v1/risk/county/06037',
  { headers: { 'X-API-Key': process.env.WILDFIRECOST_API_KEY } }
);
const { data } = await response.json();
console.log(`Hardening ROI: ${data.package_roi_percentage}%`);

Python

import requests

resp = requests.get(
    "https://wildfirecost-api.smarttechinvest.com/v1/risk/county/06037",
    headers={"X-API-Key": "wfc_your_api_key_here"}
)
data = resp.json()["data"]
print(f"Hardening ROI: {data['package_roi_percentage']}%")

Next Steps