Wraps any MCP server as a proxy and tracks the cost of each tool call, attributing spend per tool, project and customer.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add mcpspend --env MCPSPEND_API_KEY='<MCPSPEND_API_KEY>' -- npx -y @mcpspend/mcp-server~/.codex/config.toml
[mcp_servers.mcpspend]
command = "npx"
args = ["-y", "@mcpspend/mcp-server"]
env = { MCPSPEND_API_KEY = "<MCPSPEND_API_KEY>" }
# codex mcp add mcpspend --env MCPSPEND_API_KEY='<MCPSPEND_API_KEY>' -- npx -y @mcpspend/mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"mcpspend": {
"command": "npx",
"args": [
"-y",
"@mcpspend/mcp-server"
],
"env": {
"MCPSPEND_API_KEY": "<MCPSPEND_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"mcpspend": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mcpspend/mcp-server"
],
"env": {
"MCPSPEND_API_KEY": "<MCPSPEND_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"mcpspend": {
"command": "npx",
"args": [
"-y",
"@mcpspend/mcp-server"
],
"env": {
"MCPSPEND_API_KEY": "<MCPSPEND_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"mcpspend": {
"command": "npx",
"args": [
"-y",
"@mcpspend/mcp-server"
],
"env": {
"MCPSPEND_API_KEY": "<MCPSPEND_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"mcpspend": {
"command": "npx",
"args": [
"-y",
"@mcpspend/mcp-server"
],
"env": {
"MCPSPEND_API_KEY": "<MCPSPEND_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http mcpspend https://mcpspend--andreisirbu91-lab.run.tools~/.codex/config.toml
[mcp_servers.mcpspend]
url = "https://mcpspend--andreisirbu91-lab.run.tools"
# codex mcp add mcpspend --url https://mcpspend--andreisirbu91-lab.run.tools~/.cursor/mcp.json
{
"mcpServers": {
"mcpspend": {
"url": "https://mcpspend--andreisirbu91-lab.run.tools"
}
}
}.vscode/mcp.json
{
"servers": {
"mcpspend": {
"type": "http",
"url": "https://mcpspend--andreisirbu91-lab.run.tools"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"mcpspend": {
"httpUrl": "https://mcpspend--andreisirbu91-lab.run.tools"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"mcpspend": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcpspend--andreisirbu91-lab.run.tools"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"mcpspend": {
"url": "https://mcpspend--andreisirbu91-lab.run.tools"
}
}
}Environment variables
MCPSPEND_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.