{"uid":"cap_fRKFTLnFm2XVjxvHl9zc0","slug":"brainiac-cloud-finops-cost-allocation-985f7283","name":"BRAINIAC Cloud FinOps Cost Allocation","description":"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.","url":"https://www.brainiac.software/api/v1/cloud-finops/cost-allocation?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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":80,"minLength":1}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dFhgTcvfJql5UlqTk9iZE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Groups cloud cost rows by a specified tag key and returns allocated vs. unallocated cost shares with findings and limitations.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Engineering team cloud chargeback","prompt":"Here are our AWS billing rows for October — can you group all the costs by the 'team' tag and tell me what share each engineering team is responsible for, plus how much is unallocated?"},{"title":"Environment-based cost split","prompt":"I have a list of cloud cost rows with environment tags like 'prod', 'staging', and 'dev'. Allocate the total spend by the 'environment' tag so I can see what percentage each environment is consuming."},{"title":"Unallocated spend audit","prompt":"Run a cost allocation analysis on this cloud billing CSV using the 'cost-center' tag and flag how much of our total spend has no tag at all — I need to know our untagged resource exposure."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T00:37:14.245Z","isFirstParty":false,"canonicalSlug":"brainiac-cloud-finops-cost-allocation-985f7283"}