myphoner_archive_lead

Archive a lead (it leaves the calling queue). The lead moves to that state and an event is logged on it; nothing is sent to the lead. Optionally add a comment and an existing archive category. POST /leads/{id}/archive.

destructive

Argument	Type	Description
comment	string	Text added as a comment on the lead's event.
lead_id*	integer	Lead id.
category	string	A category of the list; must match an existing one exactly, including case.
call_back_in	integer	Minutes until a scheduled call back (max one year).
scheduled_for	string	When the call back is due: ISO 8601 date-time with a timezone, e.g. 2026-11-02T09:30:00Z. Takes precedence over call_back_in.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "lead_id"
  ],
  "properties": {
    "comment": {
      "type": "string",
      "maxLength": 5000,
      "description": "Text added as a comment on the lead's event."
    },
    "lead_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Lead id.",
      "exclusiveMinimum": 0
    },
    "category": {
      "type": "string",
      "maxLength": 200,
      "description": "A category of the list; must match an existing one exactly, including case."
    },
    "call_back_in": {
      "type": "integer",
      "maximum": 525600,
      "minimum": 0,
      "description": "Minutes until a scheduled call back (max one year)."
    },
    "scheduled_for": {
      "type": "string",
      "description": "When the call back is due: ISO 8601 date-time with a timezone, e.g. 2026-11-02T09:30:00Z. Takes precedence over call_back_in."
    }
  }
}

myphoner_create_lead

Add a new lead to a list. Keys of `fields` are the list's column keys (myphoner_list_columns). Creates data only; nothing is sent to the lead. Duplicate detection runs in the background a few minutes later (check detected_duplicates on the lead afterwards). POST /lists/{id}/leads.

Argument	Type	Description
fields*	object	Lead data keyed by the list's column keys (see myphoner_list_columns), e.g. {"first_name":"Ada","mobile_phone":"+4512345678"}.
list_id*	integer	List the lead is added to.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id",
    "fields"
  ],
  "properties": {
    "fields": {
      "type": "object",
      "description": "Lead data keyed by the list's column keys (see myphoner_list_columns), e.g. {\"first_name\":\"Ada\",\"mobile_phone\":\"+4512345678\"}.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 5000
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ]
      }
    },
    "list_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "List the lead is added to.",
      "exclusiveMinimum": 0
    }
  }
}

myphoner_create_list

Create a new, empty calling list with its fields. Creates data in the account (nothing is sent to anyone). Field kinds: none (text), phone, email, url, boolean, integer, date, text (multi-line), options, address. POST /lists.

Argument	Type	Description
name*	string	Name of the list.
columns	array	Fields in order. Omit to let myPhoner use its defaults.
description	string	Call script shown to agents while working the list.
skip_categories	string	Comma-separated sub-categories for skips.
loser_categories	string	Comma-separated sub-categories for losers.
winner_categories	string	Comma-separated sub-categories for winners.
archive_categories	string	Comma-separated sub-categories for archived leads.
call_back_categories	string	Comma-separated sub-categories for call backs.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Name of the list."
    },
    "columns": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "label",
          "kind"
        ],
        "properties": {
          "kind": {
            "enum": [
              "none",
              "phone",
              "email",
              "url",
              "boolean",
              "integer",
              "date",
              "text",
              "options",
              "address"
            ],
            "type": "string",
            "description": "Field kind; none = single-line text."
          },
          "label": {
            "type": "string",
            "maxLength": 100,
            "minLength": 1,
            "description": "Field label, e.g. Phone."
          },
          "visible": {
            "type": "boolean"
          }
        }
      },
      "maxItems": 60,
      "description": "Fields in order. Omit to let myPhoner use its defaults."
    },
    "description": {
      "type": "string",
      "maxLength": 10000,
      "description": "Call script shown to agents while working the list."
    },
    "skip_categories": {
      "type": "string",
      "maxLength": 1000,
      "description": "Comma-separated sub-categories for skips."
    },
    "loser_categories": {
      "type": "string",
      "maxLength": 1000,
      "description": "Comma-separated sub-categories for losers."
    },
    "winner_categories": {
      "type": "string",
      "maxLength": 1000,
      "description": "Comma-separated sub-categories for winners."
    },
    "archive_categories": {
      "type": "string",
      "maxLength": 1000,
      "description": "Comma-separated sub-categories for archived leads."
    },
    "call_back_categories": {
      "type": "string",
      "maxLength": 1000,
      "description": "Comma-separated sub-categories for call backs."
    }
  }
}

myphoner_delegate_lead

Give the claim on a lead to a user (the lead then shows up in that agent's queue), identified by user id or email. PATCH /leads/{id}/delegate.

destructive

Argument	Type	Description
lead_id*	integer	Lead id.
delegate_to*	any	User id or the user's email address.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "lead_id",
    "delegate_to"
  ],
  "properties": {
    "lead_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Lead id.",
      "exclusiveMinimum": 0
    },
    "delegate_to": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "maxLength": 254,
          "minLength": 3
        }
      ],
      "description": "User id or the user's email address."
    }
  }
}

myphoner_find_leads

Exact match on one or more fields of a list, for example a phone number or an email address (to check whether a lead already exists). All fields must match unless match_all is false. GET /lists/{id}/leads/find.

read-only

Argument	Type	Description
fields*	object	Column key → non-empty value to match exactly, e.g. {"mobile_phone":"15324083898652"}. Keys from myphoner_list_columns.
list_id*	integer	List id.
match_all	boolean	true (default) = every field must match; false = any one is enough.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id",
    "fields"
  ],
  "properties": {
    "fields": {
      "type": "object",
      "description": "Column key → non-empty value to match exactly, e.g. {\"mobile_phone\":\"15324083898652\"}. Keys from myphoner_list_columns.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 1000,
            "minLength": 1
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "list_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "List id.",
      "exclusiveMinimum": 0
    },
    "match_all": {
      "type": "boolean",
      "description": "true (default) = every field must match; false = any one is enough."
    }
  }
}

myphoner_get_call

One call made from myPhoner: who called, the number dialed, duration (0 = unanswered), direction, disposition (normal, voicemail, no_answer, busy ...), state, the lead and list it belongs to, and recording links. GET /calls/{id}.

read-only

Argument	Type	Description
call_id*	integer	Call id (the number at the end of a call's location path).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "call_id"
  ],
  "properties": {
    "call_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Call id (the number at the end of a call's location path).",
      "exclusiveMinimum": 0
    }
  }
}

myphoner_get_lead

One lead with its state, category, claim, duplicates and all lead_data fields. GET /leads/{id}.

read-only

Argument	Type	Description
lead_id*	integer	Lead id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "lead_id"
  ],
  "properties": {
    "lead_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Lead id.",
      "exclusiveMinimum": 0
    }
  }
}

myphoner_get_list

One calling list with its lead count and its call back / winner / loser / archive / skip categories. GET /lists/{id}.

read-only

Argument	Type	Description
list_id*	integer	List id from myphoner_list_lists.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id"
  ],
  "properties": {
    "list_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "List id from myphoner_list_lists.",
      "exclusiveMinimum": 0
    }
  }
}

myphoner_get_list_stats

Lead counts of a list by state (new, call back, won, lost, archived) and by category within each state. Use it for campaign progress and conversion questions. GET /lists/{id}/stats.

read-only

Argument	Type	Description
list_id*	integer	List id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id"
  ],
  "properties": {
    "list_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "List id.",
      "exclusiveMinimum": 0
    }
  }
}

myphoner_list_columns

The fields (columns) of a list. The `key` of each is the name to use when creating, updating or finding leads. GET /lists/{id}/columns.

read-only

Argument	Type	Description
list_id*	integer	List id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id"
  ],
  "properties": {
    "list_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "List id.",
      "exclusiveMinimum": 0
    }
  }
}

myphoner_list_leads

Leads of one list, newest first by creation date (or most recently updated first with order=last_updated_first). Each lead has its state (new, call_back, won, lost, archived), category, scheduled call back, who claimed it and its lead_data fields. GET /lists/{id}/leads.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
order	string	last_updated_first = by last change, newest first; default newest created first.
list_id*	integer	List id.
per_page	integer	Leads per page, 1-100 (default 50).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "order": {
      "enum": [
        "created_first",
        "last_updated_first"
      ],
      "type": "string",
      "description": "last_updated_first = by last change, newest first; default newest created first."
    },
    "list_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "List id.",
      "exclusiveMinimum": 0
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Leads per page, 1-100 (default 50).",
      "exclusiveMinimum": 0
    }
  }
}

myphoner_list_lists

All calling lists (campaigns) in the account: id, name, creation date, number of leads and whether the list guarantees the default fields. Start here to find a list id. GET /lists.

read-only

Argument	Type	Description
locked_on_defaults	boolean	true = only lists that guarantee the default fields.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "locked_on_defaults": {
      "type": "boolean",
      "description": "true = only lists that guarantee the default fields."
    }
  }
}

myphoner_mark_lead_call_back

Schedule a lead for a call back. The lead moves to that state and an event is logged on it; nothing is sent to the lead. Set when with call_back_in (minutes) or scheduled_for; optionally a comment and an existing call back category. POST /leads/{id}/call_back.

destructive

Argument	Type	Description
comment	string	Text added as a comment on the lead's event.
lead_id*	integer	Lead id.
category	string	A category of the list; must match an existing one exactly, including case.
call_back_in	integer	Minutes until a scheduled call back (max one year).
scheduled_for	string	When the call back is due: ISO 8601 date-time with a timezone, e.g. 2026-11-02T09:30:00Z. Takes precedence over call_back_in.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "lead_id"
  ],
  "properties": {
    "comment": {
      "type": "string",
      "maxLength": 5000,
      "description": "Text added as a comment on the lead's event."
    },
    "lead_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Lead id.",
      "exclusiveMinimum": 0
    },
    "category": {
      "type": "string",
      "maxLength": 200,
      "description": "A category of the list; must match an existing one exactly, including case."
    },
    "call_back_in": {
      "type": "integer",
      "maximum": 525600,
      "minimum": 0,
      "description": "Minutes until a scheduled call back (max one year)."
    },
    "scheduled_for": {
      "type": "string",
      "description": "When the call back is due: ISO 8601 date-time with a timezone, e.g. 2026-11-02T09:30:00Z. Takes precedence over call_back_in."
    }
  }
}

myphoner_mark_lead_loser

Mark a lead as a loser (not interested / lost). The lead moves to that state and an event is logged on it; nothing is sent to the lead. Optionally add a comment and an existing loser category. POST /leads/{id}/loser.

destructive

Argument	Type	Description
comment	string	Text added as a comment on the lead's event.
lead_id*	integer	Lead id.
category	string	A category of the list; must match an existing one exactly, including case.
call_back_in	integer	Minutes until a scheduled call back (max one year).
scheduled_for	string	When the call back is due: ISO 8601 date-time with a timezone, e.g. 2026-11-02T09:30:00Z. Takes precedence over call_back_in.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "lead_id"
  ],
  "properties": {
    "comment": {
      "type": "string",
      "maxLength": 5000,
      "description": "Text added as a comment on the lead's event."
    },
    "lead_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Lead id.",
      "exclusiveMinimum": 0
    },
    "category": {
      "type": "string",
      "maxLength": 200,
      "description": "A category of the list; must match an existing one exactly, including case."
    },
    "call_back_in": {
      "type": "integer",
      "maximum": 525600,
      "minimum": 0,
      "description": "Minutes until a scheduled call back (max one year)."
    },
    "scheduled_for": {
      "type": "string",
      "description": "When the call back is due: ISO 8601 date-time with a timezone, e.g. 2026-11-02T09:30:00Z. Takes precedence over call_back_in."
    }
  }
}

myphoner_mark_lead_winner

Mark a lead as a winner (a won deal). The lead moves to that state and an event is logged on it; nothing is sent to the lead. Optionally add a comment and an existing winner category. POST /leads/{id}/winner.

destructive

Argument	Type	Description
comment	string	Text added as a comment on the lead's event.
lead_id*	integer	Lead id.
category	string	A category of the list; must match an existing one exactly, including case.
call_back_in	integer	Minutes until a scheduled call back (max one year).
scheduled_for	string	When the call back is due: ISO 8601 date-time with a timezone, e.g. 2026-11-02T09:30:00Z. Takes precedence over call_back_in.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "lead_id"
  ],
  "properties": {
    "comment": {
      "type": "string",
      "maxLength": 5000,
      "description": "Text added as a comment on the lead's event."
    },
    "lead_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Lead id.",
      "exclusiveMinimum": 0
    },
    "category": {
      "type": "string",
      "maxLength": 200,
      "description": "A category of the list; must match an existing one exactly, including case."
    },
    "call_back_in": {
      "type": "integer",
      "maximum": 525600,
      "minimum": 0,
      "description": "Minutes until a scheduled call back (max one year)."
    },
    "scheduled_for": {
      "type": "string",
      "description": "When the call back is due: ISO 8601 date-time with a timezone, e.g. 2026-11-02T09:30:00Z. Takes precedence over call_back_in."
    }
  }
}

myphoner_move_lead

Move a lead to another list. The destination may be the lead's current list, which with release_claim=true just releases a claimed lead. PATCH /leads/{id}/migrate.

destructive

Argument	Type	Description
lead_id*	integer	Lead id.
to_list_id*	integer	Destination list id.
release_claim	boolean	true = also release the lead if an agent has claimed it.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "lead_id",
    "to_list_id"
  ],
  "properties": {
    "lead_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Lead id.",
      "exclusiveMinimum": 0
    },
    "to_list_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Destination list id.",
      "exclusiveMinimum": 0
    },
    "release_claim": {
      "type": "boolean",
      "description": "true = also release the lead if an agent has claimed it."
    }
  }
}

myphoner_search_leads

Free-text search across lead data and activity logs (comments, events), like the search box in myPhoner; optionally limited to some lists. Returns the total hit count and one page of leads. GET /leads/search.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
query*	string	The search text, e.g. a company name, city or phone number.
list_ids	array	Limit the search to these list ids.
per_page	integer	Leads per page, 1-100 (default 50).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "query": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "The search text, e.g. a company name, city or phone number."
    },
    "list_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "maxItems": 50,
      "description": "Limit the search to these list ids."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Leads per page, 1-100 (default 50).",
      "exclusiveMinimum": 0
    }
  }
}

myphoner_update_lead

Change field values of an existing lead (only the fields you pass change). Keys of `fields` are the list's column keys (myphoner_list_columns). Overwrites the old values; use null to clear one. PATCH /leads/{id}.

destructive

Argument	Type	Description
fields*	object	Lead data keyed by the list's column keys (see myphoner_list_columns), e.g. {"first_name":"Ada","mobile_phone":"+4512345678"}.
lead_id*	integer	Lead id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "lead_id",
    "fields"
  ],
  "properties": {
    "fields": {
      "type": "object",
      "description": "Lead data keyed by the list's column keys (see myphoner_list_columns), e.g. {\"first_name\":\"Ada\",\"mobile_phone\":\"+4512345678\"}.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 5000
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ]
      }
    },
    "lead_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Lead id.",
      "exclusiveMinimum": 0
    }
  }
}

myPhoner MCP by usefulapi

Try it

myphoner_archive_lead Destructive

myPhoner MCP by usefulapi

Try it

myphoner_archive_lead Destructive

Tools (18)