[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Statistics Canada table search](https://spiral.ai/integrations/codex/statistics-canada-table-search)

# How to Use Statistics Canada table search in Codex

Returns entries from Statistics Canada's table inventory. Use it to find a relevant dataset and distinguish its subject and frequency before inspecting the table or requesting observations.

|  |  |
| --- | --- |
| Model | Statistics Canada table search |
| 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 Statistics Canada table search in Codex

- Use Statistics Canada table search to locate monthly CPI and labor force tables for Canada, then add a source inventory to this project's documentation.
- Use Statistics Canada table search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Statistics Canada table search and tell me what changed since last week.
- Check Statistics Canada table search and summarize what you find in three bullet points.
- Pull the newest data from Statistics Canada table search and give me the result as a table.

## How to set up Statistics Canada table search 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 Statistics Canada table search**: 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": "statcan-gc-ca/economic-statistics/search_tables",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Codex finds Statistics Canada table search on Spiral, shows the price and runs it.

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

## Statistics Canada table search tools and prices

- [Statistics Canada (www150.statcan.gc.ca) · Search tables](https://spiral.ai/tools/alexandria/statcan-gc-ca/economic-statistics/search_tables) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 100 | 20 | limit |
| offset | 0 to … | 0 | Rows to skip; the previous page's next_offset. |
| frequency | Daily, Weekly, Biweekly, Monthly, Bimonthly, Quarterly, Semi-annual, Annual, Every 2 years, Every 3 years, Every 4 years, Every 5 years, Every 10 years, Occasional, Occasional Quarterly, Occasional Monthly, Occasional Daily | — | Only tables published at this frequency. |
| include_archived |  | — | Also return archived tables that are no longer updated. |

## What can you do with Statistics Canada table search in Codex?

Build a Canadian economic dashboard with StatCan observations and links to the releases behind them. A coding agent can turn the source's table definitions and series into chart data and explanatory text in your project.

### Prepare an inflation briefing

Find the latest CPI announcement, read its explanation, identify the supporting table, inspect its definitions, and compare observations with a known vector series. Check table updates before refreshing the briefing.

### Write a provincial labor market report

Discover the latest Labour Force Survey release, locate the monthly labor table, confirm the available provincial categories, and compare unemployment observations. Reuse identified vectors for later editions and check which tables changed.

### Maintain a Canadian economic dashboard

Discover relevant releases and datasets, check table definitions, and populate charts with selected observations or known vectors. Use changed-table results to choose what to refresh and Daily articles to explain new movements.

### Check statistics before publication

Trace an economic claim to its Daily article and statistical table. Confirm the categories, compare table observations with the cited vector, and check for table updates before publishing the final report.

### Compare provincial CPI trends

Locate the monthly CPI table, inspect its geographic and product categories, and retrieve comparable provincial series for a chart covering the same reference periods.

## Overview

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

## Statistics Canada table search in other agents

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

## More Codex guides

- [Statistics Canada table definitions](https://spiral.ai/integrations/codex/statistics-canada-table-definitions)
- [Statistics Canada table updates](https://spiral.ai/integrations/codex/statistics-canada-table-updates)
- [Statistics Canada latest releases](https://spiral.ai/integrations/codex/statistics-canada-latest-releases)
- [Statistics Canada table values](https://spiral.ai/integrations/codex/statistics-canada-table-values)
- [Statistics Canada Daily article](https://spiral.ai/integrations/codex/statistics-canada-daily-article)
- [Statistics Canada vector history](https://spiral.ai/integrations/codex/statistics-canada-vector-history)

## Questions about Statistics Canada table search in Codex

**Can Codex use Statistics Canada table search?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Statistics Canada table search like any built-in tool.

**How much does Statistics Canada table search 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 Statistics Canada table search in Codex?**

No. Spiral runs Statistics Canada table search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Statistics Canada table search in Codex?**

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

**Does Codex wait while Statistics Canada table search runs?**

Statistics Canada table search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Does Statistics Canada provide individual survey responses?**

The public data API provides aggregate statistics and metadata. Its documented coverage is public statistical databases, rather than individual survey responses.

**When does Statistics Canada publish new information?**

The Daily normally appears Monday through Friday at 8:30 a.m. Eastern time, excluding holidays. Statistics Canada's data service also publishes updates each business day.

**Are archived tables still updated?**

No. Statistics Canada defines an archived table as publicly available but no longer updated, so an accessible historical table may not contain current observations.

**Can published observations be preliminary or revised?**

Yes. Statistics Canada identifies preliminary observations with p and revised observations with r; those distinctions matter when comparing a published release with later table values.

**Does every statistic cover the same geographic areas?**

No. Available geography depends on the table: monthly CPI table 18-10-0004-01 includes national, provincial or territorial, and selected municipal and metropolitan geography types.

