conecto. Get started
Phone

List phone numbers

phone_list_numbers · Reads only · Markdown

The numbers the business rents, with their monthly price and next renewal.

Free*

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

An example

What phone numbers are we paying for right now?

Your agent callsphone_list_numbersFree*

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
{}
What comes back
{
  "numbers": [
    {
      "number": "+15035550123",
      "country": "US",
      "type": "local",
      "locality": "Portland",
      "status": "active",
      "monthly_usd": "$2.00",
      "renews_at": "2026-11-14T08:00:00+00:00",
      "payment_due": false,
      "released_if_unpaid_by": null
    }
  ],
  "count": 1
}

Use it when

To see which numbers exist, or when one renews.

What it does

The numbers this account rents, with their monthly price and next renewal.

What comes back

Every rented number with its country, type, locality, status, monthly price, renewal date and payment state, and how many. Every reply also carries cost_usd and balance_usd.

The call

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

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

More Phone tools

All 8 tools

Give this to your agent.

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