token_budget_calculator
Plan token allocation across system prompt, user input, context/RAG chunks, and expected output. Warns if budget exceeds the model's context window (any model from list_llm_models).
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"model": "gpt-4o",
"context_tokens": 1000,
"expected_output_tokens": 500
},
"name": "token_budget_calculator"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | Yes | Model id from list_llm_models (e.g. gpt-6.1-sol, claude-sonnet-5-5, gemini-3.8-flash) | |
| context | No | Actual context text (will estimate tokens) | |
| user_input | No | Actual user input text (will estimate tokens) | |
| system_prompt | No | Actual system prompt text (will estimate tokens) | |
| context_tokens | No | Token count for RAG context / documents | |
| user_input_tokens | No | Token count for user message | |
| system_prompt_tokens | No | Token count for system prompt | |
| expected_output_tokens | No | Expected max output tokens |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | ||
| warnings | No | ||
| breakdown | No | ||
| context_window | No | ||
| fits_in_window | No | ||
| remaining_tokens | No | ||
| utilization_percent | No |