Spiral gives your agent every tool with one account. Browse the tools →

Codex · Public Records

How to Use Elections Canada riding list in Codex

Returns federal ridings with district numbers and election-level statistics, including turnout and the elected candidate. Use it to compare districts across a province and identify a riding for closer analysis.

Prompts to try with Elections Canada riding list in Codex

Copy an example into Codex, or ask in your own words.

Use Elections Canada riding list for Ontario in 2021 and add district numbers, turnout, and elected candidates to this project's riding browser.

Elections Canada riding listCodex
Try asking
  • Use Elections Canada riding list to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from Elections Canada riding list and tell me what changed since last week.

  • Check Elections Canada riding list and summarize what you find in three bullet points.

  • Pull the newest data from Elections Canada riding list and give me the result as a table.

How to set up Elections Canada riding list in Codex

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

Use Spiral's MCP server

  1. Add the hosted server
    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.

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Elections Canada riding list

    One request; the result comes back by polling or a webhook.

    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-ca/elections/list_ridings",
        "input": {
          "election": "42"
        }
      }'

Then paste one of the prompts above: Codex finds Elections Canada riding list on Spiral, shows the price and runs it.

Elections Canada riding list providers and prices

Spiral runs Elections Canada riding list through Alexandria. Open a card for today's price, with every fee included.

AlexandriaPublic Records

Settings you can ask for

Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Election42 to 44

General election number: 44 (2021-09-20), 43 (2019-10-21) or 42 (2015-10-19). Elections Canada publishes these official voting results under the Open Government Licence - Canada; the 45th general election and by-elections are not yet released under that licence and are not served.

ProvinceNL, PE, NS, NB, QC, ON, MB, SK and 5 more

Only districts of this province or territory (two-letter code).

Every API field of Elections Canada official voting results and political contributions · List ridings is on its tool page: open its card above.

What can you do with Elections Canada riding list in Codex?

Build an election reference app with federal riding navigation, candidate results, and aggregate political funding summaries. Use Elections Canada's polling station records and published summary tables to check the calculations behind each view.

Prepare a provincial election backgrounder

Build an Ontario briefing with a district overview, candidate margins, selected polling station breakdowns, and provincial totals. Add a separate section summarizing published contributions to the federal parties discussed.

Build a federal election teaching exercise

Let students move from national totals to riding outcomes and polling station results. Include recipient-level contribution summaries as a separate exercise in reading political financing disclosures.

Study party funding alongside electoral outcomes

Compare published party contribution totals with vote shares and seats, then examine selected ridings and polling stations. Keep funding and voting measures separate and describe associations without claiming that contributions caused an outcome.

Create a public election reference browser

Provide province and riding navigation, candidate results, polling station tables, national comparisons, and aggregate funding summaries for political recipients. Keep contribution displays focused on institutions and campaigns.

Check an election analysis against official totals

Match district identifiers, total candidate votes, inspect merged polling stations, and compare the resulting figures with official riding and summary tables.

Questions about Elections Canada riding list in Codex

Can Codex use Elections Canada riding list?

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Elections Canada riding list like any built-in tool.

How much does Elections Canada riding list 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 Canada riding list in Codex?

No. Spiral runs Elections Canada riding list 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 Canada riding list in Codex?

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

Does Codex wait while Elections Canada riding list runs?

Elections Canada riding list runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

Does Elections Canada provide results outside the national totals?

Yes. Its 2021 official results are available for individual federal electoral districts, each province or territory, and all of Canada.

How detailed are the official voting results?

The polling station files report candidate votes, rejected ballots, and listed electors. They also identify void polls and results merged into another polling station.

What do the election summary tables cover?

The 2021 release has 13 summary tables. They cover turnout, voting methods, special ballots, party votes and seats, candidate results, electoral districts, and returning officers.

How far back do the maintained contribution downloads go?

The maintained downloads cover contributions to all political entities from January 2004 to the present. Elections Canada updates those downloads weekly; that schedule does not establish when an individual search result changes.

How soon do financial reports become public?

Elections Canada generally publishes an original financial report within approximately 10 business days of receiving a complete signed version. That interval starts when the report is received, rather than when a contribution is made.

Get started

Start using Elections Canada riding list in Codex

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Codex:

Set up Codex

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options