awslabs.cost-explorer-mcp-server 0.0.4__py3-none-any.whl → 0.0.6__py3-none-any.whl

{awslabs_cost_explorer_mcp_server-0.0.4.dist-info → awslabs_cost_explorer_mcp_server-0.0.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.cost-explorer-mcp-server
-Version: 0.0.4
+Version: 0.0.6
 Summary: MCP server for analyzing AWS costs and usage data through the AWS Cost Explorer API
 Project-URL: Homepage, https://awslabs.github.io/mcp/
 Project-URL: Documentation, https://awslabs.github.io/mcp/servers/cost-explorer-mcp-server/
@@ -21,7 +21,8 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
-Requires-Dist: boto3>=1.36.20
+Requires-Dist: boto3>=1.38.40
+Requires-Dist: loguru>=0.7.0
 Requires-Dist: mcp[cli]>=1.6.0
 Requires-Dist: pandas>=2.2.3
 Requires-Dist: pydantic>=2.10.6
@@ -40,17 +41,28 @@ MCP server for analyzing AWS costs and usage data through the AWS Cost Explorer
 - Query historical cost data for specific time periods
 - Filter costs by various dimensions, tags, and cost categories
 
+
+### Compare costs between time periods
+
+- **NEW AWS Feature**: Leverage AWS Cost Explorer's new [Cost Comparison feature](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-cost-comparison.html)
+- Compare costs between two time periods to identify changes and trends
+- Analyze cost drivers to understand what caused cost increases or decreases
+- Get detailed insights into the top 10 most significant cost change drivers automatically
+- Identify specific usage types, discount changes, and infrastructure changes affecting costs
+
+### Forecast future costs
+
+- Generate cost forecasts based on historical usage patterns
+- Get predictions with confidence intervals (80% or 95%)
+- Support for daily and monthly forecast granularity
+- Plan budgets and anticipate future AWS spending
+
 ### Query cost data with natural language
 
 - Ask questions about your AWS costs in plain English
 - Get instant answers about your AWS spending patterns
 - Retrieve historical cost data with simple queries
 
-### Generate cost reports and insights
-
-- Generate comprehensive cost reports based on your AWS Cost Explorer data
-- Get cost breakdowns by various dimensions (service, region, account, etc.)
-- Analyze usage patterns and spending trends
 
 ## Prerequisites
 
@@ -63,6 +75,8 @@ MCP server for analyzing AWS costs and usage data through the AWS Cost Explorer
 
 ## Installation
 
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.cost-explorer-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMuY29zdC1leHBsb3Jlci1tY3Atc2VydmVyQGxhdGVzdCIsImVudiI6eyJGQVNUTUNQX0xPR19MRVZFTCI6IkVSUk9SIiwiQVdTX1BST0ZJTEUiOiJ5b3VyLWF3cy1wcm9maWxlIn0sImRpc2FibGVkIjpmYWxzZSwiYXV0b0FwcHJvdmUiOltdfQ%3D%3D)
+
 Here are some ways you can work with MCP across AWS, and we'll be adding support to more products including Amazon Q Developer CLI soon: (e.g. for Amazon Q Developer CLI MCP, `~/.aws/amazonq/mcp.json`):
 
 ```json
@@ -146,6 +160,9 @@ The following IAM permissions are required for this MCP server:
 - ce:GetCostAndUsage
 - ce:GetDimensionValues
 - ce:GetTags
+- ce:GetCostForecast
+- ce:GetCostAndUsageComparisons
+- ce:GetCostComparisonDrivers
 
 
 
@@ -157,26 +174,39 @@ The Cost Explorer MCP Server provides the following tools:
 2. `get_dimension_values` - Get available values for a specific dimension (e.g., SERVICE, REGION)
 3. `get_tag_values` - Get available values for a specific tag key
 4. `get_cost_and_usage` - Retrieve AWS cost and usage data with filtering and grouping options
+5. `get_cost_and_usage_comparisons` - Compare costs between two time periods to identify changes and trends
+6. `get_cost_comparison_drivers` - Analyze what drove cost changes between periods (top 10 most significant drivers)
+7. `get_cost_forecast` - Generate cost forecasts based on historical usage patterns
 
 ## Example Usage
 
-Here are some examples of how to use the Cost Explorer MCP Server:
-
+Here are some examples of how to use the Cost Explorer MCP Server through natural language queries:
 
-### Get dimension values
+### Cost Analysis Examples
 
 ```
-What AWS services did I use last month?
+Show me my AWS costs for the last 3 months grouped by service in us-east-1 region
+Break down my S3 costs by storage class for Q1 2025
+Show me costs for production resources tagged with Environment=prod
+What were my costs for reserved instances vs on-demand in May?
+What was my EC2 instance usage by instance type?
 ```
 
-### Generate a cost report
+### Cost Comparison Examples
 
 ```
-Show me my AWS costs for the last 3 months grouped by service in us-east-1 region
+Compare my AWS costs between April and May 2025
+How did my EC2 costs change from last month to this month?
+Why did my AWS bill increase in June compared to May?
+What caused the spike in my S3 costs last month?
 ```
 
+### Forecasting Examples
+
 ```
-What were my EC2 costs excluding us-east-2 for January 2025?
+Forecast my AWS costs for next month
+Predict my EC2 spending for the next quarter
+What will my total AWS bill be for the rest of 2025?
 ```
 
 ## License

awslabs_cost_explorer_mcp_server-0.0.6.dist-info/RECORD

@@ -0,0 +1,17 @@
+awslabs/__init__.py,sha256=XlNvbbm4JS0QaAK93MUCbMITZLOSkWkBilYvLI3rBpU,667
+awslabs/cost_explorer_mcp_server/__init__.py,sha256=jj08M9QRfjYVfiV85UhDzpEO4Vseafpeekg31d2DhfM,785
+awslabs/cost_explorer_mcp_server/comparison_handler.py,sha256=hrj6Hr0VNl6F_pUzSMjInMHlrfgo-CEu0wrI8wCmmnQ,32204
+awslabs/cost_explorer_mcp_server/constants.py,sha256=UubGjszHgx_y2_ctrRV0kQVU8fkRK1Tb1HulPno7hKo,4467
+awslabs/cost_explorer_mcp_server/cost_usage_handler.py,sha256=w60Fd-9goTdupEVmLVapHxOe2itpnWznVCvmQz-UTtU,16889
+awslabs/cost_explorer_mcp_server/forecasting_handler.py,sha256=sEkFSqIbvX9kC3I-nM5bzWkCQSUqIEWKjIz3LNJZK9A,9509
+awslabs/cost_explorer_mcp_server/helpers.py,sha256=EWODLEAiSVzbe_Q4v1ofH7-JPBC85BNQHAWXwp6UqA0,26908
+awslabs/cost_explorer_mcp_server/metadata_handler.py,sha256=CEFTJKKkNFpxWX5HlFvNWZUIIXl5zoLdisMYSqWz37k,3249
+awslabs/cost_explorer_mcp_server/models.py,sha256=orjB06HFrMVRJIkFwAwIgtda3FpyPVwwTQsno99hia8,2753
+awslabs/cost_explorer_mcp_server/server.py,sha256=BzAF1FP3VrdKURl0lG-2M_TDgfcpdi4jGsNrq1bV440,3842
+awslabs/cost_explorer_mcp_server/utility_handler.py,sha256=ecFbAg8gyJRdRy-r2vMFOwSEAI_RMeuqlMvF-J0GtLM,1568
+awslabs_cost_explorer_mcp_server-0.0.6.dist-info/METADATA,sha256=jMDv7iPQdP4pU9Pf5R3ul-4fBaX2v4EEsD2pwagZOmE,8231
+awslabs_cost_explorer_mcp_server-0.0.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+awslabs_cost_explorer_mcp_server-0.0.6.dist-info/entry_points.txt,sha256=nkewGFi8GZCCtHhFofUmYii3OCeK_5qqgLXE4eUSFZg,98
+awslabs_cost_explorer_mcp_server-0.0.6.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
+awslabs_cost_explorer_mcp_server-0.0.6.dist-info/licenses/NOTICE,sha256=VL_gWrK0xFaHGFxxYj6BcZI30EkRxUH4Dv1u2Qsh3ao,92
+awslabs_cost_explorer_mcp_server-0.0.6.dist-info/RECORD,,

awslabs_cost_explorer_mcp_server-0.0.4.dist-info/RECORD

@@ -1,10 +0,0 @@
-awslabs/__init__.py,sha256=XlNvbbm4JS0QaAK93MUCbMITZLOSkWkBilYvLI3rBpU,667
-awslabs/cost_explorer_mcp_server/__init__.py,sha256=jj08M9QRfjYVfiV85UhDzpEO4Vseafpeekg31d2DhfM,785
-awslabs/cost_explorer_mcp_server/helpers.py,sha256=8ldRc2TVFuE7-0Js4nQWw3v3e3Om48QgQgbTAXOecgI,10186
-awslabs/cost_explorer_mcp_server/server.py,sha256=joYtlqmNnjGm162Qe71sz_weDNUujAGS6-RvdG5wpT4,21007
-awslabs_cost_explorer_mcp_server-0.0.4.dist-info/METADATA,sha256=RrYXLshB_1ZL448HUxTxw7RZl1ktNgXbLkZXBtvJ4pY,6342
-awslabs_cost_explorer_mcp_server-0.0.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-awslabs_cost_explorer_mcp_server-0.0.4.dist-info/entry_points.txt,sha256=nkewGFi8GZCCtHhFofUmYii3OCeK_5qqgLXE4eUSFZg,98
-awslabs_cost_explorer_mcp_server-0.0.4.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
-awslabs_cost_explorer_mcp_server-0.0.4.dist-info/licenses/NOTICE,sha256=VL_gWrK0xFaHGFxxYj6BcZI30EkRxUH4Dv1u2Qsh3ao,92
-awslabs_cost_explorer_mcp_server-0.0.4.dist-info/RECORD,,