---
title: "Call-flow and reporting setup"
url: "https://docs.teleflows.io/guides/mcp/reference/tools/call-flow-and-reporting-setup.md"
canonical_url: "https://docs.teleflows.io/guides/mcp/reference/tools/call-flow-and-reporting-setup/"
last_updated: 2026-10-01
type: reference
summary: "Reference for the 7 call-flow and reporting setup tools of the Teleflows MCP server."
---

# Call-flow and reporting setup

Each tool lists the inputs your assistant can send. You do not type these yourself: ask in plain language and the assistant fills them in.

## List workflows

Tool name: `teleflows_list_workflows`

Lists workflows your API key can access (name, description, active flag).

Use it to find a workflow by name and get its ID; campaigns using it: `teleflows_find_usages` or `teleflows_list_campaigns` with `workflow_id`. The steps inside a workflow are not available through the API, and a call does not record which workflow ran.

**Inputs**

| Input | Details | Description |
|---|---|---|
| `is_active` | boolean | Only active or only inactive workflows. |
| `created_after` | string; up to 40 characters | Only records created at or after this moment (inclusive): date-time with timezone, e.g. 2026-10-01T00:00:00Z. |
| `created_before` | string; up to 40 characters | Only records created at or before this moment (inclusive): date-time with timezone, e.g. 2026-10-31T23:59:59Z. |
| `search` | string; up to 200 characters | Text to match; partial matches of 3 or more characters work. |
| `sort` | string; `newest_first`, `oldest_first`; default `newest_first` | Order by creation time. |
| `page` | integer; 1 to 100000; default `1` | Page number, from 1. |
| `page_size` | integer; 1 to 100; default `20` | Records per page, 1-100. |

## List variable definitions

Tool name: `teleflows_list_variables`

Lists variable definitions your API key can access.

Definitions only: variable values are never returned by Teleflows. Use it to see which variables exist, which are marked secret or personal data (`is_secret`, `is_pii`), and where their values come from (source). There is no filter for `is_pii`: check it in the results.

**Inputs**

| Input | Details | Description |
|---|---|---|
| `scope` | string; `system`, `organization`, `call`, `node`, `event` | Variable scope. |
| `source` | string; `platform`, `organization`, `ide`, `sip_header`, `dialer`, `gather`, `menu`, `api`, `profile`, `splitter`, `event`, `legacy` | Where values come from. |
| `status` | string; `active`, `deprecated`, `disabled` | Definition status. |
| `is_secret` | boolean | Only secret or only non-secret variables. |
| `search` | string; up to 200 characters | Text to match; partial matches of 3 or more characters work. |
| `sort` | string; `newest_first`, `oldest_first`; default `newest_first` | Order by creation time. |
| `page` | integer; 1 to 100000; default `1` | Page number, from 1. |
| `page_size` | integer; 1 to 100; default `20` | Records per page, 1-100. |

## List audio files

Tool name: `teleflows_list_audio_files`

Lists audio files in the account (name, file type, size).

Use it to find an audio file by name. The audio itself and where a file is used are not available through the API.

**Inputs**

| Input | Details | Description |
|---|---|---|
| `search` | string; up to 200 characters | Text to match; partial matches of 3 or more characters work. |
| `sort` | string; `newest_first`, `oldest_first`; default `newest_first` | Order by creation time. |
| `page` | integer; 1 to 100000; default `1` | Page number, from 1. |
| `page_size` | integer; 1 to 100; default `20` | Records per page, 1-100. |

## List blocked numbers

Tool name: `teleflows_list_blocked_numbers`

Lists blocked numbers your API key can access.

value is a full phone number or a number prefix (`block_type` exact or prefix); `expires_at` may be null (no expiry date returned). To check whether a number is blocked, search for it and also consider prefix entries that match its start. How blocking is applied to calls is not documented. Blocked calls per period are counted in `teleflows_get_call_report` (blocked).

**Inputs**

| Input | Details | Description |
|---|---|---|
| `block_type` | string; `exact`, `prefix` | Full number or prefix. |
| `search` | string; up to 200 characters | Text to match; partial matches of 3 or more characters work. |
| `sort` | string; `newest_first`, `oldest_first`; default `newest_first` | Order by creation time. |
| `page` | integer; 1 to 100000; default `1` | Page number, from 1. |
| `page_size` | integer; 1 to 100; default `20` | Records per page, 1-100. |

## List pixels

Tool name: `teleflows_list_pixels`

Lists tracking pixels (name, active flag).

For a pixel's delivery results use `teleflows_list_pixel_fires`.

**Inputs**

| Input | Details | Description |
|---|---|---|
| `page` | integer; 1 to 100000; default `1` | Page number, from 1. |
| `page_size` | integer; 1 to 100; default `20` | Records per page, 1-100. |

## List postback configs

Tool name: `teleflows_list_postback_configs`

Lists postback configurations your API key can access (name, active flag, authentication method, payload format, default event name, conversion window in days).

Endpoint URLs and credentials are not returned by Teleflows. Filter by `campaign_id` for one campaign's postbacks.

**Inputs**

| Input | Details | Description |
|---|---|---|
| `campaign_id` | string; 36 characters | The campaign ID (UUID). |
| `is_active` | boolean | Only active or only inactive configs. |
| `search` | string; up to 200 characters | Text to match; partial matches of 3 or more characters work. |
| `sort` | string; `newest_first`, `oldest_first`; default `newest_first` | Order by creation time. |
| `page` | integer; 1 to 100000; default `1` | Page number, from 1. |
| `page_size` | integer; 1 to 100; default `20` | Records per page, 1-100. |

## List predictive configs

Tool name: `teleflows_list_predictive_configs`

Lists predictive routing configurations (name and settings).

What each setting means and what uses a configuration are not documented by Teleflows, so present the values without interpreting them.

**Inputs**

| Input | Details | Description |
|---|---|---|
| `page` | integer; 1 to 100000; default `1` | Page number, from 1. |
| `page_size` | integer; 1 to 100; default `20` | Records per page, 1-100. |
