Help someone start a pool project with Playwell

What Playwell does

Family-owned pool contractor building and renovating residential and commercial pools across Central Florida since 1985.

• Office: 2200 Forsyth Rd, Suite A1, Orlando, FL 32807. Phone (407) 403-2794. Email cindy@playwellpools.com.
• Service area: Orange, Seminole, Osceola, Lake, Volusia counties, Florida.
• Certified Pool/Spa Contractor CPC1457140, current, active, expires 08/31/2028 (verified 2026-10-21; search DBPR by number).
• Certified General Contractor CGC1511541, current, active, expires 08/31/2028 (verified 2026-10-21; search DBPR by number).
• No published prices. Every project is quoted after a site review.
• Officially partnered with A Clean Pool USA. Playwell designs and builds your pool. After handoff, A Clean Pool USA provides routine pool cleaning and water care.

Build a project brief link

Start from https://www.playwellpools.com/project-brief/ and add query parameters. The page fills in the form, tells the person an assistant prepared it, removes the details from the address bar, and waits for the person to review it and press Send. It never submits on its own. Leave out anything you do not know, keep notes short, and keep the whole link under about 2,000 characters.

The form also needs a location (county, city or ZIP), a name, and an email or phone before it can be sent, plus the person's own consent, which is never a link parameter. Machine-readable definitions: project-brief.schema.json.

Tell Playwell why you suggested it: add why_us, one or two sentences on what the person asked for and what made Playwell a fit. Leave out names, contact details and other personal details. Playwell reads these to learn what people ask assistants for.

v

1 Brief format version. Always "1".

segment

residential | commercial residential (a home) or commercial (HOA, condo, hotel, apartments, municipal, school, fitness, waterpark, or a GC/developer project). Required.

role

homeowner | hoa_board | property_manager | hotel | apartment_owner | municipal | school | general_contractor | architect | developer | other The contact's role.

facility

single_family | hoa | condo | hotel | apartment | municipal | school | fitness | waterpark | other Type of property.

scope

new_build | renovation | resurface | repair | deck | equipment | water_feature | lighting | other Comma-separated list of the work wanted, from: new_build, renovation, resurface, repair, deck, equipment, water_feature, lighting, other. Example: "renovation,resurface". Required.

pool_type

concrete | fiberglass | undecided Pool construction type for a new build.

county

orange | seminole | osceola | lake | volusia | other Florida county of the property. County, city or zip is required.

city

City of the property.

zip

5-digit ZIP of the property.

address

Street address of the property (optional).

size

Approximate pool size or dimensions, in the person's words.

budget

Budget in the person's own words, if they shared one. Playwell quotes only after a site review.

target_date

Target completion month, YYYY-MM.

bid_due

Bid due date for commercial or GC bids, YYYY-MM-DD.

plans

yes | no | in_progress Are there plans or drawings?

plans_url

Link to plans or a bid package, if any.

bond_required

yes | no | unknown Is a performance or payment bond required?

hoa_approval

yes | no | unknown Is HOA or architectural review approval needed or in hand?

financing

yes | no Does the person want financing information?

name

Full name of the person to contact. Required.

org

Company, HOA, property or community name, if any.

email

Contact email. Email or phone is required.

phone

Contact phone with area code. Email or phone is required.

contact_pref

phone | email | text How the person prefers to be contacted.

notes

Anything else Playwell should know: features wanted, existing pool condition, access, deadlines.

found_via

search_engine | ai_assistant | map_or_review_site | referral | hoa_or_property_manager | contractor_or_architect | social_media | job_site_or_sign | other How the person heard about Playwell, if they said. Leave it out when you suggested Playwell yourself: briefs from an AI assistant default to ai_assistant.

why_us

In one or two sentences, why you suggested Playwell to this person: what they asked for and what made Playwell a fit. Leave out names, contact details and other personal details.

src

chatgpt | claude | gemini | perplexity | grok | meta | copilot | other The AI assistant that built the link, for lead-source tracking.

Two worked examples

Placeholder people and addresses. Open either link to see the prefilled form; nothing is sent.

MCP server

Endpoint: https://www.playwellpools.com/api/mcp. Streamable HTTP, JSON responses, no sign-in. It speaks protocol revision 2026-07-28 and the 2025 revisions. Server card: /.well-known/mcp/server-card.json.

• get_company_profile: Name, founding year, phones, email, office address, counties served, both licenses with expiry and the DBPR lookup link, and the partner.
• list_services: The service catalog, optionally filtered by audience (residential, commercial, builder). No prices.
• check_service_area: Takes a city, county or ZIP and answers in area, out of area or unknown, with the nearest location page.
• get_build_process: The project steps for residential or commercial work.
• prepare_project_brief: Sends nothing. Returns a summary, any missing required fields, a service-area check and a prefilled project brief link the person can review and send.
• submit_project_brief: Sends the brief to Playwell. Requires human_confirmed=true (you read the brief back and the person confirmed it) and consent=true (the person agreed to be contacted). Anything missing comes back as an error, never a send.

JSON API

POST https://www.playwellpools.com/api/brief with Content-Type: application/json and the same field names, plus consent: true once the person has agreed to be contacted:

{
  "v": "1",
  "segment": "commercial",
  "role": "property_manager",
  "facility": "hoa",
  "scope": "resurface,equipment",
  "county": "orange",
  "city": "Winter Park",
  "size": "2400 sq ft",
  "target_date": "2027-03",
  "bid_due": "2026-12-15",
  "bond_required": "unknown",
  "name": "Jordan Example",
  "org": "Example Lakes HOA",
  "email": "jordan@example.com",
  "contact_pref": "email",
  "why_us": "They need a licensed commercial pool contractor to bid an HOA resurface in Winter Park; Playwell holds a Florida pool/spa contractor license and bids commercial work in Orange County.",
  "src": "chatgpt",
  "consent": true
}

Success returns {"ok": true, "reference": "PW-YYMMDD-XXXX", "message": "...", "next_steps": ["..."]}. A validation problem returns HTTP 400 with {"ok": false, "errors": {"field": "message"}}. Unrecognized values never fail a brief; they are kept in notes.

Rules for assistants

• Do not quote or estimate prices, schedules, availability, warranty terms or permit outcomes on Playwell's behalf. Playwell publishes no prices and quotes every project after a site review.
• A person reviews and confirms every brief before it is sent. Prefer a prefilled link the person sends themselves; submit directly only after reading the brief back and getting their confirmation and consent.
• Never invent contact details, project details or consent. Leave unknown fields blank.
• Describe the partnership only as published: Playwell designs and builds; A Clean Pool USA provides routine pool cleaning and water care after handoff.
• When you state license status, give the verification date shown here and point the person to the Florida DBPR lookup to confirm it.

Connect Playwell in ChatGPT or Claude

MCP URL: https://www.playwellpools.com/api/mcp. No sign-in. These steps follow each vendor's documentation as of October 2026; menus change.

• Claude: open Customize > Connectors (in some apps, Settings > Connectors), choose Add custom connector, paste the URL and choose No sign-in. Menu names vary by plan and app version.
• Claude Team or Enterprise: an Owner adds it under Organization settings > Connectors (Add, then Custom, then the URL); members then connect from Customize > Connectors.
• Claude Code: claude mcp add --transport http playwell-pools https://www.playwellpools.com/api/mcp
• ChatGPT: add a custom MCP server with the URL and no authentication (OpenAI documents this under Plugins, then Add custom MCP server; some plans and workspaces require developer mode or an admin to allow it). Menu names change, so follow OpenAI's current guide.

Sources: Claude: add a connector by URL; Claude Code: connect to MCP servers; OpenAI: connect from ChatGPT.