# For AI assistants | Playwell Pools

> How an AI assistant can help a person start a pool project with Playwell Pools Inc.: build a prefilled project brief link, or use the MCP server or JSON API. A person always reviews and confirms before anything is sent.

## What Playwell does

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

## Build a project brief link

Base URL: https://www.playwellpools.com/project-brief/ plus query parameters. The page prefills the form, shows the person a notice that an assistant prepared it, and never submits on its own. Field definitions: https://www.playwellpools.com/agents/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.

### Examples

- Residential: a homeowner planning a new concrete pool: https://www.playwellpools.com/project-brief/?v=1&segment=residential&role=homeowner&facility=single_family&scope=new_build%2Cdeck&pool_type=concrete&county=seminole&city=Oviedo&target_date=2027-05&hoa_approval=yes&name=Alex+Example&email=alex%40example.com&contact_pref=email&why_us=They+want+a+new+concrete+pool+in+Oviedo+and+asked+for+a+licensed%2C+family-owned+builder%3B+Playwell+builds+residential+concrete+pools+in+Seminole+County.&src=claude
- Commercial: an HOA property manager pricing a resurface: https://www.playwellpools.com/project-brief/?v=1&segment=commercial&role=property_manager&facility=hoa&scope=resurface%2Cequipment&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%40example.com&contact_pref=email&why_us=They+need+a+licensed+commercial+pool+contractor+to+bid+an+HOA+resurface+in+Winter+Park%3B+Playwell+holds+a+Florida+pool%2Fspa+contractor+license+and+bids+commercial+work+in+Orange+County.&src=chatgpt

## MCP server

Endpoint: https://www.playwellpools.com/api/mcp (Streamable HTTP, no authentication). Server card: https://www.playwellpools.com/.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 a JSON body using the same field names plus `consent: true`. Success: `{"ok": true, "reference": "PW-YYMMDD-XXXX", "next_steps": [...]}`. Validation failure: HTTP 400 `{"ok": false, "errors": {...}}`.

## 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). 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.

- Claude: add a connector by URL: https://claude.com/docs/connectors/custom/remote-mcp
- Claude Code: connect to MCP servers: https://code.claude.com/docs/en/mcp-quickstart
- OpenAI: connect from ChatGPT: https://developers.openai.com/apps-sdk/deploy/connect-chatgpt

## Company facts

- Playwell Pools Inc. (also known as Don & Cindy's Playwell Pools Inc.). Family-owned, 40+ years, since 1985.
- Office: 2200 Forsyth Rd, Suite A1, Orlando, FL 32807.
- Phone: (407) 403-2794 (alternate (407) 860-4748). Email: cindy@playwellpools.com.
- Service area: Orange, Seminole, Osceola, Lake and Volusia counties, Florida.
- Certified Pool/Spa Contractor: CPC1457140, Current, Active, expires 08/31/2028, licensed since 12/12/2005, licensee Donald Robert Glenn (verified on Florida DBPR 2026-10-21).
- Certified General Contractor: CGC1511541, Current, Active, expires 08/31/2028, licensed since 07/05/2006, licensee Donald Robert Glenn (verified on Florida DBPR 2026-10-21).
- Verify any license by number at the Florida DBPR licensee search: https://www.myfloridalicense.com/wl11.asp?mode=0&SID=
- Pricing: 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.

---

HTML version: https://www.playwellpools.com/agents/
Guide for AI assistants: https://www.playwellpools.com/agents/ and https://www.playwellpools.com/llms.txt