[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [AER publication listings](https://spiral.ai/integrations/codex/aer-publication-listings)

# How to Use AER publication listings in Codex

Returns a page of entries from an AER publication collection, such as directives, bulletins, decisions, or notices. Use it to browse a known publication type and collect document numbers for closer review.

|  |  |
| --- | --- |
| Model | AER publication listings |
| Available through | Alexandria |
| Category | Public Records |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with AER publication listings in Codex

- Use AER publication listings to find bulletins about measurement, then use AER website search for Directive 017 to assemble a linked reading list in our project.
- Use AER publication listings to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from AER publication listings and tell me what changed since last week.
- Check AER publication listings and summarize what you find in three bullet points.
- Pull the newest data from AER publication listings and give me the result as a table.

## How to set up AER publication listings 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 AER publication listings**: 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": "aer-ca/energy-regulator-decisions-directives-notices/list_publications",
    "input": {
      "collection": "directives"
    }
  }'
```

Then paste one of the prompts above: Codex finds AER publication listings on Spiral, shows the price and runs it.

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

## AER publication listings tools and prices

- [Alberta Energy Regulator (aer.ca) · List publications](https://spiral.ai/tools/alexandria/aer-ca/energy-regulator-decisions-directives-notices/list_publications) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 0 to … | 0 | Zero-based page index as the site numbers it (`?page=`). |
| sort | asc, desc | desc | Sort direction. |
| keyword |  | — | Keyword filter (the listing's `Search by keyword` box). Omit for the unfiltered listing. |
| sort_by | date, title | date | Sort column: the row date or the title/number column. |

## What can you do with AER publication listings in Codex?

Build a searchable register of Alberta application records and regulatory publications in your project. A coding agent can connect application numbers, directive references, dates, and source links to your existing review screens.

### Prepare a project review

Assemble an Alberta project's application notice and published decision, then find relevant directives and the bulletins announcing their revisions. Give reviewers a dated source list and distinguish the proposed activity from the recorded outcome.

### Build an acquisition diligence file

Review public application notices and decisions for an Alberta operator alongside relevant regulatory publications. Organize the evidence by application number and directive number for the transaction team's review.

### Prepare a municipal briefing

Explain proposed energy activity and recorded application outcomes near an Alberta municipality. Add the relevant directive descriptions and regulatory announcements so readers can follow both the project record and its regulatory context.

### Check a regulatory research report

Verify a report's cited application numbers, decision outcomes, directive editions, and bulletin announcements against the published records. Locate missing references through publication listings and website search.

### Review directive changes

Find recent bulletins on a regulatory topic, read their announcements, and retrieve the referenced directive editions and effective dates. Prepare a source-linked reading list for the operations team.

### Find consultation background

Search a directive number to locate draft consultation material and related publications. Read the directive's purpose and announcing bulletin alongside those results before drafting review questions.

## Overview

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

## AER publication listings in other agents

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

## More Codex guides

- [AER directive details](https://spiral.ai/integrations/codex/aer-directive-details)
- [AER website search](https://spiral.ai/integrations/codex/aer-website-search)
- [AER bulletin](https://spiral.ai/integrations/codex/aer-bulletin)
- [Alberta Gazette issue list](https://spiral.ai/integrations/codex/alberta-gazette-issue-list)
- [AER application notice](https://spiral.ai/integrations/codex/aer-application-notice)
- [Alberta Gazette issue text](https://spiral.ai/integrations/codex/alberta-gazette-issue-text)

## Questions about AER publication listings in Codex

**Can Codex use AER publication listings?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run AER publication listings like any built-in tool.

**How much does AER publication listings 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 AER publication listings in Codex?**

No. Spiral runs AER publication listings on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up AER publication listings in Codex?**

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

**Does Codex wait while AER publication listings runs?**

AER publication listings runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**What area do these AER records cover?**

These records concern Alberta energy regulation. AER directives set requirements and processes for energy companies operating in Alberta.

**How much application history does the notice tool cover?**

The AER describes Public Notice of Application as covering applications filed in the last 30 days. It should not be treated as a complete historical application archive.

**Does an AER bulletin establish a new requirement?**

A bulletin may announce a requirement, but it does not establish one. Check the referenced directive for the published requirements and processes.

**Does a directive result include the full directive PDF text?**

The documented response includes landing-page purpose text and a PDF link. Use that link when you need the directive's detailed sections rather than its landing-page description.

**Can website search find consultation documents?**

Yes. The documented search results include a PDF titled “What We Heard” about draft Directive 056, so results can include consultation material as well as directive pages.

