contractors.fyi
Measured conclusion: Deep-tested. L2 outcome: tools_ok.
US contractors ranked by city permits, permit costs and timelines, solar and generator sizing.
| Author | fyi.contractors |
|---|---|
| Access | remote |
| Publisher key required | No |
| Measured state | Deep-tested |
| L1 liveness | alive |
| L1 latency | 3302 ms |
| Last measured | 2026-10-26 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"contractors.fyi": {
"url": "https://contractors.fyi/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (8)
list_coverageread-onlyWhich cities and kinds of work contractors.fyi covers, with the dates each list covers. Call this before the other tools to get valid city and kind_of_work values.
Hints: read-only yes · destructive no · idempotent yes · open-world no
find_contractorsread-onlyContractors ranked by how many jobs of this kind their city permit record shows. Returns name, license where the state publishes one, job count, typical stated job value, the ZIP codes they work in most, and a profile URL. Ranking is by volume on the public record, not quality or reviews.
Parameters:
city(required) — string — City id from list_coverage, e.g. los-angeles, new-york, austinkind_of_work(required) — string — Kind of work, e.g. roofing, solar, adu, remodellimit— integer — How many to return, up to 25
Hints: read-only yes · destructive no · idempotent yes · open-world no
project_costread-onlyWhat city permits for this kind of work stated as the job value: median and middle half, with the number of permits and their dates. Give a ZIP to get that ZIP's figure where the site publishes one. The value stated on the city permit, not the price paid.
Parameters:
city(required) — string — City id from list_coverage, e.g. los-angeles, new-york, austinkind_of_work(required) — string — Kind of work, e.g. roofing, solar, adu, remodelzip— string — Five-digit ZIP code
Hints: read-only yes · destructive no · idempotent yes · open-world no
permit_timelineread-onlyDays from permit application to issue, and from issue to final inspection, from the dates on city permits, with the number of permits and the dates they cover. Final-inspection times count finished jobs only.
Parameters:
city(required) — string — City id from list_coverage, e.g. los-angeles, new-york, austinkind_of_work(required) — string — Kind of work, e.g. roofing, solar, adu, remodel
Hints: read-only yes · destructive no · idempotent yes · open-world no
search_contractor_recordsread-onlyLook a contractor up by business name across every city covered: the city, how many permitted jobs are on its record there, and its profile URL. This searches the permit record; it does not verify a license today.
Parameters:
name(required) — string — Business name or part of it
Hints: read-only yes · destructive no · idempotent yes · open-world no
solar_estimateread-onlySize a home solar system from the monthly electric bill (or its kWh, or, with neither, the home and what runs on electricity), plus anything the home plans to add such as electric cars, then give the price range homeowners in that city paid for a system that size (Berkeley Lab records, before any tax credit, no battery), yearly savings and payback. Output per kW, heating and cooling use and the default price per kWh are rough city figures.
Parameters:
city(required) — stringuses— array — What runs on electricity besides lights, fridge and outletshome_size— string — small: under 1,500 sq ft; medium: 1,500 to 3,000; large: over 3,000monthly_kwh— number — From the bill; replaces the estimatemonthly_bill— number — Monthly electric bill in dollarselectric_cars— integermiles_per_car— number — Miles a year, each carprice_per_kwh— number — Dollars per kWh from the bill; default is a typical city figure
Hints: read-only yes · destructive no · idempotent yes · open-world no
check_solar_quoteread-onlyWhere a solar quote's price falls among what homeowners in the same city paid for a system of the same size (Berkeley Lab records, homeowner-owned systems, no battery, before incentives): a percentile, the local typical price and range, and the quote's price per watt.
Parameters:
city(required) — stringprice(required) — number — Quoted cash price in dollars, before incentiveskw(required) — number — System size in kW (DC)
Hints: read-only yes · destructive no · idempotent yes · open-world no
generator_sizeread-onlyThe smallest common home standby generator size, with 10% to spare, for the things that must run in an outage: running watts plus the biggest motor's start. Also what generator permits stated as job value, by size, where a city has enough of them. Typical appliance figures; an electrician's load calculation beats them.
Parameters:
loads(required) — array — What must run in an outage
Hints: read-only yes · destructive no · idempotent yes · open-world no
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.