`twilio_list_calls`

Pack: twilio · Endpoint: https://gateway.pipeworx.io/twilio/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/twilio_list_calls for the schema, then POST the same URL with its arguments for the data.

List recent phone calls from your Twilio account. Returns call SID, status, duration, and direction.

Parameters

Name	Type	Required	Description
`_accountSid`	string	yes	Twilio Account SID
`_authToken`	string	yes	Twilio Auth Token
`limit`	number	no	Max calls to return (default 20, max 100)

Example call

Arguments

{
  "_accountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "_authToken": "your-twilio-auth-token"
}

curl

curl -X POST https://gateway.pipeworx.io/twilio/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"twilio_list_calls","arguments":{"_accountSid":"ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","_authToken":"your-twilio-auth-token"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('twilio_list_calls', {
  "_accountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "_authToken": "your-twilio-auth-token"
});

More examples

{
  "_accountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "_authToken": "your-twilio-auth-token",
  "limit": 50
}

Response shape

Field	Type	Description
`calls`	array	Array of call objects
`page`	integer	Current page number
`page_size`	integer	Page size
`total`	integer	Total number of calls
`start`	integer	Start index
`end`	integer	End index
`uri`	string	API URI for this resource
`first_page_uri`	string	URI for first page
`previous_page_uri`	string \| null	URI for previous page
`next_page_uri`	string \| null	URI for next page

Full JSON Schema

{
  "type": "object",
  "properties": {
    "calls": {
      "type": "array",
      "description": "Array of call objects",
      "items": {
        "type": "object",
        "properties": {
          "sid": {
            "type": "string",
            "description": "Call SID"
          },
          "account_sid": {
            "type": "string",
            "description": "Account SID"
          },
          "to": {
            "type": "string",
            "description": "Destination phone number"
          },
          "from": {
            "type": "string",
            "description": "Caller phone number"
          },
          "status": {
            "type": "string",
            "description": "Call status (queued, ringing, in-progress, completed, etc.)"
          },
          "direction": {
            "type": "string",
            "description": "Call direction (inbound or outbound)"
          },
          "duration": {
            "type": [
              "string",
              "null"
            ],
            "description": "Call duration in seconds"
          },
          "date_created": {
            "type": "string",
            "description": "ISO 8601 creation timestamp"
          },
          "date_updated": {
            "type": "string",
            "description": "ISO 8601 update timestamp"
          },
          "end_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO 8601 end timestamp"
          },
          "price": {
            "type": [
              "string",
              "null"
            ],
            "description": "Call cost"
          },
          "price_unit": {
            "type": "string",
            "description": "Currency unit"
          }
        }
      }
    },
    "page": {
      "type": "integer",
      "description": "Current page number"
    },
    "page_size": {
      "type": "integer",
      "description": "Page size"
    },
    "total": {
      "type": "integer",
      "description": "Total number of calls"
    },
    "start": {
      "type": "integer",
      "description": "Start index"
    },
    "end": {
      "type": "integer",
      "description": "End index"
    },
    "uri": {
      "type": "string",
      "description": "API URI for this resource"
    },
    "first_page_uri": {
      "type": "string",
      "description": "URI for first page"
    },
    "previous_page_uri": {
      "type": [
        "string",
        "null"
      ],
      "description": "URI for previous page"
    },
    "next_page_uri": {
      "type": [
        "string",
        "null"
      ],
      "description": "URI for next page"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "twilio": {
      "url": "https://gateway.pipeworx.io/twilio/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

twilio_list_calls