OCI MCP Server

Instructions

Get cost breakdown by service for a tenancy.

Args:
    tenant_id: OCID of the tenancy
    time_usage_started: Start time in ISO format (YYYY-MM-DD)
    time_usage_ended: End time in ISO format (YYYY-MM-DD)

Returns:
    List of costs grouped by service with total cost per service

Implementation Reference

• mcp_server_oci/mcp_server.py:1519-1538 (handler)

  MCP tool registration and wrapper handler function that provides the tool interface, handles context, logging, errors, and delegates to the core helper using OCI usage_api client.

  @mcp.tool(name="get_cost_by_service")
  @mcp_tool_wrapper(
      start_msg="Getting cost breakdown by service...",
      error_prefix="Error getting cost by service"
  )
  async def mcp_get_cost_by_service(ctx: Context, tenant_id: str, time_usage_started: str,
                                    time_usage_ended: str) -> List[Dict[str, Any]]:
      """
      Get cost breakdown by service for a tenancy.
  
      Args:
          tenant_id: OCID of the tenancy
          time_usage_started: Start time in ISO format (YYYY-MM-DD)
          time_usage_ended: End time in ISO format (YYYY-MM-DD)
  
      Returns:
          List of costs grouped by service with total cost per service
      """
      return get_cost_by_service(oci_clients["usage_api"], tenant_id, time_usage_started, time_usage_ended)

• mcp_server_oci/tools/cost.py:69-118 (helper)

  Core helper function that executes the OCI Usage API call to request summarized usages grouped by service and aggregates the total cost per service.

  def get_cost_by_service(usage_api_client: oci.usage_api.UsageapiClient,
                         tenant_id: str,
                         time_usage_started: str,
                         time_usage_ended: str) -> List[Dict[str, Any]]:
      """
      Get cost breakdown by service.
  
      Args:
          usage_api_client: OCI UsageApi client
          tenant_id: OCID of the tenancy
          time_usage_started: Start time in ISO format (YYYY-MM-DD)
          time_usage_ended: End time in ISO format (YYYY-MM-DD)
  
      Returns:
          List of costs grouped by service
      """
      try:
          request_summarized_usages_details = oci.usage_api.models.RequestSummarizedUsagesDetails(
              tenant_id=tenant_id,
              time_usage_started=time_usage_started,
              time_usage_ended=time_usage_ended,
              granularity="DAILY",
              group_by=["service"]
          )
  
          usage_response = oci.pagination.list_call_get_all_results(
              usage_api_client.request_summarized_usages,
              request_summarized_usages_details=request_summarized_usages_details
          )
  
          # Aggregate by service
          service_costs = {}
          for item in usage_response.data.items:
              service = item.service
              if service not in service_costs:
                  service_costs[service] = {
                      "service": service,
                      "total_cost": 0.0,
                      "currency": item.currency,
                      "unit": item.unit,
                  }
              service_costs[service]["total_cost"] += float(item.computed_amount) if item.computed_amount else 0.0
  
          result = list(service_costs.values())
          logger.info(f"Retrieved cost breakdown for {len(result)} services")
          return result
  
      except Exception as e:
          logger.exception(f"Error getting cost by service: {e}")
          raise