Developers

The HailPing MCP server

Connect an AI assistant to HailPing and ask it where it hailed. The server is read-only and public: no account, no API key, no setup beyond one URL.

HailPing publishes a Model Context Protocol (MCP) server over the same storm reports and hail market pages you can read on this site. An assistant that connects to it can look up a storm, a market, or the hail near a place, and answer with the published facts and a link back to the page they came from.

Server URL

https://app.hailping.com/api/mcp

Streamable HTTP. No authentication. Every tool is read-only, and nothing you ask writes anything to HailPing.

The four tools

Each tool answers a different shape of question. The example prompts below exercise one tool apiece, which also makes them a quick way to check your connection works.

  1. Find hail storms

    find_hail_storms

    Lists published storm reports, newest first, filtered by state, city, date range and minimum hail size. Each result carries the date, the largest reported hailstone, the report count and the report page URL.

    Try “Which hail storms hit Texas in July 2026?”

  2. Get hail storm report

    get_hail_storm_report

    Returns one storm report in full: summary, storm path, timing, largest hail, report counts, hail size distribution, affected cities and counties, and the report page URL.

    Try “Tell me about the Dimmitt, Texas hail report from July 4, 2026.”

  3. Find hail near a location

    find_hail_near_location

    Finds storm reports whose published footprint falls within a radius of a point, nearest first, over a recent window of days. Takes latitude and longitude, or a city and state.

    Try “Did it hail within 50 miles of Plano, Texas in the last 60 days?”

  4. Get hail market profile

    get_hail_market

    Returns the hail market page for a city: the last significant hail date, the largest recent hail, the hail frequency band, the event count, and the history of qualifying events with their report URLs.

    Try “When did it last hail in Abilene, Texas?”

Adding HailPing to your assistant

All four clients below consume the same URL. Menu names move around as these products change, so treat the steps as a description of where to look rather than an exact path.

ChatGPT
Open Apps, search for HailPing, and connect it. To add the endpoint by hand instead, use developer mode and paste the server URL with no authentication.
Claude
Settings, then Connectors, then Add custom connector. Name it HailPing, paste the server URL, and leave authentication set to none.
Perplexity
Available to Pro, Max and Enterprise accounts. Add a custom remote connector, paste the server URL, and choose no authentication.
Gemini
Add the server URL as a custom MCP server under Connected Apps, where your account has that option.

Rate limit

Requests are limited to 120 per minute per IP address, the same budget guest storm reads get. Over that, the server answers 429 and the assistant should retry in a moment. If you have a use that needs more, get in touch before you build against it.

What the data is, and what it is not

It is:

  • hail events in the continental United States, grouped from ground-truth hail reports of 1.00 inch and larger;
  • 2025 onward, published within about a day of a storm;
  • the same facts already published on the report and market pages of this site, with the page URL on every result.

It is not:

  • a forecast, a watch, a warning, or anything else about weather that has not happened;
  • a record of confirmed damage. A storm report says hail of a given size was reported in an area, not that any particular property was damaged;
  • per-address history. The published data has storm footprints, not individual addresses;
  • coverage outside the United States, and it is not a substitute for an official alerting service.

HailPing Pro, with new storms in full on the day they publish, lives in the HailPing app. The MCP server serves the free public data only, and the same data to everyone.

Logging

MCP requests are logged with the caller's IP address so the rate limit can be enforced. Those logs are not tied to a person or a HailPing account. The Privacy Policy covers this in full.

Support

Questions, a tool that misbehaves, or a result that looks wrong: email help@hailping.com. Corrections to a specific storm report are welcome and are the fastest way to fix an answer an assistant is giving.

Data sources

  • Weather data powered by Vaisala Xweather
  • Demographic and business-pattern data from the U.S. Census Bureau.
  • Mapped business listings from third-party data providers.
  • Storm grouping, exposure modeling, and industry assessments by HailPing.

Source names identify where information originates and do not imply endorsement, affiliation, or verification by any agency, provider, or business.

Read the data first

Every answer links back to a page here

The storm reports and hail markets the server reads are public. Browse them the same way an assistant would.

  • Industry-specific decisions
  • Hail alerts for your states
  • Full briefings free after 14 days