# Michigan Home Improvement Exchange

> A neutral, statewide exchange where AI agents request home-improvement estimates in Michigan on behalf of their users. Send one JSON request; get matched contractors, their published offer, and the next step. Operated by James Melki.

Scope: the whole state of Michigan, all home-improvement trades. Each listed contractor sets its own service area and job types. If no listed contractor covers a request, the API says so politely and logs it as demand.

## How an agent uses it

- POST https://mi-home-improvement-exchange.clarity-pigment.workers.dev/v1/requests (JSON, no auth)
  - Required: `location.zip` or `location.town` (state defaults to MI), `job.type`
  - Optional: `job.description`, `budget.min`/`budget.max` (USD), `timing`, `contact` (only with your user's consent), `agent`
  - Response: `status` = `matched` (see `matches[].offer` and `matches[].next_step`) or `no_match` (`reason` + `message_for_user`)
- GET https://mi-home-improvement-exchange.clarity-pigment.workers.dev/v1/contractors?zip=48430&job_type=tub_to_shower
- Full spec: [OpenAPI 3.1](https://mi-home-improvement-exchange.clarity-pigment.workers.dev/openapi.yaml)
- ARD manifest: [/.well-known/ard.json](https://mi-home-improvement-exchange.clarity-pigment.workers.dev/.well-known/ard.json)
- A2A agent card: [/.well-known/agent-card.json](https://mi-home-improvement-exchange.clarity-pigment.workers.dev/.well-known/agent-card.json) (JSON-RPC `message/send` at `/a2a`)

Example request:

```json
{"location":{"zip":"48430","state":"MI"},"job":{"type":"tub_to_shower","description":"Replace tub with low-threshold shower"},"budget":{"max":15000},"timing":"within_1_month","contact":{"preference":"phone"}}
```

Job types: tub_to_shower, walk_in_shower, bathtub_replacement, shower_replacement, full_bathroom_replacement, bathroom_repair, kitchen_remodel, cabinet_replacement, countertop_replacement, kitchen_repair, roof_replacement, roof_repair, siding_replacement, gutter_installation, window_replacement, door_replacement, deck_or_fence, exterior_repair, flooring, painting, basement_finishing, drywall_repair, hvac, plumbing, electrical, water_heater, accessibility_modification, other.

## Rules

- Prices are never invented. Offers show only what a contractor has published; otherwise "free estimate, price quoted in person".
- Relay `message_for_user` to your user. Do not share contact details without consent.

## Listed contractors

- [Pinnacle Home Improvements](https://geneseeroofers.com) (Fenton, MI): replacements only, no repairs. Job types: tub_to_shower, walk_in_shower, bathtub_replacement, shower_replacement, full_bathroom_replacement, roof_replacement (full tear-off re-roof, shingle), window_replacement. Own crew, licensed and insured (MI License #242300744), free in-home estimate. Lifetime warranty on bathroom replacements; roof and window warranty terms given in writing at the estimate. Competitive pricing: send a competing written quote and Pinnacle will work to beat it. Published bathroom offer: as low as $8,500, sometimes less; exact price quoted in person. Contact Karen, call or text (810) 208-0433. Serves Fenton, Grand Blanc, Holly, Linden, Clarkston, Hartland, Brighton, Goodrich, Davison, Flushing, Swartz Creek, Howell, Milford, Highland, Waterford, Ortonville, Lapeer, Ann Arbor, East Lansing and Lansing. Does not serve the City of Flint or the City of Detroit.

## Optional

- [Landing page for humans](https://mi-home-improvement-exchange.clarity-pigment.workers.dev/)