[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Elections Alberta candidate records](https://spiral.ai/integrations/codex/elections-alberta-candidate-records)

# How to Use Elections Alberta candidate records in Codex

Returns registered candidate records for an election, providing a route to campaign financial disclosures. Use it to research a division's candidates and their public filings.

|  |  |
| --- | --- |
| Model | Elections Alberta candidate records |
| 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 Elections Alberta candidate records in Codex

- Use Elections Alberta candidate records for Calgary-Acadia in the 2023 general election and create a candidate directory in this project's research view.
- Use Elections Alberta candidate records to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Elections Alberta candidate records and tell me what changed since last week.
- Check Elections Alberta candidate records and summarize what you find in three bullet points.
- Pull the newest data from Elections Alberta candidate records and give me the result as a table.

## How to set up Elections Alberta candidate records 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 Elections Alberta candidate records**: 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": "elections-ab-ca/elections/search_candidates",
    "input": {
      "event_id": "<event_id>"
    }
  }'
```

Then paste one of the prompts above: Codex finds Elections Alberta candidate records on Spiral, shows the price and runs it.

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

## Elections Alberta candidate records tools and prices

- [Elections Alberta results and political finance · Search candidates](https://spiral.ai/tools/alexandria/elections-ab-ca/elections/search_candidates) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| ed |  | — | Electoral division number 01..87 (two digits; `1` is accepted and padded). Pattern: ^[0-9]{1,2}$. |
| name |  | — | Candidate name fragment, at least 3 letters. |
| party_id |  | — | Party id from `list_parties`. Pattern: ^[0-9]{1,6}$. |

## What can you do with Elections Alberta candidate records in Codex?

Build a searchable Alberta election research tool with source records attached to each result. A coding agent can turn Elections Alberta results and financial disclosures into separate tables for electoral events, divisions, and political organizations.

### Prepare an election background brief

Identify the election, summarize division results, and inspect selected voting locations. Add the candidate roster, party directory, party filings, and disclosed organizational contributions as separately labeled financial context.

### Create a provincial civics lesson

Prepare separate exercises on election selection, division totals, voting location results, candidate records, party accounts, and referendum advertising disclosures. Use organizational contribution examples to teach the difference between disclosed donations and total fundraising.

### Build a searchable public research archive

Organize election results by event and division, candidate records by campaign, and financial disclosures by party or advertising organization. Keep contribution records in a separate collection for institutional funding research.

### Check a report's supporting evidence

Create a verification workbook for claims about election outcomes, candidate participation, party filings, and referendum advertiser fundraising. Match each claim to the relevant source record and distinguish submitted financial statements from finalized versions.

### Compare campaign financial records

Identify parties and candidates for the same election, then organize their available financial records by reporting period. Examine disclosed organizational donations separately from overall financial statements.

## Overview

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

## Elections Alberta candidate records in other agents

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

## More Codex guides

- [Edmonton property assessments](https://spiral.ai/integrations/codex/edmonton-property-assessments)
- [Elections Alberta contribution search](https://spiral.ai/integrations/codex/elections-alberta-contribution-search)
- [Edmonton dataset search](https://spiral.ai/integrations/codex/edmonton-dataset-search)
- [Elections Alberta election results](https://spiral.ai/integrations/codex/elections-alberta-election-results)
- [Edmonton dataset records](https://spiral.ai/integrations/codex/edmonton-dataset-records)
- [Elections Alberta electoral events](https://spiral.ai/integrations/codex/elections-alberta-electoral-events)

## Questions about Elections Alberta candidate records in Codex

**Can Codex use Elections Alberta candidate records?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Elections Alberta candidate records like any built-in tool.

**How much does Elections Alberta candidate records 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 Elections Alberta candidate records in Codex?**

No. Spiral runs Elections Alberta candidate records on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Elections Alberta candidate records in Codex?**

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

**Does Codex wait while Elections Alberta candidate records runs?**

Elections Alberta candidate records runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Does Elections Alberta cover federal or municipal elections?**

Elections Alberta administers provincial electoral events only. Elections Canada handles federal elections, while municipalities handle Alberta municipal elections.

**How far back do its online records go?**

The linked official results site covers general elections and by-elections from 2008 forward. The financial reporting website contains reports received from political participants from 2004 onward.

**Are all contributions individually disclosed?**

Quarterly reports identify contributors whose contributions exceed $250 in the quarter. Contributions of $250 or less appear as a combined total, so a named-contributor search does not represent every donation.

**How quickly do financial disclosures appear?**

Quarterly contribution reports are due within 15 days after the quarter ends, or the first business day thereafter. Publication is separate: for the quarter ending September 30, 2026, Elections Alberta listed October 30 as the publication date.

**Which record controls when financial figures disagree?**

Elections Alberta says the financial statement is authoritative when it differs from Contributor Search. Party statements marked final follow its review and any adjustments.

