[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [AWS pricing region coverage](https://spiral.ai/integrations/windsurf/aws-pricing-region-coverage)

# How to Use AWS pricing region coverage in Windsurf

Lists regional price files for an AWS service or Savings Plan. Use it to establish the catalog's geographic coverage before collecting product rows or comparing locations.

|  |  |
| --- | --- |
| Model | AWS pricing region coverage |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with AWS pricing region coverage in Windsurf

- Use AWS pricing region coverage for AmazonRDS and add the returned regional file references to this project's catalog inventory.
- Use AWS pricing region coverage to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from AWS pricing region coverage and tell me what changed since last week.
- Check AWS pricing region coverage and summarize what you find in three bullet points.
- Pull the newest data from AWS pricing region coverage and give me the result as a table.

## How to set up AWS pricing region coverage in Windsurf

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run AWS pricing region coverage**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "pricing-us-east-1-amazonaws-com/cloud-pricing/regions_list",
    "input": {
      "offer_code": "<offer_code>"
    }
  }'
```

Then paste one of the prompts above: Windsurf finds AWS pricing region coverage on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/windsurf

## AWS pricing region coverage tools and prices

- [AWS Price List Bulk API · Regions list](https://spiral.ai/tools/alexandria/pricing-us-east-1-amazonaws-com/cloud-pricing/regions_list) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| offer_code |  | — | Offer code from offers_list, e.g. `AmazonEC2`, `AmazonRDS`, `AmazonS3` (the `offerCode` key of the offer index and the `serviceCode` CSV column). Pattern: ^[A-Za-z0-9]{2,64}$. |
| savings_plan_offer |  | — | Savings plan offer family from offers_list `savings_plan_offer`: `AWSComputeSavingsPlan`, `AWSDatabaseSavingsPlans` or `AWSMachineLearningSavingsPlans`. Pattern: ^[A-Za-z0-9]{2,64}$. |

## What can you do with AWS pricing region coverage in Windsurf?

Build a traceable AWS catalog import for your project's estimator. A coding agent can work through service discovery, regional coverage, publication history, file metadata, and product rows to make the import reflect AWS's published catalog.

### Build an AWS catalog for an internal estimator

Discover published services, inventory their regional files and available versions, inspect source layouts, and import product rows. Keep the catalog publication alongside the estimator's assumptions.

### Prepare a weekly AWS catalog change digest

Compare service discovery results, regional coverage, publication history, source metadata, and collected rows with the previous run. Report catalog additions and changed product terms separately.

### Create a planning baseline for a cloud migration

Identify the AWS services under consideration, map their published regional coverage, and collect relevant product terms. Include publication history and source metadata so reviewers can identify the catalog used for the plan.

### Document the inputs to a procurement review

Assemble the service identifiers, regional file references, publication history, source layout, and product rows behind an AWS catalog comparison. Give reviewers enough evidence to trace each comparison to its source publication.

### Check regional catalog coverage

Find Amazon RDS in the published service catalog and list its regional price file references. Use that inventory to decide which locations a catalog comparison can include.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Windsurf guides](https://spiral.ai/integrations/windsurf)

## AWS pricing region coverage in other agents

- [Amp](https://spiral.ai/integrations/amp/aws-pricing-region-coverage)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/aws-pricing-region-coverage)
- [Claude](https://spiral.ai/integrations/claude-desktop/aws-pricing-region-coverage)
- [Claude Code](https://spiral.ai/integrations/claude-code/aws-pricing-region-coverage)
- [Cline](https://spiral.ai/integrations/cline/aws-pricing-region-coverage)
- [Codex](https://spiral.ai/integrations/codex/aws-pricing-region-coverage)
- [Cursor](https://spiral.ai/integrations/cursor/aws-pricing-region-coverage)
- [Devin](https://spiral.ai/integrations/devin/aws-pricing-region-coverage)
- [dots](https://spiral.ai/integrations/dots/aws-pricing-region-coverage)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/aws-pricing-region-coverage)
- [Gemini](https://spiral.ai/integrations/gemini/aws-pricing-region-coverage)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/aws-pricing-region-coverage)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/aws-pricing-region-coverage)
- [goose](https://spiral.ai/integrations/goose/aws-pricing-region-coverage)
- [Grok](https://spiral.ai/integrations/grok/aws-pricing-region-coverage)
- [Grok Build](https://spiral.ai/integrations/grok-build/aws-pricing-region-coverage)
- [Hermes](https://spiral.ai/integrations/hermes/aws-pricing-region-coverage)
- [Instinct](https://spiral.ai/integrations/instinct/aws-pricing-region-coverage)
- [Manus](https://spiral.ai/integrations/manus/aws-pricing-region-coverage)
- [Muse](https://spiral.ai/integrations/muse/aws-pricing-region-coverage)
- [Muse Code](https://spiral.ai/integrations/muse-code/aws-pricing-region-coverage)
- [n8n](https://spiral.ai/integrations/n8n/aws-pricing-region-coverage)
- [Notion](https://spiral.ai/integrations/notion/aws-pricing-region-coverage)
- [OpenClaw](https://spiral.ai/integrations/openclaw/aws-pricing-region-coverage)
- [opencode](https://spiral.ai/integrations/opencode/aws-pricing-region-coverage)
- [Perplexity](https://spiral.ai/integrations/perplexity/aws-pricing-region-coverage)
- [Raycast](https://spiral.ai/integrations/raycast/aws-pricing-region-coverage)
- [VS Code](https://spiral.ai/integrations/vscode/aws-pricing-region-coverage)
- [Zapier](https://spiral.ai/integrations/zapier/aws-pricing-region-coverage)

## More Windsurf guides

- [AWS pricing publication history](https://spiral.ai/integrations/windsurf/aws-pricing-publication-history)
- [AWS pricing service catalog](https://spiral.ai/integrations/windsurf/aws-pricing-service-catalog)
- [AWS price file metadata](https://spiral.ai/integrations/windsurf/aws-price-file-metadata)
- [AWS product pricing records](https://spiral.ai/integrations/windsurf/aws-product-pricing-records)
- [npm publisher packages](https://spiral.ai/integrations/windsurf/npm-publisher-packages)
- [B3 cash dividend history](https://spiral.ai/integrations/windsurf/b3-cash-dividend-history)

## Questions about AWS pricing region coverage in Windsurf

**Can Windsurf use AWS pricing region coverage?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run AWS pricing region coverage like any built-in tool.

**How much does AWS pricing region coverage cost in Windsurf?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

**Do I need an Alexandria account to use AWS pricing region coverage in Windsurf?**

No. Spiral runs AWS pricing region coverage on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up AWS pricing region coverage in Windsurf?**

About two minutes: add the server, then sign in, then check it.

**Does Windsurf wait while AWS pricing region coverage runs?**

AWS pricing region coverage runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

**How often does AWS update the catalog?**

Price list files can change at any time. AWS sends a notification when it updates a file, so a daily check can span multiple publications.

**How far back does the publication history go?**

The service version index lists the historical publications available for that service, with effective start and end dates. Check the returned versions to establish the periods represented for Amazon EC2, Amazon S3, or another service.

**Is the catalog limited to US East?**

AWS publishes regional indexes that link to pricing for the specified service, period, and region. Use the service's regional index to establish coverage rather than treating the pricing host's location as the coverage boundary.

**Does one product row describe every usage tier?**

AWS price dimensions include pricing tier limits and usage measurement. A tiered service therefore needs its applicable dimensions considered together when interpreting catalog rates.

**What identifies the currently active historical version?**

In an AWS service version index, a version without an effective end date is the currently active version. The effective period is separate from the index's publication timestamp.

