MCP Tools
Context & Resources

add_call_instruction

Save a standing instruction (guidance or a recurring transcription word fix) for how Marcora handles your future calls.

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.
kindstringYes—word_fix needs `find` and `replace`; guidance needs `text`.
textstringNo—guidance only: the instruction in one short sentence, in the user's words.
findstringNo—word_fix only: the word or phrase as it is wrongly transcribed. Matching ignores case.
replacestringNo—word_fix only: the correct word or phrase.
automatic_call_import_idstring (uuid)No—Limit to calls from this automatic call import (from automatic_call_imports in list_call_instructions). Omit for all the user's calls.
enabledbooleanNotrueFalse saves it switched off.

Input Schema

{
  "type": "object",
  "required": [
    "team_id",
    "kind"
  ],
  "properties": {
    "find": {
      "type": "string",
      "maxLength": 100,
      "description": "word_fix only: the word or phrase as it is wrongly transcribed. Matching ignores case."
    },
    "kind": {
      "enum": [
        "word_fix",
        "guidance"
      ],
      "type": "string",
      "description": "word_fix needs `find` and `replace`; guidance needs `text`."
    },
    "text": {
      "type": "string",
      "maxLength": 300,
      "description": "guidance only: the instruction in one short sentence, in the user's words."
    },
    "enabled": {
      "type": "boolean",
      "default": true,
      "description": "False saves it switched off."
    },
    "replace": {
      "type": "string",
      "maxLength": 200,
      "description": "word_fix only: the correct word or phrase."
    },
    "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."
    },
    "automatic_call_import_id": {
      "type": "string",
      "format": "uuid",
      "description": "Limit to calls from this automatic call import (from automatic_call_imports in list_call_instructions). Omit for all the user's calls."
    }
  }
}

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

Saves a standing instruction for how Marcora handles the user's calls, to the same visible list they edit in Settings. Use it when the user states a lasting preference about their calls, not for a one-off request. Two kinds. guidance (text): steers what Marcora suggests from calls, e.g. "never suggest content plans about pricing sheets", "only suggest case studies from calls", "use our One-Pager blueprint for one-pagers". word_fix (find and replace): a recurring transcription error to correct, e.g. find "Market Core", replace "MarketCore". Instructions apply to calls processed from now on; calls already imported are not changed, so say so when the user expects past calls to change. Applies to all the user's calls by default; pass automatic_call_import_id (from list_call_instructions) to limit it to calls from one automatic call import. If unsure it already exists, call list_call_instructions first. Duplicates and the per-scope limits are refused with a plain message: report it and, at the limit, offer to remove an old one. Tell the user exactly what was saved.