plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "calculatepool",
  "version": "1.0.0",
  "description": "Swimming pool math from calculatepool.com: how many gallons, litres and cubic feet a pool holds for every common shape, depth profile and above-ground wall height; how much chlorine, salt, baking soda, stabilizer, calcium chloride, muriatic acid or soda ash to add to reach a target level, in common package sizes; pump flow for a turnover time with filter area; heater BTU per hour for a temperature rise; and gallons of standard pool sizes. Same formulas and code as the calculators on the website.",
  "author": {
    "name": "Rainer Lang",
    "email": "info@calculatepool.com",
    "url": "https://calculatepool.com"
  },
  "homepage": "https://calculatepool.com",
  "keywords": [
    "pool volume calculator",
    "pool gallon calculator",
    "pool chlorine calculator",
    "pool salt calculator",
    "pool pump size",
    "pool heater size",
    "pool chemicals"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Calculate Pool",
        "shortDescription": "Pool gallons, chemicals, pumps",
        "longDescription": "How many gallons is my pool, and how much chlorine do I add? Calculate Pool answers pool owners with numbers computed by the same code as the calculators on calculatepool.com, not estimated from memory. Give the shape and size of a rectangle, round, oval, Roman, Grecian, kidney, L-shaped or freeform pool, with one depth, a shallow and a deep end, or an above-ground wall height of 48, 52 or 54 inches, and get US gallons, litres, cubic feet and the formula. Then ask how much of a chemical takes your water from its current to its target level: liquid chlorine 12.5 %, bleach, cal-hypo, dichlor or trichlor to raise chlorine; salt for a salt chlorinator; baking soda or muriatic acid for total alkalinity; stabilizer (cyanuric acid); calcium chloride for hardness; muriatic acid or soda ash for pH. Each answer gives the amount in fluid ounces, ounces or pounds, the number of common packages, the factor used and a safety reminder to test first and follow the product label. Size equipment too: the pump flow that turns the pool over in 6 or 8 hours with the matching filter area, and the heater BTU per hour to raise the water a set number of degrees. Standard pool sizes are one question away. No account and no personal data: the app needs only numbers and stores nothing.",
        "developerName": "Rainer Lang",
        "category": "Productivity",
        "capabilities": [
          "Pool volume in gallons, litres and cubic feet for eight shapes, sloped floors and above-ground wall heights",
          "Chemical amounts for chlorine, salt, alkalinity, stabilizer, calcium hardness and pH, in common package sizes",
          "Pump flow for a turnover time with filter area, and heater BTU per hour for a temperature rise",
          "Gallons of standard inground and above-ground pool sizes, with a link to the calculator page"
        ],
        "websiteURL": "https://calculatepool.com",
        "supportURL": "https://calculatepool.com/about/",
        "privacyPolicyURL": "https://calculatepool.com/privacy/",
        "termsOfServiceURL": "https://calculatepool.com/terms/",
        "defaultPrompt": [
          "How many gallons is a 16 by 32 ft pool that goes from 3 to 8 ft deep?",
          "How much 12.5% liquid chlorine raises 15,000 gallons from 1 to 3 ppm?",
          "What size heater warms 20,000 gallons by 20\u00b0F in 24 hours?"
        ],
        "brandColor": "#1F5FBF",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Pool volume from dimensions with a sloped floor. The app computes the volume with the website's formula (length x width x average depth x 7.48) and returns gallons, litres and cubic feet.",
              "prompt": "How many gallons is my 16 by 32 foot pool that goes from 3 feet to 8 feet deep?",
              "tools_triggered": "pool_volume",
              "expected_behavior": "pool_volume is called with shape rect, dimensions length 32 and width 16, shallow_depth 3, deep_depth 8. The answer states about 21,065 US gallons (79,740 litres, 2,816 cubic feet), average depth 5.5 ft, the formula, the note that steps and benches change the real figure by a few percent, and ends with the link https://calculatepool.com/?utm_source=chatgpt&utm_medium=app&utm_campaign=pilot. No product or price."
            },
            {
              "description": "Chlorine dose for a given volume and ppm change with 12.5 % liquid chlorine, in fluid ounces and package count, with the safety line.",
              "prompt": "I have a 15,000 gallon pool. Free chlorine is 1 ppm and I want 3 ppm. How much 12.5% liquid chlorine do I add?",
              "tools_triggered": "chemical_dose",
              "expected_behavior": "chemical_dose is called with chemical liquid_chlorine_12_5, gallons 15000, current 1, target 3. The answer states 32 fl oz (about 949 mL, 32.1 fl oz exactly), one 1-gallon jug, the factor 10.7 fl oz per ppm per 10,000 gal, the safety line (test first, follow the label, one chemical at a time, retest), and the link https://calculatepool.com/liquid-chlorine-calculator/?utm_source=chatgpt&utm_medium=app&utm_campaign=pilot."
            },
            {
              "description": "Two-step question: the user gives an above-ground pool size, not gallons. The app first gets the volume, then the salt for a salt chlorinator.",
              "prompt": "My above-ground pool is 24 ft round with a 52 inch wall. How much salt do I need to get from 0 to 3,200 ppm?",
              "tools_triggered": "pool_volume (or pool_facts), then chemical_dose",
              "expected_behavior": "pool_volume is called with shape round, diameter 24, above_ground_wall_in 52 (or pool_facts with kind above_ground) and returns 13,594 gallons. chemical_dose is then called with chemical salt, gallons 13594, current 0, target 3200 and returns about 363 lb (362.5), ten 40 lb bags. The answer gives both numbers, the safety line and the link https://calculatepool.com/pool-salt-calculator/?utm_source=chatgpt&utm_medium=app&utm_campaign=pilot."
            },
            {
              "description": "Pump sizing from gallons and turnover time: flow in gpm, a horsepower range, minimum filter area.",
              "prompt": "What pump flow rate do I need to turn over a 20,000 gallon pool in 8 hours?",
              "tools_triggered": "pump_size",
              "expected_behavior": "pump_size is called with gallons 20000, turnover_hours 8. The answer states 41.7 gpm (2,500 gallons per hour), a rule-of-thumb motor of 0.75-1 hp, minimum filter area sand 2.08 sq ft, cartridge 41.7 sq ft, DE 20.8 sq ft, the note to choose the pump from its curve at the system's head, and the link to calculatepool.com with utm_source=chatgpt. No pump models or prices."
            },
            {
              "description": "Heater sizing: BTU per hour for a temperature rise in a set time, plain and with the 20 % buffer for surface heat loss.",
              "prompt": "What size pool heater do I need to raise 20,000 gallons by 20 degrees F in 24 hours?",
              "tools_triggered": "heater_size",
              "expected_behavior": "heater_size is called with gallons 20000, temperature_rise_f 20, hours 24. The answer states 139,000 BTU/h required and 166,800 BTU/h with the 20 % buffer, total 3,336,000 BTU, the formula gallons x 8.34 x degrees / hours, the note on cover and heat pump derating, and the link to calculatepool.com with utm_source=chatgpt. No heater models or prices."
            }
          ],
          "negative": [
            {
              "description": "Purchase request. The app names no products, stores or prices and has no purchase links. Expected: at most the amount of chlorine needed and the calculatepool.com page, no shop or price.",
              "prompt": "Where can I buy the cheapest pool chlorine near me? Give me a link to order it."
            },
            {
              "description": "Personal data offered. The app needs only numbers and has no field for names or addresses. Expected: no personal data passed to any tool; the app answers the pool question from the numbers only, or asks for the pool size.",
              "prompt": "I'm John Smith at 12 Oak Street, Phoenix. Here's a photo of my backyard, how big is my pool?"
            },
            {
              "description": "Unrelated request. Nothing about pools, so no tool is called and no Calculate Pool content is added.",
              "prompt": "Write me a short poem about autumn."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The app sells nothing, names no products or prices and processes no payments inside ChatGPT. It links only to calculator pages on calculatepool.com."
      },
      "publication": {
        "countries": [],
        "release_notes": "1.0.0 - First version. Five read-only tools on https://calculatepool.com/mcp, computed with the same JavaScript modules as the calculators on calculatepool.com: pool_volume (gallons, litres, cubic feet for rectangle, round, oval, Roman, Grecian, kidney, L-shape and freeform pools, sloped floors, above-ground wall heights, feet or metres), chemical_dose (liquid chlorine, bleach, cal-hypo, dichlor, trichlor, salt, baking soda, stabilizer, calcium chloride, muriatic acid, soda ash: amount for a current-to-target change with common package counts and a safety line), pump_size (gpm for a turnover time, horsepower range, minimum filter area, pipe velocity), heater_size (BTU per hour for a temperature rise, with a buffer for heat loss) and pool_facts (gallons of standard inground and above-ground sizes). No sign-in, no personal data, nothing stored."
      },
      "apps": "./.app.json"
    }
  }
}