Tokei Agent MCP Server
by gilesdaweio.github.gilesdawe/tokei-agentv0.3.6
Control your Tokei (tokei.io) pre-launch and waitlist campaigns from AI agents and the command line.
context tax
queued
security
queued
cold start
queued
freshness
Active30d ago
Install Tokei Agent MCP server
Install in Claude Code
claude mcp add tokei-agent -e TOKEI_API_KEY='<tokei-api-key>' -- npx -y tokei-agentInstall in Cursor
{
"mcpServers": {
"tokei-agent": {
"command": "npx",
"args": [
"-y",
"tokei-agent"
],
"env": {
"TOKEI_API_KEY": "<tokei-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"tokei-agent": {
"command": "npx",
"args": [
"-y",
"tokei-agent"
],
"env": {
"TOKEI_API_KEY": "<tokei-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"tokei-agent": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tokei-agent"
],
"env": {
"TOKEI_API_KEY": "<tokei-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"tokei-agent": {
"command": "npx",
"args": [
"-y",
"tokei-agent"
],
"env": {
"TOKEI_API_KEY": "<tokei-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| TOKEI_API_KEY | yes | yes | Tokei API key (starts tokei_k_). Create one at tokei.io -> Dashboard -> Settings -> API Keys. Read-only keys cover every read command; write access is opt-in. |
| TOKEI_API_URL | — | — | Override the API base URL. Defaults to https://tokei.io; rarely needed. |
Freshness
Active — last maintenance signal 30d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-04 · 36d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-10 · 30d ago · official registry · v0.3.6
FAQ
›How do I install the Tokei Agent MCP server in Claude Code?
Run: claude mcp add tokei-agent -e TOKEI_API_KEY='<tokei-api-key>' -- npx -y tokei-agent. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Tokei Agent require an API key?
Yes. It expects TOKEI_API_KEY, of which 1 is a secret.
›Can I use Tokei Agent as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Tokei Agent in the official MCP registry?
Yes, as io.github.gilesdawe/tokei-agent.