[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [AWS pricing service catalog](https://spiral.ai/integrations/codex/aws-pricing-service-catalog)

# How to Use AWS pricing service catalog in Codex

Lists AWS service offer codes and applicable Savings Plans indexes. Use it to discover which pricing catalogs AWS publishes before looking up regional files or product rows.

|  |  |
| --- | --- |
| Model | AWS pricing service catalog |
| 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 service catalog in Codex

- Use AWS pricing service catalog to find AmazonEC2, AmazonRDS, and AmazonS3, then add their returned service identifiers to this project's catalog configuration.
- Use AWS pricing service catalog to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from AWS pricing service catalog and tell me what changed since last week.
- Check AWS pricing service catalog and summarize what you find in three bullet points.
- Pull the newest data from AWS pricing service catalog and give me the result as a table.

## How to set up AWS pricing service catalog in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 service catalog**: 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/offers_list",
    "input": {
      "prefix": "<prefix>"
    }
  }'
```

Then paste one of the prompts above: Codex finds AWS pricing service catalog on Spiral, shows the price and runs it.

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

## AWS pricing service catalog tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| prefix |  | — | Case-sensitive offer code prefix filter, e.g. `AmazonS` or `AWS`. Pattern: ^[A-Za-z0-9]+$. |
| savings_plans_only |  | — | Return only offers that carry a savings plan version index (`savingsPlanVersionIndexUrl`). |

## What can you do with AWS pricing service catalog in Codex?

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 Codex guides](https://spiral.ai/integrations/codex)

## AWS pricing service catalog in other agents

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

## More Codex guides

- [AWS pricing region coverage](https://spiral.ai/integrations/codex/aws-pricing-region-coverage)
- [AWS product pricing records](https://spiral.ai/integrations/codex/aws-product-pricing-records)
- [AWS pricing publication history](https://spiral.ai/integrations/codex/aws-pricing-publication-history)
- [B3 cash dividend history](https://spiral.ai/integrations/codex/b3-cash-dividend-history)
- [AWS price file metadata](https://spiral.ai/integrations/codex/aws-price-file-metadata)
- [B3 company details](https://spiral.ai/integrations/codex/b3-company-details)

## Questions about AWS pricing service catalog in Codex

**Can Codex use AWS pricing service catalog?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run AWS pricing service catalog like any built-in tool.

**How much does AWS pricing service catalog cost in Codex?**

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

**Do I need an Alexandria account to use AWS pricing service catalog in Codex?**

No. Spiral runs AWS pricing service catalog 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 service catalog in Codex?**

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

**Does Codex wait while AWS pricing service catalog runs?**

AWS pricing service catalog runs in the background. Codex 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.

