add_call_instruction
Save a standing instruction (guidance or a recurring transcription word fix) for how Marcora handles your future calls.
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. |
kind | string | Yes | — | word_fix needs `find` and `replace`; guidance needs `text`. |
text | string | No | — | guidance only: the instruction in one short sentence, in the user's words. |
find | string | No | — | word_fix only: the word or phrase as it is wrongly transcribed. Matching ignores case. |
replace | string | No | — | word_fix only: the correct word or phrase. |
automatic_call_import_id | string (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. |
enabled | boolean | No | true | False 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.