MCP Tools
Context & Resources

update_call_instruction

Edit the wording of a standing call instruction or switch it off and back on without deleting it.

Parameters

NameTypeRequiredDefaultDescription
team_idintegerYes—Team id to act in (from initialize instructions or get_current_user_info). Required on external MCP; optional in bound sessions.
instruction_idstring (uuid)Yes—The instruction's instruction_id, from list_call_instructions.
textstringNo—Guidance only: the new instruction text.
findstringNo—Word fix only: the new word or phrase to find.
replacestringNo—Word fix only: the new replacement.
enabledbooleanNo—false switches it off but keeps it; true switches it back on.

Input Schema

{
  "type": "object",
  "required": [
    "team_id",
    "instruction_id"
  ],
  "properties": {
    "find": {
      "type": "string",
      "maxLength": 100,
      "description": "Word fix only: the new word or phrase to find."
    },
    "text": {
      "type": "string",
      "maxLength": 300,
      "description": "Guidance only: the new instruction text."
    },
    "enabled": {
      "type": "boolean",
      "description": "false switches it off but keeps it; true switches it back on."
    },
    "replace": {
      "type": "string",
      "maxLength": 200,
      "description": "Word fix only: the new replacement."
    },
    "team_id": {
      "type": "integer",
      "minimum": 1,
      "description": "Team id to act in (from initialize instructions or get_current_user_info). Required on external MCP; optional in bound sessions."
    },
    "instruction_id": {
      "type": "string",
      "format": "uuid",
      "description": "The instruction's instruction_id, from list_call_instructions."
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "instruction",
    "note"
  ],
  "properties": {
    "note": {
      "type": "string",
      "description": "Reminder of when the change takes effect."
    },
    "team": {
      "type": "object",
      "required": [
        "id",
        "name"
      ],
      "properties": {
        "id": {
          "type": "integer"
        },
        "name": {
          "type": "string"
        }
      },
      "description": "Team this action applied to."
    },
    "instruction": {
      "type": "object",
      "required": [
        "instruction_id",
        "kind",
        "scope",
        "automatic_call_import_id",
        "enabled",
        "source",
        "created_at",
        "updated_at"
      ],
      "properties": {
        "find": {
          "type": "string",
          "description": "word_fix only: the word or phrase to correct."
        },
        "kind": {
          "enum": [
            "word_fix",
            "guidance"
          ],
          "type": "string",
          "description": "word_fix corrects a recurring transcription error; guidance steers what Marcora suggests from calls."
        },
        "text": {
          "type": "string",
          "description": "guidance only: the instruction, in the user's words."
        },
        "scope": {
          "enum": [
            "default",
            "automatic_call_import"
          ],
          "type": "string",
          "description": "default: applies to all the user's calls. automatic_call_import: only calls from that automatic call import."
        },
        "source": {
          "enum": [
            "settings",
            "automatic_call_import",
            "dismissal",
            "agent"
          ],
          "type": "string",
          "description": "Where it was created: agent means saved through this tool."
        },
        "enabled": {
          "type": "boolean",
          "description": "False means saved but switched off."
        },
        "replace": {
          "type": "string",
          "description": "word_fix only: what to replace it with."
        },
        "created_at": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601."
        },
        "updated_at": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601."
        },
        "instruction_id": {
          "type": "string",
          "format": "uuid",
          "description": "Id to use with update_call_instruction and remove_call_instruction."
        },
        "automatic_call_import_id": {
          "type": [
            "string",
            "null"
          ],
          "format": "uuid",
          "description": "The automatic call import this is limited to, or null for the defaults."
        }
      }
    }
  }
}

Instructions

Edits or switches on/off one of the user's standing call instructions. Use it to correct the wording, change a word fix, or turn an instruction off (enabled false) or back on without losing it. Get instruction_id from list_call_instructions. A word fix can change find and replace; guidance can change text; send only what changes. To make an instruction apply to a different automatic call import, remove it and add it again. Changes apply to calls processed from now on; calls already imported are not changed.