The weather API for AI agents.

For Developers · MCP Native

Historical weather statistics for any business location.

parasure.xyz/mcpCopy

Free

No API key

x402-native

View Tool ReferenceContact

Tool reference

One tool, one request.

POST JSON-RPC 2.0 to https://parasure.xyz/mcp. Discovery is free through GET /mcp/info, tools/list, and initialize.

get_weather_history

10 free calls/day per IP (100/day shared for Claude and ChatGPT connectors). Additional calls $0.10 USDC on Solana via x402.

Input schema

Both fields are required. business_type adds context only; it does not change the weather statistics.

Returns city/grid-level historical counts and frequencies, including rain and dry-spell duration. Missing observations may undercount events.

Sample request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_weather_history",
    "arguments": {
      "location": "Tampa, FL",
      "business_type": "car_wash"
    }
  }
}

View decoded Tampa response excerpt

This is a real decoded excerpt from result.content[0].text, not a full JSON-RPC transport response. Counts and analysis dates vary by lookup. Historical statistics are not forecasts or property-specific loss estimates.

{
  "mode": "production",
  "data": {
    "location": "Tampa, FL",
    "resolved_location": "Tampa, Florida",
    "business_type": "car_wash",
    "observations": [
      {
        "peril": "drought",
        "key_stats": {
          "longest_dry_streak_days": "52"
        }
      },
      {
        "peril": "freeze",
        "key_stats": {
          "freeze_days_total": "13",
          "annual_avg_freeze_days": "0.650"
        }
      },
      {
        "peril": "heat",
        "key_stats": {
          "hot_days_total": "218",
          "annual_avg_hot_days": "10.900"
        }
      },
      {
        "peril": "rain",
        "key_stats": {
          "rainy_days_total": "1411",
          "annual_avg_rainy_days": "70.550",
          "heavy_rain_days_total": "173",
          "annual_avg_heavy_days": "8.650"
        }
      },
      {
        "peril": "wind",
        "key_stats": {
          "high_wind_days_total": "3",
          "annual_avg_wind_days": "0.150"
        }
      }
    ],
    "analysis_period": {
      "start": "2006-01-01",
      "end": "2025-12-31",
      "years": 20
    },
    "data_sources": [
      "noaa-ncei-cdo-ghcnd",
      "us-census-city-geocoding"
    ],
    "data_source": "station_daily_history",
    "station": {
      "id": "GHCND:USW00012842",
      "name": "TAMPA INTERNATIONAL AIRPORT, FL US",
      "latitude": 27.96331,
      "longitude": -82.54,
      "distance_km": 6.44
    },
    "data_quality": {
      "total_calendar_days": 7305,
      "valid_days": {
        "PRCP": 7305,
        "TMAX": 7303,
        "TMIN": 7302,
        "WSF2": 7300,
        "WSF5": 7249,
        "SNOW": 7305
      },
      "minimum_core_coverage_per_year": 0.9
    },
    "limitations": [
      "Historical daily station observations near a Census-resolved city point, not property-level measurements or a forecast. The city point is not necessarily downtown or the business address.",
      "Historical counts and frequencies are informational only. They do not predict future events, estimate business losses, or recommend policy terms.",
      "Business type is supplied by the caller; these statistics are not business-specific loss modeling.",
      "Rainy days: daily precipitation at least 0.1 inch. Heavy rain days: daily precipitation at least 1.5 inches; these are a subset of rainy days. Precipitation includes liquid-equivalent frozen precipitation. Wind: fastest 2-minute station wind speed (WSF2) at least 45 mph, not gusts or daily average wind. Heat: daily maximum at least 95 F. Freeze: daily minimum at most 32 F. Drought: longest observed sequence of days below 0.1 inch precipitation; missing observations break the sequence.",
      "Annual frequencies are the observed day counts divided by the reported analysis years, rounded to three decimal places. They are historical averages, not forecasts or event probabilities. Missing observations can undercount events and dry spells.",
      "Only available descriptive statistics are included. Omitted perils do not imply no exposure. Flood and hail proxies are excluded; flood, hail, hurricane, wildfire, snow, and earthquake exposure are not assessed by this response."
    ],
    "coverage_status": "not_provided",
    "licensing_disclosure": "ParaSure Technologies LLC, CA License #4346787. Licensed in California and Nevada. Any coverage would be placed through a licensed surplus lines broker and is subject to underwriting review. This is weather data only, not a quote or offer of coverage. Request coverage: https://parasure.xyz/get-coverage",
    "coverage_inquiries": "For coverage inquiries, visit the Get Coverage form: https://parasure.xyz/get-coverage.",
    "coverage_invitation": "Want coverage for this weather? Request a quote at parasure.xyz."
  }
}

Payment

Pay once, then retry.

10 free calls per day per IP, then $0.10 USDC per call on Solana mainnet. No account or API key is required.

Free access is limited to 300 calls per day across all callers. Free limits reset at midnight UTC. Recognized Claude and ChatGPT connector IPs share a separate 100-call daily pool per platform. Other callers using the same outbound IP share its 10-call allowance. Accepted free attempts count even if the weather provider fails.

Once either free limit is reached, an unpaid tool call returns the existing HTTP 402. Read the current accepts[] entry, including maxAmountRequired, payToAddress, network, extra.usdcContractAddress, and extra.xPaymentFormat. Follow those returned requirements; never hardcode a receiving address.

An authorized wallet transfers the exact USDC amount. Retry the same JSON-RPC request with X-Payment set to base64-encoded proof:

Show proof schema

{
  "x402Version": 1,
  "scheme": "exact",
  "network": "solana-mainnet",
  "payload": { "signature": "<transaction-signature>" }
}

Matching paid retries recover the saved result rather than charging again. Handle HTTP 402 by reviewing requirements, 429 with backoff, and JSON-RPC or provider errors according to their returned status and message.

Quickstart

Make a request

cURL

JavaScript

# First request: free weather JSON while allowance remains, otherwise HTTP 402
curl -i https://parasure.xyz/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_weather_history","arguments":{"location":"Tampa, FL","business_type":"car_wash"}}}'

# Only after HTTP 402: review accepts[] and authorize its exact payment terms.
# After an authorized wallet transfer, retry the same request:
curl https://parasure.xyz/mcp \
  -H "Content-Type: application/json" \
  -H "X-Payment: $PAYMENT_PROOF_BASE64" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_weather_history","arguments":{"location":"Tampa, FL","business_type":"car_wash"}}}'

# Read result.content[0].text for the serialized weather JSON.

Weather history is descriptive, based on gridded data resolved to a city; it is not a forecast or property inspection. Business type is context only. Missing observations can undercount events and dry spells.

ParaSure Technologies LLC, CA License #4346787. Licensed in California and Nevada. Any coverage would be placed through a licensed surplus lines broker and is subject to underwriting review. This is weather data only, not a quote or offer of coverage. Request coverage: https://parasure.xyz/get-coverage

Coverage inquiries

Get in touch

Building with the API?

Share a little about your project. We'll follow up within one business day.

Name

Email

What are you building?

Send message