Skip to main content
Glama

Log activity

log_touch

Record a call, email, meeting or LinkedIn activity; link account_id, contact_id or opportunity_id (at least one is required: call search_records first to get the ID). Check existing activity: source_touch_id reuses captured work and fills missing details; don't narrate routine duplicates. New work needs request_id + occurred_at for retries; no time given means now, so don't ask. sequence_action records an explicit step outcome; retry the same payload for pending tracking. Process captured meetings without logging another activity: propose_updates(source_touch_id) then review_proposed_updates.

When to use: After any meaningful interaction. commit_reviewed_updates often applies this from an approved review. Logging an email or call the system also collects? Pass its id (the Gmail message id, the call id) as external_id, so the sync and the agent land on one activity.

Example: Log a 45-min discovery call with Sarah at Acme yesterday — covered pain, impact, decision criteria.

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": {
      "type": "<type>"
    },
    "name": "log_touch"
  }
}

Input Schema

NameRequiredDescriptionDefault
typeYesDefaults: call | email | meeting | linkedin | sms | other. A workspace admin may rename or add values — see the live set in propose_updates' workspace.enum_values, or an admin's describe_schema.
sourceNoOmit to use mcp. Defaults: manual | transcript_paste | api | mcp | inbox_import | calendar_import | imported_csv | scheduler | recorder | reply_io | instantly. A workspace admin may rename or add values — see the live set in propose_updates' workspace.enum_values, or an admin's describe_schema.
subjectNoShort title of the activity (an email's subject line, a meeting's title); searchable and part of the duplicate fingerprint.
summaryNoPlain-text account of what happened or was discussed — the rep's notes for an unrecorded call; searchable together with the subject.
directionNoDefaults: inbound | outbound. A workspace admin may rename or add values — see the live set in propose_updates' workspace.enum_values, or an admin's describe_schema.
account_idNoA uuid.
contact_idNoA uuid.
request_idNoUUID; requires explicit occurred_at (now if unspecified); keep both unchanged on retry.
external_idNoThe activity's id in the system it came from (a Gmail message id, a dialer call id). An activity this workspace already holds under that id is returned instead of logged again (duplicate_suppressed), with only its blank details filled from this call.
occurred_atNoAn ISO 8601 datetime.
participantsNoEmail addresses of the people on the activity (sender or recipients, meeting attendees), stored as a flat list and matched by participant search.
custom_fieldsNoValues for the workspace's custom activity fields, keyed by field key (see describe_schema); the reserved capable_sequence_action key is refused — use sequence_action.
opportunity_idNoA uuid.
sequence_actionNoRequires outbound matching-channel evidence. Call attempts or LinkedIn requests hold the step and need follow_up_on; not_now pauses. Acceptance needs confirmation. Omitted outcome means completed.
source_touch_idNoReuse captured activity; fill missing facts only. Conflicts need explicit correction. Use instead of request_id.
duration_minutesNoAn integer ≥ 0.

Output Schema

NameRequiredDescriptionDefault
noteNo
touchNo
accountNo
sequence_trackingNo
duplicate_suppressedNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / custom_fields / description
      Previous value: -"Values for the workspace's custom touch fields, keyed by field key (see describe_schema); the reserved capable_sequence_action key is refused — use sequence_action."New value: +"Values for the workspace's custom activity fields, keyed by field key (see describe_schema); the reserved capable_sequence_action key is refused — use sequence_action."
  2. Changed1 schema field changed
    • changedInput schema / properties / source / description
      Previous value: -"Defaults: manual | transcript_paste | api | mcp | inbox_import | calendar_import | imported_csv | scheduler | recorder | reply_io | instantly. A workspace admin may rename or add values — see the live set in propose_updates' workspace.enum_values, or an admin's describe_schema."New value: +"Omit to use mcp. Defaults: manual | transcript_paste | api | mcp | inbox_import | calendar_import | imported_csv | scheduler | recorder | reply_io | instantly. A workspace admin may rename or add values — see the live set in propose_updates' workspace.enum_values, or an admin's describe_schema."
  3. Changed1 schema field changed
    • changedInput schema / properties / request_id / description
      Previous value: -"A uuid."New value: +"UUID; requires explicit occurred_at (now if unspecified); keep both unchanged on retry."
  4. Changed6 schema fields changed
    • removedInput schema / properties / duration_minutes / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / duration_minutes / type
      Added value: +[
      +  "number",
      +  "string"
      +]
    • addedInput schema / properties / external_id
      Added value: +{
      +  "description": "The activity's id in the system it came from (a Gmail message id, a dialer call id). An activity this workspace already holds under that id is returned instead of logged again (duplicate_suppressed), with only its blank details filled from this call.",
      +  "type": "string"
      +}
    • removedInput schema / properties / sequence_action / properties / step / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / sequence_action / properties / step / type
      Added value: +[
      +  "number",
      +  "string"
      +]
    • changedInput schema / properties / type / description
      Previous value: -"Defaults: call | email | meeting | linkedin | other. A workspace admin may rename or add values — see the live set in propose_updates' workspace.enum_values, or an admin's describe_schema."New value: +"Defaults: call | email | meeting | linkedin | sms | other. A workspace admin may rename or add values — see the live set in propose_updates' workspace.enum_values, or an admin's describe_schema."
  5. Changed1 schema field changed
    • removedInput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
  6. Changed1 schema field changed
    • removedInput schema / properties / sequence_action / properties / follow_up_on / pattern
      Removed value: -"^(?:(?:\\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])))$"
  7. Changed7 schema fields changed
    • removedOutput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
    • removedOutput schema / additionalProperties
      Removed value: -{}
    • changedOutput schema / properties / account / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "current_arr_cents": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "id": {
      -        "format": "uuid",
      -        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      -        "type": "string"
      -      },
      -      "lifecycle_stage": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "name": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "id"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "current_arr_cents": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "lifecycle_stage": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "name": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "id"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / sequence_tracking / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / sequence_tracking / properties / enrollment_id / pattern
      Removed value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    • removedOutput schema / properties / touch / additionalProperties
      Removed value: -{}
    • removedOutput schema / properties / touch / propertyNames
      Removed value: -{
      -  "type": "string"
      -}
  8. Changed5 schema fields changed
    • changedInput schema / properties / sequence_action / description
      Previous value: -"Completes a sequence step: {enrollment_id: uuid, step: the person's current step}; needs request_id, contact_id, occurred_at, direction 'outbound' and the step's channel as type."New value: +"Requires outbound matching-channel evidence. Call attempts or LinkedIn requests hold the step and need follow_up_on; not_now pauses. Acceptance needs confirmation. Omitted outcome means completed."
    • addedInput schema / properties / sequence_action / properties / follow_up_on
      Added value: +{
      +  "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"
      +}
    • addedInput schema / properties / sequence_action / properties / outcome
      Added value: +{
      +  "description": "One of: completed | no_answer | left_voicemail | not_now | connection_requested | connection_accepted.",
      +  "type": "string"
      +}
    • addedInput schema / properties / source_touch_id
      Added value: +{
      +  "description": "Reuse captured activity; fill missing facts only. Conflicts need explicit correction. Use instead of request_id.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / note
      Added value: +{
      +  "type": "string"
      +}
  9. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources