Ripple

Ripple — connector documentation

• MCP endpoint: https://ripple.connectorbay.com/mcp
• REST API: POST https://ripple.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://ripple.connectorbay.com/openapi.json
• Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
• Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
• Health: https://ripple.connectorbay.com/health · Tool schemas: https://ripple.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/ripple · agent@connectorbay.com

What Ripple is for

The pool-chemistry question that comes up every time a test kit gives a confusing number, an above-ground pool needs its first fill calculated, or a bottle of shock and a bottle of muriatic acid are sitting next to each other on the deck — answered from one hand-curated, CDC/industry-verified reference, with real geometry for volume and dosing math, and safety warnings that are never buried.

What it does

CDC/industry-verified ideal ranges for pH, free chlorine, total alkalinity, cyanuric acid, and calcium hardness, each with why it matters and its source (ideal_range_reference); a real-geometry pool volume calculator for rectangular, circular, and oval pools that handles a uniform depth or a shallow/deep-end pair (pool_volume_calculator); a general chemical dosing estimator using standard per-10,000-gallon dosing figures, always framed as a starting estimate rather than a precise prescription — add gradually, retest, follow the label (chemical_dosing_estimator); the critical chemical-mixing safety rules verified against CDC guidance, above all never mix chlorine products with each other or with acid and add chemical to water, never water to chemical (mixing_safety_warnings); troubleshooting for cloudy water, algae, a strong chlorine smell, and eye/skin irritation — including the CDC-backed myth correction that a strong smell or stinging eyes usually mean too little effective chlorine (chloramines) or an off pH, not "too much chlorine" (troubleshooting_guide); a comparison of test strips, liquid (DPD) test kits, and digital meters (testing_method_guide); what "shocking" a pool means and when it's typically done (shock_treatment_guide); general seasonal opening/closing guidance (seasonal_guide); and a glossary of common water-chemistry terms (pool_glossary).

What it is not

Not professional pool-service, engineering, or chemical-handling advice, and not a substitute for the specific product's label and safety data sheet, which always govern over a general estimate. The dosing estimator is deliberately conservative in how it presents itself: it gives a general planning figure using standard, widely-published dosing multipliers, not a lab-precise prescription, because real product concentration varies by brand and real pool conditions vary too — every dosing result says so, every time. The chemical-mixing safety warnings are the one place Ripple is emphatic rather than general: never mix chlorine products with each other or with acid, and always add chemical to water rather than water to chemical, because getting that wrong is a genuine, serious safety hazard (CDC estimates mishandled pool chemicals send 4,500+ people to U.S. emergency departments a year). For a specific chemical injury, exposure, or a symptom that doesn't match the general troubleshooting here, this connector points to Poison Control and emergency care rather than guessing.

Tools

Chemistry Reference

ideal_range_reference — CDC/industry-verified ideal (and acceptable) ranges for pH, free chlorine, total alkalinity, cyanuric acid, and calcium hardness, one parameter or the full set, each with why it matters and its source. Use for "what should pool pH be", "ideal free chlorine range", "what's a good cyanuric acid level". Args: parameter.

pool_glossary — Definitions of common pool water-chemistry terms (free chlorine, combined chlorine/chloramines, cyanuric acid, total alkalinity, Langelier Saturation Index, breakpoint chlorination, DPD test, and more). Use for "what is combined chlorine", "what does the Langelier index mean", "what's a DPD test". Args: term.

Calculators

pool_volume_calculator — Real pool volume in gallons and liters for a rectangular, circular, or oval pool, from its dimensions in feet — handles a uniform depth or a shallow/deep-end pair (averaged). Use for "how many gallons is my 16x32 pool with a 3 to 8 foot slope", "volume of a 24-foot round pool". Args: shape, dimensions.

chemical_dosing_estimator — A general, non-authoritative estimate of how much of a common chemical it takes to move one water-chemistry parameter from its current value to a target value, using standard per-10,000-gallon dosing figures — always framed as a starting estimate: add gradually, retest before adding more, and follow the product label. Use for "how much chlorine to raise free chlorine by 2 ppm in a 15000 gallon pool", "how much muriatic acid to lower my pH from 7.8 to 7.4". Args: pool_gallons, parameter, current_value, target_value.

Safety

mixing_safety_warnings — The critical pool-chemical safety rules, verified against CDC guidance: never mix chlorine products with each other or with acid (toxic gas risk), always add chemical to water rather than water to chemical, store incompatible chemicals separately and ventilated, and more — plus what to do if someone is exposed. Use for "can I mix bleach and muriatic acid", "is it safe to combine pool shock with algaecide", "how should I store pool chemicals".

Care & Troubleshooting

troubleshooting_guide — Troubleshooting for cloudy water, algae, a strong chlorine smell, and eye/skin irritation — including the common myth-correction that a strong smell or irritated eyes usually mean too little effective chlorine (combined chlorine/chloramines) or a pH problem, not "too much chlorine". Use for "why is my pool cloudy", "how do I get rid of algae", "why does my pool smell so strongly of chlorine", "why do my eyes sting after swimming". Args: issue.

testing_method_guide — Compares test strips, liquid (DPD) test kits, and digital meters/photometers for testing pool water — accuracy, best use case, and testing-frequency guidance for each, per CDC guidance. Use for "test strips vs liquid chlorine test", "most accurate way to test pool water", "how often should I test my pool".

shock_treatment_guide — What 'shocking' a pool means (breakpoint chlorination), when it's typically done, and the general approach and safety notes. Use for "what does it mean to shock a pool", "when should I shock my pool", "how long after shocking can I swim".

seasonal_guide — General guidance for opening or closing a pool seasonally — the typical steps and what to watch for. Use for "how do I open my pool for summer", "steps to close my pool for winter". Args: topic.

Conventions

• Read-only. Every tool reads public data or computes; nothing is written anywhere and nothing about the user is stored.
• Result envelope. ok: true with data, or ok: false with a structured error (bad_input, not_found, upstream_error). degraded lists optional sources that were unreachable.
• Rate limits. Free tier 60 tool calls/minute and 300/day per user (keyed on the user identifier supplied by the host agent, else client IP); Pro keys raise this. Over-limit calls return HTTP 429 with Retry-After. initialize and tools/list are never counted.

Support

agent@connectorbay.com · connectorbay.com/ripple/support

Ripple — Privacy Policy

Effective 24 September 2026. Unify Dynamics LLC ("we", "us"), Menlo Park, California.

What Ripple is. Ripple is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for a swimming pool and hot tub water-chemistry reference: ideal chemistry ranges, a pool volume calculator, a general chemical dosing estimator, chemical-mixing safety warnings, troubleshooting guidance, a testing-method reference, shock-treatment and seasonal guides, and a glossary. You interact with your assistant; the assistant sends us only the arguments needed for that one lookup or calculation.

What we receive. The arguments of each tool call — a chemistry parameter, pool dimensions, a current and target reading for a dosing estimate, a troubleshooting issue, or a glossary term — the technical headers needed to serve the request (an IP address or a client identifier supplied by the assistant, and a Pro API key if you have one), and standard server logs.

Everything is answered from a bundled reference file or computed locally, and nothing is stored. No request is forwarded to any third party — there is no upstream call at all, live or otherwise — and no query is logged in request bodies, recorded, or used to train anything. Pool dimensions and water-test readings you send for a calculation are used only to compute that one response and are never saved.

What we do not receive or store. We do not receive your conversation with the assistant or your name, and we do not build a profile from your queries: each request is answered independently and nothing carries over between requests. Rate-limit counters (a client identifier and timestamps) are held in memory for at most 24 hours. Hosting-provider access logs, which contain IP addresses and request paths but not request bodies, are retained for up to 30 days for security and abuse prevention.

Sub-processors. None — the entire dataset is bundled with the server and every calculation runs locally. Hosting: Vercel (United States regions).

Legal bases and your rights. Our processing is necessary to provide the service you request through your assistant. Because we store no personal data beyond short-lived logs, requests to access, correct or delete personal data are usually satisfied automatically; you can still contact agent@connectorbay.com and we will respond within 30 days. We do not sell or share personal information and do not use your data to train models.

Children. Ripple is a general-audience reference operated by the adult using the assistant. It is not directed at children, and chemical-handling decisions around a pool should always involve a responsible adult.

Changes. We will post changes here with a new effective date.

Ripple — Terms of Service

Effective 24 September 2026. These terms govern use of the Ripple connector ("the Service") operated by Unify Dynamics LLC ("we", "us").

1. The Service. Ripple returns a swimming pool and hot tub water-chemistry reference — ideal chemistry ranges, a pool volume calculator, a general chemical dosing estimator, chemical-mixing safety warnings, troubleshooting guidance, a testing-method reference, shock-treatment and seasonal guides, and a glossary — hand-curated and computed locally. It is accessed through an AI assistant or directly over MCP or HTTP.
2. General reference and estimates, not professional advice. Ripple is an independent reference tool, not affiliated with or endorsed by the CDC, the Pool & Hot Tub Alliance, any product manufacturer, or any pool service company. It does not provide professional pool-service, engineering, or medical advice. Dosing figures are general planning estimates using standard, widely-published dosing multipliers — not a lab-precise prescription — and every dosing result should be treated as a starting point: add chemicals gradually, retest before adding more, and follow the specific product's label and safety data sheet, which govern over anything in this Service.
3. Chemical safety is your responsibility. Handling pool chemicals — storage, mixing, dosing, and disposal — carries real safety risk, including the risk of toxic gas release if incompatible chemicals are combined. Ripple's chemical-mixing safety warnings are general guidance verified against public CDC guidance at build time, not a substitute for the product label, safety data sheet, or professional judgment. You are solely responsible for how you store, handle, and dose any chemical, and for seeking emergency medical help or contacting Poison Control for any actual exposure or injury rather than relying on this Service.
4. Facts change. Ideal ranges and safety guidance reflect public CDC and pool-industry reporting as of the build date stated in the Service's own data; always check the current product label and, for anything safety-critical, an official source (CDC, a Certified Pool/Spa Operator, or the product manufacturer).
5. Acceptable use. Automated use within the published rate limits is welcome.
6. Availability. The Service is provided "as is" without warranty. We may change, limit or discontinue it at any time.
7. Data. Our Privacy Policy describes what we process. In short: your query is answered from a bundled reference file or computed locally, and nothing is stored.
8. Pro keys. Optional Pro API keys are issued at our discretion, are personal to the holder and may be revoked for abuse.
9. Liability. To the fullest extent permitted by law, Unify Dynamics LLC is not liable for any loss, injury, or property damage arising from use of or reliance on the Service, including from chemical handling decisions made using its reference information. Our total liability is limited to US $100.
10. Governing law. California law; venue in San Mateo County, California.
11. Contact. Unify Dynamics LLC · agent@connectorbay.com · https://connectorbay.com/ripple

Ripple support

Email agent@connectorbay.com. We answer within two business days.

• MCP endpoint: https://ripple.connectorbay.com/mcp
• REST API: https://ripple.connectorbay.com/openapi.json
• Live status: https://ripple.connectorbay.com/health

When you report a problem, include the question you asked your agent, roughly when, and which agent you used (for example Claude, ChatGPT or Gemini). Never send us passwords, account numbers or ID numbers. Ripple never asks for them.