# BRAINIAC Cloud FinOps Cost Allocation

> BRAINIAC Cloud FinOps Cost Allocation is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-17).

Groups cloud cost rows by a specified tag key and returns allocated vs. unallocated cost shares with findings and limitations.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/cloud-finops/cost-allocation?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-cloud-finops-cost-allocation-985f7283
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fRKFTLnFm2XVjxvHl9zc0

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 brainiac-cloud-finops-cost-allocation-985f7283 -d '<json body>'
```

Example prompt: Take this CSV of our cloud billing data and allocate the costs by the 'team' tag — show me how much each team is spending and what's left unallocated.

## When to prefer this

Use this endpoint when you have cloud billing data already exported (in row or CSV form) and need a quick, stateless cost allocation grouped by a specific tag — no cloud account connection required, no persistent state, pay only per call. Prefer it over full FinOps platforms when you need a lightweight, ad-hoc chargeback calculation without setting up integrations or managing credentials.

## Known failure modes

- Missing required fields (date, service, cost, currency) in rows — validation error
- CSV exceeds 200,000 character limit — rejected
- No tagKey supplied — no grouping possible, all costs land in unallocated
- Rows array exceeds 5,000 items — rejected
- Invalid date format in a row — schema validation failure
- Currency code not matching 3-letter pattern — rejected
- Payment not received or insufficient USDC — 402 response, no result returned

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object with an array of cost groups (each with tag value, total cost, share percentage, and currency), an unallocated object with remaining cost and share, a list of findings explaining allocation rules applied, a checkedAt timestamp, and a limitations array clarifying that no live cloud account was connected and only supplied figures are used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000,
   "minLength": 1
  },
  "file": {
   "type": "object",
   "required": [
    "mediaType",
    "fileBase64"
   ],
   "properties": {
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/csv",
      "text/plain"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "date",
     "service",
     "cost",
     "currency"
    ],
    "properties": {
     "cost": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": -1000000000000
     },
     "date": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
     },
     "tags": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "key",
        "value"
       ],
       "properties": {
        "key": {
         "type": "string",
         "maxLength": 80,
         "minLength": 1
        },
        "value": {
         "type": "string",
         "maxLength": 200,
         "minLength": 1
        }
       },
       "additionalProperties": false
      },
      "maxItems": 20
     },
     "region": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "account": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "service": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1
     },
     "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
     },
     "usageUnit": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1
     },
     "resourceId": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
     },
     "resourceType": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "usageQuantity": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 5000
  },
  "tagKey": {
   "type": "string",
   "maxLength"
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "groups": [
   {
    "tag": "platform",
    "cost": 70,
    "share": 0.7,
    "currency": "USD"
   }
  ],
  "status": "allocated",
  "tagKey": "team",
  "findings": [
   {
    "code": "allocation_rule",
    "kind": "extracted",
    "detail": "Costs are grouped by the supplied tag team. Charges without that tag stay unallocated and were not assigned to a group."
   }
  ],
  "checkedAt": "2026-11-02T19:00:00.000Z",
  "limitations": [
   "No cloud account was connected and no infrastructure was changed.",
   "Costs and forecasts use only figures supplied in the request.",
   "Provider list prices are not added, and no saving is claimed without a supplied cost.",
   "The billing format is brainiac-billing-v1. Native provider exports are not accepted."
  ],
  "unallocated": [
   {
    "cost": 30,
    "share": 0.3,
    "currency": "USD"
   }
  ],
  "accountConnected": false,
  "infrastructureChanged": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-cloud-finops-cost-allocation-985f7283/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
