Phone

List phone calls

phone_list_calls · Reads only · Markdown

Calls to and from the business's numbers, newest first: who, when, how long and what it cost, missed ones included.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

Who called yesterday, and did we miss anyone?

Your agent callsphone_list_callsFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments

{
  "limit": 20
}

What comes back

{
  "calls": [
    {
      "call_id": "a3f5c2d1-9b8e-4f70-8c6d-2e1b0a9f8c7d",
      "direction": "inbound",
      "from": "+15035550187",
      "to": "+15035550123",
      "at": "2026-10-13T16:42:10+00:00",
      "status": "ended",
      "answered": true,
      "duration_seconds": 146,
      "cost_usd": "$0.75",
      "summary": "Asked whether the Tabor comes in a 52 cm frame and how long a build takes."
    },
    {
      "call_id": null,
      "from": "+15035550142",
      "to": "+15035550123",
      "at": "2026-10-13T03:12:44+00:00",
      "status": "missed",
      "reason": "outside_hours",
      "message": "The call came outside the answering hours.",
      "cost_usd": "$0.00"
    }
  ],
  "count": 2
}

Use it when

Someone asks who called, or whether calls were missed.

For one call with its whole transcript, use phone_get_call.

What it does

Calls to and from the business's numbers, newest first: who, when, how long and what it cost. Missed calls (outside hours, paused, balance too low, lines busy) are included with the reason, and so are the calls the assistant made to confirm meetings. When the balance was too low the caller could leave a message, free: it is on the missed call as left_message. Read a whole conversation with phone_get_call.

What comes back

Calls newest first, each with its call_id, direction, from, to, time, status, whether it was answered, duration, cost and summary; missed calls with their reason, and left_message (its words, length and recording) when the balance was too low and the caller left a message; and how many. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`limit`	integer	1 to 100. Default: 20.
`before`	string (date-time)	Only calls before this time (ISO 8601), to page back.
`include_missed`	boolean	Default: true.

The call

Over MCP, call phone_list_calls on https://api.conecto.chat/mcp/phone. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/phone_list_calls \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":20}'

When it refuses

A refused call costs nothing and says what to do next.

Code	When	What to do
`invalid_input`400	before is not an ISO 8601 time.	Send it like 2026-10-12T09:00:00Z.

More Phone tools

All 8 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md

List phone calls

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Phone tools

Give this to your agent.