myPhoner MCP by usefulapi

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.

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

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

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

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.

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

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.

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

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.

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

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.

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

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

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

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.

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

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.

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

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.

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

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}.

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

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.

{
  "type": "object",
  "properties": {
    "lead_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Lead id."
    },
    "call_back_in": {
      "description": "Minutes until a scheduled call back (max one year).",
      "type": "integer",
      "minimum": 0,
      "maximum": 525600
    },
    "scheduled_for": {
      "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.",
      "type": "string"
    },
    "comment": {
      "description": "Text added as a comment on the lead's event.",
      "type": "string",
      "maxLength": 5000
    },
    "category": {
      "description": "A category of the list; must match an existing one exactly, including case.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "lead_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "lead_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Lead id."
    },
    "call_back_in": {
      "description": "Minutes until a scheduled call back (max one year).",
      "type": "integer",
      "minimum": 0,
      "maximum": 525600
    },
    "scheduled_for": {
      "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.",
      "type": "string"
    },
    "comment": {
      "description": "Text added as a comment on the lead's event.",
      "type": "string",
      "maxLength": 5000
    },
    "category": {
      "description": "A category of the list; must match an existing one exactly, including case.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "lead_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "lead_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Lead id."
    },
    "call_back_in": {
      "description": "Minutes until a scheduled call back (max one year).",
      "type": "integer",
      "minimum": 0,
      "maximum": 525600
    },
    "scheduled_for": {
      "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.",
      "type": "string"
    },
    "comment": {
      "description": "Text added as a comment on the lead's event.",
      "type": "string",
      "maxLength": 5000
    },
    "category": {
      "description": "A category of the list; must match an existing one exactly, including case.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "lead_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "lead_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Lead id."
    },
    "call_back_in": {
      "description": "Minutes until a scheduled call back (max one year).",
      "type": "integer",
      "minimum": 0,
      "maximum": 525600
    },
    "scheduled_for": {
      "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.",
      "type": "string"
    },
    "comment": {
      "description": "Text added as a comment on the lead's event.",
      "type": "string",
      "maxLength": 5000
    },
    "category": {
      "description": "A category of the list; must match an existing one exactly, including case.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "lead_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

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

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.

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

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}.

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