# Usage Bill Reconstructor - MCP Scores Tools

> Usage Bill Reconstructor - MCP Scores Tools is a paid API for AI agents from mcp-factory.bowling-anthony.workers.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Analyzes and reconstructs customer usage billing data, reconciling metered usage tiers with invoiced charges to verify accuracy

## Facts

- Endpoint: POST https://mcp-factory.bowling-anthony.workers.dev/usage-bill-reconstructor/analyze
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usage-bill-reconstructor-mcp-scores-tools-2192789c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QImCuDXuuw7xco6w94bI0

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 usage-bill-reconstructor-mcp-scores-tools-2192789c -d '<json body>'
```

Example prompt: Can you reconstruct and verify my usage bill — I need to check whether my invoice total of $27.46 matches my actual usage across request meters and storage meters, and flag any discrepancies?

## When to prefer this

Choose this endpoint when you need to programmatically verify, reconstruct, or audit a usage-based bill with tiered pricing structures, fixed charges, and metered consumption — especially when reconciling an invoice total against raw usage quantities. Prefer it over manual spreadsheet calculations or generic math tools when dealing with multi-tier pricing with included quantities and mixed fixed/variable charges.

## Known failure modes

- Missing or malformed usage data returns error
- Mismatched currency or unit assumptions produce incorrect totals
- Tier boundary miscalculations if included_quantity is omitted
- Payment failure via x402 returns 402 before analysis runs
- Invalid meter IDs result in unrecognized meter errors

## How this service works

Customer-input analysis tools with per-call x402 v2 USDC payments on Base. Discovery and examples are free.

## Output

Returns a JSON object with ok status, an array of billing meters each containing tiered quantity/unit-price/cost breakdowns, total charges in minor units, fixed charges (platform fees, support plans), the overall currency, whether the reconstructed total matches the invoice, and the difference if any.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "meters": [
   {
    "id": "requests",
    "tiers": [
     {
      "quantity": "100000",
      "unit_price": "0.0000005",
      "unrounded_cost": "0.05"
     },
     {
      "quantity": "150000",
      "unit_price": "0.0000003",
      "unrounded_cost": "0.045"
     },
     {
      "quantity": "0",
      "unit_price": "0.0000002",
      "unrounded_cost": "0"
     }
    ],
    "total_minor": "10",
    "usage_quantity": "1250000",
    "billable_quantity": "250000",
    "included_quantity": "1000000"
   },
   {
    "id": "storage_gb_hours",
    "tiers": [
     {
      "quantity": "500.5",
      "unit_price": "0.02",
      "unrounded_cost": "10.01"
     }
    ],
    "total_minor": "1001",
    "usage_quantity": "500.5",
    "billable_quantity": "500.5",
    "included_quantity": "0"
   }
  ],
  "currency": "USD",
  "total_minor": "2746",
  "fixed_charges": [
   {
    "id": "platform_fee",
    "total_minor": "500"
   },
   {
    "id": "support_plan",
    "total_minor": "1235"
   }
  ],
  "matches_invoice": true,
  "difference_minor": "0",
  "minor_unit_digits": 2,
  "invoice_total_minor": "2746"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usage-bill-reconstructor-mcp-scores-tools-2192789c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp-factory.bowling-anthony.workers.dev](https://www.zero.xyz/host/mcp-factory.bowling-anthony.workers.dev/llms.txt)
