zero-core-budget
Agent spending mgmt, budget tracking, ROI. Zero Core Budget.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"zero-core-budget": {
"command": "npx",
"args": [
"@meltingpixels/zero-core-budget"
]
}
}
}Runnable packages
1.0.0streamable-httpRemote endpoints
https://budget.rugslayer.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (6)
🟢list_tools
List all available Harvey Budget tools with pricing and input requirements. Use this for discovery.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢health
Check Harvey Budget server status, uptime, and payment network configuration.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡register_agent(agent_id, daily_limit_usd, weekly_limit_usd, category_limits)
Register an agent with daily and weekly budget limits, or update them. The agent_id belongs to the wallet that pays for this call: call check_spend, report_spend and get_spending_report from the same wallet.
Input Schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"description": "Your agent's name. It belongs to the wallet you pay from: only calls paid from that wallet can read or change it"
},
"daily_limit_usd": {
"type": "number",
"minimum": 0.001,
"maximum": 10000,
"description": "Maximum daily spending in USD"
},
"weekly_limit_usd": {
"type": "number",
"minimum": 0.001,
"maximum": 100000,
"description": "Maximum weekly spending in USD"
},
"category_limits": {
"type": "object",
"additionalProperties": {
"type": "number"
},
"description": "Optional per-category weekly limits (e.g. {security: 1.0, content: 2.0})"
}
},
"required": [
"agent_id",
"daily_limit_usd",
"weekly_limit_usd"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢check_spend(agent_id, service_id, amount_usd, category)
Pre-spend budget approval check. Verifies daily/weekly/category limits, estimates ROI from your own past spends with this service, and suggests cheaper alternatives you have used. Call this BEFORE paying for any service.
Input Schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"description": "Your agent's name. It belongs to the wallet you pay from: only calls paid from that wallet can read or change it (register it first)"
},
"service_id": {
"type": "string",
"description": "Service you want to pay for (e.g. 'harvey-tools/scrape_url')"
},
"amount_usd": {
"type": "number",
"minimum": 0,
"description": "Amount you're about to spend in USD"
},
"category": {
"type": "string",
"enum": [
"security",
"trading",
"social",
"content",
"data",
"infrastructure",
"other"
],
"description": "Spending category"
}
},
"required": [
"agent_id",
"service_id",
"amount_usd",
"category"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪report_spend(agent_id, service_id, amount_usd, category, outcome_success, ...)
Record a completed spend with optional outcome tracking. Call this AFTER paying for a service to track spending and build ROI history.
Input Schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"description": "Your agent's name. It belongs to the wallet you pay from: only calls paid from that wallet can read or change it"
},
"service_id": {
"type": "string",
"description": "Service that was used"
},
"amount_usd": {
"type": "number",
"minimum": 0,
"description": "Amount spent in USD"
},
"category": {
"type": "string",
"enum": [
"security",
"trading",
"social",
"content",
"data",
"infrastructure",
"other"
],
"description": "Spending category"
},
"outcome_success": {
"type": "boolean",
"description": "Whether the service call succeeded"
},
"value_received": {
"type": "string",
"description": "Description of value received"
}
},
"required": [
"agent_id",
"service_id",
"amount_usd",
"category"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_spending_report(agent_id, period)
Detailed spending analytics report. Returns total spent, category breakdown, top services with ROI, and optimization recommendations. Use to understand spending patterns and find inefficiencies.
Input Schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"description": "Your agent's name. It belongs to the wallet you pay from: only calls paid from that wallet can read or change it"
},
"period": {
"type": "string",
"enum": [
"day",
"week",
"month"
],
"description": "Report period"
}
},
"required": [
"agent_id",
"period"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence