AI assistants
Connect Pooli to your AI assistant
Use Claude, ChatGPT, or Grok to look up your pools and log your work by chatting. Add Pooli once in the assistant's settings, sign in with your Pooli account, and approve. Pooli Pro and Pooli use the same account, so the same connector works for both.
Connector URL: https://mcp.pooli.app/mcp
Four steps
Signing in works like any other "sign in with" button. Your browser opens a Pooli sign-in page, you approve access, and you come back to the chat. Pooli sets up the access for you, so there is no API key to copy.
-
1
Copy the connector URL
The URL is
https://mcp.pooli.app/mcp. You will paste it into your assistant's settings. -
2
Add a custom connector in your assistant
Name it Pooli and enter the URL. The menus are different in Claude, ChatGPT, and Grok, so follow the steps for your app below. Pasting this page into a chat does not install anything. A chat message cannot add a connector, so you do this in the settings.
-
3
Sign in with your Pooli account and approve
Your browser opens a Pooli sign-in page. Sign in, approve access, and come back to the chat.
-
4
Turn it on in a chat and try it
Ask "Who am I in Pooli, and which pools do I have?" The assistant checks your account and lists your pools.
Steps by app
Checked on November 9, 2026 against each company's help pages. Menus change often. If a name below does not match your screen, look for the closest one, and trust your screen over this page.
Claude (claude.ai, Claude Desktop, mobile)
- Open Customize, then Connectors.
- Click + Add, then Add custom connector.
- Name it
Pooli. Enterhttps://mcp.pooli.app/mcp. Click Continue. - Leave the detected sign-in settings as they are. Under Authentication, Sign in now is the simplest choice. Under OAuth client, keep the default or Register automatically. Click Continue, then Add.
- Click Connect, sign in with your Pooli account, and approve.
- In a chat, click the + button at the lower left, open Connectors, and turn Pooli on.
Team and Enterprise plans: an Owner adds the connector under Organization settings, then Connectors, then Add, Custom, Web. Members then open Customize, then Connectors, and click Connect. Free plans can add one custom connector.
ChatGPT (chatgpt.com on the web)
- Go to ChatGPT Plugins.
- Click the plus button, then Add custom MCP server.
- Enter the name
Pooliand the server URLhttps://mcp.pooli.app/mcp. - Under authentication, choose OAuth. Leave the client ID and secret empty.
- Read the risk warning, click I understand and want to continue, then Create as a plugin.
- Install it, sign in with your Pooli account when asked, and approve.
- In a chat, type
@and pick Pooli.
Some older guides say you must turn on Developer mode first. The current OpenAI page does not mention it. If you cannot find Plugins on your screen, look under Settings, then Connectors, and check Developer mode. ChatGPT shows a confirmation before any tool that writes data, so review each one. Workspace admins can block custom connectors. If the option is missing in a work account, ask your admin. The phone app cannot add connectors.
Grok (grok.com)
- Go to
grok.com/connectors. - Click New Connector, then Custom.
- Enter
https://mcp.pooli.app/mcpand complete the sign-in. Sign in with your Pooli account and approve. - Start a new chat and ask for something Pooli can do.
On Grok Business and Enterprise, a team admin has to set up the connector first. Grok only accepts servers reachable on the public internet, which this one is. We could not confirm the exact labels in the Grok form. If Grok asks for a client ID, try leaving the sign-in fields empty first. If it insists, email support@pooli.app.
What it can do
Ask in plain language and the assistant picks the right tool. The server registers 22 tools: 12 personal logging tools, and 10 Pooli Pro organization tools.
Personal / logging
12 tools for pools on the signed-in account.
| Tool | What it does |
|---|---|
whoami | Shows which Pooli account you are signed in as, your organizations and role, whether Club or a technician seat is covered, and how many requests you have left this hour. |
resolve_pool | Finds a pool by a fragment of its name, such as "oasis". Leave the name out to list your pools. |
list_maintenance_catalog | Lists the maintenance tasks you can record, built in and custom. |
match_maintenance | Matches a phrase like "brushed the walls" to catalog tasks before recording. |
record_maintenance | Records maintenance tasks on a pool. |
record_note | Adds a note to a pool. It can include photos (JPEG, PNG, GIF, or WebP, up to 4 per call). |
update_note | Edits a note, or adds more photos to it. Photos are added, never replaced. |
record_test | Records a water test: pH, chlorine, alkalinity, cyanuric acid, and the other readings. |
record_product | Records a chemical or product you added, with amount and unit. |
record_meter | Records a meter reading: pressure, temperature, salt cell, feeder, or water. |
record_swim | Records a swim: number of swimmers and duration. |
record_visit | Turns one sentence into several logs. Example: "emptied the skimmers and brushed the walls at the oasis". |
Pooli Pro / organization
10 tools for the signed-in organization. They are always registered. They refuse if the account has no organization. One organization is used automatically. With several, the assistant asks which one. Accounts without an organization keep using the personal tools above.
| Tool | What it does |
|---|---|
search_customers | Finds a customer by name, email, phone, or address, and shows their pools. |
my_route | Lists stops for today, or for a date you name, with the pool, address, and which photos each stop needs. |
add_stop | Schedules a new stop for a pool, at the local time you say. |
set_org_time_zone | Owners and admins only. Changes the organization's time zone. |
start_stop | Starts the job when you arrive. It tells you which photos are still needed. |
pause_job | Pauses an in-progress job. |
resume_job | Resumes a paused job. |
add_job_photo | Adds before, after, or gate photos to the job. |
complete_job | Finishes the job. If a required photo is missing, it names it and nothing is completed. |
send_report | Shows you who will get the service report and a preview. It emails the customer only after you confirm. |
Logging tools (record_test, record_maintenance, and so on) still work during a Pro stop if you pass the poolId from my_route or start_stop.
Photos are limited to about 1.5 MB each, 4 photos per call, and 12 photos per note.
Try: "What is on my route today?" or "Start the stop at the Martinez house." or "Finish the job and send the report."
Limits, safety, and disconnecting
- The assistant acts as you. Whatever it records is saved to your real Pooli account.
- Pooli allows 10 API requests per hour, or 150 per hour with Club. A technician whose seat is covered by their organization's Club plan also gets 150. The limit is shared by all your connected assistants and keys. If you hit it, the assistant will say so.
send_reportemails your customer only after the assistant has shown you the recipients and preview and you have said yes.- Never paste a Pooli API key into a chat. You do not need one to connect.
- If sign-in fails with a "discovery" or "could not connect" error, the Pooli sign-in service may not be switched on yet. Try again later or email support@pooli.app.
- Disconnect any time in the app under AI Assistants and API Keys. Each assistant you connect shows up in your API keys list, labeled with the assistant's name and the date you connected it. Delete that entry and the assistant loses access right away. You can also remove the connector in the assistant's own settings, but only deleting the entry in Pooli shuts off its access.
Building a tool on the API? See MCP and OAuth sign-in in the API docs. A Pooli API key still works as an advanced option.
More guides
Get started
Set up your organization
Log in or install Pro, create the company, and add the first technician. Under 5 minutes. The customer book is the next step, not a gate.
First customers
Add your first few customers
They live on the Contacts tab, with pools on the same screen. Add a few by hand, or use Import via CSV.
After the stop
Send a service report
Email the full report, copy a shareable link, or send it via Messages. The customer opens it with no login.
AI assistants
Connect Pooli to your AI assistant
Add the Pooli connector to Claude, ChatGPT, or Grok, sign in with your Pooli account, and ask about your route, stops, and logs by chat.
Building a tool on the API? See MCP and the rest of the API docs.