Tokei Agent MCP server

tokei-agent

Control your Tokei pre-launch and waitlist campaigns from the command line — and from AI agents like Claude Code and OpenClaw. Wraps the Tokei v1 REST API with JSON-only output, zero runtime dependencies.

Install

npm install -g tokei-agent
# or run without installing:
npx tokei-agent --help

Requires Node 22+.

Claude Code

Install it as a plugin and the tokei-agent skill comes with it — Claude then knows the whole command surface without being told:

/plugin marketplace add gilesdawe/tokei-agent
/plugin install tokei-agent@tokei

Set TOKEIAPIKEY (see Quick start) and you're done. The CLI itself still runs via npx, so there is nothing else to install.

Quick start

1. Create an API key at tokei.io → Dashboard → Settings → API Keys. Pick read-only unless you need to change things; API access requires an active subscription or lifetime plan.

1. Export it — the syntax differs by shell:

export TOKEI_API_KEY=tokei_k_...          # bash / zsh

set -x TOKEI_API_KEY tokei_k_...          # fish

$env:TOKEI_API_KEY = "tokei_k_..."        # PowerShell

1. Try it:

tokei-agent me                       # verify the key, see plan + API usage
tokei-agent pages:list --status active
tokei-agent stats <contestId>        # analytics for one page

Every command prints JSON to stdout with a top-level rate_limit object. Exit codes: 0 success, 1 API/network error, 2 usage error (JSON on stderr).

Interactive output (0.3.1+). When stdout is an interactive terminal, the CLI renders a banner and a human-readable summary instead of raw JSON. When stdout is a pipe, a redirect, CI, or the mcp transport, it prints exactly the JSON it always has — so agents, scripts and MCP clients are unaffected. Set TOKEIOUTPUT=json to force JSON at a terminal too; NOCOLOR disables colour and animation, and TOKEINOANIM=1 keeps the colour but stops the movement.

Known issue — exit codes on Node 24 / Windows (fixed in 0.3.0). On 0.2.2 and earlier the CLI could print its correct JSON output and then abort during process exit, corrupting the exit code ($LASTEXITCODE read -1073740791 / 0xC0000409 on success and failure alike). On an affected version, judge a run by the JSON on stdout, not by the exit status — or upgrade. (Historical labelling slip: the 0.3.0 tarball misreported --version as 0.2.2; 0.3.1+ reports correctly.)

Commands

Read (any key):

Shortened. The full README is on GitHub.