Mcpspend
- 83 repo stars
- Updated July 14, 2026
- andreisirbu91-lab/MCPSpend
MCPSpend is a MCP server that lets your agent query MCP tool usage costs, top spenders, sessions, and budget projections from MCPSpend.
About
MCPSpend is a cost monitoring tool for Model Context Protocol usage that gives you real-time visibility into what you're spending across different tools and services. Use it when you're running agents, APIs, or AI-powered applications to understand which components are driving your bills. It matters because unchecked API and LLM costs can spiral quickly—this tool helps you catch anomalies, optimize high-cost services, and stay within budget.
- Real-time cost tracking for MCP tools
- Budget projections and top tool analytics
- Daily spend summaries and recent session logs
Mcpspend by the numbers
- Data as of Jul 28, 2026 (Skillselion catalog sync)
claude mcp add --env MCPSPEND_API_KEY=YOUR_MCPSPEND_API_KEY --env MCPSPEND_ENDPOINT=YOUR_MCPSPEND_ENDPOINT mcpspend -- npx -y @mcpspend/mcp-serverAdd your badge
Show developers this MCP server is listed on Skillselion. Paste this into your README.
| repo stars | ★ 83 |
|---|---|
| Package | @mcpspend/mcp-server |
| Transport | STDIO |
| Auth | Required |
| Last updated | July 14, 2026 |
| Repository | andreisirbu91-lab/MCPSpend ↗ |
What it does
Track real-time API and LLM costs across their tools and projects, catching budget overruns before they become expensive problems.
Who is it for?
Best when you're already on MCPSpend and want cost answers inside Claude Code or Cursor without leaving the chat.
Skip if: Skip if you do not use MCP at all or need enterprise invoice reconciliation instead of session-level MCP telemetry.
What you get
After install, your agent can report MCPSpend totals and tool rankings so you can trim or rotate expensive integrations before costs spike.
- Agent-readable daily MCP cost and session summaries
- Ranked list of highest-spend MCP tools
- Budget projection answers grounded in MCPSpend data
By the numbers
- Package @mcpspend/mcp-server version 0.2.1
- Default API endpoint https://api.mcpspend.com
- stdio transport; boots without API key, auth required on tool calls
README.md
MCPSpend
Know what your AI agents really cost. Real-time cost tracking for every MCP tool call across Cursor, Claude Desktop, Windsurf, and VS Code.
mcpspend.com · Smithery · npm · Open VSX · Glama
One-command install
npx --yes @mcpspend/proxy@latest init --key mcps_live_xxx
Auto-detects Claude Desktop, Cursor, Windsurf, VS Code (user + workspace), and Claude Code (user + project). Wraps every configured MCP server, leaves a .mcpspend.bak backup, and starts streaming usage to your dashboard at mcpspend.com.
Free tier: 25,000 tool calls/month, no credit card.
What's in this monorepo
| Package | What it is |
|---|---|
packages/proxy |
@mcpspend/proxy — the stdio observability proxy + wrap-http bridge for remote MCP servers. Published on npm. |
packages/mcp-server |
@mcpspend/mcp-server — query your MCPSpend usage from inside any MCP client. Published on npm + Smithery. |
packages/vscode-extension |
mcpspend-vscode — IDE extension for Cursor, Windsurf, and VS Code. Published on Open VSX. |
apps/api |
Express + Prisma + Postgres + BullMQ. The ingest endpoint, billing, and the new /api/mcp HTTP MCP server. |
apps/dashboard |
Next.js dashboard at mcpspend.com. |
Three ways to query your usage
| Use case | How |
|---|---|
| Web dashboard | mcpspend.com/dashboard — overview, top tools, sessions, CSV export. |
| From any MCP client (stdio) | Add @mcpspend/mcp-server to your client config — agent gains tools like get_today_cost, list_top_tools. |
| From any MCP client (HTTP) | Point your client at https://api.mcpspend.com/api/mcp with Authorization: Bearer mcps_live_…. |
Pricing
| Plan | Calls/month | Monthly | Yearly |
|---|---|---|---|
| Free | 25,000 | $0 | $0 |
| Pro | 1,000,000 | $29 | $290 (2 months free) |
| Team | 10,000,000 | $99 | $990 |
| Enterprise | unlimited | $499 | $4,990 |
Every paid plan: 30–90 day retention, CSV/Slack export, budget alerts, role-based access.
Privacy
The proxy reports: tool name, server name, model, latency, success, approximate input/output sizes (tokens, derived from JSON length). It does not send the actual tool arguments or response bodies to MCPSpend. See Privacy Policy for the full sub-processor list (Stripe + Resend + Hostinger, all EU-hosted) and your GDPR rights.
Security
For automated scanners flagging this repo: the proxy uses
child_process.spawnto wrap the user's own MCP server — that's the whole point of an observability proxy. The spawn args come from the user's local MCP-client config (Claude Desktop / Cursor / Windsurf / VS Code), never from network input. No RCE path, no privilege escalation, no arbitrary command execution. Full threat model inSECURITY.md.
- API keys stored as SHA-256 hashes (never plaintext on the server)
- Passwords bcrypt cost 12
- Secrets at rest AES-256-GCM (
APP_ENCRYPTION_KEY) - Transport HTTPS only, HSTS enabled, helmet CSP headers
- No tool arguments or responses ever leave the user's machine
- Per-tenant isolation every query scopes by
organizationId - GDPR Art. 15 / 17 / 20 self-serve at
mcpspend.com/dashboard/account/privacy - EU-hosted (Hostinger EU region)
- SOC 2 Type I in progress with Vanta (Q4 2026)
- DPA available for Enterprise customers
Report vulnerabilities: security@mcpspend.com · Machine-readable disclosure: https://mcpspend.com/.well-known/security.txt · Full policy: SECURITY.md · Live posture: https://mcpspend.com/security
Support the project
If MCPSpend saves you money or you just want to keep the proxy MIT and the free tier alive, you can sponsor any amount via Stripe — no account required:
💖 buy.stripe.com/00w8wPbUxe1qgK36CRbbG06
Every dollar goes back into hosting, security audits, and shipping features.
License
MIT. Use it, fork it, run it self-hosted.
© NewRzs SRL · CUI RO48756557 · Bucharest, Romania · support@mcpspend.com
Recommended MCP Servers
Agent Audit McpImmutable audit trail for agent-to-agent interactions2
Agentguard47Read-only MCP server for coding-agent traces, alerts, costs, usage, and budget health.4
Agentic Observability MCPAgent tracing, cost tracking, anomaly detection for LLM agents
Agent Incident Relay McpAgent Incident Relay MCP — Article 73 5-clock broadcaster.
Agent Infra Mcp18 tools: agent memory, API drift detection, and HMAC-signed trust receipts
Agentmonitorrelay McpAI agent run monitoring with incident replay and SLA receipts.How it compares
MCP usage monitor via MCPSpend API, not a generic cloud billing MCP or an agent skill that changes code.
FAQ
Who is MCPSpend for?
Developers and agent power users who track MCP tool spend on MCPSpend and want those metrics callable from their coding assistant.
When should I use MCPSpend?
Use it during Operate monitoring—after MCP servers are in daily use—when you need today's cost, top tools, or budget projections mid-session.
How do I add MCPSpend to my agent?
Add the stdio npm server @mcpspend/mcp-server to your MCP config, set MCPSPEND_API_KEY from mcpspend.com/dashboard/keys for tool calls, then restart the agent.