Developers
The HailPing MCP server
Connect an AI assistant to HailPing and ask it where it hailed.
Its search tools are public: no account, no API key, no setup beyond one URL. Checking one street address needs a free HailPing sign-in.
Server URL
https://app.hailping.com/api/mcp Streamable HTTP. The search tools need no sign-in; the address check asks you to sign in to HailPing. Every tool is read-only.
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.
The tools
Each tool answers a different shape of question. The four search tools are public; the address check answers for the person signed in to HailPing. The example prompts below exercise one tool apiece, which also makes them a quick way to check your connection works.
-
Find hail storms
find_hail_stormsLists 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?”
-
Get hail storm report
get_hail_storm_reportReturns 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.”
-
Find hail near a location
find_hail_near_locationFinds 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?”
-
Get hail market profile
get_hail_marketReturns 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?”
-
Check hail at an address
check_address_hailSign-inFor one US street address or point: the days since October 2020 that radar-estimated hail reached it and how large, other days with ground reports within 5 miles, and a link to Address Lookup. It answers for the person signed in to HailPing; a free account works, and each new address counts toward that account’s Address Lookup allowance.
Try “Has hail hit the Kansas State Capitol in Topeka since 2020?”
Adding HailPing to your assistant
All four clients below use 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 the HailPing plugin in ChatGPT and choose Install plugin, or search for HailPing under Plugins. The search tools work straight away; the first address question asks you to sign in to HailPing. To add the endpoint by hand instead, use developer mode, paste the server URL and choose OAuth. Open HailPing in ChatGPT
- Claude
- Settings, then Connectors, then Add custom connector. Name it HailPing and paste the server URL. The search tools work straight away; the first address question opens HailPing’s sign-in.
- Perplexity
- Available to Pro, Max and Enterprise accounts. Add a custom remote connector and paste the server URL. With no authentication the search tools work; the address check needs OAuth sign-in.
- Gemini
- Add the server URL as a custom MCP server under Connected Apps, where your account has that option. The search tools need no sign-in; the address check needs OAuth.
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.
- Coverage outside the United States, or 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.
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.
Logging
MCP requests are logged so the rate limit can be enforced and abuse spotted. The caller's IP address is used only in a one-way form and is not kept in these logs. A request from an assistant connected to a HailPing account also records that account. The Privacy Policy covers this too.
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.
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.