Search / fyi.contractors/contractors
protogridR0· no sign-inUS contractors ranked by city permits, permit costs and timelines, solar and generator sizing.
v2026.9.25 · active · website · descriptor JSON · versions
{
"mcpServers": {
"contractors": {
"type": "http",
"url": "https://contractors.fyi/mcp"
}
}
}claude mcp add --transport http contractors https://contractors.fyi/mcp[mcp_servers.contractors]
url = "https://contractors.fyi/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"contractors": {
"type": "remote",
"url": "https://contractors.fyi/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"contractors": {
"type": "http",
"url": "https://contractors.fyi/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=contractors&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vY29udHJhY3RvcnMuZnlpL21jcCJ9"
}{
"servers": {
"contractors": {
"type": "http",
"url": "https://contractors.fyi/mcp"
}
}
}{
"mcpServers": {
"contractors": {
"httpUrl": "https://contractors.fyi/mcp"
}
}
}extensions:
"contractors":
enabled: true
name: "contractors"
type: streamable_http
uri: "https://contractors.fyi/mcp"
timeout: 300
protocol.modernsupports 2026-07-28 (server/discover)protocol.statelessanswers without a sessionprotocol.transportstreamable HTTPprotocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every useauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations8 of 8 tools declare readOnlyHint or destructiveHinttools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHinttools.token_costabout 2,126 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes12 tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packagepermit_timelinechangedinput schemaproject_costchangedinput schemafind_contractorschangedinput schemapermit_timelinechangedinput schemaproject_costchangedinput schemafind_contractorschangedinput schemapermit_timelinechangedinput schemaproject_costchangedinput schemafind_contractorschangedinput schemasolar_estimatechangedinput schemaShowing the latest 10. Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+dns-namespace +website +reachable +uptime-95% +updated-25d-ago -no-repository
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://contractors.fyi/mcp streamable-http | none | yes | 95% | 575 ms | 2026-07-28 | 2026-10-20 |
check_solar_quoteread-only | 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. |
find_contractorsread-only | 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. |
generator_sizeread-only | 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. |
list_coverageread-only | 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. |
permit_timelineread-only | 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. |
project_costread-only | 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. |
search_contractor_recordsread-only | 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. |
solar_estimateread-only | 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. |
Schemas: list_tools.
{
"name": "fyi.contractors/contractors",
"title": "contractors.fyi",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://contractors.fyi/mcp",
"type": "streamable-http"
}
],
"version": "2026.9.25",
"websiteUrl": "https://contractors.fyi/ai/",
"description": "US contractors ranked by city permits, permit costs and timelines, solar and generator sizing."
}