---
title: "Limits"
url: "https://docs.teleflows.io/guides/mcp/reference/limits.md"
canonical_url: "https://docs.teleflows.io/guides/mcp/reference/limits/"
last_updated: 2026-10-01
type: reference
summary: "Time windows, page sizes, result size and time limits of the Teleflows MCP server."
related:
  - "https://docs.teleflows.io/guides/mcp/reference/tools.md"
---

# Limits

## Time windows

Tools that read calls or events by time use a window from `since` to `until`.

- A window is at most **31 days**. Longer windows are refused; ask for longer periods in parts.
- Without `since` and `until`, the window is the **last 24 hours**.
- All times are in **UTC**.
- A date without a time, such as `2026-09-30`, means **00:00 UTC** that day.
- `until` is **exclusive**. For a single day, use that day as `since` and the next day as `until`. For example, 30 September 2026 is `since 2026-09-30`, `until 2026-10-01`.
- A date-time needs a timezone, for example `2026-09-30T00:00:00Z` or `+05:00`.

## Page sizes

Long lists come in pages. The assistant asks for the next page when it needs more.

| Tool | Per page | Default |
|---|---|---|
| List tools (`page_size`) | 1 to 100 | 20 |
| Search calls (`limit`) | 1 to 50 | 25 |
| Call report groups (`limit`) | 1 to 100 | 50 |

For counts and totals, the assistant uses the call report instead of paging through calls.

## Result size

Each result is kept under about 45,000 characters, so it fits within the assistant's limits. If a result is larger, whole items are left out from the end, the result is marked as truncated, and a note says how many were left out. Ask for a smaller page, fewer included parts or a narrower filter to see them.

## Time and reads per question

One tool call can take up to **45 seconds** and make up to **50 reads** from Teleflows. Larger requests stop with a message asking you to narrow them: fewer included parts, a smaller window or a more specific filter.

If Teleflows is busy, rate limiting or does not answer, the server may wait a few seconds and try once more. If that fails, it stops the rest of that request and says so.

## Data as Teleflows returns it

Records are shown as Teleflows returns them. Money fields ending in `_cents` are in cents. Where Teleflows does not document what a value means, the assistant says so instead of guessing.

Exact inputs and limits for each tool: [Tools](https://docs.teleflows.io/guides/mcp/reference/tools/).
