GET
/
api
/
v1
/
summary
/
month
curl https://api.costmcp.com/api/v1/summary/month \
  -H "Authorization: Bearer $COSTMCP_API_KEY"

{
  "period": "month",
  "total_usd": 42.5,
  "usage_usd": 30.1,
  "expense_usd": 10,
  "subscription_usd": 2.4,
  "by_project": {
    "slideshow-studio": 28.2,
    "progressgoat": 14.3
  },
  "top_project": {
    "slug": "slideshow-studio",
    "amount_usd": 28.2
  },
  "message_count": 184
}
Requires permission read_summaries. Scoped to the API key’s workspace.
​
period
string
required
Always "month"
​
total_usd
number
required
Sum of all message types
​
usage_usd
number
required
Usage-only total
​
expense_usd
number
required
Expense total
​
subscription_usd
number
required
Subscription total
​
by_project
object
required
Map of project slug → amount USD
​
top_project
object
{ slug, amount_usd } for the highest-spend project
​
message_count
number
required
Number of ledger rows in the period
curl https://api.costmcp.com/api/v1/summary/month \
  -H "Authorization: Bearer $COSTMCP_API_KEY"

{
  "period": "month",
  "total_usd": 42.5,
  "usage_usd": 30.1,
  "expense_usd": 10,
  "subscription_usd": 2.4,
  "by_project": {
    "slideshow-studio": 28.2,
    "progressgoat": 14.3
  },
  "top_project": {
    "slug": "slideshow-studio",
    "amount_usd": 28.2
  },
  "message_count": 184
}