{"uid":"cap_UGG-yxSnhfmlevffvHCEO","slug":"brainiac-cloud-finops-idle-resource-detector-88e208af","name":"BRAINIAC Cloud FinOps — Idle Resource Detector","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/idle-resource-detect?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"resources":{"type":"array","items":{"type":"object","required":["resourceId","resourceType","daysObserved"],"properties":{"cost":{"type":"number","maximum":1000000000000,"minimum":-1000000000000},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"cpuPercent":{"type":"number","maximum":100,"minimum":0},"resourceId":{"type":"string","maxLength":200,"minLength":1},"daysObserved":{"type":"integer","maximum":3660,"minimum":0},"resourceType":{"type":"string","maxLength":80,"minLength":1}},"additionalProperties":false},"maxItems":500,"minItems":1},"minimumDays":{"type":"integer","maximum":3660,"minimum":1},"cpuThreshold":{"type":"number","maximum":100,"minimum":0}}},"responseSchema":{"type":"json","example":{"status":"idle_observed","findings":[{"code":"idle_rule","kind":"extracted","detail":"Compute is idle only when daysObserved is at least 14 and cpuPercent is below the supplied threshold 5. Missing CPU is not treated as idle."}],"checkedAt":"2026-11-02T19:00:00.000Z","resources":[{"status":"idle","currency":"USD","cpuPercent":2,"resourceId":"i-idle","daysObserved":14,"suppliedCost":40},{"status":"insufficient","currency":"USD","cpuPercent":null,"resourceId":"i-unknown","daysObserved":14,"suppliedCost":40}],"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."],"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_iZaLmbdYxiMcys497Jjnk","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":"Analyzes a list of cloud resources by CPU usage and observation period to identify which ones are idle and eligible for cost savings.","exampleAgentPrompt":"Check these 3 cloud resources for idleness — i-abc123 (compute, 14 days observed, 2% CPU, $40/month), i-def456 (compute, 7 days observed, 12% CPU, $20/month), and i-ghi789 (compute, 20 days observed, null CPU, $60/month) — using a CPU threshold of 5% and a minimum of 14 days observed.","exampleUseCases":[{"title":"Monthly idle VM audit for cost savings","prompt":"I have a list of 10 EC2 instances from last month: each has a resource ID, days observed, and average CPU percent. Flag any that have been below 5% CPU for at least 14 days so I know which ones to shut down. Costs are in USD."},{"title":"Pre-budget review infrastructure cleanup","prompt":"Before our Q3 budget review, check these 50 cloud resources for idleness — I'll give you resource IDs, types, days observed, CPU percentages, and monthly costs in USD. Use a 10% CPU threshold and require at least 30 days of observation to call something idle."},{"title":"Automated weekly FinOps agent report","prompt":"Every week I want you to take my latest resource utilization export — resource IDs, types, days observed, and CPU percents — and identify which resources are idle using a 5% CPU threshold and 14-day minimum, so I can review potential shutdowns."}],"resultDescription":"Returns a JSON object with a top-level status, a list of resources each labeled as 'idle', 'active', or 'insufficient' (when CPU data is missing), structured findings explaining the idle detection rule applied, the timestamp of the check, and a limitations array clarifying that no cloud account was connected and no live infrastructure was changed.","failureModes":["Missing required fields (resourceId, resourceType, daysObserved) cause validation errors","Supplying more than 500 resources exceeds the maxItems limit","CPU data absent for a resource results in 'insufficient' status rather than 'idle', not an error","Resources observed fewer days than minimumDays threshold will not be flagged idle regardless of CPU","Payment failure via x402 returns HTTP 402 and no result"],"whenToPreferThis":"Use this endpoint when you have your own resource utilization data (CPU percent, days observed, optional cost) and want a structured idle-detection analysis without connecting a live cloud account. It is ideal for agent workflows that already export or collect utilization metrics and need a rules-based idle classification step. Prefer this over live-cloud FinOps tools when you do not want any infrastructure changes made and simply need a decision on which resources are idle candidates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T00:37:07.753Z","isFirstParty":false,"canonicalSlug":"brainiac-cloud-finops-idle-resource-detector-88e208af"}