mcpspend-cost-tracking — Claude Code skill
mcpspend-cost-tracking is a Claude Code skill that tracks real-time spending on MCP tool calls by tool, project, and customer. It wraps MCP servers with a transparent proxy.
no license 117 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill mcpspend-cost-tracking -a claude-codeWhat mcpspend-cost-tracking does
MCPSpend inserts a proxy layer between your MCP clients and servers. It intercepts every tool invocation, tallies the cost, and sends usage data to the MCPSpend dashboard. Compatible with Claude Desktop, Cursor, Windsurf, and VS Code.
Setup is a single command: npx --yes @mcpspend/proxy@latest init --key mcps_live_YOUR_KEY. The installer auto-detects your MCP clients, modifies their configs, and backs up the originals. All subsequent tool calls are tracked automatically.
View spend on the MCPSpend dashboard, configure budget thresholds and per-tool limits, set up alerts via Slack or email, and pause execution when you hit a ceiling. Requires an API key from mcpspend.com (free tier: 25K calls per month). Node.js and npm or pnpm must be in PATH.
What it helps with
- track spending on MCP tools per day and per tool type
- allocate costs across projects and customer accounts
- configure alerts when budget limits are exceeded
- export a cost report for a date range
Example prompts for the agent
- Set up cost tracking for all my MCP servers
- Show me the top 10 tools by spending this week
- Wrap the filesystem MCP server to start tracking its costs
How to install mcpspend-cost-tracking
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcpspend-cost-tracking -a claude-code2Manually: put the files in place
~/.claude/skills/mcpspend-cost-tracking/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mcpspend-cost-tracking/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcpspend-cost-tracking -a codex2Manually: put the files in place
.agents/skills/mcpspend-cost-tracking/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcpspend-cost-tracking -a cursor2Manually: put the files in place
.cursor/skills/mcpspend-cost-tracking/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/mcpspend-cost-tracking2Manually: put the files in place
.github/skills/mcpspend-cost-tracking/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcpspend-cost-tracking -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/mcpspend-cost-trackingManually: put the files in place
.devin/skills/mcpspend-cost-tracking/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcpspend-cost-tracking -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mcpspend-cost-tracking
How do I install mcpspend-cost-tracking in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill mcpspend-cost-tracking -a claude-code, then open ~/.claude/skills/mcpspend-cost-tracking/SKILL.md.
What does mcpspend-cost-tracking do?
It wraps MCP servers with a proxy that intercepts tool calls and logs their cost. Spending data flows to a dashboard where you can view totals by tool, project, and customer.
What do I need to use it?
An API key from mcpspend.com (free: 25K calls per month), Node.js, and npm or pnpm in PATH. Supports Claude Desktop, Cursor, Windsurf, and VS Code.