AWS Pricing Calculator Server

MCP server that provides tools for automating AWS Pricing Calculator estimate generation.

Features

• discover_services: Fetch service schemas from AWS Pricing Calculator
• build_estimate: Build complete estimate JSON from specification
• save_estimate: Save estimate to AWS and get shareable URL
• get_region_name: Convert AWS region codes to display names

Installation

Prerequisites

• Python 3.10 or higher
• uv package manager

Install uv

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or via pip
pip install uv

Run the MCP Server

The server is designed to be run via uvx directly from GitHub (no installation needed):

uvx --from git+https://github.com/elchanio-76/aws-pricing-calculator-mcp aws-pricing-calculator-mcp

Or install it globally:

uv tool install git+https://github.com/elchanio-76/aws-pricing-calculator-mcp

Once published to PyPI, you can use the simpler form:

uvx aws-pricing-calculator-mcp

Usage with Kiro

This MCP server is designed to work with the AWS Pricing Calculator Power for Kiro.

Configuration

Add to your Kiro MCP configuration (.kiro/settings/mcp.json):

{
  "mcpServers": {
    "aws-pricing-calculator": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/elchanio-76/aws-pricing-calculator-mcp", "aws-pricing-calculator-mcp"],
      "disabled": false
    }
  }
}

Or if published to PyPI:

{
  "mcpServers": {
    "aws-pricing-calculator": {
      "command": "uvx",
      "args": ["aws-pricing-calculator-mcp"],
      "disabled": false
    }
  }
}

Or install the Kiro Power which includes this configuration automatically.

Tools

discover_services

Fetch AWS Pricing Calculator service schemas.

Parameters:

• service_codes (optional): Array of service codes to discover

Example:

{
  "service_codes": ["ec2Enhancement", "amazonS3"]
}

build_estimate

Build complete estimate JSON from specification.

Parameters:

• spec (required): Estimate specification with groups and services

Example:

{
  "spec": {
    "name": "My Estimate",
    "groups": [
      {
        "name": "Production",
        "services": [...]
      }
    ]
  }
}

save_estimate

Save estimate to AWS and get shareable URL.

Parameters:

• estimate (required): Complete estimate JSON from build_estimate

get_region_name

Convert AWS region code to display name.

Parameters:

• region_code (required): AWS region code (e.g., "us-east-1")

Development

Setup

# Clone the repository
git clone https://github.com/elchanio-76/aws-pricing-calculator-mcp.git
cd aws-pricing-calculator-mcp

# Install dependencies
uv pip install -e .

Testing

# Run tests
python3 test_mcp_server.py

# Test via stdio
python3 test_mcp_stdio.py

Running Locally

python3 -m mcp_server.server

Architecture

The MCP server wraps existing Python scripts that handle:

• CloudFront API calls for service definitions
• Estimate JSON generation
• AWS Save API integration

All scripts use curl subprocess to avoid Python SSL issues with CloudFront.

License

MIT

Credits

Inspired by aws-pricing-calculator by Ian Qin. Tools have been created by converting scripts from that repo. Power.md and steering docs are based on the original repo with minor changes to make them compatible with Kiro Powers.