list_call_instructions
List your standing call instructions (saved guidance and word fixes) and your automatic call imports in the specified team.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
team_id | integer | Yes | — | Team id to act in (from initialize instructions or get_current_user_info). Required on external MCP; optional in bound sessions. |
scope | string | No | all | all: every instruction. default: only those that apply to all the user's calls. |
automatic_call_import_id | string (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.