io.github.lazymac2x/ai-budget-planner

Official6 toolsLive

by lazymac2x

Cloudflare Workers MCP server: ai-budget-planner

io.github.lazymac2x/ai-budget-planner (MCP) Server

Cloudflare Workers MCP server that provides the ai-budget-planner functionality via REST + MCP (JSON-RPC 2.0). It is live at api.lazy-mac.com/ai-budget-planner and includes 6 tools exposed through the MCP interface.

🛠️ Key Features

Cloudflare Workers deployment
REST and MCP support
MCP protocol: JSON-RPC 2.0
6 available tools
Live endpoint: api.lazy-mac.com/ai-budget-planner

🚀 Use Cases

Budget-planning access through MCP tooling
Use in environments that can consume REST APIs or JSON-RPC 2.0 MCP

⚡ Developer Benefits

JSON-RPC 2.0 compatible MCP interface
Works alongside REST for integration options
Predictable tool surface area (tool count: 6)

⚠️ Limitations

Limited details available about specific budgeting capabilities; only server type (Cloudflare Workers), protocols (REST + MCP), and tool count (6) are provided.

Captured live from the server via tools/list.

create_budget

Create a monthly LLM budget allocation for a team or department

Parameters5

name	string	required	Human-readable budget name
department	string	optional	Department or team name
monthly_limit_usd	number	required	Monthly spend cap in USD
providers	array	optional	LLM providers to track: openai, anthropic, google, mistral, cohere
api_key	string	optional	API key for the request

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Human-readable budget name"
    },
    "department": {
      "type": "string",
      "description": "Department or team name"
    },
    "monthly_limit_usd": {
      "type": "number",
      "description": "Monthly spend cap in USD"
    },
    "providers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "LLM providers to track: openai, anthropic, google, mistral, cohere"
    },
    "api_key": {
      "type": "string",
      "description": "API key for the request"
    }
  },
  "required": [
    "name",
    "monthly_limit_usd"
  ]
}

get_budget

Get current utilisation, spend breakdown by provider, and alert status for a budget

Parameters2

budget_id	string	required	Budget ID from create_budget (format: bgt_xxx)
api_key	string	optional	API key for the request

Raw schema

{
  "type": "object",
  "properties": {
    "budget_id": {
      "type": "string",
      "description": "Budget ID from create_budget (format: bgt_xxx)"
    },
    "api_key": {
      "type": "string",
      "description": "API key for the request"
    }
  },
  "required": [
    "budget_id"
  ]
}

get_budget_alerts

List all threshold alerts triggered for a budget (50%, 75%, 90%, 100%)

Parameters2

budget_id	string	required	Budget ID
api_key	string	optional	API key for the request

Raw schema

{
  "type": "object",
  "properties": {
    "budget_id": {
      "type": "string",
      "description": "Budget ID"
    },
    "api_key": {
      "type": "string",
      "description": "API key for the request"
    }
  },
  "required": [
    "budget_id"
  ]
}

weekly_report

Get a 7-day LLM spend digest broken down by department and provider

Parameters3

department	string	optional	Filter by department name (optional)
provider	string	optional	Filter by provider name (optional)
api_key	string	optional	API key for the request

Raw schema

{
  "type": "object",
  "properties": {
    "department": {
      "type": "string",
      "description": "Filter by department name (optional)"
    },
    "provider": {
      "type": "string",
      "description": "Filter by provider name (optional)"
    },
    "api_key": {
      "type": "string",
      "description": "API key for the request"
    }
  }
}

department_report

Get month-to-date spend, utilisation, and alert status per department

Parameters2

department	string	optional	Filter to a single department (optional)
api_key	string	optional	API key for the request

Raw schema

{
  "type": "object",
  "properties": {
    "department": {
      "type": "string",
      "description": "Filter to a single department (optional)"
    },
    "api_key": {
      "type": "string",
      "description": "API key for the request"
    }
  }
}

list_providers

List supported LLM providers, their models, and blended cost estimates per 1M tokens

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

Install

Tools (6)

create_budgetget_budgetget_budget_alertsweekly_reportdepartment_reportlist_providers

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.lazy-mac.com/ai-budget-planner/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ai-budget-planner": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.lazy-mac.com/ai-budget-planner/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.lazymac2x/ai-budget-planner

io.github.lazymac2x/ai-budget-planner (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

create_budget

get_budget

get_budget_alerts

weekly_report

department_report

list_providers

ai-budget-planner-api

Install

Remote endpoint

Related servers