Skip to main content

AWS Pricing MCP Server

MCP server for accessing real-time AWS pricing information and providing cost analysis capabilities

Important Note: This server provides real-time pricing data from the AWS Pricing API. We cannot guarantee that AI assistants will always construct filters correctly or identify the absolute cheapest options. All calls are free of charge.

Features

AWS Pricing Discovery & Information

  • Service catalog exploration: Discover all AWS services with available pricing information
  • Pricing attribute discovery: Identify filterable dimensions (instance types, regions, storage classes, etc.) for any AWS service
  • Real-time pricing queries: Access current pricing data with advanced filtering capabilities including multi-option comparisons and pattern matching
  • Multi-region pricing comparisons: Compare pricing across different AWS regions in a single query
  • Bulk pricing data access: Download complete pricing datasets in CSV/JSON formats for historical analysis and offline processing

Cost Analysis & Planning

  • Detailed cost report generation: Create comprehensive cost analysis reports with unit pricing, calculation breakdowns, and usage scenarios
  • Infrastructure project analysis: Scan CDK and Terraform projects to automatically identify AWS services and their configurations
  • Architecture pattern guidance: Get detailed architecture patterns and cost considerations, especially for Amazon Bedrock services
  • Cost optimization recommendations: Receive AWS Well-Architected Framework aligned suggestions for cost optimization

Query pricing data with natural language

  • Ask questions about AWS pricing in plain English, no complex query languages required
  • Get instant answers from the AWS Pricing API for any AWS service
  • Retrieve comprehensive pricing information with flexible filtering options

Prerequisites

  1. Install uv from Astral or the GitHub README
  2. Install Python using uv python install 3.10
  3. Set up AWS credentials with access to AWS services
    • You need an AWS account with appropriate permissions
    • Configure AWS credentials with aws configure or environment variables
    • Ensure your IAM role/user has pricing:* permissions to access the AWS Pricing API

Installation

Kiro Cursor VS Code
Add to Kiro Install MCP Server Install on VS Code

⚡ Using uv

Configure the MCP server in your MCP client configuration (e.g., for Kiro, edit ~/.kiro/settings/mcp.json):

For Linux/MacOS users:

{
  "mcpServers": {
    "awslabs.aws-pricing-mcp-server": {
      "command": "uvx",
      "args": [
         "awslabs.aws-pricing-mcp-server@latest"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_PROFILE": "default",
        "AWS_REGION": "us-east-1"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

For Windows users:

{
  "mcpServers": {
    "awslabs.aws-pricing-mcp-server": {
      "command": "uvx",
      "args": [
         "--from",
         "awslabs.aws-pricing-mcp-server@latest",
         "awslabs.aws-pricing-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_PROFILE": "default",
        "AWS_REGION": "us-east-1"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Using Docker

or docker after a successful docker build -t awslabs/aws-pricing-mcp-server .:

# fictitious `.env` file with AWS temporary credentials
AWS_ACCESS_KEY_ID=ASIAIOSFODNN7EXAMPLE
AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
AWS_SESSION_TOKEN=AQoEXAMPLEH4aoAH0gNCAPy...truncated...zrkuWJOgQs8IZZaIv2BXIa2R4Olgk
AWS_REGION=us-east-1
  {
    "mcpServers": {
      "awslabs.aws-pricing-mcp-server": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "--interactive",
          "--env",
          "FASTMCP_LOG_LEVEL=ERROR",
          "--env-file",
          "/full/path/to/file/above/.env",
          "awslabs/aws-pricing-mcp-server:latest"
        ],
        "env": {},
        "disabled": false,
        "autoApprove": []
      }
    }
  }

NOTE: Your credentials will need to be kept refreshed from your host

AWS Authentication

The MCP server requires specific AWS permissions and configuration:

Required Permissions

Your AWS IAM role or user must have pricing:* permissions to access the AWS Pricing API. The server only accesses generally available AWS pricing information and does not retrieve any user-specific data. All pricing API calls are free of charge and do not incur any costs.

Configuration

The server uses two key environment variables:

  • AWS_PROFILE: Specifies the AWS profile to use from your AWS configuration file. If not provided, it defaults to the "default" profile.
  • AWS_REGION: Determines the geographically closest AWS Pricing API endpoint to use. This improves performance by routing requests to the nearest regional endpoint.
"env": {
  "AWS_PROFILE": "default",
  "AWS_REGION": "us-east-1"
}

Cost report output directory

The generate_cost_report tool can save the generated report to a file via its output_file parameter. To prevent path-traversal writes outside an intended location, output_file is confined to a base directory:

  • AWS_PRICING_MCP_OUTPUT_DIR (optional): The base directory reports may be written to. Defaults to the current working directory of the server process.

Paths are resolved and must stay within this base directory. Absolute paths that fall outside it, .. traversal segments, and symlinks that escape the base are all rejected. To allow reports to be written elsewhere, set this variable to the desired directory:

"env": {
  "AWS_PROFILE": "default",
  "AWS_REGION": "us-east-1",
  "AWS_PRICING_MCP_OUTPUT_DIR": "/path/to/reports"
}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

awslabs_aws_pricing_mcp_server-1.0.34.tar.gz (173.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

awslabs_aws_pricing_mcp_server-1.0.34-py3-none-any.whl (66.4 kB view details)

Uploaded Python 3

File details

Details for the file awslabs_aws_pricing_mcp_server-1.0.34.tar.gz.

File metadata

File hashes

Hashes for awslabs_aws_pricing_mcp_server-1.0.34.tar.gz
Algorithm Hash digest
SHA256 6bc262a74922329f4a9e41c70dc8e4019b2816f15e858d8d8f712ac16c9501a1
MD5 81d04ba7f5b15c08b18410292f4c3217
BLAKE2b-256 1bb35c3ca1d22fdcbb38bb7475e277b406860dcc661af197a11451cc5e21ffb5

See more details on using hashes here.

Provenance

The following attestation bundles were made for awslabs_aws_pricing_mcp_server-1.0.34.tar.gz:

Publisher: release.yml on awslabs/mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file awslabs_aws_pricing_mcp_server-1.0.34-py3-none-any.whl.

File metadata

File hashes

Hashes for awslabs_aws_pricing_mcp_server-1.0.34-py3-none-any.whl
Algorithm Hash digest
SHA256 cc23199a83798ef4caa8fb8d80f3114b888bcf1dd4f13ac7ae6bfad1f7576e09
MD5 9ce7f60c08a8a9c1cd1114da840d3ee8
BLAKE2b-256 026eb12a417a187d1573355be6c4bd877a7553ce46c6ffad8c196e430f9cd2aa

See more details on using hashes here.

Provenance

The following attestation bundles were made for awslabs_aws_pricing_mcp_server-1.0.34-py3-none-any.whl:

Publisher: release.yml on awslabs/mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page