contractors.fyi
Server Details
US contractors ranked by city permits, permit costs and timelines, solar and generator sizing.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 8 tools
Most tools have clearly distinct purposes: solar quote evaluation (check_solar_quote) versus solar sizing (solar_estimate) are well separated, as are cost, timing, and generator sizing. The one soft spot is find_contractors (rank contractors by trade/city) versus search_contractor_records (lookup by name), which target overlapping contractor territory but are distinguished by discovery-vs-lookup intent.
Four tools use a clear verb_noun pattern (check_solar_quote, find_contractors, list_coverage, search_contractor_records) while the other four are noun phrases (generator_size, permit_timeline, project_cost, solar_estimate). The styles are mixed but all names remain readable and unambiguous in intent.
Eight tools is a well-scoped set for a permit-and-solar data domain, with each tool covering a distinct query type (coverage, cost, timeline, contractor discovery/lookup, solar quote/sizing, generator sizing). No filler or redundant tools.
The surface covers coverage discovery, cost, timeline, contractor search, and solar/generator estimation, with list_coverage serving as a sensible entry point. Minor gaps like fetching a single contractor's full profile or detail records exist, but core workflows are achievable.
Available Tools
8 toolscheck_solar_quoteCheck a solar quoteARead-onlyIdempotentInspect
Where 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.
Inputs: kw (required), city (required), price (required).
find_contractorsFind ranked contractorsARead-onlyIdempotentInspect
Contractors 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.
Inputs: city (required), kind_of_work (required), limit.
generator_sizeHome generator sizeARead-onlyIdempotentInspect
The 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.
Inputs: loads (required).
list_coverageList cities and kinds of workARead-onlyIdempotentInspect
Which 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.
Inputs: no named parameters.
permit_timelineHow long permits takeARead-onlyIdempotentInspect
Days 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.
Inputs: city (required), kind_of_work (required).
project_costJob value on permitsARead-onlyIdempotentInspect
What 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.
Inputs: city (required), kind_of_work (required), zip.
search_contractor_recordsSearch contractors by nameARead-onlyIdempotentInspect
Look 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.
Inputs: name (required).
solar_estimateSolar size, price and paybackARead-onlyIdempotentInspect
Size 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.
Inputs: city (required), uses, home_size, monthly_kwh, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
U.S. building permits, permit histories by address and contractors from city and county records.
Search and verify 79k state-licensed US contractors, checked weekly against the licensing boards.
Real quotes from local US contractors for property jobs, ranked in ~48h, plus fair-price checks.
Contractor quotes for US homeowners: start a request, see cost ranges with their sources.
Related MCP Servers
- AlicenseAqualityDmaintenanceReal-time contractor license verification across 45 US states. Verifies license status, expiration, and disciplinary history directly against state licensing board portals.453 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents and procurement systems to verify contractor licenses against official state boards, search contractors by trade and location, audit workers' comp, surety bonds and OSHA safety records, and check SAM.gov federal debarment status. It returns a deterministic ALLOW/WARN/BLOCK compliance decision plus registry health metrics for US trade contractors.MIT
- AlicenseAqualityBmaintenanceEnables listing and verifying licensed contractors across California, Texas, Washington, Oregon, and Louisiana by state, trade, city, county, license number, or business name, returning license status, expiration, classifications, owners, address, and phone.174 npmMIT
- AlicenseAqualityDmaintenanceProvides aggregated municipal development costs for US jurisdictions, including impact fees and utility connection charges, enabling AI agents to assess building feasibility quickly.1414 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.