# Budgetary: estimate token spend

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/thriftell/budgetary-clients  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/budgetary-estimate-token-spend

## Description
Pre-flight, probabilistic token-spend estimate (range, scenario, confidence) for a coding task.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "budgetary-estimate-token-spend": {
    "command": "npx",
    "args": ["-y","budgetary-estimate-token-spend"]
  }
}
```

## Documentation & README

# Budgetary clients

[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](./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](https://github.com/thriftell/budgetary-clients/blob/HEAD/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](https://github.com/thriftell/budgetary-clients/blob/HEAD/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](https://github.com/thriftell/budgetary-clients/blob/HEAD/LICENSE). Copyright Budgetary.