# myPhoner MCP by usefulapi

> myPhoner MCP by usefulapi is an MCP server. Work myPhoner calling lists and leads: search, log call outcomes, add, update and assign leads. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/myphoner/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/myphoner
- **MCP Registry name:** io.usefulapi/myphoner
- **Listing updated:** 2026-11-13

## About

Work myPhoner calling lists and leads: search, log call outcomes, add, update and assign leads.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http myphoner https://myphoner.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://myphoner.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "myphoner": {
      "url": "https://myphoner.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "myphoner": {
      "type": "http",
      "url": "https://myphoner.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "myphoner": {
      "serverUrl": "https://myphoner.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "myphoner": {
      "type": "http",
      "url": "https://myphoner.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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.
- `myphoner_get_list`: One calling list with its lead count and its call back / winner / loser / archive / skip categories. GET /lists/{id}.
- `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.
- `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.
- `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.
- `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.
- `myphoner_get_lead`: One lead with its state, category, claim, duplicates and all lead_data fields. GET /leads/{id}.
- `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.
- `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.
- `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.
- `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}.
- `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.
- `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.
- `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.
- `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.
- `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.
- `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.
- `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}.

## FAQ

### How do I add myPhoner MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http myphoner https://myphoner.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/myphoner-mcp-by-usefulapi
