# mcpspend-cost-tracking

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 117 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/mcpspend-cost-tracking/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/mcpspend-cost-tracking

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcpspend-cost-tracking -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/mcpspend-cost-tracking/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/mcpspend-cost-tracking/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcpspend-cost-tracking -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/mcpspend-cost-tracking/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcpspend-cost-tracking -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/mcpspend-cost-tracking/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/mcpspend-cost-tracking
```

2. **Manually: put the files in place**
- File: `.github/skills/mcpspend-cost-tracking/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcpspend-cost-tracking -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/mcpspend-cost-tracking
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/mcpspend-cost-tracking/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill mcpspend-cost-tracking -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/mcpspend-cost-tracking/SKILL.md

## When to use it
- 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
- 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

## Similar
- [mcpspend](https://affpapa.org/en/nevibecode/mcp/mcpspend.md) — MCP server · ★ 58 repo stars
- [cost-burn](https://affpapa.org/en/nevibecode/skills/cost-burn.md) — skill · 248 installs
- [cost-alert](https://affpapa.org/en/nevibecode/skills/cost-alert.md) — skill · ★ 1198 repo stars
- [Agent Cost Report](https://affpapa.org/en/nevibecode/skills/agent-cost-report.md) — skill · 816 installs
- [cost-optimize](https://affpapa.org/en/nevibecode/skills/cost-optimize.md) — skill · 753 installs
- [ccam-cost-guard](https://affpapa.org/en/nevibecode/hooks/ccam-cost-guard.md) — hook · ★ 1198 repo stars

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
