specification: FinOps Framework
specificationVersion: '1.0'
alignedWith:
  framework: FinOps Foundation Framework
  frameworkUrl: https://www.finops.org/framework/
  dataSpec: FOCUS
  dataSpecVersion: '1.3'
  dataSpecUrl: https://focus.finops.org/focus-specification/v1-3/
provider: Toolhouse
providerId: toolhouse
publisherName: Toolhouse
serviceCategory: API
created: '2026-05-04'
# Provenance stamped 2026-08-11: this artifact was written by the API Evangelist
# bulk sweep dated 2026-05-04, not harvested from the provider. See roadmap#35.
method: generated
modified: '2026-05-22'
reconciled: true
reconciledOn: '2026-05-22'
reconciledAgainst: https://toolhouse.ai/pricing
tags:
  - Agent Infrastructure
  - AI Agents
  - AI Workers
  - Backend as a Service
  - MCP
  - Tools
  - FinOps
  - Cost Management
  - FOCUS
description: FinOps framework definition for the Toolhouse API surface. Provides a FOCUS-aligned mapping
  for cost allocation, usage measurement, and unit-economics reporting across the provider's APIs. Toolhouse
  meters consumption in monthly "credits" (one credit per worker run) rather than per-request, so the
  primary billable meter below is worker_run_credits. Model token usage is NOT separately metered to the
  customer — every published tier advertises "free unlimited tokens."
principles:
  - name: Visibility
    description: Make worker run consumption visible to engineering, product, and finance teams in near
      real-time via the Toolhouse Platform API metrics surface.
  - name: Allocation
    description: Tag every chargeable worker run with the consuming team, environment, application, and
      worker so cost can be allocated.
  - name: Optimization
    description: Continuously evaluate worker invocation patterns, schedule cadence, and tier selection
      to reduce credits per useful unit of work.
  - name: Accountability
    description: Establish budget owners and chargeback or showback flows for each consuming team and
      organization.
domains:
  - name: Understand Usage and Cost
    capabilities:
      - Data Ingestion
      - Allocation
      - Reporting and Analytics
      - Anomaly Management
  - name: Quantify Business Value
    capabilities:
      - Planning and Estimating
      - Forecasting
      - Budgeting
      - Benchmarking
      - Unit Economics
  - name: Optimize Usage and Cost
    capabilities:
      - Architecting for Cloud
      - Rate Optimization
      - Workload Optimization
      - Cloud Sustainability
      - Licensing and SaaS
  - name: Manage the FinOps Practice
    capabilities:
      - FinOps Practice Operations
      - FinOps Education and Enablement
      - Invoicing and Chargeback
      - Onboarding Workloads
      - Intersecting Disciplines
billingModel:
  pricingCategory: Subscription with Included Quota
  billingFrequency: Monthly
  billingCurrency: USD
  chargeCategories:
    - Usage
    - Purchase
    - Tax
    - Credit
    - Adjustment
  chargeFrequency: Recurring
focusColumns:
  ServiceName: Toolhouse
  ServiceCategory: Developer Tools / API
  ProviderName: Toolhouse
  PublisherName: Toolhouse
  InvoiceIssuerName: Toolhouse
  PricingCategory: Subscription with Included Quota
  PricingUnit: credit
  BillingCurrency: USD
  ChargeCategory: Usage
meters:
  - name: worker_run_credits
    description: Primary Toolhouse billable meter. One credit corresponds to one worker run on the
      Toolhouse runtime. Monthly credit allowance is set by the subscribed plan (Business 25000, Business
      Max 80000, Enterprise negotiated).
    unit: credit
    aggregation: sum
    dimensions:
      - api
      - worker
      - tier
      - region
      - consumer
  - name: workers_active
    description: Count of workers deployed on the account. Subject to per-tier worker count caps (50
      Business, 500 Business Max, unlimited Enterprise).
    unit: worker
    aggregation: max
    dimensions:
      - tier
      - organization
  - name: api_requests
    description: Count of HTTP API requests (operational telemetry; not directly billed per request).
    unit: request
    aggregation: sum
    dimensions:
      - api
      - endpoint
      - tier
      - region
      - consumer
  - name: data_egress
    description: Bytes returned over the network in API responses (operational telemetry).
    unit: GB
    aggregation: sum
    dimensions:
      - api
      - region
      - consumer
  - name: compute_seconds
    description: Server-side compute consumed by a worker run on the Virtual Computer sandbox or other
      Toolhouse runtime (operational telemetry).
    unit: second
    aggregation: sum
    dimensions:
      - api
      - endpoint
      - tier
  - name: log_retention_days
    description: Effective log retention window for worker run logs by plan (30 days Business, 365 days
      Business Max, custom Enterprise).
    unit: day
    aggregation: max
    dimensions:
      - tier
      - organization
apis:
  - name: Toolhouse Platform API
    baseURL: ''
    tags:
      - Agent Runs
      - AI Agents
      - AI Workers
      - API Keys
      - Billing
      - Management
      - Schedules
      - Tools
    serviceName: Toolhouse Platform API
    serviceCategory: API
  - name: Toolhouse Workers API
    baseURL: https://agents.toolhouse.ai
    tags:
      - AI Agents
      - AI Workers
      - Conversations
      - Execution
      - Streaming
    serviceName: Toolhouse Workers API
    serviceCategory: API
unitEconomics:
  - name: Cost per Worker Run (Credit)
    metric: billed_cost / worker_run_credits
    target: '0.02 (Business), 0.015 (Business Max)'
  - name: Cost per Active Worker
    metric: billed_cost / workers_active
    target: TBD
  - name: Cost per 1K Requests
    metric: billed_cost / (api_requests / 1000)
    target: TBD
  - name: Credit Utilization
    metric: worker_run_credits_consumed / worker_run_credits_allocated
    target: '> 0.50'
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com