# Sergio by Serviche (remote · sergio.serviche.com)

Make sure nothing falls through the cracks in your cleaning business, even when you're not watching.

- Trust score: 79/100 (medium)
- Change this week: +2
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `sergio.serviche.com`: 79/100 (this document), [markdown](https://verifymcp.io/servers/com-serviche-sergio/api-agent-mcp.md), [page](https://verifymcp.io/servers/com-serviche-sergio/api-agent-mcp)

## Channel facts

- Endpoint: `https://sergio.serviche.com/api/agent/mcp`
- Transports: `streamable-http`
- Auth: `required`
- Version: `1.0.2`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 97/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server supports Client ID Metadata Documents, the current MCP client-registration mechanism.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 53/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 24472 tokens (~235/item across 104 items; 104 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 32/100
  - Stability check failed: schema churn in the 12 days we've observed: 8 tool removals, 1 breaking changes, 0 auth/transport breaks, 4 additions.
- **Tool Coverage**: 76/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 27% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 10 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 105 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the Sergio by Serviche MCP server?

Sergio by Serviche is a hosted endpoint at https://sergio.serviche.com/api/agent/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http com-serviche-sergio 'https://sergio.serviche.com/api/agent/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "com-serviche-sergio": {
      "url": "https://sergio.serviche.com/api/agent/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "com-serviche-sergio": {
      "type": "http",
      "url": "https://sergio.serviche.com/api/agent/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.com-serviche-sergio]
url = "https://sergio.serviche.com/api/agent/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-serviche-sergio": {
      "type": "remote",
      "url": "https://sergio.serviche.com/api/agent/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-serviche-sergio --url 'https://sergio.serviche.com/api/agent/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-serviche-sergio:
    url: "https://sergio.serviche.com/api/agent/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "com-serviche-sergio": {
      "Transport": "http",
      "Url": "https://sergio.serviche.com/api/agent/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add com-serviche-sergio -t streamable-http -u 'https://sergio.serviche.com/api/agent/mcp'
```

### Other

```json
{
  "mcpServers": {
    "com-serviche-sergio": {
      "type": "http",
      "url": "https://sergio.serviche.com/api/agent/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 79, +1)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “create_client” rewrote its description, which is the text the model reads
- [security] Tool “edit_client” rewrote its description, which is the text the model reads
- [security] Tool “report_feedback” rewrote its description, which is the text the model reads
- [functional] New tool “move_address_to_contact”
- [cosmetic] “edit_client” added an optional parameter “access_method”
- [cosmetic] “edit_client” added an optional parameter “same_person_as”
- [cosmetic] “edit_client” added an optional parameter “separate_person”
- [cosmetic] “report_feedback” added an optional parameter “hypothesis”

### 2026-11-18 (score 78, +1)

- [security] Tool “catalog” rewrote its description, which is the text the model reads
- [security] Tool “create_client” rewrote its description, which is the text the model reads
- [cosmetic] “catalog” added an optional parameter “schemas”
- [cosmetic] “create_client” added an optional parameter “address”

### 2026-11-16 (score 77, 0)

- [security regression] A breaking change shipped without a version bump: still 1.0.2
- [security regression] Tool “add_training_question” was removed
- [security regression] Tool “archive_training_module” was removed
- [security regression] Tool “create_training_module” was removed
- [security regression] Tool “delete_training_question” was removed
- [security regression] Tool “edit_training_module” was removed
- [security regression] Tool “edit_training_question” was removed
- [security regression] Tool “generate_training_questions” was removed
- [security regression] Tool “remove_training_assignment” was removed
- [security] Tool “create_client” rewrote its description, which is the text the model reads
- [security] Tool “create_handbook_article” rewrote its description, which is the text the model reads
- [security] Tool “draft_handbook_edit” rewrote its description, which is the text the model reads
- [security] Tool “edit_client” rewrote its description, which is the text the model reads
- [security] Tool “edit_handbook_article” rewrote its description, which is the text the model reads
- [security] Tool “query” rewrote its description, which is the text the model reads
- [security] Tool “read” rewrote its description, which is the text the model reads
- [security] Tool “update_settings” rewrote its description, which is the text the model reads
- [cosmetic] “create_client” added an optional parameter “platform_customer”
- [cosmetic] “edit_client” added an optional parameter “platform_customer”

### 2026-11-14 (score 77, +1)

- [security regression] Stability: 0.13 → fail
- [security regression] A breaking change shipped without a version bump: still 1.0.2
- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “read” rewrote its description, which is the text the model reads
- [security] Tool “reopen_task” rewrote its description, which is the text the model reads
- [security] Tool “update_settings” rewrote its description, which is the text the model reads
- [functional regression] “reopen_task” added a required parameter “reopen_reason”, so existing callers break

### 2026-11-13 (score 76, 0)

- [functional] New tool “record_staff_event”

### 2026-11-12 (score 76, 0)

- [security] Tool “update_settings” rewrote its description, which is the text the model reads
- [functional] New tool “edit_staff_member”

### 2026-11-11 (score 76, +1)

- [security] Tool “query” rewrote its description, which is the text the model reads
- [security] Tool “update_settings” rewrote its description, which is the text the model reads
- [functional] New tool “log_call”

### 2026-11-10 (score 75, 0)

- [functional improvement] Stability: unverified → 0.03

## MCP tools (104)

### `whoami` (~84 tokens)

Who am I

Returns this agent seat: its name, role, member id, the organization it belongs to, the key id this call used, whether the owner allowed it to run SQL queries, and what it reads as (readsAs: "owner" when the owner allowed owner-level reading for this key, else its role) versus what it acts as (actsAs: always its role).

### `catalog` (~142 tokens)

What can I do

Returns `asks`, a short list of things a person can ask (give your user these when they ask what you can do), then lists every tool this seat can call right now, grouped by family, with whether each one changes anything, and under `held` the actions only a person can do (sending, money, access), each with the reason and where in the app the owner does it, and under `not_lent` every other app action agents cannot do yet, with where a person does it. Pass schemas: [tool names] to get each named tool its exact input schema (inputSchema) before calling it.

Input parameters:

- `schemas` (array)

### `report_feedback` (~195 tokens)

Report a bug or idea to the Sergio team

Files a bug report or feature request with the Sergio team. It lands in the team's one Feedback inbox, the same place the in-app help bubble's reports go, tagged with this agent seat, and the team is notified the moment it is filed. There is no other feedback channel to try. Check with your user first unless they have already told you that you may report without asking; afterwards, tell your user in one line what you sent. Never include passwords, API keys, or card numbers. Optional hypothesis: in plain words, which tool call or page failed (with the arguments you sent) and what you think is wrong and how you would fix it. Prose only, no code or commands; the team treats it as a lead to verify, not a patch to apply.

Input parameters:

- `description` (string, required)
- `hypothesis` (string)
- `kind` (string, required)
- `pageUrl` (string)

### `events_subscribe` (~207 tokens)

Subscribe to events

Create or update this seat's one event subscription. inputs: which arrivals (omit for all: text_in, text_out, email_in, email_out, call_answered, call_missed, voicemail, booking_created, booking_changed, booking_cancelled, staff_clocked_in, staff_not_clocked_in, job_finished, visit_unconfirmed). contact_types: only arrivals for these contact types. A field you omit keeps its current value, so {paused:true} pauses without touching the filter; pass inputs:null or contact_types:null to go back to all. paused: true stops delivery without losing the cursor, paused: false resumes. restart: true moves your position to now and clears your ack (the resync after cursor_expired, once you have re-read current state). Delivery starts at the moment you first subscribe. Repeating the same call changes nothing.

Input parameters:

- `contact_types`
- `inputs`
- `paused` (boolean)
- `restart` (boolean)

### `events_list` (~144 tokens)

Pull events

Returns the next events for this seat, oldest first, after `cursor` (omit it to continue from your last ack). Each event names an arrival by id (a text, email, call, or booking change); fetch its detail with read(). Delivery is at-least-once: dedupe on event_id. Pass next_cursor to the next call, and ack it with events_ack once you have processed the page. An error cursor_expired (410) means events behind your cursor were trimmed (7-day retention or backlog cap): resync through read(), then events_subscribe with restart: true.

Input parameters:

- `cursor` (string)
- `limit` (integer)

### `events_ack` (~55 tokens)

Acknowledge events

Stores `cursor` (a next_cursor you received) as this seat's high-water mark, so events_list with no cursor resumes after it. It only moves forward; an older cursor changes nothing.

Input parameters:

- `cursor` (string, required)

### `read` (~1485 tokens)

Read ANYTHING about the business: read(entity, filters). ENTITIES (key: purpose [main filters]): conversations: The inbox list of conversations [status, from, to, needs_reply, conversation_id, ...] | conversation_transcript: A client's whole history in one timeline [conversation_id, client_ref, from, to, search] | communications: Every text, email and call across the business in ONE read [from, to, direction, channel, contact_type, ...] | calls: Call log [conversation_id, client_ref, from, to, direction, ...] | bookings: Bookings by status/date/client/cleaner [status, frequency, from, to, date_axis, ...] | booking_time_logs: Cleaner clock-in/out records as a SET read [from, to, staff, client_ref, booking_id, ...] | booking_notes: Tiered booking notes + the flat booking note [booking_id] | clients: Look up contacts by id [id, name, name_words, phone, email, ...] | contact_groups: The business's live Contacts tags and lists, as the Contacts page's side nav shows them [kind] | client_standing: Visit count + last visit per client, with the client name [client_ref, client_ids] | client_case_file: Full context for a client's thread [conversation_id, client_ref, question, as_of] | owner_directives: Standing asks the owner gave the team in the team channel [status, from, to] | tasks: Tasks [status, task_id, client_ref, conversation_id, flow, ...] | cockpit_queue: The Sergio cockpit / Needs-Attention queue | activity_log: Audit trail of changes [days, from, to, search, actor, ...] | scheduling_decisions: The scheduling decision log [booking_id, days] | chat_turns: Each Sergio chat turn's AI cost and time, newest first, read from the AI usage log [turn_id, days] | staff_roster: The cleaner/staff roster, counted in code | staff_detail: Detail for one staff member [staff, kind, from, to] | staff_events: Every logged staff event org-wide [from, to, kind, staff, sentiment, ...] | client_checkins: Every client check-in / feedback record org-wide [from, to, client_ref, staff, outc…

Input parameters:

- `entity` (string, required): The entity to read, or 'catalog' to list what you can read.
- `filters` (object): Entity-specific filters (see read('catalog')). An organization id is never a filter.
- `options` (object): Paging + projection.

### `query` (~719 tokens)

Run a read-only SQL SELECT over the business database and get rows back. It is the FALLBACK, not the first move: when a read(entity) answers the question (leads, clients, conversations, bookings and the rest of read's catalog), use read, which carries the business's own definitions (e.g. open leads = read lead_pursuits active:true) that raw tables do not. Use query only when read cannot express the question (a count, a GROUP BY, a JOIN across tables, filtering on a column read() does not expose, a discount a customer used, an arbitrary aggregate). SCHEMA: query the org-scoped view schema `soul_read` (NOT public). Every table you can read is a view there, already filtered to THIS business. You never write a WHERE organization_id clause and never pass an org id. START with `client_timeline` for any question about one person or booking: every SMS, call (with AI summary), email, booking and human action in one feed (columns: channel, direction, actor, at, text, ai_summary, sentiment, category, client_id, conversation_id, booking_id). Filter client_id, ORDER BY at DESC, LIMIT. Read `SELECT * FROM schema_notes` once for column semantics (event-time columns, value meanings, columns that lie: e.g. use sent_at not created_at; contact_type = client means a real client). Never guess a column name: before you name a column of any other table you have not listed in this conversation, list THAT table's columns first (one table, never the whole schema): `SELECT column_name FROM information_schema.columns WHERE table_schema='soul_read' AND table_name='<table>'`. Reference tables unqualified (e.g. `FROM bookings`). Search_path is already soul_read. RULES: exactly ONE SELECT statement (a second statement, SET, INSERT/UPDATE/DELETE or DDL is refused). Results cap at 100 rows; the response is {rows, returned, truncated}. When truncated is true, add your OWN aggregation (COUNT/GROUP BY) or a tighter WHERE rather than paging blindly. Dates are stored as the business's local calendar; co…

Input parameters:

- `sql` (string, required): A single read-only SQL SELECT over the soul_read schema, e.g. "SELECT status, count(*) FROM bookings WHERE scheduled_date BETWEEN '2026-07-01' AND '2026-07-31' GROUP BY status".

### `findClientByIdentifier` (~91 tokens)

Look up a client ID by a single identifier (phone or email). Returns the client ID or null. Simpler than resolveClient. No creation, no merge. Use for a quick check: "is this phone number already a client?".

Input parameters:

- `type` (string, required): Identifier type: "phone" or "email".
- `value` (string, required): The identifier value (phone number or email address).

### `send_text` (~324 tokens)

Send a text (after your person confirms)

Texts a client or teammate on your person's order, from the business number, as a Manual send under the business's Sending setting. Use it whenever your person asks you to text someone now, with their words or words you wrote for them ("text today's cleaners about the weather"); create_draft leaves it for someone else to send later. First call without confirm_token: nothing is sent; you get a preview (who it goes to and the exact text) and a confirm_token. Show your person the preview word for word, and only after they say yes, call again with the same arguments and the SAME idempotency_key, plus confirm_token. Several people: one preview each, shown together, one yes covers the ones they approve. Never send something nobody asked for, or while nobody is watching; that is a draft (create_draft). Give conversationId (one-to-one: to defaults to the conversation's number); for a cleaner or contact without one, read clients (contact_type 'staff' for cleaners) for the phone, then open_conversation_by_phone.

Input parameters:

- `body` (string, required)
- `confirm_token` (string): From the preview, after your person said yes. Leave it out to get the preview.
- `conversationId` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `to` (string)

### `start_group_text` (~142 tokens)

Open a group text thread

Opens the one group text thread for 2 to 9 contacts who each have a phone, as the inbox's New conversation with several people checked does (an existing group for the same people is reused). Nothing is sent; texting it is send_conversational_message, which shows your person the words first. Pass the same idempotency_key when retrying.

Input parameters:

- `clientIds` (array, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.

### `open_conversation_by_phone` (~113 tokens)

Open a conversation for a phone number

Opens (or finds) the one conversation for a phone number nobody is saved under, as the inbox search's Text <number> does. Nothing is sent. Pass the same idempotency_key when retrying.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `phone` (string, required)

### `assign_conversation` (~155 tokens)

Assign a conversation

Assigns a conversation to a teammate, as the thread header's Assign menu does: assigned_member_id is the teammate's id (read entity org_members), or null to unassign; assigned_to (the teammate's exact name) is accepted instead. A name that is not exactly one current teammate is refused. Pass the same idempotency_key when retrying.

Input parameters:

- `assigned_member_id`
- `assigned_to`
- `conversation_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.

### `set_conversation_status` (~163 tokens)

Mark a conversation done, or reopen it

Marks a thread done (status resolved) or reopens it (status new), as the inbox's Done and Reopen do; the Quo inbox follows when the business's write setting allows. A thread that still owes the customer a reply is refused unless replyOwedOverride is true (say why to your person first). Pass the same idempotency_key when retrying.

Input parameters:

- `conversation_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `replyOwedOverride` (boolean)
- `status` (string, required)

### `bulk_clear_conversations` (~206 tokens)

Clear old conversations in bulk

Clears every thread older than a cutoff at once, as the inbox's bulk Clear does (owner or admin seats only): mode date clears threads quiet for olderThanDays (default 14) or since cutoff (ISO date); mode leads clears threads a lead follow-up owns. includeTasks also closes their open tasks; includeReplyOwed also clears threads the customer wrote last in (date mode). The Quo inbox follows when the business's write setting allows. Pass the same idempotency_key when retrying.

Input parameters:

- `cutoff` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `includeReplyOwed` (boolean)
- `includeTasks` (boolean)
- `mode` (string)
- `olderThanDays` (integer)

### `snooze_conversation` (~166 tokens)

Mute a conversation for a few minutes

Mutes a conversation until snoozed_until (ISO 8601, in the future), at most 10 minutes from now (a later time is cut to 10 minutes), as the inbox's Mute does while someone is on a call. note is optional. For a later follow-up, use set_conversation_reminder. Pass the same idempotency_key when retrying.

Input parameters:

- `conversation_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `note` (string)
- `snoozed_until` (string, required)

### `unsnooze_conversation` (~97 tokens)

Unmute a conversation

Ends a conversation's mute now, as the inbox's Unmute does. Pass the same idempotency_key when retrying.

Input parameters:

- `conversation_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.

### `set_conversation_reminder` (~171 tokens)

Set a reminder on a conversation

Adds a reminder on a conversation, as the thread's bell does: remind_at (ISO 8601) and an optional note become a task due then. hide_until_due: true also tucks the thread away until the reminder is due (a reply from the person brings it back). Pass the same idempotency_key when retrying; a repeat returns the first reminder.

Input parameters:

- `conversation_id` (string, required)
- `hide_until_due` (boolean)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `note` (string)
- `remind_at` (string, required)

### `dismiss_conversation_reminders` (~100 tokens)

Dismiss a conversation's reminders

Dismisses every open reminder on a conversation, as the bell's Dismiss does. Pass the same idempotency_key when retrying.

Input parameters:

- `conversation_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.

### `link_conversation_to_client` (~145 tokens)

Link a conversation to a contact

Links a conversation to a contact, as the inbox's Link to a contact does: if the contact already has a one-to-one thread, it is folded into this one, and an email thread's address is saved to the contact. Sergio learns the correction for later emails. Pass the same idempotency_key when retrying.

Input parameters:

- `client_id` (string, required)
- `conversation_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.

### `move_address_to_contact` (~162 tokens)

Move an email address or number to the right contact

Says who an email address or phone number on a contact really is, as an email's This is someone else does: pass exactly one of to_client_id, new_contact_name, or none=true. Its emails, texts and calls on that contact move with it and its next message lands on the new owner. Pass the same idempotency_key when retrying.

Input parameters:

- `client_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `kind` (string, required)
- `to` (required)
- `value` (string, required)

### `merge_conversations` (~135 tokens)

Merge two conversations

Moves everything in conversation_id (messages, calls, emails, tasks) into target_conversation_id and removes the empty one, as the thread menu's Merge does. It cannot be split back. Pass the same idempotency_key when retrying; the same pair merges once.

Input parameters:

- `conversation_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `target_conversation_id` (string, required)

### `track_conversation_as_lead` (~164 tokens)

Track a conversation as a new lead

Opens a lead for this thread's contact, as the thread header's Track this as a new lead does, for a customer asking about new work. request is what they asked for, in a line. Refused when lead follow-up is off, the thread has no contact, or the contact is staff, an applicant or spam. Pass the same idempotency_key when retrying.

Input parameters:

- `channel` (string)
- `conversation_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `request` (string)

### `disposition_conversation` (~162 tokens)

Record a quiet thread's disposition

Records why a quiet thread needs no reply, as the clear gate's picker does: spam (the contact becomes spam; its lead work stops and its Quo card is tagged when the business's write setting allows), lead (the contact becomes a lead), reengage (tags the contact for a later marketing touch) or no_action. It does not clear the thread. Pass the same idempotency_key when retrying.

Input parameters:

- `conversation_id` (string, required)
- `disposition` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.

### `start_conversation_flow` (~131 tokens)

Start a flow on a conversation

Starts a flow on a conversation, as the thread's flow picker does: flowId names an active flow (read entity flows); its steps become tasks with deadlines. label is optional. Pass the same idempotency_key when retrying.

Input parameters:

- `conversation_id` (string, required)
- `flowId` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `label`

### `close_conversation_flow` (~155 tokens)

Mark a conversation's flow done

Marks a conversation's flow done, as the flow chip's Mark done does. conversationFlowId names the flow when the thread has more than one. outcome (for example declined) closes it early without marking its steps done; close_note is optional. Pass the same idempotency_key when retrying.

Input parameters:

- `close_note` (string)
- `conversationFlowId` (string)
- `conversation_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `outcome` (string)

### `remove_conversation_flow` (~130 tokens)

Remove a flow from a conversation

Takes one flow off a conversation, as the flow chip's Remove does; its open step tasks are removed. conversationFlowId names the flow. reason is optional. Pass the same idempotency_key when retrying.

Input parameters:

- `conversationFlowId` (string, required)
- `conversation_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `reason` (string)

### `edit_draft` (~175 tokens)

Edit or discard a draft

Edits a draft in a conversation's draft box, as a person typing in it does: body, subject (email), whyNote, isReady, or status 'discarded' to throw it away. Nothing is sent; a person still presses Send. draft_id comes from create_draft or read. Pass the same idempotency_key when retrying.

Input parameters:

- `body` (string)
- `draft_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `isReady` (boolean)
- `status` (string)
- `subject`
- `whyNote`

### `send_email` (~223 tokens)

Send an email (after your person confirms)

Emails a client from the business mailbox on your person's order, as a Manual send under the business's Sending setting. First call without confirm_token: nothing is sent; you get a preview (to, subject and the exact text) and a confirm_token. Show your person the preview word for word, and only after they say yes, call again with the same arguments and the SAME idempotency_key, plus confirm_token. replyToEmailId threads it as a reply to that inbound email.

Input parameters:

- `body` (string, required)
- `confirm_token` (string): From the preview, after your person said yes. Leave it out to get the preview.
- `conversation_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `replyToEmailId` (string)
- `subject` (string, required)
- `to` (string, required)

### `create_draft` (~159 tokens)

Draft a message

Writes a message into a client conversation's draft box. It never sends: a person on the team reviews the exact text and presses Send in Sergio, where the organization's sending policy applies. Give conversationId, or clientId to use that client's conversation. Pass the same idempotency_key when retrying; a repeat returns the original draft.

Input parameters:

- `body` (string, required)
- `channel` (string)
- `clientId` (string)
- `conversationId` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.

### `redraft_lead_step` (~178 tokens)

Redraft a lead's upcoming text step

Rewrites the text of a lead's upcoming step that a person sends, from the conversation so far, as the journey's Update draft does (one AI draft, billed like the composer's Draft). Refused for a call step, a step Sergio sends on its own, or a step already past. Nothing is sent. task_id is the lead (read entity tasks); step_id is the step's id from the lead's journey. Pass the same idempotency_key when retrying.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `step_id` (string, required)
- `task_id` (string, required)

### `set_lead_outcome` (~374 tokens)

Record a lead's outcome

Records what happened with a lead, as the lead card's Close menu and taps do. tap: quoted (they have a price); booked (closes it won, on the booking when one for them exists, else on your word); confirmed_booked (the same as booked); call_back_on (date YYYY-MM-DD, or at as an ISO time: pauses the lead until then; the pause ends by itself on that date, when a message goes either way, or when a step's date is changed); not_interested (lost; lostReason is one of "Timing / availability", "Price", "Went elsewhere / not needed", "Out of scope / area", or their own words for Other; a lead that just went quiet is not lost, it goes cold on its own); keep_pursuing; acknowledge_reply (their last message needs no answer: follow-ups resume); tracked_by_mistake; dismiss_plan; replied_on_site (stepKey: the Reply step answered on a lead site); undo_close (reopens a lead Sergio closed on its own, so the same evidence never closes it again; a contact made not-a-lead becomes a lead again, and Quo follows when the business's write setting allows). Nothing is sent. Pass the same idempotency_key when retrying.

Input parameters:

- `at` (string)
- `date` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `lostReason` (string)
- `stepKey` (string)
- `tap` (string, required)
- `task_id` (string, required)

### `move_lead_journey` (~132 tokens)

Move a lead to another journey

Moves a lead to another follow-up journey (segmentId, as Settings > Lead follow-ups names them: read the lead program), at the same place in the sequence, as the lead's journey tag does. Pass the same idempotency_key when retrying.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `segmentId` (string, required)
- `task_id` (string, required)

### `hold_follow_ups` (~145 tokens)

Hold automatic follow-ups

Puts a lap's automatic follow-ups on hold, as its Hold follow-ups switch does: lead follow-ups, a feedback check-in and a review request all obey the one hold. No step goes out on its own; each is drafted for a person. Turning them back on is your person's, in the app. Pass the same idempotency_key when retrying.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `task_id` (string, required)

### `hold_lead_follow_ups` (~147 tokens)

Hold automatic follow-ups

Puts a lap's automatic follow-ups on hold, as its Hold follow-ups switch does: lead follow-ups, a feedback check-in and a review request all obey the one hold. No step goes out on its own; each is drafted for a person. Turning them back on is your person's, in the app. Pass the same idempotency_key when retrying.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `task_id` (string, required)

### `edit_lead_step` (~266 tokens)

Change a step in a lead's follow-ups

Changes one step of one lead's follow-ups, as the journey list does. Send one or more of: dueAt (ISO time, or null for the plan's timing; must stay after the step before it), channel ('message', 'email', 'call', 'reply', or null for the plan), removed (true takes it out, false puts it back), keep: true (its custom text is still right after the latest conversation). Or addAfter ('message', 'email', 'call' or 'reply') alone to add a step after it (the new step's id comes back). The step's words are your person's to change in the app. step_id comes from the lead's journey. Pass the same idempotency_key when retrying.

Input parameters:

- `addAfter` (string)
- `channel`
- `dueAt`
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `keep` (boolean)
- `removed` (boolean)
- `step_id` (string, required)
- `task_id` (string, required)

### `update_payroll_settings` (~203 tokens)

Change payroll settings

Changes one payroll setting per call, as Payroll settings on the staff page does: providerPayFallbackPct (0 to 1), providerPayDefault ({ unit: visit or hour, cents }), or payHoursFrom (booked or approved_time_logs). Staff pay settings only; no money moves. Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `payHoursFrom` (string)
- `providerPayDefault` (object)
- `providerPayFallbackPct` (number)
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.

### `add_staff_member` (~228 tokens)

Add a staff member

To rename someone already on the roster, pass rename_staff_id with the new name; the old spelling keeps pointing at them. Otherwise adds a field worker to the roster, as the staff page's Add staff does: name (a profile with that name is reused, never duplicated), optional employment_type (employee or contractor), or client_id to make an existing contact staff (a name clash comes back as name_conflict; call again with link_to_staff_id to link instead). This gives them no sign-in; inviting someone to Sergio is the owner's. Nothing is sent. Pass the same idempotency_key when retrying.

Input parameters:

- `client_id` (string)
- `employment_type` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `link_to_staff_id` (string)
- `name` (string, required)
- `rename_staff_id` (string)

### `edit_staff_member` (~328 tokens)

Change a staff member's details

Changes one staff member (staff_id, from read staff_roster or staff_detail) as Save in their staff drawer does. Pass only what changes: employmentType (employee reads Staff, contractor reads Contractor), payRateCents with payRateUnit (hour, visit or percent; null clears), publicBookable (customers can pick them on the booking page), portalBookable (clients can pick them in the portal), payHidden (hide their pay from payroll views), venmo / zelle (tip handles; empty clears). To rename, use add_staff_member with rename_staff_id. Ending someone's employment is done by a person on the staff page. Nothing is sent. For several people, call once per person. Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `employmentType` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `payHidden` (boolean)
- `payRateCents`
- `payRateUnit`
- `portalBookable` (boolean)
- `publicBookable` (boolean)
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.
- `staff_id` (string, required)
- `venmo`
- `zelle`

### `clear_staff_availability_override` (~135 tokens)

Clear a worker's schedule change for a date

Clears one field worker's schedule change on a date (YYYY-MM-DD), so their normal weekly hours apply again, as Clear on the staff calendar does. To set a change, use set_staff_availability. Nothing is sent. Pass the same idempotency_key when retrying.

Input parameters:

- `cleaner_name` (string, required)
- `date` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.

### `set_staff_weekly_hours` (~243 tokens)

Save a field worker's weekly hours or details

Replaces the regular weekly hours of the workers named in staffNames with exactly the windows in entries (day_of_week 0 = Sunday to 6 = Saturday, HH:MM times; several windows a day allowed; a named worker with no entries has no regular hours). Workers not in staffNames are untouched. Omit entries to leave hours alone and only save profiles (the worker's details: email, phone, allergies, and venmo / zelle, which change only for a seat allowed to change payment handles). For one date only, use set_staff_availability. If the new hours no longer cover a worker's upcoming Sergio visits, those visits are released and a task is filed for a person. Nothing is sent. Pass the same idempotency_key when retrying.

Input parameters:

- `entries` (array)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `profiles` (array)
- `staffNames` (array, required)

### `record_staff_event` (~236 tokens)

Record a warning, kudos or note for a field worker

Adds one entry to a field worker's (staff_id) staff log and their attendance and feedback counts: kind warning (a conduct warning), kudos, note, client_feedback (with sentiment), or sick, late, no_show. A sick day, late arrival or no-show that cancelled or moved a visit is recorded by cancelling or reassigning that booking with the cleaner's reason instead, so do not record those twice. occurredOn is YYYY-MM-DD (default today); body is the detail in plain words. Nothing is sent to the worker. Pass the same idempotency_key when retrying.

Input parameters:

- `body` (string, required)
- `bookingId` (string)
- `clientId` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `kind` (string, required)
- `occurredOn` (string)
- `sentiment` (string)
- `staff_id` (string, required)

### `add_staff_scheduling_rule` (~234 tokens)

Add a scheduling rule for a field worker

Adds a plain-English scheduling rule for one field worker (staff_id), as Add rule on their Rules tab does, e.g. "Won't work Tuesdays" or "Only mornings in Brooklyn". hardness hard (default: never scheduled against it) or soft (avoided when possible). The same wording again updates the same rule. Answers the worker's rules with their ids. Remove one with remove_staff_scheduling_rule; read every rule with read staff_scheduling_rules. Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `hardness` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `plainEnglish` (string, required)
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.
- `staff_id` (string, required)

### `remove_staff_scheduling_rule` (~177 tokens)

Remove a field worker's scheduling rule

Removes one plain-English scheduling rule (ruleId, from add_staff_scheduling_rule or read staff_scheduling_rules) from a field worker (staff_id), as remove on their Rules tab does. Answers the rules left. Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.
- `ruleId` (string, required)
- `staff_id` (string, required)

### `review_cleaner_roster` (~163 tokens)

Sort a cleaner name from bookings

Sorts one cleaner name found on bookings, as the Get started card's Review your cleaner roster does: action add (adds them to the roster and links their past jobs), not_staff (this name is not one of our cleaners), or link (it is staffId under another spelling; links their past jobs). Nothing is sent. Pass the same idempotency_key when retrying.

Input parameters:

- `action` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `name` (string, required)
- `staffId` (string)

### `answer_google_review_match` (~158 tokens)

Link or unlink a Google review and a client

Says which client wrote a Google review, as Contacts > Needs review does: client_id links it (also moving a review linked to the wrong client), client_id null says no client wrote it (unlinking a linked review). A link closes that client's review requests. Find reviews and their ids with read google_reviews. Nothing is sent or posted to Google. Pass the same idempotency_key when retrying.

Input parameters:

- `client_id` (required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `review_id` (string, required)

### `edit_contacts` (~276 tokens)

Edit contacts in bulk

Applies one edit to up to 5000 contacts, as the Contacts page's selection bar does: op add_to_list / remove_from_list (listId), add_tags / remove_tags (tagIds), set_service_category (value residential, commercial, both or null), set_lead_source (value thumbtack, google_lsa, yelp, bark, website_form, google_business_profile, referral, booking_software, direct, web_chat, other or null), set_type (type client, lead, applicant, other), archive, mark_spam (at most 500 for the last three; a type change or spam tags or untags the Quo card when the business's write setting allows). Each contact answers succeeded, skipped (already so) or failed. Pass the same idempotency_key when retrying; every op is safe to repeat.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `ids` (array, required)
- `listId` (string)
- `op` (string, required)
- `tagIds` (array)
- `type` (string)
- `value`

### `accept_smaller_sync` (~170 tokens)

Accept a smaller sync

Applies a booking sync Sergio held back for returning far fewer bookings than it holds, once, and makes that size the new normal, as Accept this smaller sync on Data sources does. job_id is the held sync's import job. Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `jobId` (string, required)
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.

### `upload_spreadsheet` (~238 tokens)

Upload a spreadsheet to import

Uploads a bookings or clients spreadsheet (CSV text) and queues its import, as Upload on the Imports page does; nothing is written to customers until its columns are checked. source is the import source spelling, not a free label: a booking platform's key for its bookings export (for example bookingkoala), that key plus -clients for its clients export (for example bookingkoala-clients), or spreadsheet / spreadsheet-clients for a generic spreadsheet export. read('data_sources') names this business's platform. Returns jobId. Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `csv` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.
- `source` (string, required)

### `start_spreadsheet_import` (~127 tokens)

Start an uploaded spreadsheet's import

Starts the import of a spreadsheet uploaded with upload_spreadsheet, as Start in the import drawer does: Sergio checks its columns; a confident mapping imports, an uncertain one answers status needs_review and waits for review_import_mapping. Pass the same idempotency_key when retrying.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `jobId` (string, required)

### `review_import_mapping` (~200 tokens)

Approve or discard a spreadsheet's columns

Settles an import waiting at the column review, as its review card does: decision approve (the import runs with the confident columns plus keepFields; keepValues and assignValues teach status words) or discard (nothing is written). Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `assignValues` (array)
- `decision` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `jobId` (string, required)
- `keepFields` (array)
- `keepValues` (array)
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.

### `set_scanner_on` (~178 tokens)

Turn a Scanner on or off

Turns one of the business's Scanners on or off, as the On switch in Automations > Scanners does. A Scanner is only ever on or off (never a trial mode). scanner_id comes from read('scanners'). Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `enabled` (boolean, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.
- `scanner_id` (string, required)

### `create_scanner` (~279 tokens)

Create a Scanner

Saves a new Scanner, as Save on New Scanner does: question (required), and optionally name, inputs, look-again timing, who gets the task, due rule, destination, contact types, and enabled (on or off; there is no trial mode). Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `assignee_kind` (string)
- `assignee_member_id`
- `contact_types`
- `destination` (string)
- `draft` (boolean)
- `due_hours`
- `due_rule` (string)
- `enabled` (boolean)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `inputs` (array)
- `look_again_kind` (string)
- `look_again_minutes`
- `name` (string)
- `question` (string, required)
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.
- `refinements` (array)
- `rollup` (boolean)

### `edit_scanner` (~285 tokens)

Edit a Scanner

Changes a Scanner, as its editor on the Scanners page does: any of name, question, inputs, look-again timing, who gets the task, due rule, destination, contact types, enabled. scanner_id comes from read('scanners'). Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `assignee_kind` (string)
- `assignee_member_id`
- `contact_types`
- `destination` (string)
- `draft` (boolean)
- `due_hours`
- `due_rule` (string)
- `enabled` (boolean)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `inputs` (array)
- `look_again_kind` (string)
- `look_again_minutes`
- `name` (string)
- `question` (string)
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.
- `refinements` (array)
- `rollup` (boolean)
- `scanner_id` (string, required)

### `delete_scanner` (~155 tokens)

Delete a Scanner

Deletes a Scanner, as Delete in its editor does; the tasks it already made stay. To pause it instead, use set_scanner_on with enabled false. Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.
- `scanner_id` (string, required)

### `create_contact_list` (~110 tokens)

Make a contact list

Makes a contact list on the Contacts page, or answers the live one with that name. Add people to it with edit_contacts (op add_to_list). Pass the same idempotency_key when retrying.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `name` (string, required)

### `edit_contact_list` (~124 tokens)

Rename or archive a contact list

Renames a contact list or archives it (archived: true; its people keep their other lists), as the Contacts page's list menu does. Pass the same idempotency_key when retrying.

Input parameters:

- `archived` (boolean)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `list_id` (string, required)
- `name` (string)

### `create_contact_tag` (~106 tokens)

Make a contact tag

Makes a tag on the Contacts page, or answers the live one with that name. Tag people with edit_contacts (op add_tags). Pass the same idempotency_key when retrying.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `name` (string, required)

### `edit_contact_tag` (~117 tokens)

Rename or archive a contact tag

Renames a Contacts tag or archives it (archived: true), as the Contacts page's tag menu does. Pass the same idempotency_key when retrying.

Input parameters:

- `archived` (boolean)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `name` (string)
- `tag_id` (string, required)

### `create_campaign` (~1017 tokens)

Build a campaign (saved as a draft)

Builds a campaign as the Campaigns page's New campaign does, always saved as a draft: name, the messages (steps: the opener first, each { template, delayDays?, channel? text | email | call }), offer, audience (audience_filter, or audience_source { kind: list | view | people | filter }), caps and send window. Templates use Sergio's merge tags ({{Client First Name}}, {{User Company}}, {{Offer}}, {{Offer Expiry Date}} and the rest listed on steps.template), never a hard-coded business or client name. audience_filter takes the builder's own keys (visits, days since last booking, last booking total, days since last contact, frequency, services); audience_mode rolling (default) keeps adding people as they qualify (evergreen), fixed freezes the audience at start. read campaigns returns this vocabulary and existing campaigns to copy from. Sergio's audience rules apply unless your person asks otherwise, so leave those fields out: it leaves out anyone with an upcoming booking (audience_filter.noUpcomingBooking) and anyone another campaign reached lately (contact_floor_days, the business's window, 30 days unless changed), and new matches join on their own (audience_mode rolling). The people a rule leaves out show in the campaign as Excluded by Sergio, where a person can include one anyway, so another campaign running over the same people is not something to warn about. The answer's audience_rules says all this in one sentence: tell your person that sentence when you report the draft. A credit your person names is the offer the message describes (see offer_text); never ask them to apply credits. Nobody is enrolled and nothing is sent until it starts: start_campaign (your person sees every message first and says yes), or Start campaign in the app; turning on automatic sending stays the owner's. Pass the same idempotency_key when retrying; a repeat returns the same draft.

Input parameters:

- `audience_filter` (object): Who the campaign is for, as the builder's Audience section sets it. Use these keys only; every key given must hold.
- `audience_mode` (string)
- `audience_source`: Instead of audience_filter, follow Contacts: { kind: "list", listId } | { kind: "view", viewId } | { kind: "people", clientIds: [...] } | { kind: "filter", query } (a Contacts filter).
- `auto_send` (boolean)
- `color`
- `contact_floor_days`
- `cooldown_days` (integer)
- `daily_cap` (integer)
- `enrollment_source` (string)
- `hold_negative_feedback` (boolean)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `min_days_since_visit` (integer)
- `name` (string, required)
- `offer_expiry_days`: Days the offer stays good after each person's first message; {{Offer Expiry Date}} quotes the date.
- `offer_text`: offer_text is the offer, written the way the builder writes it ("$25 off your next booking", "10% off your next booking", "a free fridge clean"); {{Offer}} sends those exact words to every recipient.…
- `queue_expiry_days` (integer)
- `send_time_local`
- `send_window_hours`
- `short_code`
- `steps` (array)
- `text_by_email_subject`: The one email subject every text step takes when it goes by email to someone Sergio may not text. An email step keeps its own.

### `edit_campaign` (~794 tokens)

Edit, pause or archive a campaign

Edits a campaign as its builder does (the fields you pass change; the rest stay), or pauses (status paused, pulls back its queued sends) or archives it. Turning automatic sending off (auto_send false) is open. To start or resume one, use start_campaign (your person confirms first). Held for the owner, refused with where: starting it here, turning automatic sending on, and changing the messages, audience, caps or send window of a started campaign that sends automatically (turn auto_send off first, in the same call or before). Templates, offer and audience_filter follow the same rules as create_campaign (listed on each field). Pass the same idempotency_key when retrying.

Input parameters:

- `audience_filter` (object): Who the campaign is for, as the builder's Audience section sets it. Use these keys only; every key given must hold.
- `audience_mode` (string)
- `audience_source`: Instead of audience_filter, follow Contacts: { kind: "list", listId } | { kind: "view", viewId } | { kind: "people", clientIds: [...] } | { kind: "filter", query } (a Contacts filter).
- `auto_send` (boolean)
- `campaign_id` (string, required)
- `color`
- `contact_floor_days`
- `cooldown_days` (integer)
- `daily_cap` (integer)
- `dismissed_tips` (array)
- `enrollment_source` (string)
- `hold_negative_feedback` (boolean)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `min_days_since_visit` (integer)
- `name` (string)
- `offer_expiry_days`: Days the offer stays good after each person's first message; {{Offer Expiry Date}} quotes the date.
- `offer_text`: offer_text is the offer, written the way the builder writes it ("$25 off your next booking", "10% off your next booking", "a free fridge clean"); {{Offer}} sends those exact words to every recipient.…
- `queue_expiry_days` (integer)
- `send_time_local`
- `send_window_hours`
- `short_code`
- `status` (string)
- `steps` (array)
- `text_by_email_subject`: The one email subject every text step takes when it goes by email to someone Sergio may not text. An email step keeps its own.

### `delete_campaign` (~122 tokens)

Delete a campaign

Deletes a campaign as Delete on its card does: its queued messages are pulled back first; messages already sent stay in their threads. It cannot be undone; to stop it for now, edit_campaign with status paused. Pass the same idempotency_key when retrying.

Input parameters:

- `campaign_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.

### `start_campaign` (~279 tokens)

Start a campaign (after your person confirms)

Starts a draft or paused campaign on your person's order, as Start campaign does: it enrolls the people waiting and drafts their first message; starting sends nothing by itself. First call without confirm_token: nothing changes; you get a preview (every message's exact words, how many people it reaches now, the audience rules, and whether the business's Sending lets a person's messages go out) and a confirm_token. Show your person the preview word for word, and only after they say yes, call again with the same arguments and the SAME idempotency_key, plus confirm_token. If the preview says Sending is switched off, tell your person that plainly with the link; only the owner turns it on, in Sergio, and you never change it. A campaign with a message Sergio sends on its own is the owner's to start, in the app. To send the drafted messages once it has started, use send_campaign_messages.

Input parameters:

- `campaign_id` (string, required)
- `confirm_token` (string): From the preview, after your person said yes. Leave it out to get the preview.
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.

### `send_campaign_messages` (~246 tokens)

Send a campaign's ready messages (after your person confirms)

Sends a started campaign's drafted messages that are ready, on your person's order, as Send in its Ready to send does, as Manual sends under the business's Sending setting, spread over the campaign's send window. First call without confirm_token: nothing is sent; you get a preview (each person and the exact finished text they get, up to 50 at a time) and a confirm_token. Show your person the preview word for word, and only after they say yes, call again with the same arguments and the SAME idempotency_key, plus confirm_token: exactly the messages shown are sent. If Sending is switched off the answer says so with the link; only the owner turns it on, in Sergio. Never send something nobody asked for.

Input parameters:

- `campaign_id` (string, required)
- `confirm_token` (string): From the preview, after your person said yes. Leave it out to get the preview.
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.

### `start_history_import` (~163 tokens)

Import message history from a connected inbox

Starts importing the past messages of a connected inbox into Sergio, as Import history on Data sources does: source openphone (Quo) or gmail, or transcripts; days back (default 90). The account must already be connected (connecting is the owner's, in Settings). A second start while one is running returns that job; it carries on in the background. Nothing is sent. Pass the same idempotency_key when retrying.

Input parameters:

- `days` (integer)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `source` (string, required)

### `cancel_import` (~118 tokens)

Cancel a running import

Cancels a running import (message history or a spreadsheet), as Cancel in the import drawer does; what it already brought in stays. job_id comes from start_history_import or the import list. Pass the same idempotency_key when retrying.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `job_id` (string, required)

### `record_tools_access` (~209 tokens)

Record the business's other tools

Records the tools the business uses today and whether Serviche was given access to each, as Get started's Your tools step does: action pick (tools: [{ id } or { name }]), none, mark (tool, provided, note) or unmark (tool). Nothing leaves Sergio. Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `action` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `note` (string)
- `provided` (boolean)
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.
- `tool` (string)
- `tools` (array)

### `declare_lead_sources` (~186 tokens)

Say where leads come from

Records where the business gets its leads (keys from the setup guide list, for example thumbtack, google_lsa, yelp, website, other; other needs its words), as Get started's lead sources step does. An answer only: it opens and sends nothing. Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `keys` (array, required)
- `other` (string)
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.

### `approve_follow_up_style` (~256 tokens)

Approve the lead journeys drafted from follow-up answers

Records the owner's approval of the lead journeys drafted from how the business follows up today, as Get started's follow-up step does. The journeys must already be saved as the answers draw them (answers: firstChannel, speed, followUpChannel, tries, overDays, giveUpDays; sources: the journeys approved, as lead sources such as site_thumbtack or web_form; Get started's lead sources map to them). Save the journeys first through the lead follow-up journeys setting (settings.lead_pursuit_program), drawn from these answers; otherwise the route answers journeys_not_saved. Writes no journey and sends nothing. Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `answers` (object, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.
- `sources` (array, required)

### `set_flow_archived` (~148 tokens)

Archive or un-archive a flow

Archives a flow as its Archive on the Automations page does (archived true): it leaves the flow pickers and the router but is kept, and runs in progress are unaffected. archived false un-archives it. flow_id comes from read('flows'); archive several by calling once per flow. Pass the same idempotency_key when retrying.

Input parameters:

- `archived` (boolean, required)
- `flow_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.

### `set_flow_on` (~139 tokens)

Turn a flow on or off

Turns a flow on or off, as its On switch on the Automations page does. Turning it on runs the same publish check (a refusal says what is missing); turning it off ends its runs in progress. flow_id comes from read('flows'). Pass the same idempotency_key when retrying.

Input parameters:

- `flow_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `is_active` (boolean, required)

### `edit_flow` (~144 tokens)

Rename a flow or change its description

Changes a flow's name or description, as its editor on the Automations page does. Send only what changes. Its steps and how it starts are set in the editor (how it starts: set_flow_start). flow_id comes from read('flows'). Pass the same idempotency_key when retrying.

Input parameters:

- `description` (string)
- `flow_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `name` (string)

### `set_staff_availability` (~233 tokens)

Set a field worker's availability for a date

Sets one field worker's availability for a date, or a date range (end_date, up to 92 days): a day off (day_off: true), one shift (available_from + available_until, HH:MM), or split shifts (windows). It replaces that day's override; hours equal to the weekly default clear it. Nothing is sent to anyone. Returns the override ids and any booking conflicts the change creates, for a person to resolve. Pass the same idempotency_key when retrying; a repeat returns the original override ids.

Input parameters:

- `available_from` (string)
- `available_until` (string)
- `cleaner_name` (string, required)
- `date` (string, required)
- `day_off` (boolean)
- `end_date` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `reason` (string)
- `windows` (array)

### `create_task` (~150 tokens)

Create a task

Adds a task to the team's work queue, optionally tied to a client or conversation and due at a time (ISO 8601). Pass the same idempotency_key when retrying; a repeat returns the original task.

Input parameters:

- `client_id` (string)
- `conversation_id` (string)
- `description` (string)
- `due_date` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `priority` (string)
- `title` (string, required)

### `complete_task` (~135 tokens)

Complete a task

Marks a task done, recorded as completed by this seat. A flow-step task also completes its step, as the check box does. Pass the same idempotency_key when retrying; a repeat returns the task, reports what the original call applied, and changes nothing if the task changed since.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `note` (string)
- `task_id` (string, required)

### `skip_task` (~140 tokens)

Dismiss a task as not needed

Dismisses a task as not needed (terminal, distinct from done). A client check-in needs a skip_reason. Pass the same idempotency_key when retrying; a repeat returns the task, reports what the original call applied, and changes nothing if the task changed since.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `note` (string)
- `skip_reason` (string, required)
- `task_id` (string, required)

### `reopen_task` (~161 tokens)

Reopen a task

Reopens a done or dismissed task, clearing its completion. reopen_reason says briefly why (required, it rides the audit row). A lead follow-up (pursuit) task is refused: reopening it can queue a message, so a person does it. Pass the same idempotency_key when retrying; a repeat returns the task, reports what the original call applied, and changes nothing if the task changed since.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `reopen_reason` (string, required)
- `task_id` (string, required)

### `snooze_task` (~142 tokens)

Move a task's due time

Moves a task's due time (ISO 8601 with offset). A flow-step task shifts its later steps by the same gap, as in the app. Pass the same idempotency_key when retrying; a repeat returns the task, reports what the original call applied, and changes nothing if the task changed since.

Input parameters:

- `due_date` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `task_id` (string, required)

### `assign_task` (~137 tokens)

Assign a task

Assigns a task to a team member (their member id from read('team_members') or whoami), or unassigns it with null. Pass the same idempotency_key when retrying; a repeat returns the task, reports what the original call applied, and changes nothing if the task changed since.

Input parameters:

- `assigned_to` (required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `task_id` (string, required)

### `update_task` (~209 tokens)

Edit a task

Edits a task as a person can on its row: title, description (details), due_date (ISO 8601 with offset, or null to clear), priority, client_id or conversation_id (null unlinks). Send only the fields to change. A flow-step task shifts its later steps when its due time moves, as in the app. Pass the same idempotency_key when retrying; a repeat returns the task, reports what the original call applied, and changes nothing if the task changed since.

Input parameters:

- `client_id`
- `conversation_id`
- `description`
- `due_date`
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `priority` (string)
- `task_id` (string, required)
- `title` (string)

### `delete_task` (~132 tokens)

Delete a task

Deletes a task outright, as the task menu's Delete does. It cannot be undone; to say a task is not needed, use skip_task instead. Deleting a Scanner's task tells that Scanner it was wrong. Pass the same idempotency_key when retrying; a repeat returns the first delete's answer.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `task_id` (string, required)

### `complete_tasks_bulk` (~169 tokens)

Mark several tasks done

Marks up to 200 tasks done at once, as the Tasks page's selection bar does; each closes exactly as its own check box would. Kinds that close only from their own screen (lead follow-ups, flow steps, questions, staff check-ins, rules) are refused per task and reported in results. action "reopen" is the Undo. Pass the same idempotency_key when retrying; a repeat returns the first answer and moves nothing again.

Input parameters:

- `action` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `ids` (array, required)

### `accept_suggestion` (~218 tokens)

Accept a Sergio suggestion

Accepts a Sergio suggestion card, as the card's accept does. action "accept" commits it as a task (optionally with your edited title, details or due, ISO 8601 or null); "accept_no_task" resolves it without a task when the work already happened. A card whose move would send a message, move money, open to the public or grant access is refused with where the owner does it; draft instead (create_draft, or run_suggestion_now on a draft card). Pass the same idempotency_key when retrying; a repeat returns the first answer.

Input parameters:

- `action` (string)
- `due`
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `suggestion_id` (string, required)
- `taskDescription` (string)
- `taskTitle` (string)

### `dismiss_suggestion` (~127 tokens)

Dismiss a Sergio suggestion

Dismisses a Sergio suggestion card, as the card's dismiss does. reason is optional ("Not needed" tells the Scanner that raised it that it was wrong). Pass the same idempotency_key when retrying; a repeat returns the first answer.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `reason` (string)
- `suggestion_id` (string, required)

### `run_suggestion_now` (~179 tokens)

Run a Sergio card now

Runs a Sergio card's move now, as the card's "Run this now" does. action_type is the card's action type (for example create_draft). A move that sends, moves money, opens to the public or grants access is refused with where the owner does it; a move that writes to an outside system (booking changes) is not lent to agents yet. Pass the same idempotency_key when retrying; the move keys on the card, so it never runs twice.

Input parameters:

- `action_type` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `suggestion_id` (string, required)

### `dismiss_notification` (~126 tokens)

Dismiss a notification

Dismisses a notification card (action "dismiss"), snoozes it for its own snooze time ("snooze"), or marks it read ("read"), as the card's controls do. Pass the same idempotency_key when retrying.

Input parameters:

- `action` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `notification_id` (string, required)

### `create_client` (~349 tokens)

Add a contact

Adds a contact as the Add contact form does: a name, a phone (with area code) or an email is enough. contact_type picks client (default), lead, applicant, staff or other. A phone or email that already belongs to a contact, or else the exact name of one, is answered with that contact (duplicate_contact, matchedOn, its id in the message); use it, or pass createAnyway: true for a different person who shares it (two people can share a name; a shared phone stays with its owner). Look a person up first with findClientByIdentifier or read. Pass the same idempotency_key when retrying; a repeat returns the contact the first call made. platform_customer links the contact to its booking platform customer id (platform defaults to the company's one booking platform); an id another contact holds is refused with that contact. address {line, apt, zip} saves the client's service address with the contact (its default), through the same address book as add_client_address; a line without a 5-digit ZIP refuses the whole call (zip_required) and creates nothing. A booking for this client then books at that address.

Input parameters:

- `address` (object)
- `contact_type` (string)
- `createAnyway` (boolean)
- `email` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `name` (string)
- `phone` (string)
- `platform_customer` (object)

### `read_company_document` (~134 tokens)

Have Sergio read an uploaded document

Has Sergio read one uploaded company document (document_id from read entity company_documents) for Flows and recurring tasks it describes, as the setup guide's Your SOPs step does. Creates nothing; returns the suggestions (decide each with decide_company_document_suggestion). A document already read returns its list without a second read.

Input parameters:

- `document_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.

### `decide_company_document_suggestion` (~178 tokens)

Approve, edit or skip a document suggestion

Decides one suggestion Sergio read from an uploaded document (itemId from read_company_document or read entity company_documents), as the setup guide's taps do: approve creates the flow as a draft that is OFF or the recurring task PAUSED (nothing runs or sends until a person turns it on); edit rewrites its sentence; skip drops it. approve with sentence applies that edit first. A repeat returns the same created row.

Input parameters:

- `action` (string, required)
- `document_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `itemId` (string, required)
- `sentence` (string)

### `edit_client` (~439 tokens)

Edit a contact

Edits a contact as the contact card's pencil does: name, phone (with area code), email, company_name, address (keep its zip if it had one), access_method (how the crew usually gets in, e.g. someone is home, key is hidden, lockbox; for one visit or this and later visits of a plan use add_booking_note kind access_method instead), access_notes, special_instructions, has_pets, pet_details, preferred_cleaner, preferences, availability_notes, contact_type. Send only the fields to change; a contact always keeps a name, phone or email. expected (field -> the value you read) refuses the save if someone changed it since (stale_write). A rename reaches the Quo card when the business's write setting allows. Renaming a staff contact to a name another staff member holds answers name_conflict with that person: ask your user, then send the name again with same_person_as (that staff id: this contact is them) or separate_person: true (a different person; the name stays on this contact only). platform_customer links the contact to its booking platform customer id; an id another contact holds is refused with that contact. Pass the same idempotency_key when retrying.

Input parameters:

- `access_method`
- `access_notes`
- `address`
- `availability_notes`
- `client_id` (string, required)
- `company_name`
- `contact_type` (string)
- `email`
- `expected` (object)
- `has_pets`
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `name`
- `pet_details`
- `phone`
- `platform_customer` (object)
- `preferences`
- `preferred_cleaner`
- `same_person_as` (string)
- `separate_person` (boolean)
- `special_instructions`

### `add_client_note` (~143 tokens)

Add a note to a client

Adds an office note to a client's record (category general, access, preference, alert or scheduling; pinned keeps it surfaced). Only the team sees it; nothing is sent. Pass the same idempotency_key when retrying; a repeat returns the original note.

Input parameters:

- `category` (string)
- `client_id` (string, required)
- `content` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `pinned` (boolean)

### `log_call` (~266 tokens)

Log a call to a contact

Logs a phone call the team made outside the phone system (a cell phone, a desk phone) on a contact, as the contact pane's Log a call does. outcome: answered (someone picked up), no_answer, or voicemail (you left one). Optional note (what was said) and at (ISO time the call happened; now when left out, never in the future). The call joins the contact's history and moves their Lead status: an answered call reads In discussion; no answer or a voicemail, with nothing back from them, reads Contacted (a quote, a booking or a status a person set still wins). The answer carries leadStatus, where they stand now. Calls made through the connected phone system are recorded already; do not log those. Nothing is sent. Pass the same idempotency_key when retrying; a repeat returns the original call.

Input parameters:

- `at` (string)
- `client_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `note` (string)
- `outcome` (string, required)

### `pin_client_note` (~140 tokens)

Pin or unpin a client note

Pins a note to the top of a contact's card (pinned: true) or unpins it (false), as the note's pin on the contact card does. noteId comes from read (entity client notes). Pass the same idempotency_key when retrying.

Input parameters:

- `client_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `noteId` (string, required)
- `pinned` (boolean, required)

### `delete_client_note` (~128 tokens)

Delete a client note

Deletes a note from a contact's card outright, as the note's Delete does. It cannot be undone (the activity log keeps what it said). Pass the same idempotency_key when retrying; a repeat after the note is gone answers success.

Input parameters:

- `client_id` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `noteId` (string, required)

### `set_handbook_toolshed_sharing` (~180 tokens)

Keep an article out of the Toolshed, or share it again

Excludes one handbook article from Toolshed sharing (its shared rules are withdrawn) or includes it again, as the article's Toolshed sharing line does. Shared rules are generalized so no one can tell which business they came from. Pass the same idempotency_key when retrying. An owner-level change: Sergio tells the owner after it is made.

Input parameters:

- `excluded` (boolean, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `reason` (string): Why you are doing this, in one sentence. The owner sees it in the notice Sergio sends after the change.
- `sopId` (string, required)

### `create_handbook_article` (~383 tokens)

Add a handbook article

Adds an article (SOP) to the handbook, as Handbook > Admin > New SOP does: title, content_md (markdown), optional category, tags, audience (cleaner = staff, va = office), bucket (A, B or C), licensed (from a franchise or licensed manual: never shared outside the business). Nothing is sent. Before adding anything to the handbook, search the sops read entity by the topic (search finds by meaning): when an article already covers it, put the new text into that article (edit_handbook_article with its full content_md, the new lines placed where they belong, or draft_handbook_edit) instead of a new one; create a new article only when none fits, and say which closest article you found and why it did not fit. Audience comes from the person's words: cleaner SOPs, cleaning standards or staff = cleaner; policies, office or VA = va; when the words do not say, ask in one line. Ask which place, in one line naming both, when two places fit the person's words equally well: two articles that both match; a place the person named outright is never a tie. The proposed change is the confirmation, so never ask "should I add this?" first. Pass the same idempotency_key when retrying; a repeat returns the same article.

Input parameters:

- `audience` (string)
- `bucket` (string)
- `category` (string)
- `content_md` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `licensed` (boolean)
- `tags` (array)
- `title` (string, required)

### `edit_handbook_article` (~410 tokens)

Edit a handbook article

Edits a handbook article as its Edit page does: title, content_md, category, tags, audience, bucket, is_published, exclude_from_suggestions. Send only the fields to change (sop_id from read entity sops); content_md replaces the whole body, so read the article in full (read sops with id) and send all of it with the change in place. Saving supersedes pending suggestions on it. Before adding anything to the handbook, search the sops read entity by the topic (search finds by meaning): when an article already covers it, put the new text into that article (edit_handbook_article with its full content_md, the new lines placed where they belong, or draft_handbook_edit) instead of a new one; create a new article only when none fits, and say which closest article you found and why it did not fit. Audience comes from the person's words: cleaner SOPs, cleaning standards or staff = cleaner; policies, office or VA = va; when the words do not say, ask in one line. Ask which place, in one line naming both, when two places fit the person's words equally well: two articles that both match; a place the person named outright is never a tie. The proposed change is the confirmation, so never ask "should I add this?" first. Pass the same idempotency_key when retrying.

Input parameters:

- `audience` (string)
- `bucket`
- `category`
- `content_md` (string)
- `exclude_from_suggestions` (boolean)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `is_published` (boolean)
- `sop_id` (string, required)
- `tags` (array)
- `title` (string)

### `archive_handbook_article` (~113 tokens)

Remove a handbook article

Takes an article out of the handbook as its Delete does: it is marked inactive and kept (edit_handbook_article cannot bring it back; a person can). Pass the same idempotency_key when retrying.

Input parameters:

- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `sop_id` (string, required)

### `draft_handbook_edit` (~369 tokens)

Have Sergio draft an article edit

Asks Sergio to draft an edit to an article, as the article's Ask Sergio does: with context, the smallest change that does what it says; without, a general cleanup. The draft waits as a pending version (review_handbook_edit approves or rejects it). When the person gave the exact words to add, edit_handbook_article with them is the direct change; use this when they asked for a rewrite or cleanup. Before adding anything to the handbook, search the sops read entity by the topic (search finds by meaning): when an article already covers it, put the new text into that article (edit_handbook_article with its full content_md, the new lines placed where they belong, or draft_handbook_edit) instead of a new one; create a new article only when none fits, and say which closest article you found and why it did not fit. Audience comes from the person's words: cleaner SOPs, cleaning standards or staff = cleaner; policies, office or VA = va; when the words do not say, ask in one line. Ask which place, in one line naming both, when two places fit the person's words equally well: two articles that both match; a place the person named outright is never a tie. The proposed change is the confirmation, so never ask "should I add this?" first. Pass the same idempotency_key when retrying; a repeat returns the same draft without asking the model again.

Input parameters:

- `context` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `sop_id` (string, required)

### `review_handbook_edit` (~157 tokens)

Approve or reject a drafted article edit

Approves (the draft becomes the article's text) or rejects a pending drafted version of an article (version_id from draft_handbook_edit or read entity sop_versions), as the article's Approve and Reject do. The same decision again answers success; the other decision on a reviewed version is refused. Pass the same idempotency_key when retrying.

Input parameters:

- `action` (string, required)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `sop_id` (string, required)
- `versionId` (string, required)

### `log_handbook_question` (~152 tokens)

Log a handbook question

Logs a question the handbook does not answer, as Handbook's Ask a question does (optional sop_id of the article it is about, asked_by_name, channel app, sms, call or in-person). Pass the same idempotency_key when retrying; a repeat returns the same question.

Input parameters:

- `asked_by_name` (string)
- `channel` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `question` (string, required)
- `sop_id` (string)

### `answer_handbook_question` (~202 tokens)

Answer a handbook question

Answers or files a logged question (question_id from read entity sop_questions), as Handbook > Admin > Questions does: answer, status (open, answered, needs_new_sop, sop_updated, dismissed), sop_id it belongs to, notes. save_as_sop: true has Sergio write the answer into the handbook (the matching article, or a new one). Pass the same idempotency_key when retrying; a repeat does not save it to the handbook twice.

Input parameters:

- `answer` (string)
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `notes` (string)
- `question_id` (string, required)
- `save_as_sop` (boolean)
- `sop_id`
- `status` (string)

### `update_settings` (~1083 tokens)

Change organization settings

Changes one or more of the organization's settings, as a person on the Settings page would, with this seat's role deciding what it may change. Sending controls, anything that opens a page to the public, payments, spend increases, and access are never available to agents. Owner-level and confirm-level settings are available when the owner turned on "Let this agent change owner settings" for this seat on the Team page (on by default for an agent the owner adds); the owner is told about each such change, with your justification if you give one. Pass changes as { "<setting key>": value }. Keys: notification_settings.enabled (toggle); notification_settings.rules (editor); settings.booking_platforms (list); urgency_settings.do_now_lead_minutes (number); urgency_settings.task_lookahead_days (number); org.chime_enabled (toggle); settings.reply_chime.delayMinutes (number); settings.reply_chime.repeatSeconds (number); settings.reply_chime.muteMinutes (number); settings.schedule.view (enum); settings.schedule.startHour (number); settings.schedule.weekStart (enum); settings.holiday_behavior (enum); settings.holiday_audience (enum); org_holidays (list); settings.field_schedule_requests_enabled (toggle); settings.field_self_block (toggle); platform_email_rules (list); settings.review_alert_at_or_below (number); blocked_senders (list); auto_assignment_config.enabled (toggle); auto_assignment_config.pool (list); auto_assignment_config.auto_classify_flows (toggle); settings.holidays_enabled (toggle, null resets it); booking_settings.policies.clock.autoClockOut (toggle); booking_settings.policies.clock.signatureRequired (toggle); booking_settings.policies.clock.geofenceRadiusHighM (number); booking_settings.policies.clock.geofenceRadiusMediumM (number); booking_settings.policies.clock.geofenceRadiusFallbackM (number); booking_settings.policies.notifications.cleanerMessageMode (enum); settings.persona_name (text, null resets it); settings.hand_sent_text_signoff (toggle); settings.cri…

Input parameters:

- `changes` (object, required): Setting key -> new value. Send only the keys that change.
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `justification` (string): Optional: why the business wants this change. Shown to the owner in the notice Sergio sends after an owner-level change.

### `set_flow_start` (~578 tokens)

Change how a flow starts

Changes how one of this business's flows starts ("Starts when" in Automations) and whether it is on, exactly as the Automations editor's save does. starts_when "contact" means "You add it to a contact": nothing starts the flow by itself. Any other value starts it automatically on that booking event. Switching a start off ("contact") or turning a flow off (active false; its runs in progress end) is open to this seat. Starting a flow on an event or turning a flow on is owner-level: available only when the owner turned on "Let this agent change owner settings" for this seat; the owner is told about each such change. A flow that starts on every upcoming job (starts_when_words says so) turns on only after a person confirms how many jobs it covers, which this tool cannot do: it comes back refused with that count, and the owner turns it on in Automations. Picking a booking event here makes a flow start only on jobs from then on. read("flows") shows each flow and its current start. Events: booking_created (New job booked); booking_changed (Job changed); booking_cancelled (Job cancelled); staff_clocked_in (Cleaner clocked in); staff_not_clocked_in (Cleaner hasn't clocked in); job_finished (Job finished); visit_unconfirmed (Past job not marked done in the booking platform); card_declined (Card declined); review_received (Review received); review_low_rating (Low-star Google review); staff_on_the_way (Cleaner tapped On the way); staff_clocked_out (Cleaner clocked out); staff_running_late (Cleaner says they are running late); staff_not_on_the_way (Cleaner hasn't tapped On the way); staff_not_clocked_out (Cleaner hasn't clocked out); staff_clocked_in_twice (Cleaner clocked in on two jobs at once); staff_schedule_request (Cleaner asked to change their schedule). Pass the same idempotency_key when retrying; a repeat returns the original result.

Input parameters:

- `active` (boolean): true turns the flow on, false turns it off.
- `first_booking_only` (boolean): With an event: true starts it only on a client's first booking. Omitted keeps the current choice.
- `flow_id` (string, required): The flow id (from read("flows")).
- `idempotency_key` (string, required): Your id for this operation (8-128 of A-Z a-z 0-9 . _ : -). Reuse it on every retry of the same operation; use a new one for a new operation.
- `justification` (string): Optional: why the business wants this. Shown to the owner with an owner-level change.
- `starts_when` (string): "contact" for by hand only, or the booking event that starts it.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-serviche-sergio/api-agent-mcp#diagnostics

## Score history

- 2026-11-21: 79
- 2026-11-20: 78
- 2026-11-19: 78
- 2026-11-18: 78
- 2026-11-17: 77
- 2026-11-16: 77
- 2026-11-15: 77
- 2026-11-14: 77
- 2026-11-13: 76
- 2026-11-12: 76
- 2026-11-11: 76
- 2026-11-10: 75
- 2026-11-09: 75
- 2026-11-08: 39
- 2026-11-07: 39

## Common questions

### What is the Sergio by Serviche MCP server?

Sergio by Serviche is an MCP server listed in the public MCP registry as com.serviche/sergio. Make sure nothing falls through the cracks in your cleaning business, even when you're not watching. This page covers its hosted endpoint (https://sergio.serviche.com/api/agent/mcp).

### Is the Sergio by Serviche MCP server safe to use?

Sergio by Serviche scores 79 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Sergio by Serviche MCP server expose?

Sergio by Serviche exposes 104 tools: whoami, catalog, report_feedback, events_subscribe, events_list, and 99 more. Their descriptions and schemas cost roughly 23,695 tokens of context every time the server is loaded.

### Does the Sergio by Serviche MCP server require authentication?

Yes. Sergio by Serviche asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

### Is the Sergio by Serviche MCP server still maintained?

Sergio by Serviche is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the Sergio by Serviche MCP server?

VerifyMCP ran 13 checks on Sergio by Serviche, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://sergio.serviche.com/api/agent/mcp
- Website: https://sergio.serviche.com/mcp
- Changelog RSS feed: https://verifymcp.io/servers/com-serviche-sergio/api-agent-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-serviche-sergio/api-agent-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/com-serviche-sergio/api-agent-mcp.json
- HTML version of this page: https://verifymcp.io/servers/com-serviche-sergio/api-agent-mcp
