What can you do with Budgetary: estimate token spend?

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.

Install

Add Budgetary: estimate token spend to your client. Pick the one you use.

claude mcp add mcp -- npx -y @budgetary/mcp

codex mcp add mcp -- npx -y @budgetary/mcp

amp mcp add mcp -- npx -y @budgetary/mcp

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@budgetary/mcp"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@budgetary/mcp"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"mcp","command":"npx","args":["-y","@budgetary/mcp"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@budgetary/mcp"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@budgetary/mcp"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@budgetary/mcp"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "mcp": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "@budgetary/mcp"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@budgetary/mcp"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y @budgetary/mcp

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

Score

39 / 100

Incomplete

Documentation19/25
Maintenance25/25
Trust16/20
Capability0/15
Install experience12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 13 days ago
Has a release history
Repository is not archived
Licensed Apache-2.0
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
12 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
0.13.0Latest	Aug 10, 2026
0.9.3	Aug 8, 2026
0.9.1	Aug 8, 2026
0.9.0	Aug 8, 2026
0.1.1	Jun 12, 2026