Tokencast MCP Server

Pre-execution cost estimation for LLM agent workflows. Get a cost estimate before running any agent task, then let tokencast learn from actuals to improve accuracy over time. Its 5 documented tools cover cost, report. It runs locally over stdio via the published package.

People who work with cost and report and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-04-26 · ★ 2 · #140 OF 160 MAINTAINED PRODUCTIVITY · VERIFIED 2026-09-18

MIT · Python servers · how we verify → /methodology

01 · Install Tokencast

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add krulewis-tokencast -- uvx tokencast

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "krulewis-tokencast": {
      "command": "uvx",
      "args": [
        "tokencast"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package tokencast - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.krulewis is GitHub-verified and matches the repo owner

03 · What Tokencast can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can check whether your estimates are well-calibrated, browse past estimates vs actuals, and report actual cost at session end to improve calibration.

Capability map

Tools grouped from the project's README - what Tokencast lets an agent do.

read & search

2 tools - e.g. Check whether your estimates are well-calibrated; Browse past estimates vs actuals

get_calibration_status · get_cost_history

Report

2 tools - e.g. Report actual cost at session end to improve calibration; Record the cost of a single pipeline step during a session

report_session · report_step_cost

Estimate

1 tool - e.g. Estimate API cost for a planned task before running it

estimate_cost

Limitations (from the README)

- Pipeline step names reflect a default workflow - map your own steps to the closest defaults. Formulas are pipeline-agnostic (see references/heuristics.md) - Heuristics assume typical 150-300 line source files - Calibration requires 3+ completed sessions before corrections activate - Pricing data embedded; check last_updated in references/pricing.md - Multi-session tasks only capture the session containing the estim

Latest releases

v0.1.4 · 2026-03-31

restructure plugin/ dir to comply with Claude Code plugin spec · plugin.json author must be object not string · mark ${CLAUDE_PLUGIN_ROOT} verified after SC-R12 live install test · resolve agent alias names in…

v0.1.3 · 2026-03-30

Migrate from SKILL.md skill to MCP server · Remove personal paths, internal docs; make config portable · Add calibration convergence validation suite (29 tests) · Fix scripts/ packaging bug - move helper scripts into…

v0.1.2 · 2026-03-28

Fix server.json description length · Release v0.1.2: fix --version output

04 · Who maintains Tokencast

tokencast is maintained by krulewis. It's the only MCP server we track from this author; the repo dates to Mar 2026.

05 · Facts

category
productivity - ranked #140 of 160 actively-maintained productivity servers as of 2026-09-18.
registry
io.github.krulewis/tokencast (active, first published 2026-03-28)
packages
pypi:tokencast

06 · Tokencast FAQ

Is Tokencast still maintained?

Yes - as of 2026-09-18, its last commit was 2026-04-26. We re-verify nightly.

What can Tokencast do?

With this server connected, an agent can check whether your estimates are well-calibrated, browse past estimates vs actuals, and report actual cost at session end to improve calibration.

How do I install Tokencast?

Run `uvx tokencast`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does Tokencast run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Tokencast

More productivity MCP servers · Ownly · Standardnotes · Obsidian Vault MCP · Macuse · Microsoft Todo

More Python MCP servers · Sap Gui · Kubently · Zotero MCP (kujenga) · Cinema4d · Regula · see all