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?

Install SkillFM Claude Code Token Usage via npm from https://registry.npmjs.org, then add the server config to your MCP client (Claude Desktop, Cursor, or VS Code).

Is SkillFM Claude Code Token Usage open source?

Yes, SkillFM Claude Code Token Usage is open source under the MIT license. Source code is available at https://github.com/ericm1018/skillfm-claude-code-token-usage-mcp.

What category does SkillFM Claude Code Token Usage belong to?

SkillFM Claude Code Token Usage is listed under AI & ML MCP servers on MCPFind.

SkillFM Claude Code Token Usage — MCP Server for AI & ML

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.

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/poll until it returns activated: 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-code
token
usage
cost
skillfm

License

MIT

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "io-github-ericm1018-skillfm-claude-code-token-usage-cost": {
      "command": "npx",
      "args": [
        "-y",
        "@skillfm/claude-code-token-usage-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

SkillFM Claude Code Token Usage works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

SkillFM Claude Code Token Usage