Skip to main content
Glama

Propose changes to record fields

propose_changes

AI Agents: Use when the person asks to fill, correct or empty fields of records, or to make a new record: per record its type, id (left out for a new one), set with field keys and values, clear with keys to empty. Notes, tasks, stages and links have their own propose_ tool. Writes nothing: show it, and after a yes call apply_proposal (or share the approve link if needsApproval). Not for reading (use search_records).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "system": "<system>",
      "items": "<items>"
    },
    "name": "propose_changes"
  }
}

Input Schema

NameRequiredDescriptionDefault
itemsYesOne per record.
systemYesThe AI agent: its system or connection name.

Output Schema

NameRequiredDescriptionDefault
noticeNo
changesYes
systemIdYes
warningsYes
expiresAtYes
approveUrlYes
proposalIdYes
systemNameYes
needsApprovalYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / items / description
      Previous value: -"One object per record, at most 25."New value: +"One per record."
    • changedInput schema / properties / system / description
      Previous value: -"Which AI agent: the system's id from get_ai_agent_options, or the name of the system or its connection. Ask the person which AI agent they mean unless they named it in this conversation; never pick one yourself."New value: +"The AI agent: its system or connection name."
  2. Changed1 schema field changed
    • changedInput schema / properties / items / items / properties / type / enum
      Previous value: -[
      -  "contact",
      -  "opportunity",
      -  "invoice",
      -  "estimate",
      -  "job",
      -  "appointment"
      -]New value: +[
      +  "contact",
      +  "opportunity",
      +  "invoice",
      +  "estimate",
      +  "job",
      +  "appointment",
      +  "ticket"
      +]
  3. Changed1 schema field changed
    • changedInput schema / properties / system / description
      Previous value: -"Which AI agent: the system's id from get_ai_agents_info, or the name of the system or its connection. Ask the person which AI agent they mean unless they named it in this conversation; never pick one yourself."New value: +"Which AI agent: the system's id from get_ai_agent_options, or the name of the system or its connection. Ask the person which AI agent they mean unless they named it in this conversation; never pick one yourself."
  4. Changed56 schema fields changed
    • removedInput schema / properties / action
      Removed value: -{
      -  "default": "set_fields",
      -  "description": "What to propose; set_fields when left out.",
      -  "enum": [
      -    "set_fields",
      -    "create_record",
      -    "notify",
      -    "update_fields",
      -    "move_stage",
      -    "assign_owner",
      -    "add_note",
      -    "add_task",
      -    "update_task",
      -    "log_activity",
      -    "add_line_item",
      -    "send_record",
      -    "convert_estimate",
      -    "convert_lead",
      -    "link_records",
      -    "unlink_records",
      -    "create_item",
      -    "update_item",
      -    "set_item_state",
      -    "move_item",
      -    "add_tag",
      -    "remove_tag",
      -    "add_follower",
      -    "remove_follower",
      -    "add_to_workflow",
      -    "remove_from_workflow",
      -    "update_note",
      -    "send_message",
      -    "update_conversation",
      -    "record_payment",
      -    "change_consent",
      -    "void_record",
      -    "send_document",
      -    "email_contact"
      -  ],
      -  "type": "string"
      -}
    • changedInput schema / properties / items / description
      Previous value: -"One object per record, at most 25, with the values the action takes."New value: +"One object per record, at most 25."
    • removedInput schema / properties / items / items / properties / amount
      Removed value: -{
      -  "description": "record_payment: How much was paid, as a number.",
      -  "maxLength": 20,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / at
      Removed value: -{
      -  "description": "add_note: When the note is from, ISO 8601 in UTC; now when left out. log_activity: When it took place, ISO 8601 in UTC; now when left out.",
      -  "maxLength": 40,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / automation_kind
      Removed value: -{
      -  "description": "add_to_workflow: A workflow, a campaign or a sales sequence; workflow when left out. remove_from_workflow: A workflow or a campaign; workflow when left out.",
      -  "enum": [
      -    "workflow",
      -    "campaign",
      -    "sequence"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / channel
      Removed value: -{
      -  "description": "send_message: How it is sent.",
      -  "enum": [
      -    "email",
      -    "sms",
      -    "whatsapp",
      -    "facebook",
      -    "instagram",
      -    "live_chat"
      -  ],
      -  "type": "string"
      -}
    • changedInput schema / properties / items / items / properties / clear / description
      Previous value: -"set_fields: field keys to empty; only fields describe_record_type marks clearable."New value: +"Field keys to empty; only fields describe_record_type marks clearable."
    • removedInput schema / properties / items / items / properties / conversation_id
      Removed value: -{
      -  "description": "update_conversation: The id of the conversation, as list_related_records gives it.",
      -  "maxLength": 200,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / done
      Removed value: -{
      -  "description": "add_task: True for a task that is already done. update_task: True when the task is done, false to open it again.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / items / items / properties / due_at
      Removed value: -{
      -  "description": "add_task: When it is due, ISO 8601 in UTC. update_task: When it is due now, ISO 8601 in UTC.",
      -  "maxLength": 40,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / email
      Removed value: -{
      -  "description": "send_record: Send to this address instead of the one on the record. send_message: Send to this address of the contact instead of their main one.",
      -  "maxLength": 320,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / end_at
      Removed value: -{
      -  "description": "log_activity: When a meeting ended, ISO 8601 in UTC.",
      -  "maxLength": 40,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / fields
      Removed value: -{
      -  "additionalProperties": {
      -    "type": "string"
      -  },
      -  "description": "update_fields: Field names and their new values as text; an empty text empties a field.",
      -  "type": "object"
      -}
    • changedInput schema / properties / items / items / properties / id / description
      Previous value: -"The id of the record in the system. Leave it out with set_fields to make a new record, and with update_task where the system does not ask for it."New value: +"The id of the record in the system. Leave it out to make a new record."
    • removedInput schema / properties / items / items / properties / into
      Removed value: -{
      -  "description": "convert_lead: What the lead becomes.",
      -  "enum": [
      -    "estimate",
      -    "job",
      -    "contact"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / item_id
      Removed value: -{
      -  "description": "update_item, set_item_state, move_item: The id of the item, as list_items gives it. send_document: The id of the document or template, as list_items gives it.",
      -  "maxLength": 200,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / item_kind
      Removed value: -{
      -  "description": "create_item: Which kind of item to make. update_item: Which kind of item to change. set_item_state, move_item: Which kind of item it is. record_payment: For an order, the kind order instead of a type. send_document: A document that exists, or a template to make one from.",
      -  "enum": [
      -    "business",
      -    "custom_record",
      -    "object",
      -    "link_type",
      -    "link",
      -    "product",
      -    "price",
      -    "product_collection",
      -    "coupon",
      -    "order",
      -    "transaction",
      -    "subscription",
      -    "invoice_schedule",
      -    "invoice_template",
      -    "calendar",
      -    "calendar_group",
      -    "calendar_resource",
      -    "blocked_slot",
      -    "service",
      -    "booking",
      -    "pipeline",
      -    "custom_field",
      -    "custom_value",
      -    "location_tag",
      -    "template",
      -    "location",
      -    "user",
      -    "project",
      -    "project_task",
      -    "recurring_task",
      -    "comment",
      -    "document",
      -    "document_template",
      -    "workflow",
      -    "workflow_log",
      -    "form",
      -    "form_submission",
      -    "survey",
      -    "survey_submission",
      -    "campaign",
      -    "conversation",
      -    "price_list",
      -    "credit_note",
      -    "retainer_invoice",
      -    "sales_receipt",
      -    "debit_note",
      -    "delivery_challan",
      -    "time_entry",
      -    "expense",
      -    "recurring_expense",
      -    "bill",
      -    "recurring_bill",
      -    "purchase_order",
      -    "purchase_return",
      -    "vendor",
      -    "vendor_payment",
      -    "vendor_credit",
      -    "journal",
      -    "account",
      -    "tax",
      -    "currency",
      -    "bank_account"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / kind
      Removed value: -{
      -  "description": "log_activity: What to log.",
      -  "enum": [
      -    "call",
      -    "meeting"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / method
      Removed value: -{
      -  "description": "record_payment: How it was paid.",
      -  "enum": [
      -    "cash",
      -    "card",
      -    "cheque",
      -    "bank_transfer",
      -    "other"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / name
      Removed value: -{
      -  "description": "add_line_item: The name of the line.",
      -  "maxLength": 400,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / note_id
      Removed value: -{
      -  "description": "update_note: The id of the note, as list_related_records gives it.",
      -  "maxLength": 200,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / notes
      Removed value: -{
      -  "description": "add_task: More text on the task. update_task: The new text on the task. log_activity: More text on it. add_line_item: More text on the line. record_payment: More text on the payment.",
      -  "maxLength": 10000,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / other_id
      Removed value: -{
      -  "description": "link_records, unlink_records: The id of the second record in the system.",
      -  "maxLength": 200,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / other_parent
      Removed value: -{
      -  "description": "link_records, unlink_records: For a custom record, the object it belongs to, as list_items gives it.",
      -  "maxLength": 200,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / other_type
      Removed value: -{
      -  "description": "link_records, unlink_records: The type of the second record: a record type, a business or a custom record.",
      -  "enum": [
      -    "contact",
      -    "opportunity",
      -    "invoice",
      -    "estimate",
      -    "job",
      -    "appointment",
      -    "business",
      -    "custom_record"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / paid_at
      Removed value: -{
      -  "description": "record_payment: When it was paid, ISO 8601; today when left out.",
      -  "maxLength": 40,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / parent
      Removed value: -{
      -  "description": "create_item, update_item, set_item_state, move_item: The item it sits in, where the kind needs one: the object of a custom record, the product of a price, the project of a task, the task of a comment.",
      -  "maxLength": 200,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / pipeline
      Removed value: -{
      -  "description": "move_stage: The id of the pipeline, only when the stage is in another pipeline than the record's.",
      -  "maxLength": 200,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / priority
      Removed value: -{
      -  "description": "add_task: How urgent it is.",
      -  "enum": [
      -    "low",
      -    "medium",
      -    "high"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / quantity
      Removed value: -{
      -  "description": "add_line_item: How many, as a number.",
      -  "maxLength": 20,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / read
      Removed value: -{
      -  "description": "update_conversation: True to mark it read, false to mark it unread.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / items / items / properties / reason
      Removed value: -{
      -  "description": "change_consent: Why, as the person said it.",
      -  "maxLength": 400,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / reference
      Removed value: -{
      -  "description": "record_payment: A reference, such as a cheque or bank transfer number.",
      -  "maxLength": 200,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / send_at
      Removed value: -{
      -  "description": "send_message: When to send it, ISO 8601 in UTC; now when left out.",
      -  "maxLength": 40,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / sender
      Removed value: -{
      -  "description": "add_to_workflow: For a sequence: the email address of the user it is sent from, connected to the system.",
      -  "maxLength": 320,
      -  "type": "string"
      -}
    • changedInput schema / properties / items / items / properties / set / description
      Previous value: -"set_fields: field keys as describe_record_type names them (email, phone, address.city) and their new values. A money field takes a number."New value: +"Field keys as describe_record_type names them (email, phone, address.city) and their new values. A money field takes a number."
    • removedInput schema / properties / items / items / properties / stage
      Removed value: -{
      -  "description": "move_stage: The id of the stage to move to, as describe_record_type gives it with include stages.",
      -  "maxLength": 200,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / starred
      Removed value: -{
      -  "description": "update_conversation: True to star it, false to take the star off.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / items / items / properties / start_at
      Removed value: -{
      -  "description": "add_to_workflow: When it starts, ISO 8601 in UTC; now when left out.",
      -  "maxLength": 40,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / state
      Removed value: -{
      -  "description": "set_item_state: The state to put it in.",
      -  "enum": [
      -    "on",
      -    "off",
      -    "published",
      -    "draft",
      -    "started",
      -    "cancelled"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / subject
      Removed value: -{
      -  "description": "add_task: The title of the task. update_task: The new title of the task. send_message: The subject of an email.",
      -  "maxLength": 400,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / subscribed
      Removed value: -{
      -  "description": "change_consent: True to subscribe the contact, false to unsubscribe them.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / items / items / properties / tags
      Removed value: -{
      -  "description": "add_tag: The tags to add, at most 20. remove_tag: The tags to remove, at most 20.",
      -  "items": {
      -    "maxLength": 100,
      -    "type": "string"
      -  },
      -  "maxItems": 20,
      -  "minItems": 1,
      -  "type": "array"
      -}
    • removedInput schema / properties / items / items / properties / task_id
      Removed value: -{
      -  "description": "update_task: The id of the task, as list_related_records or search_tasks gives it.",
      -  "maxLength": 200,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / task_kind
      Removed value: -{
      -  "description": "add_task: What kind of task it is.",
      -  "enum": [
      -    "call",
      -    "email",
      -    "todo"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / text
      Removed value: -{
      -  "description": "add_note: The text of the note. update_note: The new text of the note. send_message: The text of the message.",
      -  "maxLength": 10000,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / title
      Removed value: -{
      -  "description": "log_activity: What it was about.",
      -  "maxLength": 400,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / to
      Removed value: -{
      -  "description": "move_item: The id of the list, group or place to move it to.",
      -  "maxLength": 200,
      -  "type": "string"
      -}
    • changedInput schema / properties / items / items / properties / type / description
      Previous value: -"The record type; link_records and unlink_records also take note or task as the first record. update_task only needs it where the system asks for it."New value: +"The record type."
    • changedInput schema / properties / items / items / properties / type / enum
      Previous value: -[
      -  "contact",
      -  "opportunity",
      -  "invoice",
      -  "estimate",
      -  "job",
      -  "appointment",
      -  "note",
      -  "task",
      -  "call",
      -  "meeting",
      -  "email"
      -]New value: +[
      +  "contact",
      +  "opportunity",
      +  "invoice",
      +  "estimate",
      +  "job",
      +  "appointment"
      +]
    • removedInput schema / properties / items / items / properties / unit_price
      Removed value: -{
      -  "description": "add_line_item: The price of one, as a number.",
      -  "maxLength": 20,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / user
      Removed value: -{
      -  "description": "assign_owner: The id of the user who becomes its owner, as describe_record_type gives it with include users. add_note: The id of the user shown as its writer, as describe_record_type gives it with include users. add_task: The id of the user the task is for, as describe_record_type gives it with include users. update_task: The id of the user the task is for now, as describe_record_type gives it with include users. log_activity: The id of the user who had it, as describe_record_type gives it with include users; some systems need it for a meeting. send_document: The id of the user it is sent from, as describe_record_type gives it with include users.",
      -  "maxLength": 200,
      -  "type": "string"
      -}
    • removedInput schema / properties / items / items / properties / users
      Removed value: -{
      -  "description": "add_follower, remove_follower: The ids of the users, as describe_record_type gives them with include users.",
      -  "items": {
      -    "maxLength": 200,
      -    "type": "string"
      -  },
      -  "maxItems": 10,
      -  "minItems": 1,
      -  "type": "array"
      -}
    • removedInput schema / properties / items / items / properties / values
      Removed value: -{
      -  "additionalProperties": true,
      -  "description": "create_item: The values of the new item, as get_item shows them for an item of this kind. update_item: The values to change, as get_item shows them.",
      -  "type": "object"
      -}
    • removedInput schema / properties / items / items / properties / workflow
      Removed value: -{
      -  "description": "add_to_workflow: The id of the workflow, campaign or sequence, as list_items gives it. remove_from_workflow: The id of the workflow or campaign, as list_items gives it.",
      -  "maxLength": 200,
      -  "type": "string"
      -}
    • changedInput schema / properties / items / items / required
      Previous value: -[]New value: +[
      +  "type"
      +]
  5. Changed6 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "set_fields",
      -  "update_fields",
      -  "move_stage",
      -  "add_note",
      -  "add_task",
      -  "update_task",
      -  "log_activity",
      -  "add_line_item",
      -  "send_record",
      -  "convert_estimate",
      -  "convert_lead",
      -  "link_records",
      -  "unlink_records",
      -  "create_item",
      -  "update_item",
      -  "set_item_state",
      -  "move_item",
      -  "add_tag",
      -  "remove_tag",
      -  "add_follower",
      -  "remove_follower",
      -  "add_to_workflow",
      -  "remove_from_workflow",
      -  "update_note",
      -  "send_message",
      -  "update_conversation",
      -  "record_payment",
      -  "change_consent",
      -  "void_record",
      -  "send_document"
      -]New value: +[
      +  "set_fields",
      +  "create_record",
      +  "notify",
      +  "update_fields",
      +  "move_stage",
      +  "assign_owner",
      +  "add_note",
      +  "add_task",
      +  "update_task",
      +  "log_activity",
      +  "add_line_item",
      +  "send_record",
      +  "convert_estimate",
      +  "convert_lead",
      +  "link_records",
      +  "unlink_records",
      +  "create_item",
      +  "update_item",
      +  "set_item_state",
      +  "move_item",
      +  "add_tag",
      +  "remove_tag",
      +  "add_follower",
      +  "remove_follower",
      +  "add_to_workflow",
      +  "remove_from_workflow",
      +  "update_note",
      +  "send_message",
      +  "update_conversation",
      +  "record_payment",
      +  "change_consent",
      +  "void_record",
      +  "send_document",
      +  "email_contact"
      +]
    • changedInput schema / properties / items / items / properties / automation_kind / description
      Previous value: -"add_to_workflow, remove_from_workflow: A workflow or a campaign; workflow when left out."New value: +"add_to_workflow: A workflow, a campaign or a sales sequence; workflow when left out. remove_from_workflow: A workflow or a campaign; workflow when left out."
    • changedInput schema / properties / items / items / properties / automation_kind / enum
      Previous value: -[
      -  "workflow",
      -  "campaign"
      -]New value: +[
      +  "workflow",
      +  "campaign",
      +  "sequence"
      +]
    • addedInput schema / properties / items / items / properties / sender
      Added value: +{
      +  "description": "add_to_workflow: For a sequence: the email address of the user it is sent from, connected to the system.",
      +  "maxLength": 320,
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / user / description
      Previous value: -"add_note: The id of the user shown as its writer, as describe_record_type gives it with include users. add_task: The id of the user the task is for, as describe_record_type gives it with include users. update_task: The id of the user the task is for now, as describe_record_type gives it with include users. log_activity: The id of the user who had it, as describe_record_type gives it with include users; some systems need it for a meeting. send_document: The id of the user it is sent from, as describe_record_type gives it with include users."New value: +"assign_owner: The id of the user who becomes its owner, as describe_record_type gives it with include users. add_note: The id of the user shown as its writer, as describe_record_type gives it with include users. add_task: The id of the user the task is for, as describe_record_type gives it with include users. update_task: The id of the user the task is for now, as describe_record_type gives it with include users. log_activity: The id of the user who had it, as describe_record_type gives it with include users; some systems need it for a meeting. send_document: The id of the user it is sent from, as describe_record_type gives it with include users."
    • changedInput schema / properties / items / items / properties / workflow / description
      Previous value: -"add_to_workflow, remove_from_workflow: The id of the workflow or campaign, as list_items gives it."New value: +"add_to_workflow: The id of the workflow, campaign or sequence, as list_items gives it. remove_from_workflow: The id of the workflow or campaign, as list_items gives it."
  6. Changed2 schema fields changed
    • changedInput schema / properties / items / items / properties / into / enum
      Previous value: -[
      -  "estimate",
      -  "job"
      -]New value: +[
      +  "estimate",
      +  "job",
      +  "contact"
      +]
    • changedInput schema / properties / items / items / properties / item_kind / enum
      Previous value: -[
      -  "business",
      -  "custom_record",
      -  "object",
      -  "link_type",
      -  "link",
      -  "product",
      -  "price",
      -  "product_collection",
      -  "coupon",
      -  "order",
      -  "transaction",
      -  "subscription",
      -  "invoice_schedule",
      -  "invoice_template",
      -  "calendar",
      -  "calendar_group",
      -  "calendar_resource",
      -  "blocked_slot",
      -  "service",
      -  "booking",
      -  "pipeline",
      -  "custom_field",
      -  "custom_value",
      -  "location_tag",
      -  "template",
      -  "location",
      -  "user",
      -  "project",
      -  "project_task",
      -  "recurring_task",
      -  "comment",
      -  "document",
      -  "document_template",
      -  "workflow",
      -  "workflow_log",
      -  "form",
      -  "form_submission",
      -  "survey",
      -  "survey_submission",
      -  "campaign",
      -  "conversation"
      -]New value: +[
      +  "business",
      +  "custom_record",
      +  "object",
      +  "link_type",
      +  "link",
      +  "product",
      +  "price",
      +  "product_collection",
      +  "coupon",
      +  "order",
      +  "transaction",
      +  "subscription",
      +  "invoice_schedule",
      +  "invoice_template",
      +  "calendar",
      +  "calendar_group",
      +  "calendar_resource",
      +  "blocked_slot",
      +  "service",
      +  "booking",
      +  "pipeline",
      +  "custom_field",
      +  "custom_value",
      +  "location_tag",
      +  "template",
      +  "location",
      +  "user",
      +  "project",
      +  "project_task",
      +  "recurring_task",
      +  "comment",
      +  "document",
      +  "document_template",
      +  "workflow",
      +  "workflow_log",
      +  "form",
      +  "form_submission",
      +  "survey",
      +  "survey_submission",
      +  "campaign",
      +  "conversation",
      +  "price_list",
      +  "credit_note",
      +  "retainer_invoice",
      +  "sales_receipt",
      +  "debit_note",
      +  "delivery_challan",
      +  "time_entry",
      +  "expense",
      +  "recurring_expense",
      +  "bill",
      +  "recurring_bill",
      +  "purchase_order",
      +  "purchase_return",
      +  "vendor",
      +  "vendor_payment",
      +  "vendor_credit",
      +  "journal",
      +  "account",
      +  "tax",
      +  "currency",
      +  "bank_account"
      +]
  7. Changed33 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "set_fields",
      -  "update_fields",
      -  "move_stage",
      -  "add_note",
      -  "add_task",
      -  "update_task",
      -  "log_activity",
      -  "add_line_item",
      -  "send_record",
      -  "convert_estimate",
      -  "link_records",
      -  "unlink_records"
      -]New value: +[
      +  "set_fields",
      +  "update_fields",
      +  "move_stage",
      +  "add_note",
      +  "add_task",
      +  "update_task",
      +  "log_activity",
      +  "add_line_item",
      +  "send_record",
      +  "convert_estimate",
      +  "convert_lead",
      +  "link_records",
      +  "unlink_records",
      +  "create_item",
      +  "update_item",
      +  "set_item_state",
      +  "move_item",
      +  "add_tag",
      +  "remove_tag",
      +  "add_follower",
      +  "remove_follower",
      +  "add_to_workflow",
      +  "remove_from_workflow",
      +  "update_note",
      +  "send_message",
      +  "update_conversation",
      +  "record_payment",
      +  "change_consent",
      +  "void_record",
      +  "send_document"
      +]
    • addedInput schema / properties / items / items / properties / amount
      Added value: +{
      +  "description": "record_payment: How much was paid, as a number.",
      +  "maxLength": 20,
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / automation_kind
      Added value: +{
      +  "description": "add_to_workflow, remove_from_workflow: A workflow or a campaign; workflow when left out.",
      +  "enum": [
      +    "workflow",
      +    "campaign"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / channel
      Added value: +{
      +  "description": "send_message: How it is sent.",
      +  "enum": [
      +    "email",
      +    "sms",
      +    "whatsapp",
      +    "facebook",
      +    "instagram",
      +    "live_chat"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / conversation_id
      Added value: +{
      +  "description": "update_conversation: The id of the conversation, as list_related_records gives it.",
      +  "maxLength": 200,
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / email / description
      Previous value: -"send_record: Send to this address instead of the one on the record."New value: +"send_record: Send to this address instead of the one on the record. send_message: Send to this address of the contact instead of their main one."
    • addedInput schema / properties / items / items / properties / into
      Added value: +{
      +  "description": "convert_lead: What the lead becomes.",
      +  "enum": [
      +    "estimate",
      +    "job"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / item_id
      Added value: +{
      +  "description": "update_item, set_item_state, move_item: The id of the item, as list_items gives it. send_document: The id of the document or template, as list_items gives it.",
      +  "maxLength": 200,
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / item_kind
      Added value: +{
      +  "description": "create_item: Which kind of item to make. update_item: Which kind of item to change. set_item_state, move_item: Which kind of item it is. record_payment: For an order, the kind order instead of a type. send_document: A document that exists, or a template to make one from.",
      +  "enum": [
      +    "business",
      +    "custom_record",
      +    "object",
      +    "link_type",
      +    "link",
      +    "product",
      +    "price",
      +    "product_collection",
      +    "coupon",
      +    "order",
      +    "transaction",
      +    "subscription",
      +    "invoice_schedule",
      +    "invoice_template",
      +    "calendar",
      +    "calendar_group",
      +    "calendar_resource",
      +    "blocked_slot",
      +    "service",
      +    "booking",
      +    "pipeline",
      +    "custom_field",
      +    "custom_value",
      +    "location_tag",
      +    "template",
      +    "location",
      +    "user",
      +    "project",
      +    "project_task",
      +    "recurring_task",
      +    "comment",
      +    "document",
      +    "document_template",
      +    "workflow",
      +    "workflow_log",
      +    "form",
      +    "form_submission",
      +    "survey",
      +    "survey_submission",
      +    "campaign",
      +    "conversation"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / method
      Added value: +{
      +  "description": "record_payment: How it was paid.",
      +  "enum": [
      +    "cash",
      +    "card",
      +    "cheque",
      +    "bank_transfer",
      +    "other"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / note_id
      Added value: +{
      +  "description": "update_note: The id of the note, as list_related_records gives it.",
      +  "maxLength": 200,
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / notes / description
      Previous value: -"add_task: More text on the task. update_task: The new text on the task. log_activity: More text on it. add_line_item: More text on the line."New value: +"add_task: More text on the task. update_task: The new text on the task. log_activity: More text on it. add_line_item: More text on the line. record_payment: More text on the payment."
    • addedInput schema / properties / items / items / properties / other_parent
      Added value: +{
      +  "description": "link_records, unlink_records: For a custom record, the object it belongs to, as list_items gives it.",
      +  "maxLength": 200,
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / other_type / description
      Previous value: -"link_records, unlink_records: The type of the second record."New value: +"link_records, unlink_records: The type of the second record: a record type, a business or a custom record."
    • changedInput schema / properties / items / items / properties / other_type / enum
      Previous value: -[
      -  "contact",
      -  "opportunity",
      -  "invoice",
      -  "estimate",
      -  "job",
      -  "appointment"
      -]New value: +[
      +  "contact",
      +  "opportunity",
      +  "invoice",
      +  "estimate",
      +  "job",
      +  "appointment",
      +  "business",
      +  "custom_record"
      +]
    • addedInput schema / properties / items / items / properties / paid_at
      Added value: +{
      +  "description": "record_payment: When it was paid, ISO 8601; today when left out.",
      +  "maxLength": 40,
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / parent
      Added value: +{
      +  "description": "create_item, update_item, set_item_state, move_item: The item it sits in, where the kind needs one: the object of a custom record, the product of a price, the project of a task, the task of a comment.",
      +  "maxLength": 200,
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / read
      Added value: +{
      +  "description": "update_conversation: True to mark it read, false to mark it unread.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / items / items / properties / reason
      Added value: +{
      +  "description": "change_consent: Why, as the person said it.",
      +  "maxLength": 400,
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / reference
      Added value: +{
      +  "description": "record_payment: A reference, such as a cheque or bank transfer number.",
      +  "maxLength": 200,
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / send_at
      Added value: +{
      +  "description": "send_message: When to send it, ISO 8601 in UTC; now when left out.",
      +  "maxLength": 40,
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / starred
      Added value: +{
      +  "description": "update_conversation: True to star it, false to take the star off.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / items / items / properties / start_at
      Added value: +{
      +  "description": "add_to_workflow: When it starts, ISO 8601 in UTC; now when left out.",
      +  "maxLength": 40,
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / state
      Added value: +{
      +  "description": "set_item_state: The state to put it in.",
      +  "enum": [
      +    "on",
      +    "off",
      +    "published",
      +    "draft",
      +    "started",
      +    "cancelled"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / subject / description
      Previous value: -"add_task: The title of the task. update_task: The new title of the task."New value: +"add_task: The title of the task. update_task: The new title of the task. send_message: The subject of an email."
    • addedInput schema / properties / items / items / properties / subscribed
      Added value: +{
      +  "description": "change_consent: True to subscribe the contact, false to unsubscribe them.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / items / items / properties / tags
      Added value: +{
      +  "description": "add_tag: The tags to add, at most 20. remove_tag: The tags to remove, at most 20.",
      +  "items": {
      +    "maxLength": 100,
      +    "type": "string"
      +  },
      +  "maxItems": 20,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • changedInput schema / properties / items / items / properties / text / description
      Previous value: -"add_note: The text of the note."New value: +"add_note: The text of the note. update_note: The new text of the note. send_message: The text of the message."
    • addedInput schema / properties / items / items / properties / to
      Added value: +{
      +  "description": "move_item: The id of the list, group or place to move it to.",
      +  "maxLength": 200,
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / user / description
      Previous value: -"add_note: The id of the user shown as its writer, as describe_record_type gives it with include users. add_task: The id of the user the task is for, as describe_record_type gives it with include users. update_task: The id of the user the task is for now, as describe_record_type gives it with include users. log_activity: The id of the user who had it, as describe_record_type gives it with include users; some systems need it for a meeting."New value: +"add_note: The id of the user shown as its writer, as describe_record_type gives it with include users. add_task: The id of the user the task is for, as describe_record_type gives it with include users. update_task: The id of the user the task is for now, as describe_record_type gives it with include users. log_activity: The id of the user who had it, as describe_record_type gives it with include users; some systems need it for a meeting. send_document: The id of the user it is sent from, as describe_record_type gives it with include users."
    • addedInput schema / properties / items / items / properties / users
      Added value: +{
      +  "description": "add_follower, remove_follower: The ids of the users, as describe_record_type gives them with include users.",
      +  "items": {
      +    "maxLength": 200,
      +    "type": "string"
      +  },
      +  "maxItems": 10,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • addedInput schema / properties / items / items / properties / values
      Added value: +{
      +  "additionalProperties": true,
      +  "description": "create_item: The values of the new item, as get_item shows them for an item of this kind. update_item: The values to change, as get_item shows them.",
      +  "type": "object"
      +}
    • addedInput schema / properties / items / items / properties / workflow
      Added value: +{
      +  "description": "add_to_workflow, remove_from_workflow: The id of the workflow or campaign, as list_items gives it.",
      +  "maxLength": 200,
      +  "type": "string"
      +}
  8. Changed2 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "set_fields",
      -  "update_fields",
      -  "move_stage",
      -  "add_note",
      -  "add_task",
      -  "update_task",
      -  "log_activity",
      -  "add_line_item",
      -  "link_records",
      -  "unlink_records"
      -]New value: +[
      +  "set_fields",
      +  "update_fields",
      +  "move_stage",
      +  "add_note",
      +  "add_task",
      +  "update_task",
      +  "log_activity",
      +  "add_line_item",
      +  "send_record",
      +  "convert_estimate",
      +  "link_records",
      +  "unlink_records"
      +]
    • addedInput schema / properties / items / items / properties / email
      Added value: +{
      +  "description": "send_record: Send to this address instead of the one on the record.",
      +  "maxLength": 320,
      +  "type": "string"
      +}
  9. Changed14 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "set_fields",
      -  "update_fields",
      -  "move_stage",
      -  "add_note",
      -  "add_task",
      -  "update_task",
      -  "link_records",
      -  "unlink_records"
      -]New value: +[
      +  "set_fields",
      +  "update_fields",
      +  "move_stage",
      +  "add_note",
      +  "add_task",
      +  "update_task",
      +  "log_activity",
      +  "add_line_item",
      +  "link_records",
      +  "unlink_records"
      +]
    • changedInput schema / properties / items / items / properties / at / description
      Previous value: -"add_note: When the note is from, ISO 8601 in UTC; now when left out."New value: +"add_note: When the note is from, ISO 8601 in UTC; now when left out. log_activity: When it took place, ISO 8601 in UTC; now when left out."
    • addedInput schema / properties / items / items / properties / end_at
      Added value: +{
      +  "description": "log_activity: When a meeting ended, ISO 8601 in UTC.",
      +  "maxLength": 40,
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / id / description
      Previous value: -"The id of the record in the system. Leave it out only with set_fields, to make a new record."New value: +"The id of the record in the system. Leave it out with set_fields to make a new record, and with update_task where the system does not ask for it."
    • addedInput schema / properties / items / items / properties / kind
      Added value: +{
      +  "description": "log_activity: What to log.",
      +  "enum": [
      +    "call",
      +    "meeting"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / items / items / properties / name
      Added value: +{
      +  "description": "add_line_item: The name of the line.",
      +  "maxLength": 400,
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / notes / description
      Previous value: -"add_task: More text on the task. update_task: The new text on the task."New value: +"add_task: More text on the task. update_task: The new text on the task. log_activity: More text on it. add_line_item: More text on the line."
    • addedInput schema / properties / items / items / properties / quantity
      Added value: +{
      +  "description": "add_line_item: How many, as a number.",
      +  "maxLength": 20,
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / task_id / description
      Previous value: -"update_task: The id of the task, as list_related_records gives it."New value: +"update_task: The id of the task, as list_related_records or search_tasks gives it."
    • addedInput schema / properties / items / items / properties / title
      Added value: +{
      +  "description": "log_activity: What it was about.",
      +  "maxLength": 400,
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / type / description
      Previous value: -"The record type; link_records and unlink_records also take note or task as the first record."New value: +"The record type; link_records and unlink_records also take note or task as the first record. update_task only needs it where the system asks for it."
    • addedInput schema / properties / items / items / properties / unit_price
      Added value: +{
      +  "description": "add_line_item: The price of one, as a number.",
      +  "maxLength": 20,
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / user / description
      Previous value: -"add_note: The id of the user shown as its writer, as describe_record_type gives it with include users. add_task: The id of the user the task is for, as describe_record_type gives it with include users. update_task: The id of the user the task is for now, as describe_record_type gives it with include users."New value: +"add_note: The id of the user shown as its writer, as describe_record_type gives it with include users. add_task: The id of the user the task is for, as describe_record_type gives it with include users. update_task: The id of the user the task is for now, as describe_record_type gives it with include users. log_activity: The id of the user who had it, as describe_record_type gives it with include users; some systems need it for a meeting."
    • changedInput schema / properties / items / items / required
      Previous value: -[
      -  "type"
      -]New value: +[]
  10. Changed1 schema field changed
    • changedInput schema / properties / system / description
      Previous value: -"Which AI agent: the system's id from list_ai_systems, or the name of the system or its connection. Ask the person which AI agent they mean unless they named it in this conversation; never pick one yourself."New value: +"Which AI agent: the system's id from get_ai_agents_info, or the name of the system or its connection. Ask the person which AI agent they mean unless they named it in this conversation; never pick one yourself."
  11. Changed7 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "set_fields",
      -  "update_fields",
      -  "move_stage",
      -  "add_note",
      -  "add_task",
      -  "link_records",
      -  "unlink_records"
      -]New value: +[
      +  "set_fields",
      +  "update_fields",
      +  "move_stage",
      +  "add_note",
      +  "add_task",
      +  "update_task",
      +  "link_records",
      +  "unlink_records"
      +]
    • changedInput schema / properties / items / items / properties / done / description
      Previous value: -"add_task: True for a task that is already done."New value: +"add_task: True for a task that is already done. update_task: True when the task is done, false to open it again."
    • changedInput schema / properties / items / items / properties / due_at / description
      Previous value: -"add_task: When it is due, ISO 8601 in UTC."New value: +"add_task: When it is due, ISO 8601 in UTC. update_task: When it is due now, ISO 8601 in UTC."
    • changedInput schema / properties / items / items / properties / notes / description
      Previous value: -"add_task: More text on the task."New value: +"add_task: More text on the task. update_task: The new text on the task."
    • changedInput schema / properties / items / items / properties / subject / description
      Previous value: -"add_task: The title of the task."New value: +"add_task: The title of the task. update_task: The new title of the task."
    • addedInput schema / properties / items / items / properties / task_id
      Added value: +{
      +  "description": "update_task: The id of the task, as list_related_records gives it.",
      +  "maxLength": 200,
      +  "type": "string"
      +}
    • changedInput schema / properties / items / items / properties / user / description
      Previous value: -"add_note: The id of the user shown as its writer, as describe_record_type gives it with include users. add_task: The id of the user the task is for, as describe_record_type gives it with include users."New value: +"add_note: The id of the user shown as its writer, as describe_record_type gives it with include users. add_task: The id of the user the task is for, as describe_record_type gives it with include users. update_task: The id of the user the task is for now, as describe_record_type gives it with include users."
  12. Changed4 schema fields changed
    • addedInput schema / properties / action
      Added value: +{
      +  "default": "set_fields",
      +  "description": "What to propose; set_fields when left out.",
      +  "enum": [
      +    "set_fields",
      +    "update_fields",
      +    "move_stage",
      +    "add_note",
      +    "add_task",
      +    "link_records",
      +    "unlink_records"
      +  ],
      +  "type": "string"
      +}
    • removedInput schema / properties / changes
      Removed value: -{
      -  "description": "The records to change or make, at most 25.",
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "clear": {
      -        "description": "Field keys to empty; only fields describe_record_type marks clearable.",
      -        "items": {
      -          "maxLength": 80,
      -          "type": "string"
      -        },
      -        "maxItems": 40,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "id": {
      -        "description": "The id of the record to change. Leave it out to make a new record.",
      -        "maxLength": 200,
      -        "type": "string"
      -      },
      -      "set": {
      -        "additionalProperties": true,
      -        "description": "Field keys as describe_record_type names them (email, phone, address.city) and their new values. A money field takes a number.",
      -        "type": "object"
      -      },
      -      "type": {
      -        "description": "The record type, as list_ai_systems lists it: contact, opportunity, invoice, estimate, job, appointment.",
      -        "maxLength": 40,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  "maxItems": 25,
      -  "minItems": 1,
      -  "type": "array"
      -}
    • addedInput schema / properties / items
      Added value: +{
      +  "description": "One object per record, at most 25, with the values the action takes.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "at": {
      +        "description": "add_note: When the note is from, ISO 8601 in UTC; now when left out.",
      +        "maxLength": 40,
      +        "type": "string"
      +      },
      +      "clear": {
      +        "description": "set_fields: field keys to empty; only fields describe_record_type marks clearable.",
      +        "items": {
      +          "maxLength": 80,
      +          "type": "string"
      +        },
      +        "maxItems": 40,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "done": {
      +        "description": "add_task: True for a task that is already done.",
      +        "type": "boolean"
      +      },
      +      "due_at": {
      +        "description": "add_task: When it is due, ISO 8601 in UTC.",
      +        "maxLength": 40,
      +        "type": "string"
      +      },
      +      "fields": {
      +        "additionalProperties": {
      +          "type": "string"
      +        },
      +        "description": "update_fields: Field names and their new values as text; an empty text empties a field.",
      +        "type": "object"
      +      },
      +      "id": {
      +        "description": "The id of the record in the system. Leave it out only with set_fields, to make a new record.",
      +        "maxLength": 200,
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "add_task: More text on the task.",
      +        "maxLength": 10000,
      +        "type": "string"
      +      },
      +      "other_id": {
      +        "description": "link_records, unlink_records: The id of the second record in the system.",
      +        "maxLength": 200,
      +        "type": "string"
      +      },
      +      "other_type": {
      +        "description": "link_records, unlink_records: The type of the second record.",
      +        "enum": [
      +          "contact",
      +          "opportunity",
      +          "invoice",
      +          "estimate",
      +          "job",
      +          "appointment"
      +        ],
      +        "type": "string"
      +      },
      +      "pipeline": {
      +        "description": "move_stage: The id of the pipeline, only when the stage is in another pipeline than the record's.",
      +        "maxLength": 200,
      +        "type": "string"
      +      },
      +      "priority": {
      +        "description": "add_task: How urgent it is.",
      +        "enum": [
      +          "low",
      +          "medium",
      +          "high"
      +        ],
      +        "type": "string"
      +      },
      +      "set": {
      +        "additionalProperties": true,
      +        "description": "set_fields: field keys as describe_record_type names them (email, phone, address.city) and their new values. A money field takes a number.",
      +        "type": "object"
      +      },
      +      "stage": {
      +        "description": "move_stage: The id of the stage to move to, as describe_record_type gives it with include stages.",
      +        "maxLength": 200,
      +        "type": "string"
      +      },
      +      "subject": {
      +        "description": "add_task: The title of the task.",
      +        "maxLength": 400,
      +        "type": "string"
      +      },
      +      "task_kind": {
      +        "description": "add_task: What kind of task it is.",
      +        "enum": [
      +          "call",
      +          "email",
      +          "todo"
      +        ],
      +        "type": "string"
      +      },
      +      "text": {
      +        "description": "add_note: The text of the note.",
      +        "maxLength": 10000,
      +        "type": "string"
      +      },
      +      "type": {
      +        "description": "The record type; link_records and unlink_records also take note or task as the first record.",
      +        "enum": [
      +          "contact",
      +          "opportunity",
      +          "invoice",
      +          "estimate",
      +          "job",
      +          "appointment",
      +          "note",
      +          "task",
      +          "call",
      +          "meeting",
      +          "email"
      +        ],
      +        "type": "string"
      +      },
      +      "user": {
      +        "description": "add_note: The id of the user shown as its writer, as describe_record_type gives it with include users. add_task: The id of the user the task is for, as describe_record_type gives it with include users.",
      +        "maxLength": 200,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 25,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "system",
      -  "changes"
      -]New value: +[
      +  "system",
      +  "items"
      +]
  13. First observed

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description discloses the most important behavioral trait beyond the annotations: the call writes nothing and only stages a proposal that requires human confirmation, with a named commit tool and an approval-link fallback. That is exactly the context an agent needs. Minor gap: it says 'Writes nothing' while readOnlyHint=false and idempotentHint=false, and does not reconcile this (the call does persist a proposal artifact); explaining why calling twice produces two proposals would fully close the loop.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the agent trigger and everything after it is load-bearing: routing, item shape, the non-writing behavior, and the commit path. It is a dense run-on sentence with a parenthetical, so it is slightly harder to scan than it could be, but there is no filler to cut.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given an output schema exists (so return values need no explanation), full schema coverage, and annotations covering the safety profile, the description supplies everything an agent still lacks: trigger, exclusions, alternatives, item semantics, and the mandatory confirmation/commit workflow. Nothing needed to call it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, and the description earns above baseline by explaining the intent-level shape: one entry per record with its type, an id that is omitted for a new record, a 'set' map of field keys to values, and a 'clear' list of keys to empty. It does not repeat the schema's limits (max 25 items, the 7-value type enum) but it does add the create-vs-update mental model the schema only implies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb+resource (propose changes to record fields) and enumerates the exact operations: fill, correct, empty fields, or create a new record. It also carves out scope against siblings, stating that notes, tasks, stages and links have their own propose_ tool, so an agent can route without opening another schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit trigger ('when the person asks to fill, correct or empty fields... or to make a new record'), an explicit exclusion ('Not for reading (use search_records)'), and the required follow-up path (show it, then call apply_proposal on a yes, or share the approve link if needsApproval). Nothing about when to choose this over alternatives is left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources