> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowstep.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Usage Limits

> How Flowstep usage limits apply to MCP tool calls, and how to check your remaining quota.

Flowstep usage limits apply at the **organization** level and are **shared** between the web app and the MCP server. A generation kicked off in Cursor counts against the same quota as one started from app.flowstep.ai.

## How limits work

Limits are per-feature (the primary feature is `messages`). Each plan defines:

* A **daily limit** — resets at **00:00 UTC** every day
* A **monthly limit** — resets on the **date of the account sign up or paid subscription start each month**

Hitting either limit blocks further generations until it resets.

## Checking your quota

Call `get-plan-details` to see your current limits, usage, and remaining quota:

```json theme={"system"}
// Response (excerpt)
{
  "limits": {
    "messages": {
      "daily": { "max": 50, "warn": 40 },
      "monthly": { "max": 500, "warn": 400 },
      "unlimited": false
    }
  },
  "usage": {
    "messages": { "daily": 12, "monthly": 87 }
  },
  "remaining": {
    "messages": { "daily": 38, "monthly": 413 }
  }
}
```

Actual limit values depend on your plan. Run the tool to see your specific numbers. See [Pricing](https://flowstep.ai/pricing) for per-plan details.

## Per-request limits (all plans)

These limits are enforced at the request level regardless of plan:

| Limit                                                                                         | Value                                                                                                                                                      |
| --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Max attachments per `create-new-design` / `edit-design` call                                  | 5                                                                                                                                                          |
| Max attachment size                                                                           | 3 MB                                                                                                                                                       |
| Supported attachment types                                                                    | `image/jpeg`, `image/png`, `image/webp`, `application/pdf` (base64), plus text/code files — `.html`, `.htm`, `.js`, `.ts`, `.jsx`, `.tsx` — as plain UTF-8 |
| Generation timeout (`create-new-design`, `edit-design`, `regenerate-design`, `expand-design`) | 180 seconds                                                                                                                                                |

## Failed generations don't count

If a generation request fails — due to a timeout, a server error, or an invalid input — it does **not** consume a message.