# Pool Brain MCP by usefulapi

> Pool Brain MCP by usefulapi is a freemium MCP server. Hosted MCP connector giving Claude or ChatGPT read and write access to Pool Brain. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode, CLI
- **Website:** https://usefulapi.io/pool-brain/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/pool-brain
- **MCP Registry name:** io.usefulapi/pool-brain
- **Listing updated:** 2026-11-19

## About

The server connects a Pool Brain account to AI clients such as Claude, ChatGPT, Cursor and VS Code over remote Streamable HTTP. Once connected, an assistant can look up customers, route stop jobs, technician routes, invoices, payments and job alerts, and it can create customers, update contact and address details, or add notes to a customer record.

Authentication uses OAuth: the login page asks for a Pool Brain ACCESS-KEY and optionally a COMPANY-ID, and the server calls the Pool Brain API with that access. Of the 28 tools, 21 are read-only and 3 write data, so most clients will ask for approval before a change runs. The README also lists four account tools for usage status, feature requests, upgrades and subscription cancellation.

The product is aimed at pool and spa service companies that already run their routes, jobs and billing in Pool Brain. It is run by usefulapi, which states it is not affiliated with Pool Brain.

## Features

- **Customer and service history:** Search customers, read their contact details, addresses, notes and water body records.
- **Route and job review:** List route stop jobs in a date range and open a job to read chemical readings and status.
- **Invoice and payment lookup:** List invoices with balances due and see the payments recorded against them.
- **Technician routes and pay:** Read technician routes, stops and schedules, along with pay and payment history.
- **Customer record updates:** Create customers, change their contact or address details, and add notes.
- **OAuth sign-in per user:** Connect once through a login page without placing API keys in client config files.

## Good for

- Find customers with open alerts on their pools before a route day
- Review the week's route stop jobs and who is assigned to each route
- Check which invoices have a balance due and what payments came in recently
- Record a changed gate code or other access note on a customer record
- Create a new customer with address and water body details

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http pool-brain https://pool-brain.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://pool-brain.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pool-brain": {
      "url": "https://pool-brain.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pool-brain": {
      "type": "http",
      "url": "https://pool-brain.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pool-brain": {
      "serverUrl": "https://pool-brain.usefulapi.io/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://pool-brain.usefulapi.io/mcp
```

Enter a Name (for example "Pool Brain MCP by usefulapi"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pool-brain": {
      "type": "http",
      "url": "https://pool-brain.usefulapi.io/mcp"
    }
  }
}
```

## Tools

21 of 24 tools say they're read-only. 3 of 24 tools say they can delete or change data. From the server's own tool annotations; not verified by us.

- `poolbrain_list_companies` (says read-only): List the companies a Master API Key can reach, with companyId, name and subscription status. A company key gets an error here. Pool Brain Open API: GET /v2/company_list.
- `poolbrain_list_users` (says read-only): List staff users with userId, name, email, role, permissions and active flag. Pool Brain Open API: GET /v2/user_detail.
- `poolbrain_get_billing_defaults` (says read-only): Read the company's billing defaults (terms, tax and invoice settings). Pool Brain Open API: GET /v2/setting_billing_defaults.
- `poolbrain_list_service_levels` (says read-only): Read service level details, including the pool types linked to each service level. Pool Brain Open API: GET /v2/service_level_list.
- `poolbrain_search_customers` (says read-only): Search customers: contact details, addresses and service history. Filter by any field below. Pool Brain Open API: GET /v2/customer_detail.
- `poolbrain_list_customer_notes` (says read-only): List customer notes, optionally for one customer. Pool Brain Open API: GET /v2/customer_notes_detail.
- `poolbrain_list_quotes` (says read-only): List quotes with their line items, totals, tax, status and assigned sales rep. Pool Brain Open API: GET /v2/customer_quotes_detail.
- `poolbrain_get_pool_details` (says read-only): Read a customer's pool details, including water bodies and their associated data. Pool Brain Open API: GET /v2/customer_pool_details.
- `poolbrain_list_products` (says read-only): List the products and services of the company. Pool Brain Open API: GET /v2/product_list.
- `poolbrain_list_product_categories` (says read-only): List product and service categories, with child categories up to level 3. Pool Brain Open API: GET /v2/product_service_category_list.
- `poolbrain_list_invoices` (says read-only): List invoices with balance due, customer, dates and payment link. Pool Brain Open API: GET /v2/invoice_list.
- `poolbrain_get_invoice_details` (says read-only): Read invoice details, including product details, for one invoice or a date window. Pool Brain Open API: GET /v2/invoice_list_detail.
- `poolbrain_list_payments` (says read-only): List customer payments, with their method and amount. Pool Brain Open API: GET /v2/payment_List.
- `poolbrain_list_one_time_jobs` (says read-only): List one-time jobs with their dates and status. Pool Brain Open API: GET /v2/one_time_job_list.
- `poolbrain_get_one_time_job` (says read-only): Read one-time job details: job title, instructions, notes, inventory used and schedule status. Pool Brain Open API: GET /v2/one_time_job_list_details.
- `poolbrain_list_route_stop_jobs` (says read-only): List jobs on route stops within a date range. Pool Brain Open API: GET /v2/route_stops_job_list.
- `poolbrain_get_route_stop_job` (says read-only): Read route stop job details, including chemical readings and chemical status. Pool Brain Open API: GET /v2/route_stops_job_list_details.
- `poolbrain_list_alerts` (says read-only): List alerts on jobs, with the alert type and whether it is dismissed. Pool Brain Open API: GET /v2/alerts_list.
- `poolbrain_get_technician` (says read-only): Read technician details in a date window, optionally for one technician. Pool Brain Open API: GET /v2/technician_detail.
- `poolbrain_get_technician_routes` (says read-only): Read technician routes, with stops and schedules, for one day or a date range. Pool Brain Open API: GET /v2/technician_route_detail.
- `poolbrain_get_technician_pay` (says read-only): Read technician pay and payment history in a date window. Pool Brain Open API: GET /v2/technician_pay.
- `poolbrain_create_customer` (says it can change data): Create a customer with contact, address and water body details. Writes a new customer record. Pool Brain Open API: POST /v2/create_customer.
- `poolbrain_update_customer` (says it can change data): Update a customer's and one property's contact and address details. Pass customerId and addressId with the fields to update. Pool Brain Open API: PUT /v2/update_customer_details.
- `poolbrain_create_customer_note` (says it can change data): Add a note to a customer record. Writes a new note. Pool Brain Open API: POST /v2/create_customer_notes.

## FAQ

### Is this an official Pool Brain product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Pool Brain.

### What do I need to connect?

The login page asks for a Pool Brain ACCESS-KEY, an Open API key that Pool Brain issues on request. A COMPANY-ID is optional and can be left empty for a Master API Key.

### Can the AI change my Pool Brain data?

Yes, through three write tools: creating a customer, updating customer details and adding a customer note. Most MCP clients ask you to approve a tool call before it runs.

### What does it cost?

The Free plan includes 50 tool calls a month. Pro is $9 per month or $90 per year with 10,000 calls, and Pro+ is $39 per month or $390 per year with 100,000 calls. Each paid plan covers this server only.

### Is Pool Brain MCP by usefulapi free?

Pool Brain MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Pool Brain MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http pool-brain https://pool-brain.usefulapi.io/mcp

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

---
Source: https://ai-powered.com/mcp/pool-brain-mcp-by-usefulapi
