# ZenSched Usage & Spend Meter

> ZenSched Usage & Spend Meter is a paid API for AI agents from mcp.zensched.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-27).

Retrieves metered API usage and spend totals for a given billing period (YYYY-MM format) for the calling organization.

## Facts

- Endpoint: GET https://mcp.zensched.com/x402/tools/usage_get?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zensched-usage-spend-meter-6bc2d99f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uP_sc90UP2GgGC0O1Yakq

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability zensched-usage-spend-meter-6bc2d99f
```

Example prompt: Can you pull up my ZenSched usage and spend for last month, say 2025-05?

## When to prefer this

Use this endpoint when you need programmatic access to ZenSched API consumption metrics and spend for a specific billing month. Prefer this over the billing_status endpoint when you want historical period-level usage data rather than current plan and payment rail status. Ideal for automated cost reporting, budget monitoring, or integrating ZenSched spend into a broader financial dashboard.

## Known failure modes

- Invalid period format (not YYYY-MM) returns an error or falls back to current month
- Unrecognized or unprovisioned wallet/org may result in auto-provisioning on first call or an auth error
- Network or payment failure for the $0.01 USDC per-call fee may block the request
- Period in the future with no data may return empty or zero values

## How this service works

ZenSched `usage_get` — Meter usage + spend for a period (YYYY-MM; blank = current month). Pay-per-call $0.01 USDC; the paying wallet owns the org (auto-provisioned on first call). Catalog: https://mcp.zensched.com/x402/tools

## Output

Returns metered call counts and cumulative spend in USDC for the requested billing period (or the current month if no period is specified), scoped to the organization that owns the paying wallet.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "title": "usage_getArguments",
     "properties": {
      "period": {
       "type": "string",
       "title": "Period",
       "default": ""
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zensched-usage-spend-meter-6bc2d99f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.zensched.com](https://www.zero.xyz/host/mcp.zensched.com/llms.txt)