How do I install MCPSpend?

MCPSpend is a local plugin. Install it using npm package: @mcpspend/mcp-server and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does MCPSpend need?

MCPSpend requires the following credentials or environment variables: MCPSPEND_API_KEY, MCPSPEND_ENDPOINT. You can find setup instructions on the server detail page.

What AI apps work with MCPSpend?

MCPSpend uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

MCPSpend MCP Server

by Andreisirbu91 Lab

Developer ToolsLow Risk9.0MCP RegistryLocal

Free

Server data from the Official MCP Registry

Query your MCPSpend usage: cost today, top tools, recent sessions, budget projections.

About

Query your MCPSpend usage: cost today, top tools, recent sessions, budget projections.

Security Report

9.0

Low Risk9.0Low Risk

Valid MCP server (2 strong, 2 medium validity signals). 2 known CVEs in dependencies ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

11 files analyzed · 3 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

database

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your MCPSpend API key. Create one at https://mcpspend.com/dashboard/keys. Starts with mcps_live_ or mcps_test_.Required

Environment variable: MCPSPEND_API_KEY

Optional. Override the MCPSpend API endpoint. Defaults to https://api.mcpspend.com. Use only if you self-host MCPSpend.Optional

Environment variable: MCPSPEND_ENDPOINT

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-andreisirbu91-lab-mcpspend": {
      "env": {
        "MCPSPEND_API_KEY": "your-mcpspend-api-key-here",
        "MCPSPEND_ENDPOINT": "your-mcpspend-endpoint-here"
      },
      "args": [
        "-y",
        "@mcpspend/mcp-server"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

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.spawn to 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 in SECURITY.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.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

mcp-creator-typescript

Free

by mcp-marketplace · Developer Tools

Scaffold, build, and publish TypeScript MCP servers to npm — conversationally

MCPSpend MCP Server

About

Security Report