# Control the cost of your MCP servers

> Follow the calls that your apps use, set a spend limit for calls past your plan, or change the plan. For workspace owners and admins.

Updated: 2026-10-15

Each Bonnard plan includes a fixed number of calls for each monthly billing period. When the included calls run out, your
apps refuse requests, unless extra usage is on.

## Requirements

- The Owner or Admin role in your Bonnard workspace. The Member role cannot open **Billing**.

## What counts as a call

A call is one tool call that an agent makes through your apps, from an AI client or an API key. Calls to the
staging URL count too. When an AI client draws a chart, its read of the chart view counts as one more call.

These are free:

- Connections, refused or not, and the tool list.
- `explore_docs`.
- Downloads of export files (the export itself counts).
- Work in the console at `app.bonnard.ai`.

A dashboard counts as one call, for any number of charts. A failed call counts only when the agent or your database
caused it, for example SQL with a wrong column name. These failures are free: Bonnard errors, timeouts and lost database connections.

## Plans

Table: Plans and their calls

| Plan | Monthly price | Included calls | Each 100 extra calls |
| --- | --- | --- | --- |
| Free | $0 | 3,000 | $0.95 |
| Team | $150 | 20,000 | $0.75 |
| Scale | $600 | 100,000 | $0.60 |
| Enterprise | Custom | Custom | Custom |

A billing period starts on the day of the month that your plan started. Unused calls do not carry over. See
[Pricing](https://bonnard.ai/pricing).

## When the included calls run out

At 80% of the included calls, and when they run out, Bonnard emails the workspace owners. Owners and admins also
get a banner on **Overview**.

When the included calls run out and **Extra usage** is off, your apps refuse requests with HTTP status `402` until
the period resets:

- Your workspace members get [`allowance_exhausted`](https://bonnard.ai/docs/reference/errors.md#allowance_exhausted).
- Your customers get [`not_serving`](https://bonnard.ai/docs/reference/errors.md#not_serving), which names no plan, price or limit.

To serve calls again, an owner or admin can [start extra usage](#start-extra-usage) or
[change the plan](#change-the-plan). With extra usage on, the apps stop at your spend limit, if any.

## Start extra usage

[Image: The Billing & usage page on the Free plan: Plan with Upgrade, Usage this period at 1,012 of 3,000 calls, Payment method with a Visa card and Update, and Extra usage off with Turn on extra usage]

1. In the console, select **Settings**, then **Billing**.
2. In the **Extra usage** card, select **Turn on extra usage**.
3. Optional: set **Spend limit** to on, and enter the **Maximum extra usage per period (USD)**.
4. Select **Continue**.
5. If no card is on file, enter the card details and select **Save card**.
6. If a card is on file, select **Continue** to use it. To use another card, select **Use a different card**.

With a limit, Bonnard emails the owners at 80% of it.

To change the limit, select **Edit spend limit**. To stop extra usage, set the **Extra usage** switch to off, then
select **Turn off extra usage**.

## Read your usage

- On **Billing**, **Usage this period** shows the calls used and the reset date.
- The **Usage** tab of [Observability](https://bonnard.ai/docs/operate/observability.md) counts calls for each tenant (the value that marks a
  customer's data in your database), free calls too. Any role can open it.

## Change the plan

1. On **Billing**, in the **Plan** card, select **Upgrade** or **Change plan**.
2. Under a plan, select **Select**.
3. For a larger plan, select or add a card. Then select **Pay <amount> and upgrade**.
4. For a smaller plan, select **Confirm downgrade**.

An upgrade starts immediately, with a new period and the new included calls. The **Confirm** step shows the
amount due today. A downgrade starts at the next period. For Enterprise, under the plans, select
**Contact us.**

## Payments and invoices

**Update**, on the **Payment method** card, opens the Stripe portal for your card and invoices. Stripe charges
the plan each month, and extra usage on a separate invoice after each period.

If a payment fails, the **Payment failed** card shows a date. Until that date, the included calls continue, but extra
usage stops. After it, all calls stop. To update the card, select **Manage billing**.

## Related

- [Observability](https://bonnard.ai/docs/operate/observability.md): each recorded call.
- [Publish and staging](https://bonnard.ai/docs/apps/publish-and-staging.md): the staging URL.
- [Audience](https://bonnard.ai/docs/apps/audience.md): who can connect.