Agentic Platform
Documentation API reference Tools Skills

Tools

Credit Consumption

get_credit_usage MCP

Report how much of this project's agent credit allowance is used, daily and monthly.

Report how far through its agent credit allowance the project is, over both windows that carry one: the day and the calendar month. The allowance is a project-wide pool shared by every member, not a personal one, and passing it warns rather than blocks: calls keep being served up to a higher ceiling. Reading consumption through this agent is itself free and consumes no credits.

Playground

Your organization, project and token stay in this browser's local storage and are sent straight to the API — this page never sees them.

POST
item

No fields.

Schemas

item is what you send, config how the tool behaves, and the response is what you get back.

Item

object
Example
{}

Response

object
Properties
credit_status string required

Where the project stands overall: the worse of the daily and the monthly credit status

Values: healthy warning over blocked

daily CreditWindow required

Information about the daily allowance usage

Type: CreditWindow

monthly CreditWindow required

Information about the monthly allowance usage

Type: CreditWindow

summary string required

A paragraph summarizing where usage sits expressed in natural language

Example
{
  "credit_status": "healthy",
  "daily": {
    "usage_percent": 0.0,
    "status": "healthy",
    "resets_at": "string"
  },
  "monthly": {
    "usage_percent": 0.0,
    "status": "healthy",
    "resets_at": "string"
  },
  "summary": "string"
}

Type Definitions

1 type

These are the available sub-object types that can be used in the properties above.

CreditWindow object
#

How far through its allowance one window is, and where that stands.

usage_percent number | null required

Share of the window's allowance that has been consumed, above 100 once the allowance is passed. Null when there is no allowance to take a share of -- not a statement that calls are blocked

status string required

Where this window's consumption stands, and the only field that says whether calls are still being served: they are refused on ``blocked`` alone

Values: healthy warning over blocked

resets_at string (date-time) required

When the window rolls over and consumption returns to 0

Endpoints

POST http://agents.botify.com/{organization}/{project}/get_credit_usage/process
POST http://agents.botify.com/{organization}/{project}/get_credit_usage/batch_process
POST http://agents.botify.com/{organization}/{project}/get_credit_usage/async_process
POST http://agents.botify.com/{organization}/{project}/get_credit_usage/async_batch_process

See running a long job in the background for the polling flow.

cURL

curl -X POST "http://agents.botify.com/{organization}/{project}/get_credit_usage/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {}
}'

Over MCP

This tool is exposed as the MCP tool get_credit_usage. An MCP client passes organization, project and item as tool arguments. Set up MCP →

Raw metadata