MCP Server
contractors.fyi
fyi.contractors/contractors
What this MCP does
Analyzes US contractor permit records, rankings, project costs, permit timelines, solar estimates, solar quote pricing, and home generator sizing.
Capabilities
Tools
8
tools
check_solar_quote
Check a solar quote
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.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['city', 'price', 'kw'], 'properties': {'kw': {'type': 'number', 'maximum': 100, 'minimum': 0.5, 'description': 'System size in kW (DC)'}, 'city': {'enum': ['austin', 'los-angeles', 'new-york', 'san-francisco'], 'type': 'string'}, 'price': {'type': 'number', 'maximum': 1000000, 'minimum': 1, 'description': 'Quoted cash price in dollars, before incentives'}}}
find_contractors
Find ranked contractors
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.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['city', 'kind_of_work'], 'properties': {'city': {'enum': ['los-angeles', 'san-francisco', 'seattle', 'new-york', 'austin', 'philadelphia', 'chicago', 'nashville', 'sacramento', 'boulder', 'las-vegas', 'new-orleans', 'baton-rouge', 'raleigh', 'buffalo', 'cleveland', 'somerville', 'cambridge', 'minneapolis', 'bellevue', 'cary', 'elk-grove', 'anaheim', 'arlington-va', 'greensboro', 'naperville', 'everett', 'chattanooga', 'orlando', 'tacoma', 'riverside', 'pittsburgh', 'miami-dade'], 'type': 'string', 'description': 'City id from list_coverage, e.g. los-angeles, new-york, austin'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 25, 'minimum': 1, 'description': 'How many to return, up to 25'}, 'kind_of_work': {'enum': ['addition', 'adu', 'electrical-panel', 'ev-charger', 'heat-pump', 'pool', 'remodel', 'roofing', 'seismic-retrofit', 'solar'], 'type': 'string', 'description': 'Kind of work, e.g. roofing, solar, adu, remodel'}}}
generator_size
Home generator size
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.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['loads'], 'properties': {'loads': {'type': 'array', 'items': {'enum': ['Refrigerator', 'Sump pump', 'Furnace fan', 'Well pump', 'Central air, 3 ton', 'Heat pump, 3 ton', 'Electric water heater', 'Electric oven', 'Microwave', 'Electric dryer', 'Washer', 'Lights and outlets', 'TV, internet, computers', 'Space heater'], 'type': 'string'}, 'maxItems': 14, 'minItems': 1, 'description': 'What must run in an outage'}}}
list_coverage
List cities and kinds of work
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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
permit_timeline
How long permits take
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.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['city', 'kind_of_work'], 'properties': {'city': {'enum': ['los-angeles', 'san-francisco', 'seattle', 'new-york', 'austin', 'philadelphia', 'chicago', 'nashville', 'sacramento', 'boulder', 'las-vegas', 'new-orleans', 'baton-rouge', 'raleigh', 'buffalo', 'cleveland', 'somerville', 'cambridge', 'minneapolis', 'bellevue', 'cary', 'elk-grove', 'anaheim', 'arlington-va', 'greensboro', 'naperville', 'everett', 'chattanooga', 'orlando', 'tacoma', 'riverside', 'pittsburgh', 'miami-dade'], 'type': 'string', 'description': 'City id from list_coverage, e.g. los-angeles, new-york, austin'}, 'kind_of_work': {'enum': ['addition', 'adu', 'electrical-panel', 'ev-charger', 'heat-pump', 'pool', 'remodel', 'roofing', 'seismic-retrofit', 'solar'], 'type': 'string', 'description': 'Kind of work, e.g. roofing, solar, adu, remodel'}}}
project_cost
Job value on permits
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.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['city', 'kind_of_work'], 'properties': {'zip': {'type': 'string', 'pattern': '^\\d{5}$', 'description': 'Five-digit ZIP code'}, 'city': {'enum': ['los-angeles', 'san-francisco', 'seattle', 'new-york', 'austin', 'philadelphia', 'chicago', 'nashville', 'sacramento', 'boulder', 'las-vegas', 'new-orleans', 'baton-rouge', 'raleigh', 'buffalo', 'cleveland', 'somerville', 'cambridge', 'minneapolis', 'bellevue', 'cary', 'elk-grove', 'anaheim', 'arlington-va', 'greensboro', 'naperville', 'everett', 'chattanooga', 'orlando', 'tacoma', 'riverside', 'pittsburgh', 'miami-dade'], 'type': 'string', 'description': 'City id from list_coverage, e.g. los-angeles, new-york, austin'}, 'kind_of_work': {'enum': ['addition', 'adu', 'electrical-panel', 'ev-charger', 'heat-pump', 'pool', 'remodel', 'roofing', 'seismic-retrofit', 'solar'], 'type': 'string', 'description': 'Kind of work, e.g. roofing, solar, adu, remodel'}}}
search_contractor_records
Search contractors by name
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.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['name'], 'properties': {'name': {'type': 'string', 'maxLength': 100, 'minLength': 3, 'description': 'Business name or part of it'}}}
solar_estimate
Solar size, price and payback
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.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['city'], 'properties': {'city': {'enum': ['austin', 'los-angeles', 'new-york', 'san-francisco'], 'type': 'string'}, 'uses': {'type': 'array', 'items': {'enum': ['Central air conditioning', 'Heat pump or electric heat', 'Heat pump water heater', 'Electric dryer', 'Electric stove and oven', 'Pool pump', 'Hot tub'], 'type': 'string'}, 'default': [], 'maxItems': 7, 'description': 'What runs on electricity besides lights, fridge and outlets'}, 'home_size': {'enum': ['small', 'medium', 'large'], 'type': 'string', 'default': 'medium', 'description': 'small: under 1,500 sq ft; medium: 1,500 to 3,000; large: over 3,000'}, 'monthly_kwh': {'type': 'number', 'maximum': 20000, 'minimum': 1, 'description': 'From the bill; replaces the estimate'}, 'monthly_bill': {'type': 'number', 'maximum': 5000, 'minimum': 1, 'description': 'Monthly electric bill in dollars'}, 'electric_cars': {'type': 'integer', 'default': 0, 'maximum': 5, 'minimum': 0}, 'miles_per_car': {'type': 'number', 'default': 12000, 'maximum': 60000, 'minimum': 0, 'description': 'Miles a year, each car'}, 'price_per_kwh': {'type': 'number', 'maximum': 5, 'minimum': 0, 'description': 'Dollars per kWh from the bill; default is a typical city figure'}}}
History
Recent tool changes
Added
generator_size
Sept. 27, 2026, 2:40 a.m.
Added
check_solar_quote
Sept. 27, 2026, 2:40 a.m.
Added
solar_estimate
Sept. 27, 2026, 2:40 a.m.
Added
search_contractor_records
Sept. 27, 2026, 2:40 a.m.
Added
permit_timeline
Sept. 27, 2026, 2:40 a.m.
Added
project_cost
Sept. 27, 2026, 2:40 a.m.
Added
find_contractors
Sept. 27, 2026, 2:40 a.m.
Added
list_coverage
Sept. 27, 2026, 2:40 a.m.
Discover
Similar MCP servers
Microburbs Australian Property Data
au.com.microburbs/property-data
Provides Australian property, suburb, valuation, sales, rental, zoning, school, risk, geospatial, and census statistics.
DFX Real Estate Intelligence
io.github.Capital-W-Holdings/us-property-parcel-real-estate-debt
Provides US commercial real estate, parcel, debt maturity, bank CRE exposure, private capital, investor, ownership, occupancy, an…
Housing Intel
io.github.pipeworx-io/housing-intel
Analyzes housing markets, affordability, mortgage rates, rental yields, property data, employment, metro demand, and investment s…
Dubai Land
io.github.pipeworx-io/dubai-land
Provides Dubai Land Department data on properties, transactions, rents, valuations, projects, developers, brokers, and districts.
Homecastr Remote MCP
io.github.dhardestylewis/homecastr-remote
Provides U.S. property value forecasts across addresses, parcels, units, ZIP codes, census geographies, and states, along with ho…
Attom
io.github.pipeworx-io/attom
Provides US property search, characteristics, valuations, rental estimates, sales histories, tax assessments, school searches, an…
Worldcastr Remote MCP
io.github.dhardestylewis/worldcastr-remote
Provides probabilistic property and market forecasts at address, parcel, unit, tract, ZIP, county, state, and other geographic le…
Census
io.github.pipeworx-io/census
Provides U.S. Census housing and demographic data including home values, rents, population, homeownership, vacancies, building pe…