AWS Billing

Allows working with workload estimates using the AWS Billing and Cost Management Pricing Calculator API. IMPORTANT USAGE GUIDELINES: - Always first check the rate preference setting for the authorized principal by calling the get_preferences operation. - DO NOT state assumptions about Free Tier API USE THIS TOOL FOR: - Listing available **workload estimates** for the logged in account. - **Filter list of available workload estimates** using name, status, created date, or expiration date. - Get **details of a workload estimate**. - Get the list of **services, usage type, operation, and usage amount** modeled within a workload estimate. - Get **rate preferences** set for Pricing Calculator. These rate preferences denote what rate preferences can be used by each account type in your organization. ## OPERATIONS 1) list_workload_estimates - list of available workload estimates Required: operation="list_workload_estimates" Optional: created_after, created_before, expires_after, expires_before, status_filter, name_filter, name_match_option, next_token, max_results Returns: List of all workload estimates for the account. 2) get_workload_estimate - get details of a workload estimate Required: operation="get_workload_estimate", identifier Returns: Details of a specific workload estimate. 3) list_workload_estimate_usage - list of modeled usage lines within a workload estimate Required: operation="get_workload_estimate", identifier Optional: usage_account_id_filter, service_code_filter, usage_type_filter, operation_filter, location_filter, usage_group_filter, next_token, max_results Returns: List of usage associated with a workload estimate. 4) get_preferences - get the rate preferences available to an account Required: operation="get_preferences" Returns: Retrieves the current preferences for AWS Billing and Cost Management Pricing Calculator.

Retrieves AWS budget information using the AWS Budgets API. This tool uses the DescribeBudgets API to retrieve all budgets for an account. The API returns information about: - Budget names, types, and time periods - Budget limits (amount and unit) - Current actual spend - Forecasted spend - Cost filters applied to budgets With this information, you can determine which budgets have been exceeded or are projected to exceed their limits. The tool automatically retrieves the AWS account ID of the calling identity or uses the provided account_id.

Retrieves AWS cost anomalies using the Cost Explorer GetAnomalies API. This tool allows you to retrieve cost anomalies detected on your AWS account during a specified time period. Anomalies are available for up to 90 days. You can filter anomalies by: - Date range (required) - Monitor ARN (optional) - Feedback status (optional) - Total impact (optional) Feedback status options: - YES: Anomalies marked as accurate - NO: Anomalies marked as inaccurate - PLANNED_ACTIVITY: Anomalies marked as planned activities

Retrieves AWS cost comparisons between two one-month periods. Do not use this tool except for comparing the costs of one month to the costs of another month. This tool should not be used for week-over-week or quarter-over-quarter (e.g., comparing Q2 vs. Q1) analysis. USE THIS TOOL ONLY FOR: - **Month-to-month cost variance analysis** (e.g., January vs February) - **Root cause analysis** of cost changes between specific months - **Detailed cost driver identification** (what exactly caused the cost change) - **Service-level impact analysis** for month-over-month changes - **Executive reporting** on monthly cost variances STRICT LIMITATIONS: - ONLY compares exactly one month to another month - Both periods must start on 1st day of month, end on 1st day of next month - Cannot compare weeks, quarters, or custom periods - DO NOT USE for general cost analysis or flexible time periods This tool supports two main operations: 1. getCostAndUsageComparisons: Compare costs between two time periods with flexible grouping and filtering 2. getCostComparisonDrivers: Identify key factors driving cost changes between two time periods Both operations require: - BaselineTimePeriod: Earlier time period for comparison (must be exactly one month) - ComparisonTimePeriod: Later time period for comparison (must be exactly one month) - MetricForComparison: The cost metric to compare (e.g., BlendedCost, UnblendedCost) Supported metrics for comparison include: - AmortizedCost: Costs with upfront and recurring reservation fees spread across the period - BlendedCost: Average cost of all usage throughout the billing period - NetAmortizedCost: Amortized cost after discounts - NetUnblendedCost: Unblended cost after discounts - NormalizedUsageAmount: Normalized usage amount - UnblendedCost: Actual costs incurred during the specified period - UsageQuantity: Usage amounts in their respective units You can group results by dimensions such as: - SERVICE: AWS service (e.g., Amazon EC2, Amazon S3) - LINKED_ACCOUNT: Member accounts in an organization - REGION: AWS Region - USAGE_TYPE: Type of usage (e.g., BoxUsage:t2.micro) - INSTANCE_TYPE: EC2 instance type (e.g., t2.micro, m5.large) - PLATFORM: Operating system (e.g., Windows, Linux) - TENANCY: Instance tenancy (e.g., shared, dedicated) - RECORD_TYPE: Record type (e.g., Usage, Credit, Tax) - LEGAL_ENTITY_NAME: AWS seller of record Note: - Time periods must start and end on the first day of a month, with a duration of exactly one month - The getCostComparisonDrivers operation automatically includes SERVICE and USAGE_TYPE dimensions - Data is available for the last 13 months, or up to 38 months if multi-year data is enabled

Retrieves AWS Free Tier usage information using the Free Tier Usage API. This tool provides insights into your AWS Free Tier usage across services: 1. get_free_tier_usage: Shows your current Free Tier usage across AWS services - Helps identify where you are approaching Free Tier limits - Shows actual usage against Free Tier allocations - Supports filtering by service, region, or usage type - Possible Dimensions values are: 'SERVICE'|'OPERATION'|'USAGE_TYPE'|'REGION'|'FREE_TIER_TYPE'|'DESCRIPTION'|'USAGE_PERCENTAGE' - Possible MatchOptions are: 'EQUALS'|'STARTS_WITH'|'ENDS_WITH'|'CONTAINS'|'GREATER_THAN_OR_EQUAL'

Get detailed cost optimization recommendation with integrated data from multiple AWS services. This tool combines data from: - Cost Optimization Hub (base recommendation) - AWS Compute Optimizer (detailed metrics for compute resources) - Cost Explorer (Savings Plans/RI purchase recommendations) It provides comprehensive analysis with utilization metrics, savings calculations, and implementation guidance. RESPONSE FORMATTING INSTRUCTIONS: The tool may return both raw recommendation data and a formatting template. When presenting the recommendation: 1. If a template is provided, use it to organize your response 2. If no template is provided, structure your response in a clear, logical manner 3. Always include key information like resource details, savings amounts, and implementation steps 4. Ensure all numeric values (costs, savings, metrics) are included 5. Add natural language explanations to make the information more accessible

Retrieves AWS Reserved Instance (RI) coverage and utilization data using the Cost Explorer API. This tool provides insights into your Reserved Instance (RI) and Savings Plans usage patterns through two main operations: 1. get_reservation_coverage: Shows how much of your eligible usage is covered by RIs - Helps identify opportunities to purchase additional RIs - Supports grouping by dimensions like REGION, INSTANCE_TYPE, etc. - Can filter by specific services, regions, or instance types 2. get_reservation_utilization: Shows how effectively you're using your purchased RIs - Reveals underutilized or idle reserved capacity - Can be grouped by SUBSCRIPTION_ID to see utilization per RI - Helps identify RIs that could be modified or sold in the marketplace Supported dimensions for grouping reservation coverage: - AZ: Availability Zone - INSTANCE_TYPE: Instance type (e.g., m4.xlarge) - LINKED_ACCOUNT: Member accounts in organization - PLATFORM: Operating system - REGION: AWS Region - SERVICE: AWS service (EC2, RDS, etc.) - TENANCY: Instance tenancy (default, dedicated) Reservation utilization can only be grouped by SUBSCRIPTION_ID.

Tool that retrieves AWS Savings Plans coverage and utilization data using the Cost Explorer API. This tool provides insights into your Savings Plans usage patterns through three main operations: 1. get_savings_plans_coverage: Shows how much of your eligible usage is covered by Savings Plans 2. get_savings_plans_utilization: Shows overall utilization metrics for your Savings Plans 3. get_savings_plans_utilization_details: Shows detailed per-Savings Plan utilization

Execute SQL queries on the persistent session database. This tool queries tables created by other tools (like cost_explorer_sql) within the current session. All tools share the same database, allowing cross-tool data analysis and joins. Use this tool to: - Query tables created by cost_explorer_sql and other tools - Join data from multiple AWS APIs - Perform complex analysis across different data sources Common queries: - SELECT name FROM sqlite_master WHERE type='table' -- List all tables - SELECT * FROM [table_name] LIMIT 10 -- Preview table data

Retrieves a list of billing groups from AWS Billing Conductor. This tool retrieve billing groups for a given billing period. If no billing period is provided, the current billing period is used. The tool returns information about: - Billing group ARN, name, and description - Billing group type (STANDARD or TRANSFER_BILLING) - Billing group status (ACTIVE, PRIMARY_ACCOUNT_MISSING, or PENDING) - Primary account ID - Computation preference (pricing plan ARN) - Account grouping settings (auto-associate, responsibility transfer ARN) - Group size (number of member accounts) - Creation and last modified timestamps You can filter billing groups by: - ARNs: Filter by specific billing group ARNs - Names: Filter by billing group name (supports STARTS_WITH search) - Statuses: Filter by status (ACTIVE, PRIMARY_ACCOUNT_MISSING, PENDING) - Billing group types: Filter by type (STANDARD, TRANSFER_BILLING) - Primary account IDs: Filter by primary account ID - Pricing plan: Filter by pricing plan ARN - Auto-associate: Filter by auto-associate setting - Responsibility transfer ARNs: Filter by responsibility transfer ARNs The tool paginates through results up to max_pages pages (default 10). If more results are available after reaching the page limit, a next_token is returned. Pass the next_token back to this tool to continue fetching from where you left off. Example 1: {"billing_period": "2025-01"} Example 2 (with filter): {"filters": "{"Statuses": ["ACTIVE"], "BillingGroupTypes": ["STANDARD"]}", "billing_period": "2025-01"}

Lists linked accounts associated with the payer account from AWS Billing Conductor. This tool retrieve linked accounts for a given billing period. If no billing period is provided, the current billing period is used. The tool returns information about each linked account: - Account ID - Account name - Account email - Billing group ARN (if associated to a billing group) You can filter account associations by: - AccountId: Filter by a specific AWS account ID - AccountIds: Filter by a list of AWS account IDs (up to 30) - Association: Filter by association status: - MONITORED: linked accounts associated to billing groups - UNMONITORED: linked accounts not associated to billing groups - Billing Group ARN: linked accounts associated to a specific billing group The tool paginates through results up to max_pages pages (default 10). If more results are available after reaching the page limit, a next_token is returned. Pass the next_token back to this tool to continue fetching from where you left off. Example 1: {"billing_period": "2025-01"} Example 2 (monitored only): {"filters": "{"Association": "MONITORED"}", "billing_period": "2025-01"} Example 3 (by account IDs): {"filters": "{"AccountIds": ["123456789012", "234567890123"]}"}

Retrieves a summary report of actual AWS charges and calculated AWS charges based on the associated pricing plan of a billing group. This tool retrieve cost reports for billing groups. If no billing period is provided, the current billing period is used. The tool returns cost report information for each billing group: - Billing group ARN - AWS cost (actual AWS charges) - Proforma cost (hypothetical charges based on the associated pricing plan) - Margin (billing group margin) - Margin percentage (percentage of billing group margin) - Currency (displayed currency) You can filter cost reports by: - BillingGroupArns: Filter by specific billing group ARNs (1 to 100 ARNs) Example 1: {"billing_period": "2025-01"} Example 2 (with filter): {"filters": "{"BillingGroupArns": ["arn:aws:billingconductor::123456789012:billinggroup/abc"]}", "billing_period": "2025-01"}

Retrieves the margin summary report for a specific billing group, which includes the AWS cost and charged amount (pro forma cost) broken down by attributes such as AWS service name or billing period. This tool retrieve detailed cost reports for a single billing group, optionally broken down by product name and/or billing period. The tool returns margin summary report results for the billing group: - Billing group ARN - Attributes (key-value pairs for grouping, e.g., PRODUCT_NAME: "S3", BILLING_PERIOD: "Nov 2023") - AWS cost (actual AWS charges) - Proforma cost (hypothetical charges based on the associated pricing plan) - Margin (billing group margin) - Margin percentage (percentage of billing group margin) - Currency (displayed currency) You can customize the report by: - BillingPeriodRange: JSON string specifying a time range (up to 12 months) - GroupBy: JSON array string with values "PRODUCT_NAME" and/or "BILLING_PERIOD" Example 1: {"arn": "arn:aws:billingconductor::123456789012:billinggroup/abc", "group_by": "["PRODUCT_NAME"]"} Example 2: {"arn": "arn:aws:billingconductor::123456789012:billinggroup/abc", "group_by": "["PRODUCT_NAME", "BILLING_PERIOD"]", "billing_period_range": "{"InclusiveStartBillingPeriod": "2025-01", "ExclusiveEndBillingPeriod": "2025-07"}"}

Retrieves a list of custom line items (FFLIs) from AWS Billing Conductor. Custom line items let you allocate costs and discounts to designated AWS accounts within a billing group. Common use cases include allocating support fees, shared service costs, managed service fees, taxes, credits, and distributing RI/Savings Plans savings. This tool retrieve custom line items for a given billing period. If no billing period is provided, the current billing period is used. The tool returns information about: - Custom line item ARN, name, and description - Account ID, billing group ARN - Charge details (type: CREDIT or FEE, flat or percentage) - Computation rule (CONSOLIDATED or ITEMIZED) - Currency code, association size, product code - Presentation details, creation and last modified timestamps You can filter custom line items by: - AccountIds: Filter by AWS account IDs (up to 30) - Arns: Filter by specific custom line item ARNs (up to 100) - BillingGroups: Filter by billing group ARNs (up to 100) - Names: Filter by custom line item names (up to 100) Example 1: {"billing_period": "2025-01"} Example 2 (with filter): {"filters": "{"Names": ["MyCustomLineItem"]}", "billing_period": "2025-01"}

Retrieves a list of versions for a specific custom line item from AWS Billing Conductor. This tool retrieve all versions of a custom line item. If no billing period is provided, the current billing period is used. The tool returns information about each version including charge details, computation rule, billing periods, and timestamps. You can filter versions by: - BillingPeriodRange: Filter by start and/or end billing period Example 1: {"arn": "arn:aws:billingconductor::123456789012:customlineitem/abcdef1234"} Example 2: {"arn": "...", "filters": "{"BillingPeriodRange": {"StartBillingPeriod": "2025-01", "EndBillingPeriod": "2025-06"}}"}

Lists the resources associated to a custom line item from AWS Billing Conductor. This tool retrieve resources associated with a specific custom line item. If no billing period is provided, the current billing period is used. The tool returns information about each associated resource: - Resource ARN (can be a billing group or custom line item) - End billing period of the association - Relationship type (PARENT or CHILD) You can filter associated resources by: - Relationship: Filter by relationship type ("PARENT" or "CHILD") Example 1: {"arn": "arn:aws:billingconductor::123456789012:customlineitem/abcdef1234"} Example 2: {"arn": "...", "filters": "{"Relationship": "CHILD"}", "billing_period": "2025-01"}

Retrieves a list of pricing rules from AWS Billing Conductor. This tool retrieve pricing rules for a given billing period. The tool returns information about: - Pricing rule ARN, name, and description - Type (MARKUP, DISCOUNT, or TIERING) - Scope (GLOBAL, SERVICE, BILLING_ENTITY, or SKU) - Modifier percentage, associated pricing plan count - Service, operation, usage type, billing entity - Tiering configuration, creation and last modified timestamps You can filter pricing rules by: - Arns: Filter by specific pricing rule ARNs Example 1: {"billing_period": "2025-01"} Example 2: {"filters": "{"Arns": ["arn:aws:billingconductor::123456789012:pricingrule/abc"]}", "billing_period": "2025-01"}

Retrieves a list of pricing plans from AWS Billing Conductor. This tool retrieve pricing plans for a given billing period. If no billing period is provided, the current billing period is used. The tool returns information about: - Pricing plan ARN, name, and description - Number of associated pricing rules (size) - Creation and last modified timestamps You can filter pricing plans by: - Arns: Filter by specific pricing plan ARNs Example 1: {"billing_period": "2025-01"} Example 2: {"filters": "{"Arns": ["arn:aws:billingconductor::123456789012:pricingplan/abc"]}", "billing_period": "2025-01"}

Lists the pricing rules associated with a specific pricing plan. This tool retrieve pricing rules associated with a specific pricing plan If no billing period is provided, the current billing period is used. The tool returns information about: - The billing period for which the pricing rule associations are listed. - The optional pagination token to be used on subsequent calls. - The ARN of the pricing plan for which associations are listed. - A list containing pricing rules that are associated with the requested pricing plan Example: {"pricing_plan_arn": "arn:aws:billingconductor::123456789012:pricingplan/abc"}

Lists the pricing plans associated with a specific pricing rule. This tool retrieve pricing plans associated with a specific pricing rule If no billing period is provided, the current billing period is used. The tool returns information about: - The billing period for which the pricing rule associations are listed. - The optional pagination token to be used on subsequent calls. - The ARN of the pricing rule for which associations are listed. - The list containing pricing plans that are associated with the requested pricing rule. Example: {"pricing_rule_arn": "arn:aws:billingconductor::123456789012:pricingrule/abc"}