# contractors.fyi

> US contractors ranked by city permits, permit costs and timelines, solar and generator sizing.

- name: fyi.contractors/contractors
- version: 2026.9.25
- connection class: R0 (autonomous)
- trust: 82/100 flags: no-repository
- quality: 90/100 (strong)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/fyi.contractors%2Fcontractors
- tools: https://api.protogrid.dev/v1/servers/fyi.contractors%2Fcontractors/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "contractors": {
      "type": "http",
      "url": "https://contractors.fyi/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 98
- freshness: 100
- provenance: 55
- drivers: +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.

## Quality 90/100 (strong)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 8 of 8 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 2,126 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 12 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 8, about 2,126 tokens to load them all
- tool set hash: b2477daf86746a50708d9fa3f034120f
- tools last changed: 2026-10-08T17:23:00.196Z
- badge: [![protogrid quality](https://protogrid.dev/badge/fyi.contractors/contractors.svg)](https://protogrid.dev/servers/fyi.contractors/contractors)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-08 `permit_timeline` changed (inputSchema)
- 2026-10-08 `project_cost` changed (inputSchema)
- 2026-10-08 `find_contractors` changed (inputSchema)
- 2026-10-04 `permit_timeline` changed (inputSchema)
- 2026-10-04 `project_cost` changed (inputSchema)
- 2026-10-04 `find_contractors` changed (inputSchema)
- 2026-10-04 `permit_timeline` changed (inputSchema)
- 2026-10-04 `project_cost` changed (inputSchema)
- 2026-10-04 `find_contractors` changed (inputSchema)
- 2026-09-26 `solar_estimate` changed (inputSchema)

Full history: https://api.protogrid.dev/v1/servers/fyi.contractors%2Fcontractors/changes

## Remotes

- https://contractors.fyi/mcp (streamable-http, auth none, reachable true, uptime30d 0.94623655)

## Packages

_none_

## Tools (8)

- `check_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.
- `find_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.
- `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.
- `list_coverage`: 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_timeline`: 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_cost`: 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_records`: 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_estimate`: 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.