MCP Tools
Context & Resources

list_call_instructions

List your standing call instructions (saved guidance and word fixes) and your automatic call imports in the specified team.

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.
scopestringNoallall: every instruction. default: only those that apply to all the user's calls.
automatic_call_import_idstring (uuid)No—Only this automatic call import's instructions (from automatic_call_imports in this tool's result). Not with scope "default".

Input Schema

{
  "type": "object",
  "required": [
    "team_id"
  ],
  "properties": {
    "scope": {
      "enum": [
        "all",
        "default"
      ],
      "type": "string",
      "default": "all",
      "description": "all: every instruction. default: only those that apply to all the user's calls."
    },
    "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": "Only this automatic call import's instructions (from automatic_call_imports in this tool's result). Not with scope \"default\"."
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "instructions",
    "automatic_call_imports",
    "limits",
    "note"
  ],
  "properties": {
    "note": {
      "type": "string",
      "description": "Reminder of when the change takes effect."
    },
    "limits": {
      "type": "object",
      "required": [
        "word_fixes_per_scope",
        "guidance_per_scope",
        "guidance_max_chars"
      ],
      "properties": {
        "guidance_max_chars": {
          "type": "integer"
        },
        "guidance_per_scope": {
          "type": "integer"
        },
        "word_fixes_per_scope": {
          "type": "integer"
        }
      },
      "description": "Per scope (the defaults, or each automatic call import)."
    },
    "instructions": {
      "type": "array",
      "items": {
        "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."
          }
        }
      }
    },
    "automatic_call_imports": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "automatic_call_import_id",
          "name",
          "enabled"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "automatic_call_import_id": {
            "type": "string",
            "format": "uuid"
          }
        }
      },
      "description": "The user's automatic call imports in this workspace. Refer to them as automatic call imports."
    }
  }
}

Instructions

Lists the user's standing call instructions: the saved guidance and word fixes Marcora applies to their calls, the same list they edit in Settings. Use it before adding one (to avoid a duplicate), when the user asks what they have told Marcora about their calls, or to find an instruction_id to change or remove. Also returns the user's automatic call imports (automatic_call_import_id, name) so an instruction can be limited to one. Default: every instruction the user has in the specified team; pass scope "default" for only those that apply to all their calls, or automatic_call_import_id for one automatic call import's. Instructions apply to calls processed from now on; calls already imported are not changed.