---
title: "Get Billing Status"
description: "Show the account's billing status: plan (free_trial, pay_as_you_go, pro or custom), creditsRemaining, renewsAt, trialEndsAt, pendingPayment and canManageBilling."
---

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

# Get Billing Status

Use the Speak AI MCP server tool `get_billing_status` to show the account's billing
status: plan (free_trial, pay_as_you_go, pro or custom), creditsRemaining, renewsAt,
trialEndsAt, pendingPayment and canManageBilling.

## What does it do?

Show the account's billing status: plan (free_trial, pay_as_you_go, pro or custom),
creditsRemaining, renewsAt, trialEndsAt, pendingPayment and canManageBilling.
Read-only and free to call. Use it to tell the user before an upload, analysis or
chat would run past the remaining credits, or after a tool reports that the account
cannot cover the work. Retry a blocked tool only after the user confirms their
account has credits.

## Parameters

`get_billing_status` takes no parameters.

## Behaviour

The Speak AI MCP server publishes these behaviour hints for `get_billing_status`.

- Only reads data. Does not modify your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call is safe.
- Stays inside Speak AI. Does not reach other systems.

## Related

- [Billing](/mcp/tools/billing/) lists the rest of the Billing category.
- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/billing/get_billing_status/index.mdx