{"_id":"aws-calculator-mcp","_rev":"6-bfda55efafb4272d9735f4a5aef7425c","name":"aws-calculator-mcp","dist-tags":{"latest":"2.3.1"},"versions":{"2.0.0":{"name":"aws-calculator-mcp","version":"2.0.0","keywords":["mcp","model-context-protocol","aws","pricing","calculator","estimate","cost","cloud","ec2","lambda","s3","ai","agent","claude","kiro","cursor"],"author":{"url":"https://github.com/Musheer360","name":"Musheer360"},"license":"MIT","_id":"aws-calculator-mcp@2.0.0","maintainers":[{"name":"musheer360","email":"musheeralam360@gmail.com"}],"homepage":"https://github.com/Musheer360/aws-calculator-mcp#readme","bugs":{"url":"https://github.com/Musheer360/aws-calculator-mcp/issues"},"bin":{"aws-calculator-mcp":"mcp-server.js"},"dist":{"shasum":"394fac79e013ae07b811f037dceab93a7843cd70","tarball":"https://registry.npmjs.org/aws-calculator-mcp/-/aws-calculator-mcp-2.0.0.tgz","fileCount":8,"integrity":"sha512-nDPUo68NKYbX0vFEll5MjrvZtTGoJGAVNvqS9n1yqSn6jjaktyzZjJxREOGvF2oU3kmLDa7nbEjKs31p0IQJ3w==","signatures":[{"sig":"MEYCIQD0IwJQMr95UfgrGHDpnsra2Xubiw3zGew5AcH3TOTydwIhALGC64cCETeZTnBxzLBWpIJdP4YK3RrRXgYi/mDVgrAA","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":74073},"main":"mcp-server.js","engines":{"node":">=18.0.0"},"gitHead":"4be8272a83de52ff4b4be4c07cc9d216306225e6","scripts":{"test":"node --test test/*.test.js","start":"node mcp-server.js"},"_npmUser":{"name":"musheer360","email":"musheeralam360@gmail.com"},"repository":{"url":"git+https://github.com/Musheer360/aws-calculator-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for AWS Pricing Calculator — create estimates, get shareable links, and retrieve actual AWS-calculated costs. Supports all 400+ AWS services, EC2 Savings Plans, sub-service resolution, and headless browser cost verification.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"puppeteer-core":"^25.0.2","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"optionalDependencies":{"puppeteer":"^25.0.0"},"_npmOperationalInternal":{"tmp":"tmp/aws-calculator-mcp_2.0.0_1779094957733_0.026755985605902977","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"aws-calculator-mcp","version":"2.1.0","keywords":["mcp","model-context-protocol","aws","pricing","calculator","estimate","cost","cloud","ec2","lambda","s3","ai","agent","claude","kiro","cursor"],"author":{"url":"https://github.com/Musheer360","name":"Musheer360"},"license":"MIT","_id":"aws-calculator-mcp@2.1.0","maintainers":[{"name":"musheer360","email":"musheeralam360@gmail.com"}],"homepage":"https://github.com/Musheer360/aws-calculator-mcp#readme","bugs":{"url":"https://github.com/Musheer360/aws-calculator-mcp/issues"},"bin":{"aws-calculator-mcp":"mcp-server.js"},"dist":{"shasum":"4311ed95c1b4c92bb4163d562bfba5feb8476591","tarball":"https://registry.npmjs.org/aws-calculator-mcp/-/aws-calculator-mcp-2.1.0.tgz","fileCount":8,"integrity":"sha512-8yKMNKkqO3PIGyxTWTBvzBVyG3Zn/NoWJmTnPUXkiOj2c/AFO3/Wq2LIJGmEmqqnTu9eyduNnr65PsNa7OcQrQ==","signatures":[{"sig":"MEUCIQCXYQjMziBurXuAHSpICuxzAKR16YIGYtOEEdo4jLWxLQIgAsLp81sZgu4qLbhF06vy7nxQueeRpNK4TF5wwn8JJyQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":75671},"main":"mcp-server.js","engines":{"node":">=18.0.0"},"gitHead":"532a467bf044746bbb8ffcd356044a9c5e481000","scripts":{"test":"node --test test/*.test.js","start":"node mcp-server.js"},"_npmUser":{"name":"musheer360","email":"musheeralam360@gmail.com"},"repository":{"url":"git+https://github.com/Musheer360/aws-calculator-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for AWS Pricing Calculator — create estimates, get shareable links, and retrieve actual AWS-calculated costs. Supports all 400+ AWS services, EC2 Savings Plans, sub-service resolution, and headless browser cost verification.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"puppeteer-core":"^25.0.2","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"optionalDependencies":{"puppeteer":"^25.0.0"},"_npmOperationalInternal":{"tmp":"tmp/aws-calculator-mcp_2.1.0_1779095716075_0.06469085233467053","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"name":"aws-calculator-mcp","version":"2.2.0","keywords":["mcp","model-context-protocol","aws","pricing","calculator","estimate","cost","cloud","ec2","lambda","s3","ai","agent","claude","kiro","cursor"],"author":{"url":"https://github.com/Musheer360","name":"Musheer360"},"license":"MIT","_id":"aws-calculator-mcp@2.2.0","maintainers":[{"name":"musheer360","email":"musheeralam360@gmail.com"}],"homepage":"https://github.com/Musheer360/aws-calculator-mcp#readme","bugs":{"url":"https://github.com/Musheer360/aws-calculator-mcp/issues"},"bin":{"aws-calculator-mcp":"mcp-server.js"},"dist":{"shasum":"a2bcb6ec4a03aea1294b461a17a093acad6b5a7d","tarball":"https://registry.npmjs.org/aws-calculator-mcp/-/aws-calculator-mcp-2.2.0.tgz","fileCount":8,"integrity":"sha512-b13yDQ7ux77PSzeG3pB/GqB7o9t/xJ4jNzd9T4g2yzhsL3Q1XUZ7E6UGixyExKLssSy0uG2rO9xp/0Dr6VpE0g==","signatures":[{"sig":"MEUCIBqN35Z085KfFqcchbsd/U5HFB6fgn1R7OuD/iEs8A+JAiEA8nbpqrZEMchMdf5fTvcst7O1HYve3kAQFCqvF25pqsc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":74332},"main":"mcp-server.js","engines":{"node":">=18.0.0"},"gitHead":"f56b9675a236ab1bfce87e3bdf0cffea235ee9c6","scripts":{"test":"node --test test/*.test.js","start":"node mcp-server.js"},"_npmUser":{"name":"musheer360","email":"musheeralam360@gmail.com"},"repository":{"url":"git+https://github.com/Musheer360/aws-calculator-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for AWS Pricing Calculator — create estimates, get shareable links, and retrieve actual AWS-calculated costs. Supports all 400+ AWS services, EC2 Savings Plans, sub-service resolution, and headless browser cost verification.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"puppeteer-core":"^25.0.2","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"optionalDependencies":{"puppeteer":"^25.0.0"},"_npmOperationalInternal":{"tmp":"tmp/aws-calculator-mcp_2.2.0_1779180550993_0.45369994987592","host":"s3://npm-registry-packages-npm-production"}},"2.2.1":{"name":"aws-calculator-mcp","version":"2.2.1","keywords":["mcp","model-context-protocol","aws","pricing","calculator","estimate","cost","cloud","ec2","lambda","s3","ai","agent","claude","kiro","cursor"],"author":{"url":"https://github.com/Musheer360","name":"Musheer360"},"license":"MIT","_id":"aws-calculator-mcp@2.2.1","maintainers":[{"name":"musheer360","email":"musheeralam360@gmail.com"}],"homepage":"https://github.com/Musheer360/aws-calculator-mcp#readme","bugs":{"url":"https://github.com/Musheer360/aws-calculator-mcp/issues"},"bin":{"aws-calculator-mcp":"mcp-server.js"},"dist":{"shasum":"41939d75978a64a00ecb889f53e7011492090882","tarball":"https://registry.npmjs.org/aws-calculator-mcp/-/aws-calculator-mcp-2.2.1.tgz","fileCount":8,"integrity":"sha512-KK0O3Gs+0ThXas7490GLljCEPBkkw0JDbQiBKpbvdndy3Tyfl1Bv4OQNI8pVoEiVSroAJhIEIJPx7s88VydINA==","signatures":[{"sig":"MEYCIQCteR6Eag56O3JB1YK+lQgHvn2zDvZ2CGWVASRjHiFb2QIhAPnUWhx4pjqgTC/zI8kvJvZTgHqmll8C7q0OGXMlVm9y","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":74427},"main":"mcp-server.js","engines":{"node":">=18.0.0"},"gitHead":"43c15b5e1b06ce348d29eacdeedc853e8488de00","scripts":{"test":"node --test test/*.test.js","start":"node mcp-server.js"},"_npmUser":{"name":"musheer360","email":"musheeralam360@gmail.com"},"repository":{"url":"git+https://github.com/Musheer360/aws-calculator-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for AWS Pricing Calculator — create estimates, get shareable links, and retrieve actual AWS-calculated costs. Supports all 400+ AWS services, EC2 Savings Plans, sub-service resolution, and headless browser cost verification.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"puppeteer-core":"^25.0.2","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"optionalDependencies":{"puppeteer":"^25.0.0"},"_npmOperationalInternal":{"tmp":"tmp/aws-calculator-mcp_2.2.1_1779185128813_0.5772735706915304","host":"s3://npm-registry-packages-npm-production"}},"2.3.0":{"name":"aws-calculator-mcp","version":"2.3.0","keywords":["mcp","model-context-protocol","aws","pricing","calculator","estimate","cost","cloud","ec2","lambda","s3","ai","agent","claude","kiro","cursor"],"author":{"url":"https://github.com/Musheer360","name":"Musheer360"},"license":"MIT","_id":"aws-calculator-mcp@2.3.0","maintainers":[{"name":"musheer360","email":"musheeralam360@gmail.com"}],"homepage":"https://github.com/Musheer360/aws-calculator-mcp#readme","bugs":{"url":"https://github.com/Musheer360/aws-calculator-mcp/issues"},"bin":{"aws-calculator-mcp":"mcp-server.js"},"dist":{"shasum":"0095ddf4726212ff878ae786523512fa91185881","tarball":"https://registry.npmjs.org/aws-calculator-mcp/-/aws-calculator-mcp-2.3.0.tgz","fileCount":8,"integrity":"sha512-DjHYHn763M1VC64+WpVZu7f2zr8zLX7dW2lOVXSWM0ugAPm3k2E8qI1PRNHVpViB+IRr5hxGBjldIxXo8D6nBw==","signatures":[{"sig":"MEUCIQCow9Qqv/mJXp4Z+e0Vpv2fLdTwhfEQiQK3m23L/2PJlQIgG9L4jcuQ82WzR1qW+IXiTIIpAjw4EyDmbPjtNy2u5+E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":72984},"main":"mcp-server.js","engines":{"node":">=18.0.0"},"gitHead":"963852dd602df4e43e714a71d0cc8fb4e5b2403b","scripts":{"test":"node --test test/*.test.js","start":"node mcp-server.js"},"_npmUser":{"name":"musheer360","email":"musheeralam360@gmail.com"},"repository":{"url":"git+https://github.com/Musheer360/aws-calculator-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for AWS Pricing Calculator — create estimates, get shareable links, and retrieve actual AWS-calculated costs. Supports all 400+ AWS services, EC2 Savings Plans, sub-service resolution, and headless browser cost verification.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"puppeteer-core":"^25.0.2","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"optionalDependencies":{"puppeteer":"^25.0.0"},"_npmOperationalInternal":{"tmp":"tmp/aws-calculator-mcp_2.3.0_1779250789020_0.3063182826662141","host":"s3://npm-registry-packages-npm-production"}},"2.3.1":{"name":"aws-calculator-mcp","version":"2.3.1","description":"MCP server for AWS Pricing Calculator — create estimates, get shareable links, and retrieve actual AWS-calculated costs. Supports all 400+ AWS services, EC2 Savings Plans, sub-service resolution, and headless browser cost verification.","main":"mcp-server.js","bin":{"aws-calculator-mcp":"mcp-server.js"},"license":"MIT","author":{"name":"Musheer360","url":"https://github.com/Musheer360"},"repository":{"type":"git","url":"git+https://github.com/Musheer360/aws-calculator-mcp.git"},"bugs":{"url":"https://github.com/Musheer360/aws-calculator-mcp/issues"},"homepage":"https://github.com/Musheer360/aws-calculator-mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","aws","aws-pricing","aws-calculator","pricing-calculator","cost-estimation","cloud-pricing","finops","ec2","lambda","s3","rds","bedrock","savings-plans","reserved-instances","ai","agent","claude","kiro","cursor","vscode"],"engines":{"node":">=18.0.0"},"scripts":{"test":"node --test test/*.test.js","start":"node mcp-server.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","puppeteer-core":"^25.0.2"},"optionalDependencies":{"puppeteer":"^25.0.0"},"gitHead":"8eec8a19517c7548ccf59a7deb2ad40f81300ed0","_id":"aws-calculator-mcp@2.3.1","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-W3563Chj5EKobXwTQiKqBrm4Lq6SZJrg44AxrCDmA2hNcRNJvUbvFJ2J/J66zLsGLstz5O/XhmJ8KmKYsQTNUQ==","shasum":"a9053f4a6167057baf712628991b9e55a6ed7263","tarball":"https://registry.npmjs.org/aws-calculator-mcp/-/aws-calculator-mcp-2.3.1.tgz","fileCount":8,"unpackedSize":73570,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDChIlquxuvRxKaGB3LL1ONlvI1kASCkFctsJiA6jJuowIgb+qKLbJPFMYt3DrGSBQUDlBDLWf8cfjjFQ8nkKhAbo8="}]},"_npmUser":{"name":"musheer360","email":"musheeralam360@gmail.com"},"directories":{},"maintainers":[{"name":"musheer360","email":"musheeralam360@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/aws-calculator-mcp_2.3.1_1779255128547_0.5569313563857752"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-18T09:02:37.645Z","modified":"2026-05-20T05:32:08.821Z","2.0.0":"2026-05-18T09:02:37.884Z","2.1.0":"2026-05-18T09:15:16.239Z","2.2.0":"2026-05-19T08:49:11.147Z","2.2.1":"2026-05-19T10:05:28.976Z","2.3.0":"2026-05-20T04:19:49.161Z","2.3.1":"2026-05-20T05:32:08.705Z"},"bugs":{"url":"https://github.com/Musheer360/aws-calculator-mcp/issues"},"author":{"name":"Musheer360","url":"https://github.com/Musheer360"},"license":"MIT","homepage":"https://github.com/Musheer360/aws-calculator-mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","aws","aws-pricing","aws-calculator","pricing-calculator","cost-estimation","cloud-pricing","finops","ec2","lambda","s3","rds","bedrock","savings-plans","reserved-instances","ai","agent","claude","kiro","cursor","vscode"],"repository":{"type":"git","url":"git+https://github.com/Musheer360/aws-calculator-mcp.git"},"description":"MCP server for AWS Pricing Calculator — create estimates, get shareable links, and retrieve actual AWS-calculated costs. Supports all 400+ AWS services, EC2 Savings Plans, sub-service resolution, and headless browser cost verification.","maintainers":[{"name":"musheer360","email":"musheeralam360@gmail.com"}],"readme":"# aws-calculator-mcp\n\n[![npm version](https://img.shields.io/npm/v/aws-calculator-mcp)](https://www.npmjs.com/package/aws-calculator-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\nAWS Pricing Calculator MCP server. Create estimates, get shareable calculator.aws links, and retrieve actual AWS-calculated costs — all through natural language via any MCP client.\n\n- **436 services** across **72 regions** — EC2, Lambda, RDS, Bedrock, S3, and everything else on calculator.aws\n- **Real pricing** — uses headless Chrome to get actual AWS-calculated costs, not approximations\n- **Savings Plans & Reserved Instances** — full support for all pricing models\n- **No AWS credentials required** — works without an account\n\n## Install\n\n```json\n{\n  \"mcpServers\": {\n    \"aws-calculator\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"aws-calculator-mcp@latest\"]\n    }\n  }\n}\n```\n\nPlace this in your MCP client's config file:\n\n| Client | Config location |\n|--------|----------------|\n| Kiro | `~/.kiro/settings/mcp.json` |\n| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Claude Desktop (Windows) | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| Cursor | `.cursor/mcp.json` |\n| VS Code | `.vscode/mcp.json` |\n\nAlternatively, clone and point to the local path:\n\n```bash\ngit clone https://github.com/Musheer360/aws-calculator-mcp.git\ncd aws-calculator-mcp && npm install\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"aws-calculator\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/aws-calculator-mcp/mcp-server.js\"]\n    }\n  }\n}\n```\n\n> **Note:** Claude.ai web connectors require a remote HTTP URL. This server uses stdio transport and is not directly compatible with Claude.ai's custom connector feature.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `search_services` | Search the service catalog by keyword (comma-separated). |\n| `get_service_fields` | Get field IDs, types, labels, and valid options for a service. Suggests corrections for invalid keys. |\n| `create_estimate` | Create an empty estimate. |\n| `add_service` | Add services with config. Validates field names with typo suggestions. Warns on missing critical fields. |\n| `update_service` | Modify a service's config in-place without rebuilding the estimate. |\n| `export_estimate` | Save to calculator.aws, returns a shareable URL. |\n| `refresh_estimate` | Opens the estimate in headless Chrome, triggers recalculation, returns actual costs. |\n| `generate_report` | Navigates into each group for per-service costs, merges with config, outputs CSV or Markdown. |\n| `import_estimate` | Download an existing estimate by URL or ID (JSON or Markdown). |\n| `list_estimates` | List in-memory estimates. |\n| `delete_estimate` | Remove an estimate. |\n| `get_server_info` | Server version and capabilities. |\n\n### Typical workflow\n\n```\nsearch_services → get_service_fields → create_estimate → add_service → export_estimate → refresh_estimate\n```\n\n## How it works\n\nThe MCP does not calculate prices. It packages service configurations into the payload format expected by calculator.aws's save API, then uses headless Chrome to retrieve the costs that calculator.aws computes client-side.\n\n1. Service catalog and field schemas are fetched from AWS's public CDN (same source as calculator.aws).\n2. Configurations are serialized and POSTed to the save API — returns an estimate ID and shareable URL.\n3. `refresh_estimate` opens the URL in Chrome, clicks \"Update estimate\", and scrapes the rendered costs.\n\nAccuracy is identical to calculator.aws because it *is* calculator.aws doing the calculation.\n\n## Service coverage\n\nAll services available on calculator.aws are supported, including:\n\n- EC2 (On-Demand, Savings Plans, Reserved Instances, dedicated tenancy)\n- RDS (all engines, Multi-AZ, Reserved)\n- Lambda, S3, CloudFront, DynamoDB, ECS, EKS\n- Bedrock (all model providers: Anthropic, Meta, Mistral, Cohere, etc.)\n- VPC, ELB, Route 53, CloudWatch, WAF, GuardDuty\n- All other services in the calculator catalog\n\nSub-services (e.g. `applicationLoadBalancer` under `elasticLoadBalancing`) are auto-resolved when using the `instance` parameter.\n\n## EC2 configuration\n\nEC2 uses a shorthand format. Do not call `get_service_fields` for it.\n\n```json\n{\n  \"service\": \"ec2Enhancement\",\n  \"config\": {\n    \"region\": \"us-west-2\",\n    \"instanceType\": \"c5.xlarge\",\n    \"selectedOS\": \"linux\",\n    \"tenancy\": \"shared\",\n    \"pricingStrategy\": \"computeSavings1yrNoUpfront\",\n    \"quantity\": \"2\",\n    \"storageType\": \"gp3\",\n    \"storageAmount\": {\"value\": \"50\", \"unit\": \"gb|NA\"}\n  }\n}\n```\n\nSupported pricing strategies: `ondemand`, `computeSavings1yrNoUpfront`, `computeSavings3yrAllUpfront`, `instanceSavings1yrPartialUpfront`, etc.\n\n## Partitions\n\n| Partition | Regions |\n|-----------|---------|\n| `aws` (default) | All commercial regions |\n| `aws-iso` | us-iso-east-1, us-iso-west-1 |\n| `aws-iso-b` | us-isob-east-1 |\n\n## Requirements\n\n- Node.js ≥ 18\n- Chrome/Chromium (optional — only for `refresh_estimate` and `generate_report`)\n\nTo install a bundled Chromium: `npx puppeteer browsers install chrome`\n\n## Troubleshooting\n\n| Issue | Resolution |\n|-------|-----------|\n| MCP fails to load | Verify Node.js ≥ 18. Use absolute path for local installs. |\n| \"Cannot find module\" | Run `npm install` in the project directory. |\n| \"No Chrome/Chromium found\" | Install Chrome or run `npx puppeteer browsers install chrome`. |\n| First call slow (~2s) | Initial catalog fetch from CDN. Cached for subsequent calls. |\n| `refresh_estimate` slow (~20s) | Expected — launches a browser and waits for page render. |\n\n## Architecture\n\n```\nmcp-server.js              12 MCP tools, input validation, routing\nlib/aws-client.js          CalculatorAPI class — catalog, schemas, save, download\nlib/estimate-builder.js    Estimate class — incremental building, serialization, export\nlib/ec2.js                 EC2 config transformation\nlib/browser.js             Headless Chrome — cost retrieval, group navigation\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}