English Français العربية

Budgetary: estimate token spend

Registre officiel Outils de développement

Pre-flight token-spend estimate (range, scenario, confidence) for a coding task, or an abstention.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @budgetary/mcp
Claude Code 
claude mcp add budgetary-estimate-token-spend -e 'BUDGETARY_API_KEY=<your budgetary_api_key>' -e 'BUDGETARY_HOST=<BUDGETARY_HOST>' -- npx -y @budgetary/mcp@0.13.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "budgetary-estimate-token-spend": {
            "command": "npx",
            "args": [
                "-y",
                "@budgetary/mcp@0.13.0"
            ],
            "env": {
                "BUDGETARY_API_KEY": "<your budgetary_api_key>",
                "BUDGETARY_HOST": "<BUDGETARY_HOST>"
            }
        }
    }
}

Variables d'environnement

  • BUDGETARY_API_KEY obligatoire secret Budgetary API key (bg_live_ or bg_test_ prefix). Get one at https://budgetary.tools.
  • BUDGETARY_HOST Optional tag naming the MCP host this server runs under — e.g. claude-code, cursor, codex, copilot. It labels each estimate with where it came from, and an explicit value overrides the host name the MCP handshake reports. Free-form; defaults to "mcp" when unset.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Budgetary clients
  2. Quick example
  3. Install
  4. API
  5. Status
  6. License

Budgetary clients

Budgetary tells you how many tokens an LLM query will cost — before you run it.

Budgetary is a hosted API at https://api.budgetary.tools that returns probabilistic pre-inference token-spend estimates for LLM queries. This repository holds the open-source clients that talk to it: language SDKs and editor plugins.

Quick example

import { BudgetaryClient } from "@budgetary/sdk";

const budgetary = new BudgetaryClient({ apiKey: process.env.BUDGETARY_API_KEY! });
const estimate = await budgetary.estimate("Summarize the attached PDF in three bullets.");

The SDK in this release is a stub — the call above illustrates the shape of the API surface, not a working implementation.

Install

See docs/installation.md for per-client setup:

  • TypeScript / JavaScript SDK — @budgetary/sdk on npm
  • Python SDK — budgetary on PyPI
  • VS Code extension (dashboard)
  • Claude Code plugin
  • Codex plugin

API

Bearer-auth HTTP API at https://api.budgetary.tools. The wire contract is published at docs/api-contract.md.

Status

Early access. The hosted API is live, but client interfaces may change between releases until they reach 1.0. Pin exact versions in production.

License

Apache-2.0. Copyright Budgetary.

Questions fréquentes

Qu'est-ce que Budgetary: estimate token spend ?

Pre-flight token-spend estimate (range, scenario, confidence) for a coding task, or an abstention.

Comment installer Budgetary: estimate token spend ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add budgetary-estimate-token-spend -e 'BUDGETARY_API_KEY=<your budgetary_api_key>' -e 'BUDGETARY_HOST=<BUDGETARY_HOST>' -- npx -y @budgetary/mcp@0.13.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Budgetary: estimate token spend ?

Oui. Il attend BUDGETARY_API_KEY, à renseigner dans sa configuration.

Budgetary: estimate token spend est-il open source ?

Oui. Son code est sur GitHub sous licence Apache-2.0.

Qui maintient Budgetary: estimate token spend ?

Il est publié par thriftell. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.