SkillFM Claude Code Token Usage
Claude Code token usage, cost visibility, and SkillFM Beacon AI health checks for MCP agents.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@skillfm/claude-code-token-usage-mcpclaude mcp add skillfm-claude-code-token-usage -- npx -y @skillfm/claude-code-token-usage-mcp@0.1.0
{
"mcpServers": {
"skillfm-claude-code-token-usage": {
"command": "npx",
"args": [
"-y",
"@skillfm/claude-code-token-usage-mcp@0.1.0"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
SkillFM Claude Code Token Usage MCP
Claude Code token usage and cost visibility for MCP-capable agents.
This repository is a transparent SkillFM gateway package. It exists to match a specific marketplace/search intent, then delegates execution to the canonical SkillFM Beacon MCP and local runtime.
Powered by SkillFM Beacon.
Quick Start
Use this gateway as an MCP stdio server:
npx -y @skillfm/claude-code-token-usage-mcp@latest
Equivalent explicit SkillFM entrypoint:
npx -y @skillfm/mcp@latest
For MCP clients that accept JSON config:
{
"mcpServers": {
"claude-code-token-usage": {
"command": "npx",
"args": ["-y", "@skillfm/claude-code-token-usage-mcp@latest"]
}
}
}
What This Gateway Helps With
- Inspect Claude Code token usage and estimated cost signals.
- Connect usage visibility to SkillFM Beacon AI health checks.
- Find repeated context, stale sessions, and cost-saving opportunities.
- Route users toward local-first SkillFM activation without asking for provider keys first.
This gateway is for users who ask:
- "How many Claude Code tokens did I use today?"
- "Why did my Claude Code usage spike?"
- "Which sessions or projects are wasting context?"
- "Can my agent show me token usage before I connect provider keys?"
How It Works
The public package is intentionally thin. It sets SKILLFM_GATEWAY_SOURCE=claude-code-token-usage and forwards execution to @skillfm/mcp@latest, which then delegates to the canonical @skillfm/local runtime.
No private SkillFM platform logic, customer data, provider credentials, or backend modules live in this repository.
Activation Path
Start the local sidecar when the user wants to connect SkillFM:
npx -y @skillfm/claude-code-token-usage-mcp@latest start
Agent-driven activation flow:
- Read the sidecar URL from stdout or
~/.skillfm/local.json. - Call
POST <sidecar_url>/activate/start. - Show the returned verification URL and real device code to the user.
- Poll
POST <sidecar_url>/activate/polluntil it returnsactivated: true. - Use SkillFM Beacon MCP tools for checkups, usage visibility, BYOK guidance, and cleanup audits.
Do not fabricate a placeholder code. The device code must come from POST /activate/start.
Security Model
- Transparent gateway: This package is a public search/distribution gateway, not a separate hidden product.
- Local-first runtime: Runtime execution goes through SkillFM's local package.
- BYOK boundary: Provider keys are introduced only after user value is established, and key values are not read back by agents.
- No private core: This repository contains distribution metadata, docs, and a thin launcher only.
- Read-only first: Cleanup and usage inspection begin with read-only audits.
See PRIVACY.md and SECURITY.md.
Marketplace Keywords
Claude Code token usage, Claude usage, token cost, LLM cost, AI health checkup, agent monitoring, context cleanup, SkillFM Beacon, MCP server.
Expected Official MCP Registry single-token hits:
claude-codetokenusagecostskillfm
License
MIT
Frequently asked questions
What is SkillFM Claude Code Token Usage?
Claude Code token usage, cost visibility, and SkillFM Beacon AI health checks for MCP agents.
How do I install SkillFM Claude Code Token Usage?
It runs on your machine. In Claude Code: claude mcp add skillfm-claude-code-token-usage -- npx -y @skillfm/claude-code-token-usage-mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.
Does SkillFM Claude Code Token Usage need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is SkillFM Claude Code Token Usage open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains SkillFM Claude Code Token Usage?
It is published by ericm1018. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.