Budgetary: estimate token spend
Pre-flight token-spend estimate (range, scenario, confidence) for a coding task, or an abstention.
Open source Open in the app JSON README (API)
About
Pre-flight token-spend estimate (range, scenario, confidence) for a coding task, or an abstention.
Details
- Kind
- MCP servers
- Topic
- Maps, weather & travel
- Publisher
- thriftell
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.13.0
- Last push
- 2026-08-18T18:45:13Z
- Repository state
- ativo
- Language
- TypeScript
- License
- Apache-2.0
- Added
- 2026-08-29 04:01:32
- Updated
- 2026-08-29 04:01:32
- Origin id
io.github.thriftell/budgetary
README
# Budgetary clients
[](./LICENSE)
**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
```ts
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](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](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](./LICENSE). Copyright Budgetary.