estimate_cost

Instructions

Implementation Reference

• packages/mcp/cloudwright_mcp/tools/cost.py:11-53 (handler)

  The MCP tool handler for 'estimate_cost'. Takes an ArchSpec dict and pricing_tier, validates with ArchSpec.model_validate, then calls CostEngine().estimate() to compute monthly cost breakdown. Returns CostEstimate dict.

  def estimate_cost(
      spec_json: Annotated[
          dict,
          Field(
              description=(
                  "ArchSpec to price. Pricing is resolved per-component against a "
                  "bundled SQLite catalog (no network calls), with formula dispatch "
                  "for serverless/managed services and a static fallback for rare ones."
              ),
          ),
      ],
      pricing_tier: Annotated[
          str,
          Field(
              description=(
                  "Pricing tier multiplier applied to compute and data-store components. "
                  "Values: 'on_demand' (1.0x), 'reserved_1yr' (0.6x), "
                  "'reserved_3yr' (0.4x), 'spot' (0.3x)."
              ),
              examples=["on_demand", "reserved_1yr", "reserved_3yr", "spot"],
          ),
      ] = "on_demand",
  ) -> dict:
      """Estimate the monthly cloud bill for an architecture spec.
  
      Returns a structured estimate with per-component breakdown, total
      monthly cost, data-transfer costs, and currency. Deterministic: same
      spec + tier yields same result.
  
      When to use: You need the numeric bill for one architecture on one
      provider+tier combination. For multi-provider comparison of just the
      costs, use `compare_provider_costs`. For side-by-side architecture +
      cost comparison across providers, use `compare_providers` + this tool.
  
      Behavior: Pure computation — no LLM, no network, no API costs. Works
      offline. Does not deploy or touch cloud resources.
      """
      from cloudwright.cost import CostEngine
      from cloudwright.spec import ArchSpec
  
      spec = ArchSpec.model_validate(spec_json)
      estimate = CostEngine().estimate(spec, pricing_tier=pricing_tier)
      return estimate.model_dump(exclude_none=True)

• packages/mcp/cloudwright_mcp/tools/cost.py:9-10 (registration)

  Tool registration via @mcp.tool() decorator on the estimate_cost function inside the register() function.

  def register(mcp: FastMCP) -> None:
      @mcp.tool()

• packages/mcp/cloudwright_mcp/tools/cost.py:11-33 (schema)

  Input schema: spec_json (dict, ArchSpec) and pricing_tier (str, default 'on_demand', choices: on_demand/reserved_1yr/reserved_3yr/spot).

  def estimate_cost(
      spec_json: Annotated[
          dict,
          Field(
              description=(
                  "ArchSpec to price. Pricing is resolved per-component against a "
                  "bundled SQLite catalog (no network calls), with formula dispatch "
                  "for serverless/managed services and a static fallback for rare ones."
              ),
          ),
      ],
      pricing_tier: Annotated[
          str,
          Field(
              description=(
                  "Pricing tier multiplier applied to compute and data-store components. "
                  "Values: 'on_demand' (1.0x), 'reserved_1yr' (0.6x), "
                  "'reserved_3yr' (0.4x), 'spot' (0.3x)."
              ),
              examples=["on_demand", "reserved_1yr", "reserved_3yr", "spot"],
          ),
      ] = "on_demand",
  ) -> dict: