{
  "openapi": "3.1.0",
  "info": {
    "title": "Hook MCP",
    "version": "1.0.15",
    "description": "{% admonition type=\"warning\" name=\"Preview\" %}\nThe Hook MCP server is in preview. Its tools, and what they take and return, can change at any time without notice. Its availability and uptime are not currently guaranteed.\n{% /admonition %}\n\nHook is a customer success platform. This server acts as one member of a Hook organization, and everything it returns is limited to what that member can access.\n\nAn organization is the company that uses Hook. Its customers are the companies it sells to and looks after. Members are the people in the organization who work in Hook. A signal flags something about a customer that needs attention, such as a concern about renewal or an opportunity to expand.\n\nAny tool that takes a customer accepts its name or its ID. Use the ID once you have it. If a name matches more than one customer, the tool lists the matches: ask which one is meant. If a name matches nothing, search with find_customers.\n\nLists return 10 items unless a limit is given, with the total count. Ask for more only when the first results were not enough. When the total count is higher than what was returned, call the tool again with offset set to how many have been returned so far. A total count of null means the total is not known: there may be more when a full page came back.\n\nMost tools only read from Hook. Tools that create or change something say so in their description. They act as the member, so before calling one, tell the person exactly what will be created or changed and get their agreement. If no tool does what is asked, say that it is not possible here."
  },
  "servers": [
    {
      "url": "https://connect.hook.co/mcp",
      "description": "Europe"
    },
    {
      "url": "https://connect.us.hook.co/mcp",
      "description": "United States"
    }
  ],
  "paths": {},
  "x-mcp": {
    "protocolVersion": "2025-11-25",
    "servers": [
      {
        "url": "https://connect.hook.co/mcp",
        "description": "Europe"
      },
      {
        "url": "https://connect.us.hook.co/mcp",
        "description": "United States"
      }
    ],
    "capabilities": {
      "tools": {}
    },
    "tools": [
      {
        "name": "get_current_member",
        "title": "Who am I",
        "description": "Returns the Hook member these tools are acting as, and the organization they belong to. Use it to answer \"who am I\" or to find out whose customers \"my customers\" refers to.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {},
          "additionalProperties": false
        }
      },
      {
        "name": "find_members",
        "title": "Find members",
        "description": "Searches the people who are members of the organization by name or email address, and returns their IDs, names and email addresses. Use it to turn a member’s name into an ID, for tools that take a member ID such as list_customers.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "query": {
              "default": "",
              "description": "All or part of a member’s name or email address. Leave empty to list members",
              "type": "string"
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 100. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "additionalProperties": false
        }
      },
      {
        "name": "find_customers",
        "title": "Find customers",
        "description": "Searches the customers the member can access by name, and returns their names and IDs. Use it to turn a customer name into an ID, or to list \"my customers\" with scope set to mine. To find customers by what is true of them, such as renewal date, ARR or segment, use list_customers.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "query": {
              "default": "",
              "description": "All or part of a customer name. Leave empty to list customers",
              "type": "string"
            },
            "scope": {
              "default": "all",
              "description": "mine: customers the member is assigned to. team: customers the member or their team is assigned to. all: every customer the member can see",
              "type": "string",
              "enum": [
                "mine",
                "team",
                "all"
              ]
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 100. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "additionalProperties": false
        }
      },
      {
        "name": "list_customers",
        "title": "List customers",
        "description": "Returns the customers that match what is asked for, with status, segment, region, products, ARR in the organization’s currency, next renewal date, the date of the last meeting, and their IDs in the organization’s CRM and other sources. Use it for questions such as \"which customers renew in the next 30 days\", \"my largest enterprise customers\", \"which customers have we not met since March\" or \"which customers does this member look after\". ARR is what a customer pays now, so a churned customer usually has an ARR of 0; null means the ARR is not known. Every filter given must match. Highest ARR first, unless sortBy says otherwise. To find a customer by name, use find_customers.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "scope": {
              "default": "mine",
              "description": "mine: customers the member is assigned to. team: customers the member or their team is assigned to. all: every customer the member can see",
              "type": "string",
              "enum": [
                "mine",
                "team",
                "all"
              ]
            },
            "statuses": {
              "description": "Only customers in one of these states",
              "minItems": 1,
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "active",
                  "churned",
                  "upcoming",
                  "unassigned"
                ]
              }
            },
            "segments": {
              "description": "Only customers in one of these segments, as named by get_customer",
              "minItems": 1,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1
              }
            },
            "regions": {
              "description": "Only customers in one of these regions",
              "minItems": 1,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1
              }
            },
            "countries": {
              "description": "Only customers in one of these countries",
              "minItems": 1,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1
              }
            },
            "renewalFromDate": {
              "description": "Only customers whose next renewal is on or after this day",
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            },
            "renewalToDate": {
              "description": "Only customers whose next renewal is on or before this day",
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            },
            "lastMeetingFromDate": {
              "description": "Only customers last met on or after this day",
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            },
            "lastMeetingToDate": {
              "description": "Only customers last met on or before this day. Customers never met are not included",
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            },
            "minArr": {
              "description": "Only customers with at least this much ARR",
              "type": "number",
              "minimum": 0
            },
            "maxArr": {
              "description": "Only customers with at most this much ARR",
              "type": "number",
              "minimum": 0
            },
            "memberId": {
              "description": "Only customers this member is assigned to, by the member’s ID",
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "memberRoleId": {
              "description": "With memberId, only customers where the member holds this role, by the role’s ID from get_organization_context",
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "customFields": {
              "description": "Filters on the organization’s custom fields, by the key of each field from get_organization_context. Give a list of values to match any of them, such as {\"tier\": [\"gold\", \"silver\"]}; a true or false field takes \"true\" or \"false\". For a number or date field, give a range with both ends, such as {\"seats\": {\"from\": \"100\", \"to\": \"500\"}}",
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "anyOf": [
                  {
                    "minItems": 1,
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  {
                    "type": "object",
                    "properties": {
                      "from": {
                        "type": "string"
                      },
                      "to": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "from",
                      "to"
                    ],
                    "additionalProperties": false
                  }
                ]
              }
            },
            "sortBy": {
              "default": "arr",
              "type": "string",
              "enum": [
                "arr",
                "nextRenewalDate",
                "lastMeetingDate",
                "name"
              ]
            },
            "sortOrder": {
              "description": "Descending for arr, ascending otherwise",
              "type": "string",
              "enum": [
                "ascending",
                "descending"
              ]
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 100. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "additionalProperties": false
        }
      },
      {
        "name": "get_customer",
        "title": "Get a customer",
        "description": "Returns an overview of one customer: where it is, its segment, its IDs in the organization’s CRM and other sources, the members assigned to it, and each product it has with status, ARR and renewal date.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            }
          },
          "required": [
            "customer"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "get_customer_hierarchy",
        "title": "Get a customer’s hierarchy",
        "description": "Returns the family of customers one customer belongs to, such as a holding company and its subsidiaries. Each customer in it comes with its parentId, which is null for the one at the top, so parents, children and siblings can be worked out. Status, segment, region and ARR are given only for the customers the member can access; the others are listed by name, with accessible set to false, so the shape of the family stays whole. ARR is what a customer pays now, so a churned customer usually has an ARR of 0; null means the ARR is not known. A customer with no parent and no children is returned on its own.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            }
          },
          "required": [
            "customer"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "list_customer_subscriptions",
        "title": "List a customer’s subscriptions",
        "description": "Returns the subscription history of one customer, latest start date first: each subscription with its product, type, value in the organization’s currency, licenses, start and end dates, and whether it is active and renews automatically. get_customer gives each product’s ARR and renewal date now; this gives the subscriptions behind them, including past ones.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 100. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "customer"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "list_customer_signals",
        "title": "List a customer’s signals",
        "description": "Returns the signals on one customer, most recently raised first. A signal flags something about the customer that needs attention, such as a concern about renewal or an opportunity to expand. Active signals were raised by a member, or detected by Hook and accepted, and are still open; cleared ones have been closed. Detected signals are ones Hook has found in meetings, emails and calls that no member has accepted yet; dismissed ones were detected and rejected. Active signals only, unless statuses says otherwise.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "statuses": {
              "default": [
                "active"
              ],
              "description": "Which signals to return. Give several to combine them, such as active and detected",
              "minItems": 1,
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "active",
                  "cleared",
                  "detected",
                  "dismissed"
                ]
              }
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 100. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "customer"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "list_signals",
        "title": "List signals",
        "description": "Returns signals across the member’s customers, most recently raised first, each with the customer it is on. A signal flags something about a customer that needs attention, such as a concern about renewal or an opportunity to expand. Use it for questions such as \"what signals are open on my customers\", \"which detected signals need reviewing\" or \"which of the team’s customers might churn\". For one customer’s signals, use list_customer_signals. Active signals only, unless statuses says otherwise.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "scope": {
              "default": "mine",
              "description": "mine: customers the member is assigned to. team: customers the member or their team is assigned to. all: every customer the member can see",
              "type": "string",
              "enum": [
                "mine",
                "team",
                "all"
              ]
            },
            "statuses": {
              "default": [
                "active"
              ],
              "description": "Which signals to return. Give several to combine them, such as active and detected",
              "minItems": 1,
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "active",
                  "cleared",
                  "detected",
                  "dismissed"
                ]
              }
            },
            "typeIds": {
              "description": "Only signals of these types, by the type’s ID from get_organization_context",
              "minItems": 1,
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              }
            },
            "categoryIds": {
              "description": "Only signals in these categories, by the category’s ID from get_organization_context",
              "minItems": 1,
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              }
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 100. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "additionalProperties": false
        }
      },
      {
        "name": "get_signal",
        "title": "Get a signal",
        "description": "Returns one signal in full: the customer and product it is on, its status, type, category, summary, and severity with the reason for it; who owns it; when it was raised and closed; how it was cleared or why it was dismissed; and where it came from. For its status updates, use list_signal_status_updates. Take the id from list_signals or list_customer_signals.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The signal’s ID"
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "list_signal_status_updates",
        "title": "List a signal’s status updates",
        "description": "Returns every status update on one signal, newest first: what was written, the member who wrote it, and when. Take the id from list_signals or list_customer_signals.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The signal’s ID"
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "list_customer_notes",
        "title": "List a customer’s notes",
        "description": "Returns the notes written about one customer, most recent first. Notes are written by members, or synced from a CRM, and record calls, decisions and context.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "userIds": {
              "description": "Only return notes about these users at the customer, as returned by list_customer_users",
              "type": "array",
              "items": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 25. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 25
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "customer"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "list_news",
        "title": "List news",
        "description": "Returns news across the member’s customers, or about one customer, most recent first, each with the customer it is about. News items tell members about customer or user activity, such as a meeting that was held or a change in how a product is used. Use it for questions such as \"what’s new on my customers\" or \"what’s new at Acme\". To see only the news about particular users at a customer, give the customer and userIds from list_customer_users.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "description": "Only news about this customer, by name or ID",
              "type": "string",
              "minLength": 1
            },
            "scope": {
              "default": "mine",
              "description": "Ignored when a customer is given. mine: customers the member is assigned to. team: customers the member or their team is assigned to. all: every customer the member can see",
              "type": "string",
              "enum": [
                "mine",
                "team",
                "all"
              ]
            },
            "userIds": {
              "description": "Only news about these users at the customer, as returned by list_customer_users. Give it with a customer",
              "minItems": 1,
              "type": "array",
              "items": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "categories": {
              "description": "Only news in these categories, such as meeting, product or crm",
              "minItems": 1,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1
              }
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 100. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "additionalProperties": false
        }
      },
      {
        "name": "list_customer_contacts",
        "title": "List a customer’s contacts",
        "description": "Returns the contacts at one customer: the people the organization deals with there, usually synced from a CRM, with their email address and the kind of contact they are. Use it to find who to talk to at a customer. For the people who use the organization’s product, use list_customer_users.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "search": {
              "description": "Part of a name or email address, to return only matching contacts",
              "type": "string",
              "minLength": 1
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 100. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "customer"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "list_customer_users",
        "title": "List a customer’s users",
        "description": "Returns the users at one customer: the people who use the organization’s product, with their job title, department, when they last met with the organization, and for each product how they use it. A user can be several types at once: active (used the product recently), power (among the heaviest users), zombie (has access but barely uses it), inactive (no recent use) and influencer (their use shapes how the customer uses the product). Give userType to return only users of one type, most recently active first; this needs productId when the organization has more than one product. For the people the organization deals with, who may not use the product, use list_customer_contacts.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "userType": {
              "description": "Return only users of this type",
              "type": "string",
              "enum": [
                "active",
                "power",
                "zombie",
                "inactive",
                "influencer"
              ]
            },
            "productId": {
              "description": "The product userType applies to. Only needed when the organization has more than one product",
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 100. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "customer"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "list_customer_conversations",
        "title": "List a customer’s conversations",
        "description": "Returns the conversations with one customer as a single timeline, most recent first: meetings, emails and support tickets. Each has a title, a short summary and who took part. Use fromDate and toDate to reach older conversations, and get_conversation with the type and id for the full transcript, email or ticket. The emails are the ones synced from the customer’s mail or CRM, which can include emails sent from Hook; list_customer_sent_emails has those with their tracking.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "types": {
              "description": "Only return these types of conversation. Leave empty for all of them",
              "minItems": 1,
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "meeting",
                  "email",
                  "support_ticket"
                ]
              }
            },
            "fromDate": {
              "description": "Only conversations on or after this date, such as 2025-01-31",
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            },
            "toDate": {
              "description": "Only conversations on or before this date. A day, such as 2025-03-31, includes the whole day",
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 25. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 25
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "customer"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "list_customer_sent_emails",
        "title": "List the emails sent to a customer from Hook",
        "description": "Returns the emails sent to one customer from Hook, by a member or by one of the organization’s agents, most recent first, with whether each was opened, clicked, replied to or bounced. Emails synced from the customer’s mail or CRM are in list_customer_conversations, where an email sent from Hook can also appear. Use get_conversation with type sent_email and the id for the text of the email.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "fromDate": {
              "description": "Only emails sent on or after this date, such as 2025-01-31",
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            },
            "toDate": {
              "description": "Only emails sent on or before this date. A day, such as 2025-03-31, includes the whole day",
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            },
            "opened": {
              "description": "true for only emails that were opened, false for only those that were not",
              "type": "boolean"
            },
            "clicked": {
              "description": "true for only emails with a link that was clicked, false for the rest",
              "type": "boolean"
            },
            "replied": {
              "description": "true for only emails that were replied to, false for the rest",
              "type": "boolean"
            },
            "bounced": {
              "description": "true for only emails that bounced, false for the rest",
              "type": "boolean"
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 25. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 25
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "customer"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "get_conversation",
        "title": "Get a conversation",
        "description": "Returns one conversation with a customer in full: the summary, next steps and participants of a meeting, the body of an email, the request of a support ticket, or the text of an email sent from Hook. Take the type and id from list_customer_conversations, or use type sent_email with an id from list_customer_sent_emails. A meeting comes without its transcript unless includeTranscript is set; ask for it only when the summary is not enough. A long transcript comes in parts: when nextTranscriptLine is given, call again with transcriptFromLine set to it for the next part. Other very long content is cut short, and truncated says when it was.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "type": {
              "type": "string",
              "enum": [
                "meeting",
                "email",
                "support_ticket",
                "sent_email"
              ],
              "description": "The type of the conversation"
            },
            "id": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991,
              "description": "The id of the conversation, as returned by the tool that listed it"
            },
            "includeTranscript": {
              "default": false,
              "description": "For a meeting, also return the transcript. hasTranscript says whether there is one",
              "type": "boolean"
            },
            "transcriptFromLine": {
              "default": 0,
              "description": "For a long transcript, the line to start from. Give the nextTranscriptLine of the part before",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "customer",
            "type",
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "find_support_tickets",
        "title": "Find support tickets",
        "description": "Finds support tickets by the number people know them by, such as a Salesforce case number or a Zendesk ticket number. Use it whenever a ticket number is given: no customer is needed. It returns tickets whose number is exactly the reference, or whose subject contains it, most recently opened first, for customers the member can access. To read one in full, call get_conversation with its customerId as the customer, type support_ticket and its id.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "reference": {
              "type": "string",
              "minLength": 3,
              "description": "The ticket number, exactly as it was given. At least 3 characters"
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 25. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 25
            }
          },
          "required": [
            "reference"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "list_customer_briefs",
        "title": "List a customer’s briefs",
        "description": "Returns the briefs Hook holds for one customer, most recently updated first, without their content: each brief’s name, what it is for, when it was last updated and how long it is. A brief is a written summary of the customer that Hook keeps up to date, such as an executive summary; an organization defines which briefs it has. Start here for an overview of a customer, then read the one that fits with get_customer_brief. Prefer a brief updated recently: an old one may no longer match the customer’s signals.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            }
          },
          "required": [
            "customer"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "get_customer_brief",
        "title": "Get one of a customer’s briefs",
        "description": "Returns the latest version of one brief for one customer, in full. Take the brief’s id or name from list_customer_briefs. A very long brief is cut and marked truncated.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "brief": {
              "type": "string",
              "minLength": 1,
              "description": "The id of the brief, or its name, as returned by list_customer_briefs"
            }
          },
          "required": [
            "customer",
            "brief"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "list_alerts",
        "title": "List alerts",
        "description": "Returns alerts, most recent first. An alert is raised on a customer when something needs attention, such as a drop in usage, and stays open until a member completes or dismisses it. Each comes with the playbook to follow, if it has one, whether the member has saved it, and how many comments it has; read them with list_alert_comments. Give a customer for its alerts, or leave it out for alerts across the member’s customers.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "description": "Only alerts for this customer, by name or ID",
              "type": "string",
              "minLength": 1
            },
            "scope": {
              "default": "mine",
              "description": "Ignored when a customer is given. mine: customers the member is assigned to. team: customers the member or their team is assigned to. all: every customer the member can see",
              "type": "string",
              "enum": [
                "mine",
                "team",
                "all"
              ]
            },
            "status": {
              "default": "open",
              "description": "Which alerts to return. saved is the open alerts the member has saved",
              "type": "string",
              "enum": [
                "open",
                "saved",
                "completed",
                "dismissed"
              ]
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 100. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "additionalProperties": false
        }
      },
      {
        "name": "list_alert_comments",
        "title": "List an alert’s comments",
        "description": "Returns the comments members have left on one alert, newest first, with who wrote each and when. Take the id and customer from list_alerts.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the alert, as returned by list_alerts"
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 100. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "customer",
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "list_action_groups",
        "title": "List action groups",
        "description": "Returns action groups. An action group is a set of recommended actions for one customer, such as an email to send or a call to make, raised from a signal, a meeting, a support ticket or an automation, with the background that explains why. Each comes with how many actions it has; use get_action_group for the actions themselves. Give a customer for its groups, or leave it out for groups across the member’s customers. Each group names the agent that created it; give agentId for the groups of one agent only.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "description": "Only action groups for this customer, by name or ID",
              "type": "string",
              "minLength": 1
            },
            "scope": {
              "default": "mine",
              "description": "Ignored when a customer is given. mine: customers the member is assigned to. team: customers the member or their team is assigned to. all: every customer the member can see",
              "type": "string",
              "enum": [
                "mine",
                "team",
                "all"
              ]
            },
            "status": {
              "description": "Only groups with an action in this state. todo means not yet completed or dismissed",
              "type": "string",
              "enum": [
                "todo",
                "completed",
                "dismissed"
              ]
            },
            "dismissalSource": {
              "description": "Only groups with an action dismissed by a member, or automatically by Hook (system)",
              "type": "string",
              "enum": [
                "member",
                "system"
              ]
            },
            "agentId": {
              "description": "Only groups created by this agent, by its ID from get_organization_context",
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "limit": {
              "default": 10,
              "description": "How many to return, up to 25. Ask for more only if the first results were not enough",
              "type": "integer",
              "minimum": 1,
              "maximum": 25
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "additionalProperties": false
        }
      },
      {
        "name": "get_action_group",
        "title": "Get an action group",
        "description": "Returns one action group with its actions: what each action is, why it was recommended, its status, who it is assigned to, and the email or task it would carry out. A dismissed action says whether a member dismissed it, or Hook did automatically because nobody had updated it. An email’s body is given as plain text; use get_action_email for the email as it is stored, to edit it. Take the id from list_action_groups.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991,
              "description": "The id of the action group, as returned by list_action_groups"
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "get_action_email",
        "title": "Get an action’s email",
        "description": "Returns the draft email of one action, exactly as it is stored: the subject and the body as HTML. Use it before editing the email with edit_action_email. To read an email, get_action_group gives the body as plain text. Take the id from the actions in get_action_group.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991,
              "description": "The id of the action, as returned in the actions of get_action_group"
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "list_metrics",
        "title": "List metrics",
        "description": "Returns the metrics the organization tracks about its customers, such as weekly active users, with the product each belongs to, what it means and how its value is formatted. An organization can have hundreds, so search by name or narrow to a product; totalCount says how many match. Use the key with get_customer_metrics to get a customer’s values.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "query": {
              "description": "Only metrics whose name contains this, such as \"active users\"",
              "type": "string",
              "minLength": 1
            },
            "productId": {
              "description": "Only metrics for this product, by its ID",
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "limit": {
              "default": 25,
              "description": "How many to return, up to 100",
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "offset": {
              "default": 0,
              "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "additionalProperties": false
        }
      },
      {
        "name": "get_customer_metrics",
        "title": "Get a customer’s metrics",
        "description": "Returns one customer’s current value for each metric asked for, with its value 30 days ago and the change since then. Take the keys from list_metrics. A key that is not a metric is listed in unknownMetricKeys; a metric the customer has no value for is listed in metricKeysWithoutValues.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "metricKeys": {
              "minItems": 1,
              "maxItems": 50,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1
              },
              "description": "The keys of the metrics to return, as given by list_metrics. Up to 50"
            }
          },
          "required": [
            "customer",
            "metricKeys"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "get_customer_renewal_outlook",
        "title": "Get a customer’s renewal outlook",
        "description": "Returns how likely one customer is to renew each product, and why. For each product: the customer’s latest engagement level; renewalLikelihood, how likely a customer at that level is to renew the product, from 0 to 1, as Hook last calculated it from the organization’s renewals, which is the renewal likelihood shown in Hook; how the engagement level has changed, newest first, each level with the date it began; and the main reasons behind the latest level. Also returns the latest upsell, cross-sell and engagement predictions for the customer, one output per product. Covers the last 16 weeks unless fromDate is given, so the oldest level may have begun earlier. No products, and predictions with no date, mean Hook’s models have produced nothing for this customer in that time; it is not an error. For renewal dates and ARR, use get_customer.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "fromDate": {
              "description": "Only engagement levels on or after this date, such as 2025-01-31",
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            }
          },
          "required": [
            "customer"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "get_renewals_summary",
        "title": "Get a renewals summary",
        "description": "Returns how many customers are due to renew in a period, and the total ARR renewing in the organization’s currency, across the member’s customers. Both dates are included in the period.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "fromDate": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ],
              "description": "The first day of the period, such as 2025-01-01"
            },
            "toDate": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ],
              "description": "The last day of the period, such as 2025-03-31"
            },
            "scope": {
              "default": "mine",
              "description": "mine: customers the member is assigned to. team: customers the member or their team is assigned to. all: every customer the member can see",
              "type": "string",
              "enum": [
                "mine",
                "team",
                "all"
              ]
            }
          },
          "required": [
            "fromDate",
            "toDate"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "get_organization_context",
        "title": "Get the organization’s context",
        "description": "Returns background on the organization these tools act for: what it sells and who it competes with, in its own words; its currency and the month its fiscal year starts; its products, with what makes someone an active user or a power user of each; the roles its members hold on customers; its agents, which create action groups; the custom fields it keeps on customers; the types and categories of signal it uses, with the outcomes and competitors a signal can be cleared with, the reasons one can be dismissed for, and whether the organization requires a dismissal reason or a competitor; and the categories a note can have. Call it once, early, to interpret everything else: product IDs, ARR, roles and signal names all refer to this, and the tools that create or change something take their IDs from here.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {},
          "additionalProperties": false
        }
      },
      {
        "name": "resolve_time_period",
        "title": "Resolve a time period",
        "description": "Returns the first and last day of a period such as this quarter or last year, worked out from today’s date and the organization’s fiscal year. Use it before any tool that takes dates when the period is described in words: quarters and years follow the fiscal year, which may not start in January. Both dates are included in the period.",
        "tags": [
          "Read only"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "period": {
              "type": "string",
              "enum": [
                "last",
                "this",
                "next"
              ],
              "description": "Which period, relative to today"
            },
            "unit": {
              "type": "string",
              "enum": [
                "month",
                "quarter",
                "year"
              ],
              "description": "The length of the period"
            }
          },
          "required": [
            "period",
            "unit"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "create_note",
        "title": "Create a note",
        "description": "Adds a note to one customer, written by the member. Use it to record a call, a decision or context about the customer. Take categoryId from noteCategories in get_organization_context. userIds and contactIds link the note to people at the customer: take them from list_customer_users and list_customer_contacts. Confirm the customer and the wording with the person before creating it.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "categoryId": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The category of the note"
            },
            "title": {
              "description": "A short title for the note",
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "body": {
              "type": "string",
              "minLength": 1,
              "maxLength": 20000,
              "description": "The text of the note"
            },
            "userIds": {
              "description": "The users at the customer the note is about",
              "type": "array",
              "items": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "contactIds": {
              "description": "The contacts at the customer the note is about",
              "type": "array",
              "items": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            }
          },
          "required": [
            "customer",
            "categoryId",
            "body"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "edit_note",
        "title": "Edit a note",
        "description": "Changes one of the member’s own notes on a customer. A member cannot edit anyone else’s note, or a note synced from a CRM other than Salesforce. Take the note’s id from list_customer_notes. Only the fields given change: a null title removes it, and userIds or contactIds replace the people linked to the note. Confirm the changes with the person first.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "noteId": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the note, as returned by list_customer_notes"
            },
            "categoryId": {
              "description": "The new category of the note",
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "title": {
              "description": "The new title of the note, or null to remove it",
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                {
                  "type": "null"
                }
              ]
            },
            "body": {
              "description": "The new text of the note",
              "type": "string",
              "minLength": 1,
              "maxLength": 20000
            },
            "userIds": {
              "description": "The users at the customer the note is about",
              "type": "array",
              "items": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "contactIds": {
              "description": "The contacts at the customer the note is about",
              "type": "array",
              "items": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            }
          },
          "required": [
            "customer",
            "noteId"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "delete_note",
        "title": "Delete a note",
        "description": "Deletes one of the member’s own notes on a customer. A member cannot delete anyone else’s note, or a note synced from a CRM other than Salesforce. Take the note’s id from list_customer_notes. This cannot be undone, so confirm with the person which note is being deleted.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "noteId": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the note, as returned by list_customer_notes"
            }
          },
          "required": [
            "customer",
            "noteId"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "create_signal",
        "title": "Create a signal",
        "description": "Raises a signal on one customer, as the member. A signal flags something about the customer that needs attention, such as a concern about renewal or an opportunity to expand. It is active at once and shows wherever the customer’s signals do. Take productId, typeId, categoryId and subCategoryId from products, signalTypes and signalCategories in get_organization_context; a subCategoryId must belong to the categoryId given. Confirm the customer, the type and the summary with the person before creating it.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "productId": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The product the signal is about"
            },
            "typeId": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The type of signal"
            },
            "summary": {
              "type": "string",
              "minLength": 1,
              "description": "What the signal is, in a sentence or two"
            },
            "categoryId": {
              "description": "The category of the signal",
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "subCategoryId": {
              "description": "The sub-category, within the category given",
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "customer",
            "productId",
            "typeId",
            "summary"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "dismiss_signal",
        "title": "Dismiss a detected signal",
        "description": "Dismisses a detected signal: one Hook found in meetings, emails and calls that no member has accepted. Use it when the signal is wrong or not worth acting on. It only works on a detected signal; to close an active one, use clear_signal. Take the id from list_customer_signals with status detected, and dismissalReasonId from signalDismissalReasons in get_organization_context. signalRequirements there says whether the organization requires a dismissal reason. This cannot be undone, so confirm with the person which signal is being dismissed and why.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the detected signal"
            },
            "dismissalReasonId": {
              "description": "Why the signal is being dismissed",
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "notes": {
              "description": "Anything to record about why it was dismissed",
              "type": "string",
              "minLength": 1
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "clear_signal",
        "title": "Clear an active signal",
        "description": "Clears an active signal, which closes it, once what it flagged has been dealt with or no longer applies. It only works on an active signal; to reject a detected one, use dismiss_signal. Take the id from list_customer_signals, and outcomeId and competitorId from signalOutcomes and signalCompetitors in get_organization_context. signalRequirements there says whether the organization requires a competitor. This cannot be undone, so confirm with the person which signal is being cleared and how it turned out.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the active signal"
            },
            "outcomeId": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "How the signal turned out"
            },
            "notes": {
              "type": "string",
              "minLength": 1,
              "description": "What happened, in a sentence or two"
            },
            "competitorId": {
              "description": "The competitor involved, if there was one",
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "id",
            "outcomeId",
            "notes"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "edit_signal",
        "title": "Edit a signal",
        "description": "Changes an active or detected signal; a cleared or dismissed one cannot be changed. Only the fields given change. Take the id from list_customer_signals, typeId, categoryId and subCategoryId from signalTypes and signalCategories in get_organization_context, ownerId from find_members, and competitorId from signalCompetitors. Giving categoryId replaces the category and any sub-category; a subCategoryId must be given with the categoryId it belongs to. A null ownerId removes the owner. Confirm the changes with the person first.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the signal"
            },
            "summary": {
              "description": "What the signal is, in a sentence or two",
              "type": "string",
              "minLength": 1
            },
            "typeId": {
              "description": "The type of signal",
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "categoryId": {
              "description": "The category of the signal",
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "subCategoryId": {
              "description": "The sub-category, within the category given",
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "ownerId": {
              "description": "The member who owns the signal, or null for nobody",
              "anyOf": [
                {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "competitorId": {
              "description": "The competitor involved",
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "accept_signal",
        "title": "Accept a detected signal",
        "description": "Accepts a detected signal: one Hook found in meetings, emails and calls that no member has accepted. It becomes active, as if a member had raised it. It only works on a detected signal; to reject one, use dismiss_signal. Take the id from list_customer_signals with status detected. A signal cannot go back to detected, so confirm with the person which signal is being accepted.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the detected signal"
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "make_signal_primary",
        "title": "Make a signal primary",
        "description": "Makes an active signal the primary one for its product. Each customer has at most one primary active signal per product, so the one that was primary stops being so. A signal cannot be made not primary directly; make another one primary instead. Take the id from list_customer_signals. Confirm with the person which signal should be primary.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the active signal"
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "add_signal_status_update",
        "title": "Add a status update to a signal",
        "description": "Adds a status update to an active or detected signal, written by the member, to record progress on it. Take the id from list_customer_signals. Confirm the wording with the person first.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the signal"
            },
            "text": {
              "type": "string",
              "minLength": 1,
              "maxLength": 20000,
              "description": "The status update"
            }
          },
          "required": [
            "id",
            "text"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "edit_signal_status_update",
        "title": "Edit a status update on a signal",
        "description": "Replaces the text of a status update on an active or detected signal. Take the signal’s id from list_customer_signals and the status update’s id from list_signal_status_updates. Confirm the new wording with the person first.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the signal"
            },
            "statusUpdateId": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the status update, as returned by list_signal_status_updates"
            },
            "text": {
              "type": "string",
              "minLength": 1,
              "maxLength": 20000,
              "description": "The new text of the status update"
            }
          },
          "required": [
            "id",
            "statusUpdateId",
            "text"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "delete_signal_status_update",
        "title": "Delete a status update on a signal",
        "description": "Deletes a status update on an active or detected signal. Take the signal’s id from list_customer_signals and the status update’s id from list_signal_status_updates. This cannot be undone, so confirm with the person which status update is being deleted.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the signal"
            },
            "statusUpdateId": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the status update, as returned by list_signal_status_updates"
            }
          },
          "required": [
            "id",
            "statusUpdateId"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "complete_action",
        "title": "Complete an action",
        "description": "Marks an action as done by the member, such as after making the call it asked for. Completing an action only marks it as done: it does not send the action’s email, and no tool here sends one. Take the id from the actions in get_action_group. reopen_action reverses it. Confirm with the person which action is being completed.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the action, as returned in the actions of get_action_group"
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "dismiss_action",
        "title": "Dismiss an action",
        "description": "Dismisses an action the member will not carry out, such as one that is no longer relevant. Take the id from the actions in get_action_group. reopen_action reverses it. Confirm with the person which action is being dismissed.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the action, as returned in the actions of get_action_group"
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "reopen_action",
        "title": "Reopen an action",
        "description": "Sets a completed or dismissed action back to todo. An action whose email has been sent cannot be reopened. Take the id from the actions in get_action_group. Confirm with the person which action is being reopened.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the action, as returned in the actions of get_action_group"
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "assign_action",
        "title": "Assign an action",
        "description": "Assigns an action to a member, or leaves it unassigned when memberId is null. Take the id from the actions in get_action_group, and the member’s ID from find_members. Confirm with the person who the action should go to.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the action, as returned in the actions of get_action_group"
            },
            "memberId": {
              "anyOf": [
                {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ],
              "description": "The member to assign the action to, or null to unassign it"
            }
          },
          "required": [
            "id",
            "memberId"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "edit_action_email",
        "title": "Edit an action’s email",
        "description": "Changes the draft email of an action. Give only what changes; the rest is kept. A list of recipients replaces the whole list. Read the email first with get_action_email, which gives the body as HTML, and keep the body as HTML. Nothing is sent, and no tool here sends it. Show the person the changed email and get their agreement before saving it.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the action, as returned in the actions of get_action_group"
            },
            "subject": {
              "type": "string",
              "minLength": 1
            },
            "bodyHtml": {
              "description": "The whole body, as HTML",
              "type": "string",
              "minLength": 1
            },
            "to": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "format": "email",
                    "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                  },
                  "firstName": {
                    "type": "string",
                    "minLength": 1
                  },
                  "lastName": {
                    "type": "string",
                    "minLength": 1
                  },
                  "contactId": {
                    "description": "The contact this is, from list_customer_contacts",
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  },
                  "userId": {
                    "description": "The user this is, from list_customer_users",
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "email"
                ]
              }
            },
            "cc": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "format": "email",
                    "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                  },
                  "firstName": {
                    "type": "string",
                    "minLength": 1
                  },
                  "lastName": {
                    "type": "string",
                    "minLength": 1
                  },
                  "contactId": {
                    "description": "The contact this is, from list_customer_contacts",
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  },
                  "userId": {
                    "description": "The user this is, from list_customer_users",
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "email"
                ]
              }
            },
            "bcc": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "format": "email",
                    "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                  },
                  "firstName": {
                    "type": "string",
                    "minLength": 1
                  },
                  "lastName": {
                    "type": "string",
                    "minLength": 1
                  },
                  "contactId": {
                    "description": "The contact this is, from list_customer_contacts",
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  },
                  "userId": {
                    "description": "The user this is, from list_customer_users",
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "email"
                ]
              }
            }
          },
          "required": [
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "complete_alert",
        "title": "Complete an alert",
        "description": "Marks an alert as dealt with, by the member, such as after reaching out about the drop in usage it flagged. Take the id and customer from list_alerts. This cannot be undone, so confirm with the person which alert is being completed.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the alert, as returned by list_alerts"
            },
            "reason": {
              "description": "What was done about it",
              "type": "string",
              "minLength": 1
            }
          },
          "required": [
            "customer",
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "dismiss_alert",
        "title": "Dismiss an alert",
        "description": "Marks an alert as not needing action, by the member, such as one that is expected or already handled elsewhere. Take the id and customer from list_alerts. This cannot be undone, so confirm with the person which alert is being dismissed and why.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the alert, as returned by list_alerts"
            },
            "reason": {
              "description": "Why it does not need action",
              "type": "string",
              "minLength": 1
            }
          },
          "required": [
            "customer",
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "save_alert",
        "title": "Save an alert",
        "description": "Saves an alert for the member, so it shows in list_alerts with status saved. Take the id and customer from list_alerts. unsave_alert reverses it.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the alert, as returned by list_alerts"
            }
          },
          "required": [
            "customer",
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "unsave_alert",
        "title": "Unsave an alert",
        "description": "Removes an alert from the member’s saved alerts. Take the id and customer from list_alerts. save_alert reverses it. Confirm with the person which alert they want to unsave first.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the alert, as returned by list_alerts"
            }
          },
          "required": [
            "customer",
            "id"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "comment_on_alert",
        "title": "Comment on an alert",
        "description": "Adds a comment to an alert, written by the member, for their team to see. Take the id and customer from list_alerts. Confirm the wording with the person first.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the alert, as returned by list_alerts"
            },
            "text": {
              "type": "string",
              "minLength": 1,
              "description": "The comment"
            }
          },
          "required": [
            "customer",
            "id",
            "text"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "edit_alert_comment",
        "title": "Edit a comment on an alert",
        "description": "Replaces the text of one of the member’s own comments on an alert. A member cannot edit anyone else’s comment. Take the comment’s id from list_alert_comments. Confirm the new wording with the person first.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "alertId": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the alert, as returned by list_alerts"
            },
            "commentId": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the comment, as returned by list_alert_comments"
            },
            "text": {
              "type": "string",
              "minLength": 1,
              "description": "The new text of the comment"
            }
          },
          "required": [
            "customer",
            "alertId",
            "commentId",
            "text"
          ],
          "additionalProperties": false
        }
      },
      {
        "name": "delete_alert_comment",
        "title": "Delete a comment on an alert",
        "description": "Deletes one of the member’s own comments on an alert. A member cannot delete anyone else’s comment. Take the comment’s id from list_alert_comments. This cannot be undone, so confirm with the person which comment is being deleted.",
        "tags": [
          "Makes changes"
        ],
        "inputSchema": {
          "type": "object",
          "properties": {
            "customer": {
              "type": "string",
              "minLength": 1,
              "description": "The name of the customer, its ID, or its ID in a CRM or another source written as source:ID, such as salesforce:0010x000000aAAA. Use an ID when you have one; a name must match one customer"
            },
            "alertId": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the alert, as returned by list_alerts"
            },
            "commentId": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "description": "The id of the comment, as returned by list_alert_comments"
            }
          },
          "required": [
            "customer",
            "alertId",
            "commentId"
          ],
          "additionalProperties": false
        }
      }
    ]
  },
  "components": {}
}