MCPSpend
MCPSpend wraps MCP servers in a proxy and counts what each tool call costs per project, model and client
- 56 ★ on the repository
- Last commit
Extended access
Why this level
- The proxy sits between the client and all your MCP servers and passes the metadata of every call outside
- Installation rewrites the Claude Desktop, Cursor, Windsurf, VS Code and Claude Code configurations
Install
- Works in
Manual install
npx --yes @mcpspend/proxy@latest init --key mcps_live_xxxThe key comes from the mcpspend.com dashboard and the command keeps `.mcpspend.bak`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The proxy sits between the client and all your MCP servers and passes the metadata of every call outside
- Installation rewrites the Claude Desktop, Cursor, Windsurf, VS Code and Claude Code configurations
This is third-party code. Review the repository files before installing.
What it does
MCPSpend is a monorepo of a service that tracks the cost of MCP tool calls. The `@mcpspend/proxy` proxy finds configured servers in Claude Desktop, Cursor, Windsurf, VS Code and Claude Code with the `init` command, wraps them, leaves a configuration backup with the `.mcpspend.bak` suffix and sends statistics to the dashboard at mcpspend.com. The proxy reports tool and server name, model, latency, success and approximate input and output size in tokens. The arguments and responses themselves are not sent to the service. Costs can be queried from a client through the `@mcpspend/mcp-server` package with tools such as `get_today_cost` and `list_top_tools` or through an HTTP endpoint. The free plan gives 25 thousand calls a month and paid plans add retention, export and budgets.
Who it is for. Teams and developers with several MCP servers who want to see where tokens and money go.
Good fit when
- Find out which MCP tools in Cursor and Claude Code spend the most tokens
- Ask the agent how much calls cost today through `get_today_cost`
- Set up alerts when a project exceeds its budget
- Export spend per customer to CSV
Not a fit when
- Even call metadata must not go to an external service
- You only need token accounting from the model provider
- There are one or two MCP servers and spend is of no interest
Example request
How much did MCP tool calls cost today and which five tools spend the most?MCP
- Transport
- stdio, http
- Authentication
- API key
Environment variables
MCPSPEND_API_KEYrequired, secret- Service key like mcps_live_...
Limitations
A key like `mcps_live_...` from the mcpspend.com dashboard is required and is passed with `npx --yes @mcpspend/proxy@latest init --key <key>`. The proxy edits client configurations, so a `.mcpspend.bak` copy is created and rollback is manual. Call metadata goes to a cloud service while argument and response texts do not. The free plan has a limit of 25 thousand calls a month and paid plans follow. The main repository includes the API server, a Next.js dashboard and a VS Code extension.
How to disable. Restore the original client configuration from the `.mcpspend.bak` file, delete the `@mcpspend/mcp-server` entry and revoke the key in the service dashboard.
FAQ
How do I connect MCPSpend?
Run `npx --yes @mcpspend/proxy@latest init --key <key>`. The command finds configured servers in Claude Desktop, Cursor, Windsurf, VS Code and Claude Code and wraps them.
What data goes to the service?
Tool and server name, model, latency, success and approximate input and output size in tokens. Arguments and responses are not sent.
How much does it cost?
The free plan covers 25 thousand calls a month with no card. Paid Pro, Team and Enterprise plans add volume, retention, export and budgets.
How do I ask about spend from an agent?
Add `@mcpspend/mcp-server` to the client and use the `get_today_cost` and `list_top_tools` tools. An HTTP variant exists at `https://api.mcpspend.com/api/mcp` with a Bearer header.
Does it work with remote MCP servers?
Yes, the `wrap-http` bridge wraps a remote server the way the local proxy wraps stdio.
Discussion
No questions or reviews yet.
Related
MCP serversThe Betterlytics web analytics MCP server: an agent reads traffic, funnels, JavaScript errors and uptime monitor state.
Humblytics MCP gives an agent live site analytics, funnels and A/B tests plus 12 marketing skills for finding conversion problems.
HitKeep is open source cookieless web analytics in one binary with a read-only MCP server that gives assistants aggregate data.
Eight read-only SEO MCP servers
seo-tools-mcp
SERP, Wordstat, GSC, GA4, Yandex Webmaster, Metrika and A-Parser: eight read-only MCP servers with strict JSON and multi-account support for Claude Code
MCP Yandex Metrica with counter management
@theyahia/yandex-metrika-mcp
Yandex Metrica MCP server with 15 tools: reports and traffic plus creating, editing, and deleting counters and goals
crawlseo MCP compares the latest 28 days of site metrics with the preceding 28 days, alongside results from the latest crawl.
README in short
The README presents the project as accounting for the real cost of agent work and describes one-command installation. The monorepo packages, three ways to query data, pricing, the privacy policy and a note for automated security scanners are covered next.