[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Skimmer API and MCP server: Let your AI agent run the pool office between stops.

> Skimmer has a public API and webhooks. Enterprise accounts create their own API keys in the Integrations Center; software vendors get access after Skimmer approves them as partners. No Skimmer MCP server and no official ChatGPT or Claude connector was verified.

Skimmer gives API keys to Enterprise accounts only and runs no MCP server (checked 16 Nov 2026). Cotlet runs a hosted Skimmer MCP server with 30 tools that ChatGPT and Claude use in your own Skimmer web account, on any tier. Quotes, broadcasts and anything that reaches a customer or a tech wait for your OK.

- Free 7-day trial, no card
- Unofficial, not affiliated with Skimmer
- Page: https://cotlet.dev/integrations/skimmer-api-mcp-server

> Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Skimmer. Skimmer is a trademark of its owner. If Skimmer's own integrations cover what you need, use them first.

## What can your AI agent do in Skimmer?

- Quote a repair, then convert it to a job
- Move a day of stops to another tech
- Review skipped stops and alert notes
- Add a customer with pool and equipment
- Read AR aging and set invoice dates
- Send a season broadcast email

## Does Skimmer have an MCP server or an API?

- API keys and webhooks are on the Enterprise tier only, per the Integrations Center article.
- The Skimmer Zapier app, included from Scaling Up, triggers on new customers, products and bodies of water, and creates customers, products and work orders.
- Webhook events include service stop finished, work order finished, invoice created, payment added and customer created.

| What you need | Skimmer API | Skimmer Zapier app | Cotlet |
|---|---|---|---|
| Ask ChatGPT or Claude to do the work | No MCP server | Zaps, not chat | Hosted MCP server |
| Available on your tier | Enterprise only | Scaling Up and above | Any tier, your login |
| Quotes, routes, service notes, broadcasts | Endpoints not verified | Customers, products, work orders | 30 tools, writes after your OK |
| Run from n8n or a script | Your own code | Inside Zapier | REST, same key |

Checked 16 Nov 2026. Sources: [Help: Integrations Center (API keys, webhooks)](https://help.getskimmer.com/article/353-integrations-center), [Software Vendor Partners](https://www.getskimmer.com/partners/software-vendors), [Help: Zapier Integration](https://help.getskimmer.com/article/354-zapier-integration), [Skimmer pricing](https://www.getskimmer.com/pricing), [Help: Add, Edit, or Delete a Customer](https://help.getskimmer.com/article/121-add-edit-or-delete-a-customer-web), [Help: Import Customers From a File](https://help.getskimmer.com/article/128-import-customers-from-a-file-web), [Help: Manage Service Rates in Bulk](https://help.getskimmer.com/article/124-manage-service-rates-in-bulk-web), [Help: Customize Tags](https://help.getskimmer.com/article/99-customize-tags-web), [Help: Add a Service Location](https://help.getskimmer.com/article/54-add-a-service-location-web), [Help: Body of Water](https://help.getskimmer.com/article/56-add-edit-or-delete-a-body-of-water-web), [Help: Service Types to Bodies of Water](https://help.getskimmer.com/article/382-add-service-types-to-bodies-of-water), [Help: Manage Pool Equipment](https://help.getskimmer.com/article/59-add-and-delete-equipment-web), [Help: Build a Pool Service Route](https://help.getskimmer.com/article/96-build-a-route-web), [Help: Manage Route Assignments](https://help.getskimmer.com/article/97-manage-route-assignments-web), [Help: Route Dashboard](https://help.getskimmer.com/article/98-view-build-and-manage-routes-web), [Help: The Schedule, Calendar](https://help.getskimmer.com/article/273-the-schedule-calendar), [Help: Quotes, Create and Send](https://help.getskimmer.com/article/172-quotes-create-and-send), [Help: Quotes, Related Invoices](https://help.getskimmer.com/article/174-quotes-create-related-invoices), [Help: Quotes, Related Work Orders](https://help.getskimmer.com/article/222-quotes-create-related-work-orders-web), [Help: Jobs, Create and View](https://help.getskimmer.com/article/293-jobs-create-and-view), [Help: Jobs, Manage Work](https://help.getskimmer.com/article/294-jobs-manage-work), [Help: Jobs, Manage Invoices](https://help.getskimmer.com/article/295-jobs-manage-invoices), [Help: Work Orders](https://help.getskimmer.com/article/74-create-a-new-work-order-web), [Help: Recurring Work Orders](https://help.getskimmer.com/article/284-create-edit-or-delete-automatically-recurring-work-orders-web), [Help: Work Order Reminders](https://help.getskimmer.com/article/77-add-and-edit-recurring-work-web), [Help: Work Order Types](https://help.getskimmer.com/article/73-create-edit-and-delete-a-work-order-web), [Help: Pool Service History](https://help.getskimmer.com/article/80-view-customer-service-history-web), [Help: Service Notes and Issues](https://help.getskimmer.com/article/81-manage-service-notes-web), [Help: Service Checklist](https://help.getskimmer.com/article/61-customize-the-service-checklist-web), [Help: Readings and Dosages](https://help.getskimmer.com/article/60-customize-readings-and-dosages-web), [Help: Shopping List](https://help.getskimmer.com/article/78-add-or-delete-a-shopping-list-item-web), [Help: Products](https://help.getskimmer.com/article/85-add-a-product-web), [Help: Auto Invoicing by Customer Date](https://help.getskimmer.com/article/328-auto-invoicing-by-customer-date), [Help: Suspend Service When Payment Is Overdue](https://help.getskimmer.com/article/304-suspend-service-when-payment-is-overdue), [Help: Service Emails](https://help.getskimmer.com/article/35-customize-and-enable-service-emails), [Help: Skipped Stops](https://help.getskimmer.com/article/160-skipped-stops-skip-tracking-reasons-and-email-alerts), [Help: Broadcast Emails](https://help.getskimmer.com/article/102-send-mass-emails-to-your-customers), [Help: Marketing Suite](https://help.getskimmer.com/article/374-marketing-suite-automations-broadcasts-and-segments), [Help: Send Alerts to Your Techs](https://help.getskimmer.com/article/349-send-alerts-to-your-techs), [Help: Directory of Skimmer Reports](https://help.getskimmer.com/article/178-directory-of-skimmer-reports)

## How does the Skimmer MCP server work?

1. **Sign in to Skimmer.** Once, in a browser we host for you.
2. **Connect your AI agent.** One address in its settings.
3. **Hand it the office work.** Draft a repair quote, then approve it.

Your agent works in your own signed-in Cloud Browser. Writes, and anything that reaches a customer or a tech, wait for your OK.

## How to connect Skimmer to your AI agent

1. **Sign in to Skimmer in a Cloud Browser.** Open app.getskimmer.com in your Cotlet Cloud Browser and sign in with your own Skimmer web user.
2. **Add the Cotlet address.** Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
3. **Let the agent in.** Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

Skimmer shares the address `https://cotlet.dev/mcp/v1` with every other app you enable, so one connector covers them all. Turned Skimmer on after connecting? Refresh the connector and the 30 Skimmer tools appear.

ChatGPT:

```
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
```

Claude:

```
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
```

Cursor:

```
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}
```

Codex:

```
# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
```

n8n:

```
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: skimmer_read
```

## All 30 Skimmer MCP tools

One tool per web workflow in the Skimmer Help Center. Most take an `action`: `list` and `get` only read, the other actions write and ask first.

### Routes and the day's schedule

Read the Route Dashboard or the calendar, make permanent route changes, or move stops for one day.

- **Read the route dashboard and schedule** (`view_schedule`, read): Read the Route Dashboard or the Schedule calendar for a day or week, per tech.
- **Build and change route assignments** (`manage_route_assignments`, write, asks first): Add a route stop or change a tech's permanent route: move, frequency, end, optimize.
- **Move scheduled work** (`move_scheduled_work`, write, asks first): Move stops to another tech or day, once or permanently, from the dashboard or calendar.
- **Send tech alerts** (`send_tech_alert`, write, asks first): Send a push alert to techs' phones from the Skimmer web app.

### Customers, pools and equipment

Customer profiles, service locations, bodies of water and the equipment on them.

- **Add and update customers** (`manage_customers`, write, asks first): List, read, add or update a Skimmer customer, or set them back to Lead.
- **Import customers from a file** (`import_customers`, write, asks first): Import a customer list from an Excel or CSV file with Import from File.
- **Tag customers** (`manage_customer_tags`, write, asks first): Create, rename or delete customer tags, and add or remove a tag on a customer.
- **Add service locations and bodies of water** (`manage_service_locations`, write, asks first): Add a service location, or add, edit or delete a body of water on one.
- **Set service types for bodies of water** (`set_service_types`, write, asks first): Set the default service type of a body of water type, or assign one to a body of water.
- **Track pool equipment** (`manage_equipment`, write, asks first): List, add or update the equipment on a customer's body of water.
- **Update service rates in bulk** (`update_service_rates`, write, asks first): Change service rates for the customers on a Service Rates page with Bulk Update.

### Quotes, jobs and work orders

From a repair quote to a job with its work orders and invoices. Quotes need Scaling Up, jobs Scaling Up or Enterprise.

- **Create and send quotes** (`manage_quotes`, write, asks first): List or read quotes, create one, send it, or mark it approved or rejected.
- **Convert quotes to jobs** (`manage_jobs`, write, asks first): Convert an approved quote to a job, read a job, add work or put it on hold.
- **Create related invoices** (`create_related_invoice`, write, asks first): Create an invoice from an approved quote or a job, and save or send it.
- **Create work orders** (`manage_work_orders`, write, asks first): List, create, edit or delete a one-time work order, scheduled or unscheduled.
- **Create recurring work orders** (`manage_recurring_work_orders`, write, asks first): List, create, edit or end a work order that repeats on a schedule.
- **Set work order reminders** (`manage_work_order_reminders`, write, asks first): Add, edit or delete a reminder that tells you when a repeat job is due.
- **Set work order types** (`manage_work_order_types`, write, asks first): List, create or edit a work order type, the template for a kind of job.

### Service records

What techs recorded at each stop, the notes they flagged, and the checklist, readings and dosages they work from.

- **Read pool service history** (`view_service_history`, read): Read the service history of one customer's body of water.
- **Resolve service notes and issues** (`manage_service_notes`, write, asks first): List service notes and issues, mark one resolved or change its alert flag.
- **Set the service checklist** (`configure_service_checklist`, write, asks first): Add, edit or remove a task on the universal route stop checklist.
- **Set readings and dosages** (`configure_readings_dosages`, write, asks first): Add or edit a reading or dosage, its values and the default techs see.

### Parts and products

The shopping list of parts and chemicals to buy, and your product catalog with cost and price.

- **Keep the shopping list** (`manage_shopping_list`, write, asks first): List, add, edit, mark purchased or delete shopping list items.
- **Keep the product catalog** (`manage_products`, write, asks first): List, add, edit or discontinue a product in your Skimmer catalog.

### Billing and customer messages

Reports, invoice dates, reminders, service emails and broadcasts. Anything that emails customers waits for your OK.

- **Read reports** (`view_reports`, read): Run one of Skimmer's reports for a date range and read the result.
- **Set customer invoice dates** (`set_customer_invoice_dates`, write, asks first): Give customers their own day of the month for auto invoicing.
- **Set invoice reminders and overdue suspension** (`configure_invoice_reminders`, write, asks first): Set reminder emails for unpaid invoices and the overdue service suspension.
- **Set service and skipped stop emails** (`configure_service_emails`, write, asks first): Turn service emails and skipped stop emails on or off, and set their messages.
- **Send broadcast emails** (`send_broadcast_email`, write, asks first): Read past broadcasts or send a new email to a group of customers.
- **Build marketing campaigns** (`manage_marketing_campaigns`, write, asks first): List or build Marketing Suite automations, broadcasts and segments.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/skimmer-api-mcp-server#tools

## Who can see my Skimmer session, and how do I revoke it?

- **What we store.** Your signed-in Skimmer browser profile, AES-256-GCM encrypted, in Finland. Never your password.
- **What your agent gets.** The 30 Skimmer tools. The session cookie stays in the Cloud Browser.
- **What the session sees.** The customers, routes and billing your Skimmer user's permissions open, on your tier, and nothing more.
- **What no tool touches.** Skimmer users and permissions, payment settings, Stripe payouts, refunds and the QuickBooks Online connection.
- **If Skimmer signs you out.** You sign in again yourself, in the same Cloud Browser.
- **How to cut access.** Disable Skimmer for agents, reset the browser, or change your Skimmer password.

Cotlet never sees or stores your password: you type it yourself, and the agent only uses the session that sign-in leaves behind. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)).

## Approvals, undo and mistakes

1. **Read the equipment.** manage_equipment finds the pump marked Poor.
2. **Show you the quote.** Lines and total, before anything is saved.
3. **Save the draft.** manage_quotes `create` after your OK.
4. **Send on a second OK.** `send` is its own call, so nothing emails early.

| Action | How to put it right |
|---|---|
| Customer fields, tags, route assignments | Call the same tool again with the earlier values |
| A one-time move of stops | move_scheduled_work back to the first tech and date |
| Draft quote, work order | Edit it, or delete the work order with manage_work_orders |
| Sent quote, broadcast or tech alert | Already delivered: follow up with the customer or tech directly |

All 27 write tools ask first: by default you confirm each call, and you can switch that off per tool. The 3 read tools, the schedule, service history and reports, run at once.

MCP call:

```
{
  "name": "manage_quotes",
  "arguments": {
    "action": "create",
    "customer": "Example Homeowner",
    "lines": [
      {
        "description": "Variable speed pump",
        "quantity": 1,
        "price": 1680
      },
      {
        "description": "Pump install labor",
        "quantity": 1,
        "price": 650
      },
      {
        "description": "Plumbing fittings",
        "quantity": 1,
        "price": 150
      }
    ],
    "expires": "2026-12-01"
  }
}
```

REST:

```
curl -X POST https://cotlet.dev/api/v1/skimmer/quotes/manage \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"create","customer":"Example Homeowner","lines":[{"description":"Variable speed pump","quantity":1,"price":1680},{"description":"Pump install labor","quantity":1,"price":650},{"description":"Plumbing fittings","quantity":1,"price":150}],"expires":"2026-12-01"}'
```

Response:

```
{
  "quote": "Q-1042",
  "customer": "Example Homeowner",
  "total": 2480,
  "status": "Draft",
  "expires": "2026-12-01"
}
```

The example quotes a $1,680 pump, $650 of install labor and $150 of fittings: $2,480, saved as a draft. A cron job or n8n flow can make the same call over REST at `/api/v1/skimmer` with the same key and price, in JSON. Failed calls are free.

## How much does the Skimmer MCP server cost?

**About $21 a month** for a pool company with three techs, 3,560 credits. Your Skimmer plan stays as it is.

| Job | Calls | Credits |
|---|---|---|
| Evening check of skipped stops and alert notes | 2 × 22 | 440 |
| Work orders and due reminders | 1 × 40 | 400 |
| Repair quote, job and related invoice | 4 × 12 | 480 |
| New customer with pool, equipment and route | 4 × 8 | 320 |
| Covering a tech: move stops, send alert | 3 × 6 | 180 |
| Shopping list and product updates | 1 × 20 | 200 |
| Monday AR Aging review | 1 × 4 | 40 |
| Cloud Browser, 30 days |  | 1,500 |
| Total | 206 calls | 3,560 |

The smallest pack, 5,000 credits for $29, covers this month. More techs and more repair work use more calls.

- Free 7-day trial, no card
- 10 credits per successful call, MCP or REST
- 50 credits a day for the Cloud Browser
- Your Skimmer tier and permissions apply as they are

Credit packs are one-time purchases, not a subscription. The month above is an example built from our own assumptions, not measured customer usage.

## Skimmer MCP server: other ways to connect

| Option | What it does | Where it stops |
|---|---|---|
| Skimmer API and webhooks | Keys from the Integrations Center; webhooks for finished stops, work orders, invoices and payments. | Enterprise tier only; you write, host and fix the code. |
| Skimmer Zapier app | Zaps on new customers and products; creates customers, products and work orders. | Scaling Up and above; no quotes, routes or service notes, and no chat. |
| AI Insights in Skimmer Reports | Skimmer's own assistant answers questions about your report data. | Inside Skimmer, read only; no ChatGPT or Claude connector was verified. |
| By hand | Open each customer, route and quote in Skimmer. | One screen at a time, only while someone is at the desk. |

If you are on Enterprise and the API covers your job, use it: it is Skimmer's own route. Cotlet fits when you want ChatGPT, Claude or a script working in Skimmer on any tier, from your own login, with nothing to host.

## Who runs Cotlet

Cotlet is run by Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273) and in business since 2019. Its founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Write to contact@cotlet.dev with questions about the Skimmer tools.

## Skimmer MCP server: questions

### How do I get access?

Sign up free at https://cotlet.dev/signup?app=skimmer, turn on Skimmer under Integrations in the console and sign in at https://app.getskimmer.com/ in your Cloud Browser. Then connect your AI agent and ask it about today's routes. The trial needs no card.

### Does Skimmer have an API?

Skimmer has a public API with webhooks, but only Enterprise accounts can create API keys; software vendors get API access after partner approval (checked 16 Nov 2026). Its Zapier app, included from the Scaling Up tier, covers customers, products and work orders. No Skimmer MCP server and no official ChatGPT or Claude connector was verified. Cotlet does not use that API: it works in your own signed-in Skimmer account.

### Which Skimmer tier do the tools need?

The tools use the features your tier has. Skimmer documents quotes, the Schedule calendar and overdue suspension from Scaling Up, jobs, recurring work orders, route optimization and tech alerts on Scaling Up and Enterprise, and Marketing Suite as an add-on.

### Can the agent finish a stop or mark an item installed?

No. Skimmer documents those steps in its mobile app, where your techs record the visit. The tools work in the Skimmer web app your office uses.

### Which Skimmer user should I sign in with?

An office user whose work the agent should do, such as an admin or route manager. The agent sees only what that user's permissions open, so a user who cannot view quotes gives the agent no quotes either.

### Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 30 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.

### Is Cotlet affiliated with Skimmer?

No. Cotlet is independent and not affiliated with Skimmer.

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.
