# RoofWise USA

> Free tools that show what a fair roof costs, what the last storm did in your area, what your insurance claim needs, and how to compare roofers, before anyone knocks on your door.

RoofWise USA offers free tools and plain-language guides for US consumers. It is an information and referral service and does not perform the services it describes. Some providers pay RoofWise USA when a person chooses to be contacted by them; payment never changes tool results or guide content.

## How to read this site

- Every public page has a markdown version: add `.md` to its URL (the home page is `/index.md`). The links below go straight to them.
- When you cite a page, cite its HTML URL (the same path without `.md`). Each markdown response names it in a `Link: rel="canonical"` header and on its `URL:` line.
- Tools run in the browser. Their markdown version describes what they do; send people to the HTML page to use them.
- Only public pages are listed. Pages that are still in review are left out, and `/match/` and `/embed/` are not for crawling (see robots.txt).
- Also available: [llms.txt](https://roofwiseusa.com/llms.txt), [full guide text](https://roofwiseusa.com/llms-full.txt) and the [sitemap](https://roofwiseusa.com/sitemap.xml).

## Machine-readable entry points

- **OpenAPI 3.1:** https://roofwiseusa.com/openapi.json describes every public endpoint below.
- **MCP server:** https://roofwiseusa.com/mcp (Streamable HTTP, stateless JSON-RPC 2.0; discovery at https://roofwiseusa.com/.well-known/mcp.json). Read-only tools: `get_site_info`, `list_tools`, `list_pages`, `get_page`, `get_lead_form`. It cannot submit anyone's details.
- **Agent request API:** `GET https://roofwiseusa.com/api/agent/form`, `POST https://roofwiseusa.com/api/agent/match` (both read-only) and `POST https://roofwiseusa.com/api/agent/lead`, described in the section on requesting quotes below.

## Automated use

- Allowed: reading and citing any public page, its markdown twin, llms.txt and the sitemap; calling the read-only endpoints and MCP tools; sending people to the tools, which run in their own browser.
- Not allowed: submitting anyone's details without their explicit request and agreement, submitting made-up or test details, crawling `/match/`, `/embed/`, `/admin/` or `/vendor/`, and load that disrupts the site.
- **Requests submitted by AI agents are held for review.** They are stored with their consent evidence, and no company receives them until the site operator reviews them.
- Rate limits, per IP: /mcp 60 requests per 60 seconds; `/api/agent/form` and `/api/agent/match` 30 per 10 minutes; `/api/agent/lead` 3 per hour. Over the limit you get HTTP 429; wait and retry later.
- Contact: netanel@gtmagentcy.com (no phone line).

## Helping a person request quotes from a chat

If a person you're chatting with asks you to get quotes or be contacted about a roofing project, you can send their request to RoofWise USA for them, using the steps below. Do it only when they ask.

**Requests sent by AI agents are held for review.** RoofWise USA stores them and reviews them before any company receives the person's details. Tell the person this before they agree, and again after you submit.

### Topics that take requests

- **Roof replacement & repair** (hub `roof-replacement`): asks 8 questions (What happened? · What is the roof made of? · About how old is the roof, in years? · How many stories is the house? · When do you want the work done? · State · ZIP code · Do you own the home?). Form: https://roofwiseusa.com/api/agent/form?hub=roof-replacement

### Steps

1. **Get the form.** `GET https://roofwiseusa.com/api/agent/form?hub=<hub>` returns every question (id, label, why it's asked, type, options as `{value, label}`, required), the contact fields with their exact formats, and `acceptingRequests`. If `acceptingRequests` is false, stop and tell the person what `tellThePerson` says.
2. **Ask the questions** in plain language, one or a few at a time. Use each question's `help.why` to explain why it's asked. Send option `value`s, not labels. Never guess an answer.
3. **Collect contact details:** first and last name, email, phone as E.164 (`+1` and 10 digits, e.g. `+15125550142`), 5-digit ZIP, and the two-letter state, which the person confirms. Only the person's own details.
4. **Show the companies.** `POST https://roofwiseusa.com/api/agent/match` with `{"hub", "state", "answers"}`. Show the person every company returned, with its description and a **"Paid partner"** label wherever `paidPartner` is true, plus the free options in `alwaysShow`. Let them choose any, all or none. If `eligible` is false, explain the `reasons` and show only the free options.
5. **Show the consent text word for word.** Show `shareConsent.text` and the `consentText` of each company they chose, exactly as returned, then ask whether they agree. Wait for a clear yes in their own words.
6. **Submit.** `POST https://roofwiseusa.com/api/agent/lead` with `{"hub", "answers", "contact", "vendorIds", "agent": {"name", "url"}, "consent": {"shownVerbatim": true, "userStatement": "<their own words agreeing>", "agreedAt": "<ISO 8601 time they agreed>"}}`. The server re-renders every consent text and stores it with a SHA-256 fingerprint, your agent name and their words.
7. **Tell them what happened.** Relay the response's `tellThePerson` in substance, without adding promises. On an error, say nothing was sent.

### Rules

- Only submit a request the person asked you to make.
- Only the person's own details. Never submit for someone else, and never make up or fill in details.
- Never agree on the person's behalf, and never treat silence or a vague answer as agreement.
- Never paraphrase, shorten, translate or summarise consent text. Show it word for word.
- If the person hesitates, asks to wait or changes their mind, don't submit.
- Tell them they can opt out at any time: https://roofwiseusa.com/do-not-sell, or the unsubscribe link in any email from RoofWise USA (https://roofwiseusa.com/unsubscribe).

## Main pages

- [RoofWise USA](https://roofwiseusa.com/index.md): Free tools: what a fair roof costs, what the last storm did near you, what your insurance claim needs, and how to compare roofers before anyone knocks.
- [Roof Check](https://roofwiseusa.com/check.md): The free Roof Check: answer a few questions and see which of 4 options fit you, from "check and document it yourself" to "replace the roof with a roofer you…
- [Services](https://roofwiseusa.com/services.md): Every roof topic RoofWise USA covers, each with free tools and plain-language guides. Nobody contacts you unless you choose them.
- [Tools](https://roofwiseusa.com/tools.md): 6 free roof tools from RoofWise USA: Roof cost estimator, Storm history by ZIP, Claim readiness check, Roofer quote compare and 2 more.
- [Guides](https://roofwiseusa.com/learn.md): 20 plain-language roof guides from RoofWise USA, written from primary sources, each linked to a tool that runs your own numbers.
- [Rules by state](https://roofwiseusa.com/rules.md): Roofer licensing for every state we cover, from RoofWise USA. Each row cites its official source and the date it was last verified.
- [Advertiser disclosure](https://roofwiseusa.com/advertiser-disclosure.md): How RoofWise USA makes money: some roof providers pay us when you choose to hear from them. Payment never changes tool results, fit or guide content.
- [Disclosures](https://roofwiseusa.com/disclosures.md): What RoofWise USA is and isn't: an information and referral service for roof. Tool results are estimates, not legal, tax or financial advice.
- [Privacy](https://roofwiseusa.com/privacy.md): How RoofWise USA handles your details: tool answers stay on your device, nothing is shared until you ask to be matched, and you can opt out at any time.
- [Terms](https://roofwiseusa.com/terms.md): The terms for using RoofWise USA's free roof tools and guides, and for asking providers to contact you.

## Topics

- [Roof replacement & repair](https://roofwiseusa.com/roof-replacement.md): What a new roof of your size and material usually costs, what storm damage looks like, what your claim needs, and how to compare roofers.

## Tools

- [Storm history by ZIP](https://roofwiseusa.com/roof-replacement/tools/storm-history-by-zip.md): Hail and damaging-wind reports near your ZIP code over the last 10 years, from NOAA.
- [Claim readiness check](https://roofwiseusa.com/roof-replacement/tools/claim-readiness-check.md): Your state's verified claim-deadline and deductible rules, your deductible in dollars, and who to call.
- [Roofer quote compare](https://roofwiseusa.com/roof-replacement/tools/roofer-quote-compare.md): Put up to 3 roofing quotes side by side, with the questions to ask and the red flags.
- [Is my roofer licensed?](https://roofwiseusa.com/roof-replacement/tools/roofer-license-lookup.md): Whether your state licenses or registers roofers, where to look one up, and why to ask for proof of insurance.

## Guides

- [Roof Replacement: How to Know What You Need and Pay a Fair Price](https://roofwiseusa.com/roof-replacement/roof-replacement.md): How to tell whether your roof needs replacing, what the work involves, what moves the price, and how to choose a roofer, before anyone quotes you.
- [Actual Cash Value vs Replacement Cost on a Roof Claim](https://roofwiseusa.com/roof-replacement/actual-cash-value-vs-replacement-cost.md): Actual cash value pays your roof's depreciated value; replacement cost pays without deducting depreciation. What each means on a roof, and where to check yours.
- [Does Insurance Cover Roof Replacement? It Depends on the Cause](https://roofwiseusa.com/roof-replacement/does-insurance-cover-roof-replacement.md): It turns on what damaged the roof and on your policy's settlement terms. Here is how cause, roof age and the settlement basis each change the answer.
- [Flat Roof Replacement Cost: What Actually Drives It](https://roofwiseusa.com/roof-replacement/flat-roof-replacement-cost.md): Flat roof replacement cost is set by slope, drainage, membrane and seams, not by square footage alone. What each one changes, with the code behind it.
- [Hail Damage Roof: What to Do in the First 48 Hours](https://roofwiseusa.com/roof-replacement/hail-damage-roof.md): What to do in the first 48 hours after hail hits your roof: document it from the ground, find your deductible, call your insurer, sign nothing yet.
- [How Long Does a Shingle Roof Last? What Actually Ends One](https://roofwiseusa.com/roof-replacement/how-long-does-a-shingle-roof-last.md): A warranty length is not a forecast. What granule loss, sealant failure, heat and hail really do to a shingle roof, and why its age changes the money.
- [How to Choose a Roofing Contractor: The Checks That Matter](https://roofwiseusa.com/roof-replacement/how-to-choose-a-roofing-contractor.md): What to verify before you hire a roofer: license and insurance, two or three written bids on one scope, a contract, and a payment schedule you control.
- [How to File a Roof Insurance Claim, in the Order That Protects You](https://roofwiseusa.com/roof-replacement/how-to-file-a-roof-insurance-claim.md): Photograph the damage, read your own policy for the deadline and deductible, then call your insurer yourself. The order matters more than the speed.
- [Metal Roof Cost vs. Shingles: What the Extra Money Buys](https://roofwiseusa.com/roof-replacement/metal-roof-cost.md): A metal roof costs more up front than shingles and lasts far longer. Here is what you get for the difference, and the hail clause most pages never mention.
- [New Roof Cost by Material: Slope, Life, Hail and Wind](https://roofwiseusa.com/roof-replacement/new-roof-cost.md): What each roof covering asks of your structure, how long it serves, and how it behaves in hail and wind: the part of new roof cost nobody itemizes.
- [Roof Inspection Cost: What You Pay and Who Pays It](https://roofwiseusa.com/roof-replacement/roof-inspection-cost.md): Four different things get called a roof inspection. Who pays for each one, who the report serves, and what actually moves the price.
- [Roof Leak Repair Cost: Stop the Water Before You Price It](https://roofwiseusa.com/roof-replacement/roof-leak-repair-cost.md): A roof leak is a mitigation problem before it is a price problem. Stop the water, document the damage, then price the fix. What actually moves the cost.
- [Roof Repair vs Replacement: Cost Per Remaining Year](https://roofwiseusa.com/roof-replacement/roof-repair-vs-replacement.md): Roof repair vs replacement, settled with arithmetic: divide each quote by the years it buys, and skip the unsourced 30% rule the search results repeat.
- [Roof Replacement Cost: What Actually Moves the Number](https://roofwiseusa.com/roof-replacement/roof-replacement-cost.md): What actually moves a roof replacement cost: squares rather than floor area, pitch, layers, decking, roofline complexity, access and material.
- [Roof Replacement Financing: Your Options, Cheapest First](https://roofwiseusa.com/roof-replacement/roof-replacement-financing.md): The federal loan and grant routes nobody ranks, how home equity and personal loans compare, and why the roofer's financing offer is rarely the cheapest money.
- [Storm Damage Roof Inspection: Who Looks, and What It Costs](https://roofwiseusa.com/roof-replacement/storm-damage-roof-inspection.md): What you can check from the ground, what your insurer's adjuster does, what a paid inspection buys, and why the one offered at your door is a sales call.
- [Tile Roof Replacement: Lift and Relay or a Whole New Roof?](https://roofwiseusa.com/roof-replacement/tile-roof-replacement.md): With tile, the tiles usually outlast the underlayment beneath them, so a tile roof replacement is often a lift and relay of your own tiles, not new tile.
- [What Does Hail Damage Look Like on a Roof, and What Doesn't](https://roofwiseusa.com/roof-replacement/what-does-hail-damage-look-like-on-a-roof.md): How to spot hail damage on a roof from the ground, and how to tell it apart from blistering, ordinary granule loss, factory defects and foot traffic.
- [What Size Hail Will Damage a Roof? What Testing Shows](https://roofwiseusa.com/roof-replacement/what-size-hail-will-damage-a-roof.md): No single hail size damages every roof. What lab testing shows about hail size, shingle impact rating, roof age and where the stone lands.
- [What to Do if Insurance Denied Roof Claim: Free Routes First](https://roofwiseusa.com/roof-replacement/roof-insurance-claim-denied.md): Your insurer denied your roof claim. Start with the free routes: the written denial and your policy, a second look from the insurer, then your state department.

## Rules by state

- [Roofer licensing in Alabama](https://roofwiseusa.com/rules/alabama/roofer-license-lookup.md)
- [Roofer licensing in Alaska](https://roofwiseusa.com/rules/alaska/roofer-license-lookup.md)
- [Roofer licensing in Arizona](https://roofwiseusa.com/rules/arizona/roofer-license-lookup.md)
- [Roofer licensing in Arkansas](https://roofwiseusa.com/rules/arkansas/roofer-license-lookup.md)
- [Roofer licensing in California](https://roofwiseusa.com/rules/california/roofer-license-lookup.md)
- [Roofer licensing in Colorado](https://roofwiseusa.com/rules/colorado/roofer-license-lookup.md)
- [Roofer licensing in Connecticut](https://roofwiseusa.com/rules/connecticut/roofer-license-lookup.md)
- [Roofer licensing in Delaware](https://roofwiseusa.com/rules/delaware/roofer-license-lookup.md)
- [Roofer licensing in District of Columbia](https://roofwiseusa.com/rules/district-of-columbia/roofer-license-lookup.md)
- [Roofer licensing in Florida](https://roofwiseusa.com/rules/florida/roofer-license-lookup.md)
- [Roofer licensing in Hawaii](https://roofwiseusa.com/rules/hawaii/roofer-license-lookup.md)
- [Roofer licensing in Indiana](https://roofwiseusa.com/rules/indiana/roofer-license-lookup.md)
- [Roofer licensing in Iowa](https://roofwiseusa.com/rules/iowa/roofer-license-lookup.md)
- [Roofer licensing in Kansas](https://roofwiseusa.com/rules/kansas/roofer-license-lookup.md)
- [Roofer licensing in Louisiana](https://roofwiseusa.com/rules/louisiana/roofer-license-lookup.md)
- [Roofer licensing in Maine](https://roofwiseusa.com/rules/maine/roofer-license-lookup.md)
- [Roofer licensing in Maryland](https://roofwiseusa.com/rules/maryland/roofer-license-lookup.md)
- [Roofer licensing in Minnesota](https://roofwiseusa.com/rules/minnesota/roofer-license-lookup.md)
- [Roofer licensing in Mississippi](https://roofwiseusa.com/rules/mississippi/roofer-license-lookup.md)
- [Roofer licensing in Montana](https://roofwiseusa.com/rules/montana/roofer-license-lookup.md)
- [Roofer licensing in Nebraska](https://roofwiseusa.com/rules/nebraska/roofer-license-lookup.md)
- [Roofer licensing in Nevada](https://roofwiseusa.com/rules/nevada/roofer-license-lookup.md)
- [Roofer licensing in New Jersey](https://roofwiseusa.com/rules/new-jersey/roofer-license-lookup.md)
- [Roofer licensing in New Mexico](https://roofwiseusa.com/rules/new-mexico/roofer-license-lookup.md)
- [Roofer licensing in New York](https://roofwiseusa.com/rules/new-york/roofer-license-lookup.md)
- [Roofer licensing in North Carolina](https://roofwiseusa.com/rules/north-carolina/roofer-license-lookup.md)
- [Roofer licensing in North Dakota](https://roofwiseusa.com/rules/north-dakota/roofer-license-lookup.md)
- [Roofer licensing in Ohio](https://roofwiseusa.com/rules/ohio/roofer-license-lookup.md)
- [Roofer licensing in Oklahoma](https://roofwiseusa.com/rules/oklahoma/roofer-license-lookup.md)
- [Roofer licensing in Oregon](https://roofwiseusa.com/rules/oregon/roofer-license-lookup.md)
- [Roofer licensing in South Carolina](https://roofwiseusa.com/rules/south-carolina/roofer-license-lookup.md)
- [Roofer licensing in Tennessee](https://roofwiseusa.com/rules/tennessee/roofer-license-lookup.md)
- [Roofer licensing in Texas](https://roofwiseusa.com/rules/texas/roofer-license-lookup.md)
- [Roofer licensing in Utah](https://roofwiseusa.com/rules/utah/roofer-license-lookup.md)
- [Roofer licensing in Vermont](https://roofwiseusa.com/rules/vermont/roofer-license-lookup.md)
- [Roofer licensing in Virginia](https://roofwiseusa.com/rules/virginia/roofer-license-lookup.md)
- [Roofer licensing in Washington](https://roofwiseusa.com/rules/washington/roofer-license-lookup.md)
- [Roofer licensing in West Virginia](https://roofwiseusa.com/rules/west-virginia/roofer-license-lookup.md)
- [Roofer licensing in Wisconsin](https://roofwiseusa.com/rules/wisconsin/roofer-license-lookup.md)
