Michigan Home Improvement Exchange

For AI agents: how to request a home-improvement estimate on behalf of your user. One JSON request in, an instant contractor match and next step out. Statewide, all trades.

OpenAPI 3.1 spec llms.txt A2A agent card Plugin manifest Contractors (JSON)

How it works

Your user asks you (Siri, ChatGPT, Gemini, or a personal agent) to find someone for a home-improvement job in Michigan.
You send one POST /v1/requests with the town or ZIP and the job type. No account or API key.
You get back matched with each contractor's published offer and the next step, or no_match with a polite message to relay. Unmatched requests are logged as demand so coverage can grow.

Example request

POST https://mi-home-improvement-exchange.clarity-pigment.workers.dev/v1/requests
Content-Type: application/json

{
  "schema_version": "1.0",
  "location": { "zip": "48430", "town": "Fenton", "state": "MI" },
  "job": { "type": "tub_to_shower", "description": "Replace old tub with a low-threshold walk-in shower" },
  "budget": { "min": 8000, "max": 15000 },
  "timing": "within_1_month",
  "contact": { "preference": "phone" },
  "agent": { "name": "ExampleAssistant", "on_behalf_of_user": true }
}

A compact flat form also works: {"zip":"48104","job_type":"walk_in_shower"}

Example response (trimmed)

{
  "request_id": "req_…",
  "status": "matched",
  "matches": [{
    "contractor_id": "pinnacle-home-improvements-mi",
    "name": "Pinnacle Home Improvements",
    "offer": {
      "estimate": "Free in-home estimate",
      "warranty": "Lifetime warranty",
      "pricing": {
        "advertised": "Bathroom replacements as low as $8,500, sometimes less (Pinnacle's published ad offer).",
        "competitive": "Competitive pricing - send us a competing written quote and we will work to beat it.",
        "note": "Exact price is quoted in person at the free in-home estimate."
      }
    },
    "next_step": { "action": "call_or_text", "contact_name": "Karen", "phone_display": "(810) 208-0433" }
  }],
  "message_for_user": "Call or text Karen at (810) 208-0433 to book a free in-home estimate for your tub to shower in Fenton."
}

When nothing matches, you get "status": "no_match" with a reason of outside_service_area, not_offered, no_listed_contractor or outside_exchange_scope, plus a message_for_user.

Fields

Field	Required	Notes
`location.zip` or `location.town`	Yes (one)	Michigan only. State defaults to MI.
`job.type`	Yes	e.g. `tub_to_shower`, `walk_in_shower`, `bathtub_replacement`, `full_bathroom_replacement`, `roof_replacement`, `kitchen_remodel`. Full list in the spec.
`job.description`	No	Plain words. Repairs are detected and only matched to contractors that do repairs.
`budget.min`, `budget.max`	No	USD.
`timing`	No	`asap`, `within_1_month`, `1_3_months`, `3_plus_months`, `flexible`, `just_researching`
`contact`	No	Only with your user's consent. `preference`: phone, sms, email, agent_relay, none.

Listed contractors

Pinnacle Home Improvements (Fenton, MI) · geneseeroofers.com
Replacements only: bathrooms (tub-to-shower, walk-in showers, bathtub, shower and full bathroom), roofs (full tear-off re-roof, shingle) and windows. No repairs. Own crew, licensed and insured (MI License #242300744), free in-home estimate. Lifetime warranty on bathroom replacements; roof and window warranty terms are 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.
Call or text Karen: (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.

Contractors set their own service areas and job types. More Michigan contractors can be listed; requests nobody covers yet are logged so coverage can grow.

Rules and privacy

Prices are never invented. An offer only shows what that contractor has published; otherwise it's a free estimate with the price quoted in person.
Requests are logged so the exchange operator and the matched contractor can follow up. Contact details are optional and should only be sent with the user's consent.
Send real user requests only. Requests are rate-limited and may be reviewed.

Michigan Home Improvement Exchange, operated by James Melki. API version 1.0.0.