Call these via local stdio or remote HTTP at https://mcp.costmcp.com.

​
log_usage

Permission: log_usage
ParamTypeRequired
projectstring✓
providerstring✓
unit_typestring✓
quantitynumber (>0)✓
modelstring
estimated_costnumber
featurestring
batch_idstring
Local: POST /api/v1/messages with source: "mcp".
Remote: persists directly via service role.

​
add_expense

Permission: add_expenses
ParamTypeRequiredDefault
projectstring✓
vendorstring✓
amountnumber (>0)✓
currencystringUSD
categorystring
notesstring

​
get_project_spend

Permission: read_summaries
ParamTypeRequired
projectstring✓
fromISO datetime
toISO datetime
Local: GET /api/v1/projects/{project}/spend.
Remote: DB query (limit 200).

​
get_budget_status

Permission: read_summaries
No parameters. Returns the same shape as GET /api/v1/budgets/status.

​
get_monthly_summary (remote only)

Permission: read_summaries
No parameters. Same shape as GET /api/v1/summary/month. 
{
  "period": "month",
  "total_usd": 0,
  "usage_usd": 0,
  "subscription_usd": 0,
  "expense_usd": 0,
  "by_project": {},
  "top_project": null,
  "message_count": 0
}

​
Example prompts

  • “Log 1.2M tokens under ProgressGoat”
  • “Log $18.40 Kling batch under YouTube Pipeline”
  • “How much did Slideshow Studio cost this week?”
  • “Can I afford 100 video generations?”