# Abeam Cost Graph

*/Software/Abeam_Cost_Graph*

## Solution Overview

Abeam Cost Graph is a headless SaaS API that maps blended infrastructure and AI token expenses to specific application events. It ingests usage logs, cloud provider billing exports, and model API responses to build a queryable, real-time ledger of unit economics. The output is a multi-dimensional GraphQL graph that prices individual application transactions, calculating exact gross margins per user, per tenant, or per prompt.

FinOps engineers and AI backend architects integrate this API to solve the attribution problem of shared computing resources. Rather than waiting for end-of-month cloud invoices to allocate expenses, engineering teams use Abeam to trace the immediate financial impact of specific feature usage. It replaces the manual reconciliation of AWS Cost and Usage Reports against disparate token logs, providing deterministic cost data for complex multi-tenant architectures.

Sitting at the data layer, Abeam Cost Graph consumes raw telemetry from Kubernetes clusters, Stripe accounts, and LLM provider endpoints. It is consumed above by autonomous FinOps agents, dynamic pricing services, and internal accounting dashboards. Because financial attribution directly influences customer billing and margin reporting, the system enforces a human-in-the-loop checkpoint where finance teams review and approve allocation rule changes before they propagate to live pricing models.

## Headless Saas Data Model

**Entities**:
- Name: AttributedCost · Description: Ledger entry mapping a fractional provider expense to a specific application transaction.
- Name: Workspace · Description: Tenant boundary isolating cost data, telemetry, and allocation rules for an organization.
- Name: AppEvent · Description: Telemetry record of a specific application transaction or prompt execution.
- Name: ProviderCharge · Description: Raw billing line item exported from a cloud or AI provider.
- Name: AllocationRule · Description: Finance-approved heuristic mapping raw cloud charges to specific application events.
**Relations**:
- To: Workspace · From: AttributedCost · Label: belongs to workspace · Cardinality: one-to-many
- To: AppEvent · From: AttributedCost · Label: attributes cost to event · Cardinality: one-to-many
- To: ProviderCharge · From: AttributedCost · Label: allocates charge · Cardinality: one-to-many
- To: AllocationRule · From: AttributedCost · Label: calculated by rule · Cardinality: one-to-many
- To: Workspace · From: AppEvent · Label: logged in workspace · Cardinality: one-to-many
- To: Workspace · From: ProviderCharge · Label: billed to workspace · Cardinality: one-to-many
- To: Workspace · From: AllocationRule · Label: configured in workspace · Cardinality: one-to-many
**Tenant Anchor**: Workspace
**Primary Resource**: AttributedCost

## Api Definition

**Protocols**:
- GraphQL
- SDK
- MCP
- Webhooks
**Consumed By**:
- [FinOps Agent](/Agents/FinOps_Agent)
- [Dynamic Pricing Agent](/Agents/Dynamic_Pricing_Agent)
- [Margin Optimization Agent](/Agents/Margin_Optimization_Agent)
**Integrations**:
- [AWS](/Products/AWS)
- [Stripe](/Products/Stripe)
- [Kubernetes](/Products/Kubernetes)
- [OpenAI](/Products/OpenAI)
- [Anthropic](/Products/Anthropic)
**Consumption Model**: An agent registers the MCP server to execute daily allocation sweeps on ingested telemetry, subsequently querying the GraphQL endpoint to retrieve real-time unit economics per tenant.
**Workflow Wrappers**:
- Name: Execute Allocation Sweep · Wraps: evaluates approved allocation rules against telemetry to post attributed cost ledgers
- Name: Ingest Provider Billing · Wraps: parses raw cloud and AI invoices to generate normalized provider charge records
- Name: Propose Rule Change · Wraps: submits a new allocation rule and orchestrates the human-in-the-loop finance approval state

## Api Function Cascade

**Ai Role**: As a stateless software primitive, the engine runs completely digital, straight-through allocation sweeps using deterministic code to match telemetry and generative models to parse raw invoices, only halting to request human finance approval when an unmapped spend anomaly triggers a proposed rule change.
**Cascade**:
- Kind: Code · Note: Fetches raw usage metrics from AWS, Kubernetes, and OpenAI endpoints. · Step: Ingest Provider Telemetry · Verb: ingest · Realizes: Ingest Telemetry Data · Oversight: none
- Kind: Generative · Note: Extracts and normalizes line-item charges from semi-structured cloud invoices. · Step: Parse Provider Invoices · Verb: extract · Realizes: Process Billing Records · Oversight: none
- Kind: Code · Note: Evaluates approved allocation rules against telemetry to attribute costs. · Step: Execute Allocation Sweep · Verb: allocate · Realizes: Allocate Operating Costs · Oversight: none
- Kind: Generative · Note: Identifies unmapped spend and proposes new rules for finance approval. · Step: Draft Missing Rules · Verb: draft · Realizes: Develop Allocation Rules · Oversight: review-on-exception
- Kind: Code · Note: Commits normalized unit economics to the graph for downstream agents. · Step: Post Attributed Ledger · Verb: post · Realizes: Maintain Financial Ledger · Oversight: none
**Optimizes**:
- [Cost Attribution Coverage](/Metrics/Cost_Attribution_Coverage)
- [Allocation Sweep Latency](/Metrics/Allocation_Sweep_Latency)
- [Unmapped Spend Ratio](/Metrics/Unmapped_Spend_Ratio)
- [Unit Cost Accuracy](/Metrics/Unit_Cost_Accuracy)

## Headless Saas Representative Offer

**Warranty**: Standard service level agreement guaranteeing high availability for API endpoints and strict idempotency on ledger writes, backed by service credits for downtime.
**Price Band**: Roughly $0.01 to $0.05 per thousand allocation records processed or telemetry events ingested, depending on data retention and query volume.
**Pricing Kind**: UsageMeter
**Deliverables**:
- GraphQL and MCP endpoint access for real-time cost querying
- Automated billing ingestion pipelines for cloud and AI providers
- Execution capacity for allocation sweeps and rule evaluation
- Webhook orchestration for finance approval workflows
**Delivery Mode**: Instant self-serve provisioning, granting immediate access to the GraphQL API, MCP server credentials, and webhook configuration via developer portal.
**Business Function**: ProvideService
**Agent Checkout Support**:
- agentic-commerce-protocol
- stored-credential

## Headless Saas Crud Surface

**Auth Model**: API Key
**Endpoints**:
- GET /attributed-costs — list attributed costs mapping provider expenses to application transactions
- POST /attributed-costs — create a new attributed cost ledger entry
- GET /attributed-costs/{id} — fetch a specific attributed cost entry
- PATCH /attributed-costs/{id} — update properties of an attributed cost
- GET /workspaces — list workspaces
- POST /workspaces — create a new tenant workspace boundary
- GET /workspaces/{id} — fetch a specific workspace
- PATCH /workspaces/{id} — update workspace status or configuration
- GET /workspaces/{id}/app-events — list application events scoped to a specific workspace
- GET /app-events — list all application events across accessible scopes
- POST /app-events — ingest a new application transaction or prompt execution telemetry record
- GET /app-events/{id} — fetch a specific application event
- PATCH /app-events/{id} — update application event context
- GET /workspaces/{id}/provider-charges — list raw billing line items scoped to a specific workspace
- GET /provider-charges — list raw provider charges
- POST /provider-charges — ingest a raw billing line item from a cloud or AI provider
- GET /provider-charges/{id} — fetch a specific provider charge
- PATCH /provider-charges/{id} — update a provider charge
- GET /workspaces/{id}/allocation-rules — list allocation rules mapped to a specific workspace
- GET /allocation-rules — list allocation rules
- POST /allocation-rules — create a new allocation rule heuristic
- GET /allocation-rules/{id} — fetch a specific allocation rule
- PATCH /allocation-rules/{id} — update an allocation rule expression
- POST /allocation-rules/{id}/approve — approve an allocation rule for production cost mapping
**Multitenancy**: Row-level isolation
**Webhook Events**:
- attributed_cost.allocated
- app_event.ingested
- provider_charge.imported
- allocation_rule.approved

## Headless Saas Erd

```mermaid
erDiagram
    AttributedCost {
        UUID id PK
        UUID workspaceId FK
        UUID appEventId FK
        UUID providerChargeId FK
        UUID allocationRuleId FK
        DECIMAL allocatedCost
    }
    Workspace {
        UUID id PK "tenant key"
        VARCHAR name
        VARCHAR status
    }
    AppEvent {
        UUID id PK
        UUID workspaceId FK
        VARCHAR eventType
        VARCHAR tenantContext
        TIMESTAMP timestamp
    }
    ProviderCharge {
        UUID id PK
        UUID workspaceId FK
        VARCHAR vendor
        DECIMAL totalAmount
        TIMESTAMP invoicedAt
    }
    AllocationRule {
        UUID id PK
        UUID workspaceId FK
        VARCHAR ruleExpression
        VARCHAR approvalStatus
    }
    AttributedCost ||--o{ Workspace : "belongs to workspace"
    AttributedCost ||--o{ AppEvent : "attributes cost to event"
    AttributedCost ||--o{ ProviderCharge : "allocates charge"
    AttributedCost ||--o{ AllocationRule : "calculated by rule"
    AppEvent ||--o{ Workspace : "logged in workspace"
    ProviderCharge ||--o{ Workspace : "billed to workspace"
    AllocationRule ||--o{ Workspace : "configured in workspace"
```

## Neighborhood

### Who offers this

- [Abeam](/Startups/Abeam) — offers · Startups

### Optimizes

- [Cost Attribution Coverage](/Metrics/Cost_Attribution_Coverage) — optimizes · Metrics
- [Unit Cost Accuracy](/Metrics/Unit_Cost_Accuracy) — optimizes · Metrics
- [Unmapped Spend Ratio](/Metrics/Unmapped_Spend_Ratio) — optimizes · Metrics
- [Allocation Sweep Latency](/Metrics/Allocation_Sweep_Latency) — optimizes · Metrics

### What it uses

- [Anthropic](/Products/Anthropic) — uses · Products
- [Kubernetes](/Products/Kubernetes) — uses · Products
- [OpenAI](/Products/OpenAI) — uses · Products
- [Stripe](/Software/Stripe) — uses · Software
- [AWS](/Products/AWS) — uses · Products

### Who consumes this

- [Dynamic Pricing Agent](/Agents/Dynamic_Pricing_Agent) — consumed by · Agents
- [FinOps Agent](/Agents/FinOps_Agent) — consumed by · Agents
- [Margin Optimization Agent](/Agents/Margin_Optimization_Agent) — consumed by · Agents

### Similar Agents

- [Unified Cost Graph Engine](/Agents/Unified_Cost_Graph_Engine) — similar · Agents

### Similar Startups

- [Resonancespring](/Startups/Resonancespring) — similar · Startups
- [Accumulationmargin](/Startups/Accumulationmargin) — similar · Startups
- [Gatavanna](/Startups/Gatavanna) — similar · Startups
- [Marginlogic](/Startups/Marginlogic) — similar · Startups
- [Pricingyard](/api/md.md/Problems/Usage-Based_Billing_Reconciliation/Startups/Pricingyard) — similar · Startups
- [Quintum](/Startups/Quintum) — similar · Startups
- [Calculationsoar](/Startups/Calculationsoar) — similar · Startups
- [Monarch](/Startups/Monarch) — similar · Startups

### Similar Metrics

- [Cost Per Meter Unit](/Metrics/Cost_Per_Meter_Unit) — similar · Metrics
- [Cost Per Data Request](/Metrics/Cost_Per_Data_Request) — similar · Metrics

### Similar Problems

- [Cloud Cost Attribution](/Problems/Cloud_Cost_Attribution) — similar · Problems
- [Audit Cloud Compute Spend](/Problems/Audit_Cloud_Compute_Spend) — similar · Problems

### Similar Software

- [Enterprise Resource Planning](/Metrics/Development_Cost_Per_Product/Processes/Engineering_And_Coding/Problems/Defect_Rework_Cycles/Competitors/GitLab/Software/Enterprise_Resource_Planning) — similar · Software
- [EazyBI Reports](/Metrics/Development_Cost_Per_Product/Processes/Engineering_And_Coding/Problems/Senior_Engineering_Attrition/Competitors/Atlassian_Jira/Software/EazyBI_Reports) — similar · Software
- [GitHub Actions](/Metrics/Development_Cost_Per_Product/Processes/Engineering_And_Coding/Problems/Defect_Rework_Cycles/Competitors/GitHub/Software/GitHub_Actions) — similar · Software
- [Pluralsight Flow](/Metrics/Development_Cost_Per_Product/Processes/Engineering_And_Coding/Problems/Software_Capitalization_Audits/Competitors/LinearB/Software/Pluralsight_Flow) — similar · Software
- [GitHub Enterprise](/Metrics/Development_Cost_Per_Product/Processes/Engineering_And_Coding/Problems/Uncapitalized_Developer_Hours/Competitors/Atlassian_Jira_Tempo_Timesheets/Software/GitHub_Enterprise) — similar · Software
- [CodeClimate](/Metrics/Development_Cost_Per_Product/Processes/Engineering_And_Coding/Problems/Defect_Rework_Cycles/Competitors/ESLint/Software/CodeClimate) — similar · Software

### Similar Opportunities

- [Token Reconciliation Ledger.md](/api/md.md/Opportunities/Token_Reconciliation_Ledger.md) — similar · Opportunities