Mcpspend MCP server
io.github.andreisirbu91-lab/mcpspend·v0.2.1·113 starsQuery your MCPSpend usage: cost today, top tools, recent sessions, budget projections.
113 stars
Reviews
Write oneNobody has reviewed Mcpspend yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Mcpspend tools (6)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
estimate_costEstimate the USD cost of an MCP tool call BEFORE invoking it. Returns expected cost based on the historical average for this (server, tool, model) combo in this org over the last 30 days. Use this to make spend-aware decisions — e.g. confirm with the user before calling tools that would cost more than $0.10. Returns 0 + isUnknown=true when no history exists yet.
get_session_detailsDrill into a single session by ID: returns the session summary plus every tool call (up to 500) with timing, cost, and success.
get_today_costGet total tool-call cost and call count for the current day (UTC). Returns a human-readable summary plus structured data.
get_usage_this_monthReturns calls used this month, plan limit, percentage used, and a projection for the rest of the month based on the current daily average. Use this to spot when an org is about to hit the cap.
list_recent_sessionsRecent agent sessions (each MCP-client process start = one session) with model, total cost, tool call count, and duration.
list_top_toolsTop tools by total cost over the past N days. Optionally limit how many entries to return. Useful for finding "what is the most expensive thing my agents do".
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 27 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
How Mcpspend compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 80/100
- higher than 60% of 48,255 servers
- Tools
- 6
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 113
- more than 95% of 28,688 servers
What its tools let an agent do: 6 read
Install Mcpspend in Claude Code, Cursor or VS Code
Runs npx -y @mcpspend/mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcpspend -- npx -y @mcpspend/mcp-server
What the publisher says
From the Mcpspend repository's README, as published. We do not edit it. Read it on GitHub
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_xxxAuto-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
Three ways to query your usage
Pricing
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
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Mcpspend: common questions
- Is Mcpspend MCP server safe?
- Mostly: it is graded B (80/100). Read the Mcpspend safety report
- How do I install Mcpspend?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Mcpspend need an API key?
- Yes. The registry entry asks for
MCPSPEND_API_KEY. - Is Mcpspend maintained?
- The last commit was 64 days ago (2026-08-31). The latest release is v0.2.1.
- How does Mcpspend compare with other MCP servers?
- safety score 80/100 (higher than 60% of 48,255 servers); tools 6 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.