Skip to main content
Glama

toke-local

A local, zero-dependency MCP server that cuts the round-trips, re-reads and log floods out of coding agents — the same tool-aggregation model published by the commercial Tokeasy (tokeasy.net), implemented from scratch, auditable, and fully local.

12 calls  →  glob → grep → read → read → read → edit ✕ → re-read → retry → verify…
2 calls   →  agent_search → agent_edit

Every savings number is labeled counted / measured / estimated and every pricing assumption is a named constant in source.

Features

Tool

What it does

Saves

agent_search

glob + grep + read + import graph in one ranked call: matches with score, context lines, per-file imports and reverse imported_by

4–5 calls → 1

agent_read

structure-aware truncation: imports/types/interfaces/signatures kept, long bodies stubbed ([body omitted: N lines]); mode:"full" for the whole file

full-file dumps → ~10–20% of bytes

agent_edit

batched, multi-file edits; fuzzy match tolerates whitespace and quote drift; TS/JSON/YAML/Python validated before any write; invalid output rejected, ambiguous hunks refused

failed-edit re-read + retry loops

agent_exec

accepted command → failure-preserving digest: exit code, all failure lines, per-line ~200-char cap, receipt stored for exact fetch-back; wait_ms and until:regex; timeout kills

100 KB log → ~2 KB digest

agent_git

branch, upstream, remote, ahead/behind, dirty, files changed, diffstat, recent commits, stash, merge state in one call

5+ git calls → 1

agent_savings

persistent ledger with labeled totals (counted/measured/estimated), estimate, receipts, reset

transparency (measure, don't guess)

[now: … UTC]

every response stamps the clock, so the agent stops wasting a call asking the date

1 call per session

Plus safety: edits are applied snapshot-safe (immutable blob + 3-way merge + atomic write via the sibling snapedit project), path traversal (../) and symlink escapes are blocked with out_of_scope, and no code ever leaves your machine.

Related MCP server: Kontrol

Benchmark

npm run bench reproduces the site's five benchmark categories (VR physics, worker provisioning, security audit, financial research, mobile refactor) with real tool outputs measured end-to-end and the session-transcript economics modeled with named constants:

Task

Vanilla

toke-local

Δ

VR physics simulation game

$3.00

$0.08

−97.4%

SaaS worker provisioning

$1.99

$0.07

−96.2%

SaaS security audit

$1.46

$0.07

−94.9%

Financial deep research

$2.40

$0.07

−96.9%

Mobile app multi-day refactor

$2.46

$0.07

−97.0%

Whole suite

$11.32

$0.38

−96.6%

Honest caveat: this is a modeled benchmark (local measured tool outputs + published list-price constants), not a billed agent session. Real-world savings depend on how read/retry-heavy the workload is — the same mechanisms the commercial product documents as ~20% on its own suite. The happy-path claim is: architecturally the identical cost drivers are removed, measured locally rather than published by a committee. See docs/BENCHMARK.md.

Install

Requires Node ≥ 18. No runtime dependencies.

git clone https://github.com/rianprei/toke-local
cd toke-local

Connect to any MCP client

The server speaks JSON‑RPC 2.0 over stdio. Point Claude Code, Codex, opencode, Cursor, Copilot or Windsurf at:

node bin/toke-local mcp

Claude Code example:

claude mcp add toke-local -- npx -y github:rianprei/toke-local -- mcp   # or: node /abs/path/bin/toke-local mcp

CLI

toke-local mcp | search | read | edit | exec | git | savings [json-args]

Example:

node bin/toke-local search '{"query":"renderInvoice","root":".","context_lines":2}'
node bin/toke-local read '{"file":"src/invoice.ts"}'
node bin/toke-local edit '{"cwd":".","edits":[{"path":"src/invoice.ts","old_text":"…","new_text":"…"}]}'

Tests

npm test        # 25/25 pass (node:test, zero deps)
npm run bench   # the benchmark above

Repository layout

bench/bench.js         benchmark harness (5 tasks, vanilla vs toke, named constants)
bin/toke-local         executable entry point
src/server.js          MCP JSON‑RPC server (initialize, tools/list, tools/call)
src/cli.js             CLI dispatch
src/tools/             the six tools
src/ledger.js          savings ledger (labeled) with named constants
src/syntax.js          validators (TS/JS/JSON/YAML/Python)
src/util.js            tsHeader + small helpers
test/toke-local.test.js  25 tests
docs/                   architecture, benchmark methodology, runbook

License

MIT © 2026 rianprei — see LICENSE. Built to be the open, local, auditable alternative to a closed commercial MCP kit. Code never leaves your machine.

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    C
    maintenance
    A local-first MCP server that provides AI agents with safe codebase access through file discovery, hybrid lexical-semantic search, and project introspection. It features durable local memory and semantic indexing while keeping all data and processing entirely on your local machine.
    Last updated
    74
    39
    5
    MIT
  • A
    license
    -
    quality
    B
    maintenance
    A self-hosted MCP server that enables AI coding agents to read, edit, search, and run code in local projects with human review loops and policy controls.
    Last updated
    MIT
  • A
    license
    -
    quality
    A
    maintenance
    An MCP server that indexes a repository locally and provides keyword, semantic, hybrid, and SQL search tools, enabling coding agents to answer questions about the codebase efficiently without reading files one by one.
    Last updated
    51
    18
    Apache 2.0

View all related MCP servers

Related MCP Connectors

  • Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.

  • User-owned memory for AI agents, Copilot, Claude, IDEs, CLIs, and chat apps over remote MCP.

  • A paid remote MCP for OpenAI Codex agent coordination MCP, built to return verdicts, receipts, usage

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rianprei/toke-local'

If you have feedback or need assistance with the MCP directory API, please join our Discord server