Tools
Every tool the server exposes
358 tools in 69 modules, read from the server's code when this page was built. Search ranks them the way search_tools does. Open a tool for its parameters, its keywords and a call you can adapt.
Always visible to the agent
plan_query- Turns a question into an ordered plan across agencies, with caveats on combining them.
search_tools- Ranks the other 357 tools against a plain-language query and returns the top 5.
call_tool- Runs a tool that search_tools found, by name, with its arguments.
Federal and national
Statistics Canada
statcan_census_profile_ statcan_census_profile_2016_ statcan_census_profile_archive_ statcan_census_tables_ cimt_ statcan_daily_ statcan_delta_ statcan_geo_ statcan_indicators_ statcan_lode_ statcan_pumf_ rdaas_ statcan_reference_ statcan_sdg_ sdmx_ sdmx_space_ statcan_surveys_ wds_
Statistics Canada: the Web Data Service (WDS) for table/cube discovery, metadata and time-series data; the SDMX REST API for filtered, server-side-sliced series queries…
Full description
Statistics Canada: the Web Data Service (WDS) for table/cube discovery, metadata and time-series data; the SDMX REST API for filtered, server-side-sliced series queries; two more .Stat Suite SDMX spaces (tools prefixed sdmx_space_): ccei, the Canadian Centre for Energy Information (ECCC greenhouse gas inventory and projections, air pollutants, NRCan energy efficiency, 245 flows), and stcshared (internal trade, quality of life, rural, PCEIP, drinking water advisories, 238 flows), with flow listing, full-text search, a dimension and code browser and filtered data (all flagged NonProductionDataflow); Reference Data as a Service (RDaaS) for classifications, codesets, concordances, indices and exclusions (e.g. NAICS, the Standard Geographical Classification); and the 2021 Census Profile SDMX API (tools prefixed statcan_census_profile_) -- a separate host and dataflow structure from the WDS/SDMX table service above, covering demographic, dwelling, income, and other census characteristics by geography (province, census division/subdivision, census tract, dissemination area, forward sortation area, health/economic region, federal electoral district, population centre) -- search a geography or characteristic by name, then fetch values for any combination, including each characteristic's parent_code where the profile table itself nests one characteristic under another (e.g. age-group breakdowns). All tools accept lang: en|fr; the Census Profile API selects language via an Accept-Language header rather than a query parameter, handled internally. Earlier censuses (2001, 2006, 2011, 2016) have no equivalent live query API -- tools prefixed statcan_census_profile_archive_ resolve their official bulk CSV/TAB download links instead (1996 has no equivalent bulk-download page under this URL scheme and is not covered). The Daily's official Atom feeds (tools prefixed statcan_daily_): statcan_daily_get_releases returns StatCan's official release bulletin (new/updated tables, survey results, analytical products) for the last 100 days, either across all subjects or filtered to one of 30 (e.g. housing, labour, prices_and_price_indexes) -- The Daily's own web pages are plain server-rendered HTML with no JSON API, so this goes through StatCan's documented Atom feed family instead. statcan_daily_search_archive covers the full release history back to 2012-03-14 instead of the Atom feeds' 100-day window, via the JSON file backing the release-schedule calendar's client-side rendering (18,222 entries confirmed live) -- filter by title/reference-period keyword and/or a date range. StatCan's "Reference resources" catalogue (tools prefixed statcan_reference_): statcan_reference_search_documents searches 2,031 definitions, data-source, and methodology documents -- distinct from actual data and from The Daily -- each carrying a catalogue number, category, description, and release date. Its search page silently ignores the keyword parameter (returning every document unfiltered) unless the session already visited the unparameterized base page first, confirmed live; handled internally with a one-time per-language warm-up request. The same tool family also covers StatCan's Analysis catalogue (statcan_reference_search_analysis, 10,841+ analytical articles, "Stats in brief", journals and periodicals) -- an identical Drupal search engine, path, and quirks, just a different catalogue. The same tool family also covers StatCan's Data catalogue (statcan_reference_search_data, 13,342+ items) -- the same Drupal search engine again, and the only place with any discovery path at all for Public Use Microdata Files (PUMFs; e.g. catalogue number 71M0001X for the Labour Force Survey, 98M0001X for the Census) and other bulk data products WDS/SDMX cannot see. Most other Data-catalogue results are ordinary table PIDs also reachable via WDS/SDMX, so prefer those tools for routine table search. Confirmed live: a PUMF's catalogue-number page links one hop further to a bespoke, per-product static page (not this Drupal engine, so not parsed generically) listing the actual bulk download -- confirmed for 98M0001X, a direct, unauthenticated ~182 MB ZIP with no login or account required. The 2016 Census Profile Web Data Service (tools prefixed statcan_census_profile_2016_): a separate JSON REST API (not SDMX) for 2016 census data, currently unavailable (StatCan's www12 host answers scripts with a Cloudflare bot challenge, checked 2026-10-02; the tools say so and point to WDS tables 17100122 and 17100123, the indicator subset down to health regions) -- distinct from statcan_census_profile_archive_* (2016 bulk downloads only). statcan_census_profile_2016_list_geographies finds a geography's DGUID; statcan_census_profile_2016_get_data fetches its full profile, optionally scoped to one of 14 topics, with separate total/male/female values and suppression symbols. StatCan's Delta File (tools prefixed statcan_delta_): statcan_delta_get_file_link resolves the daily bulk-update ZIP for one date (all table/vector data and metadata StatCan released that business day) and confirms it exists -- files only exist for business days with a release. statcan_delta_list_files shows the ~47 days kept and why a date has none; statcan_delta_list_tables lists the cubes a file changed and statcan_delta_read_table reads one cube's rows by range requests, without downloading the zip; statcan_delta_list_real_time_tables pairs the 19 real-time (vintage) tables with their regular tables. StatCan's official Indicators feeds (tools prefixed statcan_indicators_): statcan_indicators_get_indicators returns current named-indicator values (population, CPI, GDP, trade, unemployment, etc., 2,362 confirmed live in the "all" dataset) with growth rates and a link back to the releasing Daily article -- the same feeds that power My StatCan and StatCan's own home page. StatCan's survey directory and IMDB metadata (tools prefixed statcan_surveys_): statcan_surveys_search_surveys searches the A-Z directory of ~899 surveys and statistical programs (active and inactive) to find a survey's numeric ID; statcan_surveys_get_survey_metadata fetches that survey's actual "Definitions, data sources and methods" content from IMDB (Integrated Metadata Base, a separate, older system from the Reference/Analysis catalogues) -- status, frequency, description, and subjects, with a detail_url to the full methodology sections (target population, sampling, data sources, data accuracy) rather than flattening that lengthy prose into fields. An unknown survey ID redirects through StatCan's own dedicated error page, which itself answers HTTP 500 due to a broken redirect chain on their end -- handled internally as a normal not-found result. StatCan's census-geography ArcGIS REST service (tools prefixed statcan_geo_, geo.statcan.gc.ca -- yet another host, and the only genuinely queryable geospatial API in this module, distinct from static bulk boundary-file downloads): statcan_geo_list_services finds what boundary products exist for a year (a census year like 2021 publishes a full suite covering every geography level; an intercensal year only CSD-level updates and the road network file -- genuinely different per year, discovered live rather than hardcoded); statcan_geo_get_layer_detail inspects one layer's field schema; statcan_geo_query_layer filters features by attribute (e.g. finding a CSD's DGUID by name) and, on request, returns polygon boundaries reprojected from the service's native EPSG:3347 (Statistics Canada Lambert) to plain lat/lon. Confirmed live: every error (an unknown year/service/layer, a malformed filter) comes back as HTTP 200 with an embedded error object, not a non-2xx status, and about one in three to five otherwise-valid requests hits a genuine transient HTTP 500 from an unhealthy backend node -- both handled internally (the latter by the existing shared retry layer). StatCan's Sustainable Development Goals Data Hub (tools prefixed statcan_sdg_, hosted as two separate static "Open SDG" GitHub Pages sites, not a StatCan-run API): statcan_sdg_search_indicators searches the "canada" framework (86 indicators, Canada's own national reporting) or the "global" framework (251 indicators, Canada's reporting against the UN's own Global Indicator Framework) -- distinct, differently-numbered indicator sets with no WDS/SDMX cube/PID equivalent. statcan_sdg_get_indicator_metadata returns an indicator's goal/target, description, units, and data sources; statcan_sdg_get_indicator_data returns its observations, each with whatever disaggregation columns (e.g. geography) that specific indicator happens to publish. The two frameworks use genuinely different metadata field names for the same concepts (confirmed live) -- handled internally so callers see one consistent shape regardless of framework. The Canadian International Merchandise Trade (CIMT) web-application API (tools prefixed cimt_; undocumented, found in the CIMT page's JavaScript, may change without notice): monthly exports and imports from 1988-01 by HS commodity (6 digits, or 8 for exports and 10 for imports), partner country, US state and province, which WDS does not carry below aggregates. cimt_search_commodities and cimt_search_partners find the codes; cimt_get_trade returns rows with values (Canadian dollars) and quantities (with units), a row limit and a truncation flag; cimt_get_top_partners, _top_commodities and _province_breakdown rank one month; cimt_get_series gives a five-year monthly line. Totals reconcile with WDS table 12-10-0011-01. StatCan's public use microdata files (tools prefixed statcan_pumf_): statcan_pumf_search finds the surveys that publish respondent-level microdata, statcan_pumf_list_files lists a PUMF's free ZIP downloads, statcan_pumf_list_zip shows a ZIP's contents without downloading it, and statcan_pumf_get_codebook reads variable definitions from its codebook. The 2006, 2011 (Census and NHS) and 2016 census data tables (tools prefixed statcan_census_tables_): statcan_census_tables_search finds cross-tabulations by topic and geography and statcan_census_tables_get_downloads lists their CSV, SDMX and Beyond 20/20 IVT files; the www12 host may refuse automated clients. Every result carries a Statistics Canada Open Licence attribution note in provenance.licence.
2021 Census Profile 3
statcan_census_profile_get_data Get 2021 Census Profile values for geographies and characteristics.
Use for retrieving actual census data (counts or rates) for one or more geographies (by DGUID, from statcan_census_profile_search_geography) crossed with one or more characteristics (by code, from statcan_census_profile_search_characteristic), for a given gender breakdown. Multiple geography_codes or characteristic_codes are combined (every geography x every characteristic). Returns each value alongside its data-quality flag and confidence interval when the upstream API supplies one -- do not drop a flagged or interval-bounded value silently.
- Keywords
- census, population, dwelling, income, age, demographics, statistics Canada, 2021 census, SDMX
- Mots-clés
- profil du recensement, recensement de 2021, population, logement, revenu, âge, démographie, données du recensement, Statistique Canada
| Parameter | Type | Default |
|---|---|---|
level | "canada_provinces_territories" | "census_divisions" | "census_subdivisions" | "dissolved_census_subdivisions" | "census_metro_areas" | "census_tracts" | "dissemination_areas" | "aggregate_dissemination_areas" | "designated_places" | "economic_regions" | "federal_electoral_districts" | "forward_sortation_areas" | "health_regions" | "population_centres" | required |
geography_codes | list[str] | required |
characteristic_codes | list[str] | required |
gender | "total" | "men" | "women" | "total" |
statistic | "counts" | "rate" | "counts" |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_census_profile_get_data", "arguments": {"level": "…", "geography_codes": "…", "characteristic_codes": "…"}}statcan_census_profile_search_characteristic Search the 2021 Census Profile's 2,631 characteristics (variables) by name.
Use for finding a characteristic code (needed by statcan_census_profile_get_data) by keyword, e.g. "population", "median household income", "dwelling", "commute". An empty query returns every characteristic. Each match includes parent_code when the characteristic is a sub-item of a broader one in the profile table's own hierarchy (e.g. "0 to 4 years" is a child of "0 to 14 years", itself a child of "Total - Age groups of the population") -- use this to tell a summary row from its breakdown rows rather than treating all 2,631 characteristics as a flat list.
- Keywords
- census, characteristic, variable, population, income, dwelling, age, language, education, housing, commuting
- Mots-clés
- recensement, profil du recensement, caractéristique, variable, population, revenu, logement, âge, langue, scolarité, éducation, navettage
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
limit | int | 20 |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_census_profile_search_characteristic", "arguments": {}}statcan_census_profile_search_geography Search 2021 Census Profile geography names for one geography level.
Use for finding a geography's DGUID code (needed by statcan_census_profile_get_data) by place name substring, at a chosen level (province, census division, census subdivision/ municipality, census metro area, census tract, dissemination area, forward sortation area, health region, economic region, federal electoral district, population centre, designated place). An empty query returns every geography at that level.
- Keywords
- census, geography, DGUID, place name, municipality, province, census subdivision, census tract, forward sortation area, FSA
- Mots-clés
- recensement, profil du recensement, géographie, DGUID, nom de lieu, municipalité, ville, province, subdivision de recensement, secteur de recensement, région de tri d'acheminement, code géographique
| Parameter | Type | Default |
|---|---|---|
level | "canada_provinces_territories" | "census_divisions" | "census_subdivisions" | "dissolved_census_subdivisions" | "census_metro_areas" | "census_tracts" | "dissemination_areas" | "aggregate_dissemination_areas" | "designated_places" | "economic_regions" | "federal_electoral_districts" | "forward_sortation_areas" | "health_regions" | "population_centres" | required |
query | str | "" |
limit | int | 20 |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_census_profile_search_geography", "arguments": {"level": "…"}}2016 Census Profile 2
statcan_census_profile_2016_get_data Get 2016 Census Profile data for one geography (by DGUID).
Use for retrieving 2016 census values (counts or rates) for a geography found via statcan_census_profile_2016_list_geographies, optionally scoped to one topic (population, income, housing, labour, education, language, mobility, immigration and citizenship, ethnic origin, visible minority, Aboriginal peoples, journey to work, language of work, families/households/marital status). Values include separate total/male/female breakdowns and any suppression/quality symbol alongside the numeric value -- do not drop a flagged value silently. Set include_notes=True for the full explanatory footnote text. This is distinct from statcan_census_profile_* (2021) and covers only the 2016 census.
- Keywords
- census 2016, population, dwelling, income, age, demographics, statistics Canada, census profile
- Mots-clés
- recensement de 2016, profil du recensement, population, logement, revenu, âge, démographie, données du recensement, Statistique Canada
| Parameter | Type | Default |
|---|---|---|
dguid | str | required |
topic | "all_topics" | "aboriginal_peoples" | "education" | "ethnic_origin" | "families_households_and_marital_status" | "housing" | "immigration_and_citizenship" | "income" | "journey_to_work" | "labour" | "language" | "language_of_work" | "mobility" | "population" | "visible_minority" | "all_topics" |
statistic | "counts" | "rate" | "counts" |
include_notes | bool | false |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_census_profile_2016_get_data", "arguments": {"dguid": "…"}}statcan_census_profile_2016_list_geographies List 2016 Census geographies (with their DGUIDs) for one geography level.
Use for finding a geography's DGUID code (needed by statcan_census_profile_2016_get_data) for the 2016 census, at a chosen level (province, census division, census subdivision, census metro area, census tract, dissemination area, forward sortation area, health region, economic region, federal electoral district, population centre, designated place). Optionally filter to one province/territory. Each result also carries global non-response rates and a data-quality flag.
- Keywords
- census 2016, geography, DGUID, place name, municipality, census subdivision, CMA, geographic code
- Mots-clés
- recensement de 2016, profil du recensement, géographie, DGUID, nom de lieu, municipalité, subdivision de recensement, RMR, code géographique
| Parameter | Type | Default |
|---|---|---|
level | "canada_provinces_territories" | "census_divisions" | "census_subdivisions" | "census_metro_areas" | "census_tracts" | "dissemination_areas" | "designated_places" | "economic_regions" | "federal_electoral_districts" | "forward_sortation_areas" | "health_regions" | "population_centres" | required |
province_territory | "all" | "newfoundland_and_labrador" | "prince_edward_island" | "nova_scotia" | "new_brunswick" | "quebec" | "ontario" | "manitoba" | "saskatchewan" | "alberta" | "british_columbia" | "yukon" | "northwest_territories" | "nunavut" | "all" |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_census_profile_2016_list_geographies", "arguments": {"level": "…"}}Census Profile archive, 2001-2016 2
statcan_census_profile_archive_get_download_link Get the direct bulk-download URL for one archived census year/level/format.
Use for resolving the actual downloadable file (a compressed CSV or TAB archive covering every geography at that level, for all topics) for a pre-2021 census, given a level key from statcan_census_profile_archive_list_geography_levels. Files can be large (tens to hundreds of megabytes for fine-grained levels like dissemination areas). Only CSV and TAB formats are covered -- IVT (a proprietary Beyond 20/20 format) uses a different, separate resolver not implemented here. lang="fr" returns StatCan's French-language file for every year.
- Keywords
- census, archive, historical, download, CSV, TAB, comprehensive download file, census profile
- Mots-clés
- recensement, archive, historique, téléchargement, fichier de téléchargement global, profil du recensement, fichier en français, CSV
| Parameter | Type | Default |
|---|---|---|
year | 2001 | 2006 | 2011 | 2016 | required |
level | str | required |
file_format | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_census_profile_archive_get_download_link", "arguments": {"year": "…", "level": "…", "file_format": "…"}}statcan_census_profile_archive_list_geography_levels List geography levels and file formats available for an archived census year.
Use for discovering what level keys (needed by statcan_census_profile_archive_get_download_link) and file formats exist for one archived census (2001, 2006, 2011, or 2016) before the 2021 Census Profile (covered by statcan_census_profile_* instead). Coverage genuinely narrows going back in time: 2016 has 34 geography groupings, 2011 has 14, 2006 and 2001 each have 5. Level keys are the same in both languages, so lang does not change this list; pass it to the download-link tool for French files.
- Keywords
- census, archive, historical, 2001, 2006, 2011, 2016, bulk download, comprehensive download file
- Mots-clés
- recensement, archive, historique, téléchargement en bloc, fichier de téléchargement global, niveau géographique, format de fichier, profil du recensement
| Parameter | Type | Default |
|---|---|---|
year | 2001 | 2006 | 2011 | 2016 | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_census_profile_archive_list_geography_levels", "arguments": {"year": "…"}}Census data tables, 2006-2016 2
statcan_census_tables_get_downloads Get a census data table's download links: CSV, SDMX and Beyond 20/20 IVT.
Use for downloading a table found with statcan_census_tables_search (by pid). Checks which formats exist and their sizes. When only the IVT exists, returns an R snippet using mountainMath's canivt to read it. Some SDMX files are very large; check size_bytes first.
- Keywords
- census table download, CSV, SDMX, IVT, Beyond 20/20, canivt, full table, census
- Mots-clés
- téléchargement, tableau du recensement, CSV, SDMX, IVT, Beyond 20/20, tableau complet, recensement
| Parameter | Type | Default |
|---|---|---|
pid | str | required |
release | "2016" | "2011" | "2011_nhs" | "2006" | "2016" |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_census_tables_get_downloads", "arguments": {"pid": "…"}}statcan_census_tables_search Search the 2006, 2011 (Census and NHS) and 2016 census data tables.
Use for census cross-tabulations by topic and geography, e.g. "income household type" or "language dissemination areas", with the catalogue number and PID of each table. Every word must appear in the title. 2021 census tables are StatCan tables: use wds_search_cubes. StatCan retired the 2011 Census tabulations (the 2011 NHS ones remain); copies are on Borealis, see borealis_search_ivt. Titles are in English; lang is accepted for consistency.
- Keywords
- census data tables, cross-tabulation, 2016 census, 2011 National Household Survey, 2006 census, Beyond 20/20, topic-based tabulations, census
- Mots-clés
- tableaux de données du recensement, totalisations croisées, recensement de 2016, Enquête nationale auprès des ménages, recensement de 2006, Beyond 20/20, tableaux thématiques, recensement
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
release | "2016" | "2011" | "2011_nhs" | "2006" | "2016" |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_census_tables_search", "arguments": {}}Merchandise trade by commodity 8
cimt_get_periods Get the first and latest month covered by the merchandise trade database (CIMT).
Use for finding the latest published month of detailed Canadian exports and imports before querying them. Data starts in 1988-01. This is an undocumented web-application API: WDS has no commodity-level trade, only aggregates by section and partner.
- Keywords
- CIMT, merchandise trade, exports, imports, latest month, coverage, reference period, Canadian international merchandise trade
- Mots-clés
- CICM, commerce de marchandises, exportations, importations, dernier mois, couverture, période de référence, commerce international canadien de marchandises, données disponibles
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "cimt_get_periods", "arguments": {}}cimt_get_province_breakdown Split one month of exports or imports by province, optionally for one partner or chapter.
Use for "which provinces export the most to China" or "imports by province of clearance". Exports are by province of origin (domestic exports and re-exports are reported separately); imports are by province of clearance, not of final use, which overstates provinces with ports and warehouses. period is a month (empty = latest).
- Keywords
- trade by province, provincial exports, provincial imports, province of origin, province of clearance, CIMT, regional trade, territory, breakdown
- Mots-clés
- commerce par province, exportations provinciales, importations provinciales, province d'origine, province de dédouanement, CICM, commerce régional, territoire, répartition
| Parameter | Type | Default |
|---|---|---|
direction | "exports" | "imports" | required |
period | str | "" |
hs_chapter | str | "" |
partner | str | "" |
us_state | str | "" |
lang | "en" | "fr" | "en" |
call_tool {"name": "cimt_get_province_breakdown", "arguments": {"direction": "…"}}cimt_get_series Get a five-year monthly series of exports or imports for an HS chapter or one commodity.
Use for a quick trend line, for example crude oil exports to the US over the last 60 months. The window is the five years ending at period (empty = latest). hs_code is a 2-digit chapter (one value per month) or a 6-, 8- or 10-digit commodity (value and quantity measures: for exports domestic_value plus reexport_value is total exports, and the quantities are in unit). For longer ranges or several commodities use cimt_get_trade.
- Keywords
- time series, monthly trend, exports, imports, HS code, chapter, commodity, five years, CIMT, quantity, value
- Mots-clés
- série chronologique, tendance mensuelle, exportations, importations, code SH, chapitre, marchandise, cinq ans, CICM, quantité, valeur
| Parameter | Type | Default |
|---|---|---|
direction | "exports" | "imports" | required |
hs_code | str | required |
period | str | "" |
partner | str | "" |
us_state | str | "" |
province | str | "" |
lang | "en" | "fr" | "en" |
call_tool {"name": "cimt_get_series", "arguments": {"direction": "…", "hs_code": "…"}}cimt_get_top_commodities Rank the largest traded commodities for one month, by partner, province or HS chapter.
Use for "what does Alberta export to the US", "top imports from China" or the biggest products inside one HS chapter. period is a month (empty = latest). Filters are all optional. The service returns only its largest commodities.
- Keywords
- top commodities, largest products, ranking, exports, imports, HS code, province, partner, CIMT, trade composition, leading goods
- Mots-clés
- principales marchandises, plus gros produits, classement, exportations, importations, code SH, province, partenaire, CICM, composition du commerce, principaux biens
| Parameter | Type | Default |
|---|---|---|
direction | "exports" | "imports" | required |
period | str | "" |
hs_chapter | str | "" |
province | str | "" |
partner | str | "" |
us_state | str | "" |
hs_level | "hs6" | "national" | "hs6" |
lang | "en" | "fr" | "en" |
call_tool {"name": "cimt_get_top_commodities", "arguments": {"direction": "…"}}cimt_get_top_partners Rank Canada's 15 largest trading partners (countries or US states) for one month.
Use for "who buys the most Canadian lumber" or "top import sources in July 2026". period is a month (empty = latest). hs_chapter limits to a 2-digit HS chapter, province to one province. view "us_state" ranks the states within the United States. total_value_cad is the all-partner total, so shares are of the whole and, with no chapter, matches the published monthly total. The service returns only the top 15.
- Keywords
- top trading partners, ranking, largest export markets, import sources, country, US state, CIMT, exports, imports, share, Canada trade
- Mots-clés
- principaux partenaires commerciaux, classement, plus grands marchés d'exportation, sources d'importation, pays, État américain, CICM, exportations, importations, part, commerce du Canada
| Parameter | Type | Default |
|---|---|---|
direction | "exports" | "imports" | required |
period | str | "" |
hs_chapter | str | "" |
province | str | "" |
view | "country" | "us_state" | "country" |
lang | "en" | "fr" | "en" |
call_tool {"name": "cimt_get_top_partners", "arguments": {"direction": "…"}}cimt_get_trade Get Canadian merchandise exports or imports by month, HS commodity, partner and province.
Use for commodity-level trade values and quantities, for example "crude oil exports to the US by month in 2025" or "vehicle imports from Mexico by province". from_period and to_period are months (YYYY-MM, 1988-01 to the latest, see cimt_get_periods). hs_code is a prefix: 2 digits (chapter), 4 (heading), 6, 8 or 10; empty means every commodity (large: set a limit and narrow it). hs_level "hs6" aggregates to 6 digits for both directions; "national" returns Canada's detail (8 digits exports, 10 imports) and then the code may be at most that long. partner is a country id, two-letter code or name (empty = all countries), us_state a US state (implies the US), provinces provinces of origin for exports or of clearance for imports (empty = Canada). annualize sums calendar years. Values are Canadian dollars at current prices; exports include re-exports. When truncated is true the rows are an arbitrary subset of total_count, not a ranking: narrow the query. The undocumented web-application API behind these tools may change.
- Keywords
- CIMT, exports, imports, merchandise trade, HS code, commodity, partner, province, US state, monthly trade, trade value, Statistics Canada, international trade
- Mots-clés
- CICM, exportations, importations, commerce de marchandises, code SH, marchandise, partenaire, province, État américain, commerce mensuel, valeur des échanges, Statistique Canada, commerce international
| Parameter | Type | Default |
|---|---|---|
direction | "exports" | "imports" | required |
from_period | str | required |
to_period | str | required |
hs_code | str | "" |
partner | str | "" |
us_state | str | "" |
provinces | list[str] | null | null |
hs_level | "hs6" | "national" | "hs6" |
annualize | bool | false |
limit | int | 500 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cimt_get_trade", "arguments": {"direction": "…", "from_period": "…", "to_period": "…"}}cimt_search_commodities Search Harmonized System (HS) commodity codes by code prefix or by words.
Use for turning a product ("crude petroleum", "pétrole brut") into the HS code that cimt_get_trade needs, or listing the codes under a chapter ("27"). Matches words in English and French. level is chapter (2 digits), heading (4), hs6 (6, the international level) or national (Canada's detail: 8 digits for exports, 10 for imports; the import list is a 16 MB file on first use). Each hit carries the unit of measure and the months the code was in use (codes change with HS revisions).
- Keywords
- HS code, harmonized system, commodity, product, tariff, classification, trade, exports, imports, CIMT, search, chapter, heading
- Mots-clés
- code SH, Système harmonisé, marchandise, produit, tarif, classification, commerce, exportations, importations, CICM, recherche, chapitre, position
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
direction | "exports" | "imports" | "exports" |
level | "chapter" | "heading" | "hs6" | "national" | "hs6" |
lang | "en" | "fr" | "en" |
limit | int | 20 |
call_tool {"name": "cimt_search_commodities", "arguments": {}}cimt_search_partners Search trading-partner countries, US states or Canadian provinces and their codes.
Use for finding the partner, US state or province to pass to cimt_get_trade and the other CIMT tools. They also accept a country's two-letter code ("CN"), a province's abbreviation ("AB") or a name directly. Country ids include historical partners (Czechoslovakia, West Germany) with the months they were reported. Exports are attributed to the US state of destination and imports to the state of origin.
- Keywords
- trading partner, country code, US state, province, origin, destination, CIMT, trade, exports, imports, partner code, geography
- Mots-clés
- partenaire commercial, code de pays, État américain, province, origine, destination, CICM, commerce, exportations, importations, code de partenaire, géographie
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
kind | "country" | "us_state" | "province" | "country" |
lang | "en" | "fr" | "en" |
limit | int | 20 |
call_tool {"name": "cimt_search_partners", "arguments": {}}The Daily and the release calendar 3
statcan_daily_get_release_calendar Find when StatCan will next release something (forward release calendar).
Use for "when is the next release of X" -- the planned date of upcoming Daily releases of key indicators (Labour Force Survey, international merchandise trade, building permits, CPI and so on, with their reference period), checked live to reach about six months ahead. query needs every word to appear in the title, reference period or catalogue number (accents ignored); start_date and end_date are "YYYY-MM-DD". With upcoming_only=True (default) results run soonest first from today (Toronto); with False they are the history, newest first. kind "products" is the catalogue-number release history since 2012 only: that file has no future dates (use it for "when was catalogue 62-013-X published"); "all" merges both. Scheduled rows have no URL until the release is out. Dates are plans and can move. For releases already out use statcan_daily_search_archive.
- Keywords
- release calendar, release schedule, next release, upcoming releases, when is the next, Labour Force Survey release date, CPI release date, The Daily, indicators calendar, Statistics Canada
- Mots-clés
- calendrier de diffusion, prochaine diffusion, prochaines parutions, date de diffusion, quand sort, Enquête sur la population active, indice des prix à la consommation, Le Quotidien, indicateurs clés, Statistique Canada
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
lang | "en" | "fr" | "en" |
kind | "key_indicators" | "products" | "all" | "key_indicators" |
upcoming_only | bool | true |
start_date | str | null | null |
end_date | str | null | null |
limit | int | 20 |
call_tool {"name": "statcan_daily_get_release_calendar", "arguments": {}}statcan_daily_get_releases Get recent releases from The Daily, StatCan's official release bulletin.
Use for finding what data StatCan has released recently -- new or updated tables, survey results, analytical products -- optionally filtered to one subject (e.g. "housing", "labour", "prices_and_price_indexes"). Covers the last 100 days. Each release has a title, a canonical URL (either a Daily article or a catalogue-number product page), a publication timestamp, and a plain-text summary. Use "all" for every subject in one call.
- Keywords
- The Daily, release bulletin, new data, recent releases, what's new, StatCan announcement, Statistics Canada, latest statistics, today's releases, press releases, news
- Mots-clés
- Le Quotidien, bulletin de diffusion, nouvelles données, diffusions récentes, quoi de neuf, annonce de Statistique Canada, Statistique Canada, dernières statistiques, communiqués du Quotidien, communiqués d'aujourd'hui, diffusions du jour, nouveautés
| Parameter | Type | Default |
|---|---|---|
subject | "all" | "agriculture_and_food" | "business_and_consumer_services_and_culture" | "business_performance_and_ownership" | "children_and_youth" | "construction" | "crime_and_justice" | "digital_economy_and_society" | "economic_accounts" | "education_training_and_learning" | "energy" | "environment" | "families_households_and_marital_status" | "government" | "health" | "housing" | "immigration_and_ethnocultural_diversity" | "income_pensions_spending_and_wealth" | "indigenous_peoples" | "international_trade" | "labour" | "languages" | "manufacturing" | "older_adults_and_population_aging" | "population_and_demography" | "prices_and_price_indexes" | "reference" | "retail_and_wholesale" | "science_and_technology" | "society_and_community" | "statistical_methods" | "transportation" | "travel_and_tourism" | "all" |
lang | "en" | "fr" | "en" |
limit | int | 20 |
call_tool {"name": "statcan_daily_get_releases", "arguments": {}}statcan_daily_search_archive Search The Daily's full release archive (2012-03-14 onward), not just the last 100 days.
Use for finding when StatCan first or last released something on a topic, or listing every historical release matching a keyword, going back to 2012 -- statcan_daily_get_releases only covers the last 100 days via the official Atom feeds. query matches against the release title and reference period (e.g. "second quarter 2020"); leave it empty to browse by date range alone. start_date and end_date are "YYYY-MM-DD" and filter to releases on or between those dates (inclusive); omit either to leave that side open. Results are returned most-recent-first. The archive also holds UPCOMING releases (entries of type "meeting", dated in the future): search with start_date set to today to see what StatCan has scheduled. Each entry has scheduled (true when the release date is today or later, Toronto time); an upcoming one has url null because its article does not exist yet.
- Keywords
- The Daily, historical, archive, past releases, release history, when was, Statistics Canada, release date, upcoming releases, release schedule, release calendar
- Mots-clés
- Le Quotidien, historique, archive, diffusions passées, historique des diffusions, quand, Statistique Canada, date de diffusion, diffusions à venir, calendrier de diffusion
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
lang | "en" | "fr" | "en" |
start_date | str | null | null |
end_date | str | null | null |
limit | int | 20 |
call_tool {"name": "statcan_daily_search_archive", "arguments": {}}Delta files: daily bulk updates 5
statcan_delta_get_file_link Get the Delta File download link for one date, confirming it exists.
Use for bulk-downloading every table/vector data and metadata update StatCan released on one business day, as a single ZIP -- the preferred mechanism (per StatCan's own developer guidance) for large updates, rather than re-fetching individual tables one at a time. date is "YYYY-MM-DD". A Delta File only exists for business days that had a release (weekends and holidays will report exists=False); check exists before treating the url as downloadable. Files can be very large (20261001.zip is 3.9 GB): read size_bytes before downloading. The ZIP carries both English and French metadata; lang sets the language of the notes and messages.
- Keywords
- StatCan, delta file, bulk update, daily update, all tables, full refresh, changed data, download
- Mots-clés
- Statistique Canada, fichier delta, mise à jour en bloc, mise à jour quotidienne, tous les tableaux, actualisation complète, données modifiées, téléchargement
| Parameter | Type | Default |
|---|---|---|
date | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_delta_get_file_link", "arguments": {"date": "…"}}statcan_delta_list_files List the Delta Files kept (about 47 business days), from StatCan's Delta File page, and say why a given date has none.
Use for which dates can be read, the newest release, retention, and "is there a file for 2026-09-30?" (date): the answer is available, no release that day (weekend or holiday), past retention, or not yet published. include_sizes adds a HEAD request per file for size, ETag and Last-Modified (about 46 requests). Files appear on business days about 8:30 ET; the page's own user guide says 5 releases, which is out of date. Then use statcan_delta_list_tables or statcan_delta_read_table with a listed date.
- Keywords
- delta file, available dates, retention, release schedule, holidays, business days, file sizes, etag, last modified, archive
- Mots-clés
- fichier delta, dates disponibles, période de conservation, calendrier de diffusion, jours fériés, jours ouvrables, taille des fichiers, date de modification, archives
| Parameter | Type | Default |
|---|---|---|
date | str | null | null |
include_sizes | bool | false |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_delta_list_files", "arguments": {}}statcan_delta_list_real_time_tables List StatCan's 19 real-time (vintage) cubes, each paired with its regular cube, to find the revision history of a statistic.
Use for how a figure was revised over time, "what did it say when first released", vintage analysis and evaluating projections. A regular cube always shows the latest revision; its real-time twin adds a release-date (vintage) dimension, published about a week later. Returns both product ids and titles in English and French; query filters by a word or a product id. Three of the 19 are listed by StatCan but not served by WDS (flagged wds_available False). Read the cube itself with wds_get_cube_metadata, wds_get_data_from_cube_coord or wds_get_full_table_download.
- Keywords
- real-time tables, vintage, revision history, data revisions, historical releases, first release, real time data, revisions, vintages of releases
- Mots-clés
- tableaux en temps réel, versions, historique des révisions, révisions de données, diffusions historiques, première diffusion, données en temps réel, versions de diffusions
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_delta_list_real_time_tables", "arguments": {}}statcan_delta_list_tables List the cubes released or changed in one day's Delta File, reading only its metadata by range requests.
Use for "what was published on this date", checking whether a cube changed that day before fetching it, release-day monitoring. Each entry: productId, CANSIM number, English and French titles, frequency, release time, series count, archive status, corrections and dimensions (with members and correction notes when detail is True and product_id is given). Cheap even for the 3.9 GB day: about 1 MB is fetched. date is "YYYY-MM-DD", a business day among the roughly 47 kept (statcan_delta_list_files shows which). query filters by a word in either title. Rows are read with statcan_delta_read_table. The list is not WDS getChangedCubeList for the same date: WDS lists the cubes whose releaseTime falls on that date, while a day's file holds every cube processed since the previous file (built before 8:30 ET), with its own releaseTime. So a release after 8:30 lands in the next business day's file (42100107, released 2026-09-29 at 14:20, is in the 20261001 file with that releaseTime: 51 tables against WDS's 50; it was also in the 20260929 file marked 08:30), and metadata-only changes to old cubes keep their old releaseTime (four 2024-10-03 cubes in 20260925: 23 against 19). Compare release_time with the date to tell them apart.
- Keywords
- delta file, released today, what changed, changed cubes, release calendar, daily release, new cubes, cube metadata, corrections, product id
- Mots-clés
- fichier delta, publié aujourd'hui, quoi de neuf, tableaux modifiés, calendrier de diffusion, diffusion quotidienne, nouveaux tableaux, métadonnées de tableau, corrections, numéro de tableau
| Parameter | Type | Default |
|---|---|---|
date | str | required |
product_id | int | null | null |
query | str | null | null |
detail | bool | false |
max_tables | int | 200 |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_delta_list_tables", "arguments": {"date": "…"}}statcan_delta_read_table Read the data points one cube received in one day's Delta File, streaming only as much of the zip as needed (never the whole file).
Use for the exact values released or revised for one productId on one date, checking a release-day revision, pulling a handful of vectors from a large update. Rows carry vectorId, coordinate, reference period, value, symbol/status/security/scalar-factor/frequency codes (decoded in legend from the file's codeSet.xml) and release time. Values are raw: the scalar factor is not applied. Rows are never deleted; a correction arrives in the next day's file. The CSV is sorted by productId and must be inflated from its start, so a cube early in a big file is quick, and one deep in a multi-gigabyte file (20261001: 3.9 GB) takes several calls: each call reads up to 400 MB or 75 s (about 5 MB/s), then errors with how far it got and saves resume points, so calling again with the same arguments continues from there. Once a day's file has been scanned past a table, later reads of it on this server start next to it (scan_started_at_byte). For a single deep table, wds_get_changed_series_data or wds_get_full_table_download is faster. block_complete is False when the ceiling stopped inside the table's own rows. vector_ids keeps only those series; max_rows (1 to 10,000) caps the answer. date is "YYYY-MM-DD"; the productId must be in statcan_delta_list_tables for that date.
- Keywords
- delta file, revisions, changed data points, vector values, release day, bulk update, symbol status codes, scalar factor, delta rows
- Mots-clés
- fichier delta, révisions, points de données modifiés, valeurs de vecteur, jour de diffusion, mise à jour en bloc, codes de symbole et de statut, facteur d'échelle, lignes delta
| Parameter | Type | Default |
|---|---|---|
date | str | required |
product_id | int | required |
vector_ids | list[int] | null | null |
max_rows | int | 1000 |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_delta_read_table", "arguments": {"date": "…", "product_id": "…"}}Geography: census boundaries, road network and map layers 6
statcan_geo_get_layer_detail Get one geography layer's field schema, geometry type, and record cap.
Use for inspecting a layer's queryable fields (e.g. CSDUID, DGUID, CSDNAME, PRUID) and its maxRecordCount before calling statcan_geo_query_layer -- service is a name from statcan_geo_list_services (e.g. "Cartographic_boundary_files"), layer_id a small integer identifying one geography level within that service (e.g. layer 9 = CSD, layer 12 = DA for 2021's Cartographic boundary files -- layer numbering is not fixed across years/services and should be discovered, not assumed). The language comes from service itself, so lang has no effect here.
- Keywords
- statcan, geography, layer, schema, fields, arcgis, boundary file, geometry type
- Mots-clés
- Statistique Canada, géographie, couche, schéma, champs, attributs, fichier des limites, type de géométrie, structure de la couche
| Parameter | Type | Default |
|---|---|---|
year | str | required |
service | str | required |
layer_id | int | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_geo_get_layer_detail", "arguments": {"year": "…", "service": "…", "layer_id": "…"}}statcan_geo_get_spatial_layer_detail Get one layer's field list, geometry type and record cap (infc, hna, qol, nrn).
Use for reading the queryable field names of a layer before building a where clause for statcan_geo_query_spatial_layer, e.g. the dissemination-area fields (DAUID, DGUID, csdname, cmaname and indicator columns named AA###) of the infc Census_DA_2021 layer, or the roadclass, route name and number fields of an NRN road layer. Take layer_id from statcan_geo_list_spatial_layers. The tool's text is English only, so lang has no effect.
- Keywords
- statcan, layer schema, fields, geoanalytics, infc, hna, qol, national road network, nrn, attribute names, max record count
- Mots-clés
- Statistique Canada, schéma de couche, champs, géoanalytique, réseau routier national, noms d'attributs, indice de défavorisation, qualité de vie, besoins en logement
| Parameter | Type | Default |
|---|---|---|
dataset | "infc" | "hna" | "qol" | "nrn" | required |
layer_id | int | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_geo_get_spatial_layer_detail", "arguments": {"dataset": "…", "layer_id": "…"}}statcan_geo_list_services List StatCan's census-geography boundary services for one year.
Use for discovering what geography boundary products exist for a given year before drilling into a service's layers. A census year (e.g. "2021") publishes a full suite (Cartographic/Digital boundary files, Agricultural/Population ecumene boundary files, Road Network File, each in English and French) with every geography level; an intercensal year publishes only a smaller CSD-level update and the Road Network File -- this genuinely varies year to year and is discovered live, not hardcoded. Years 2019-2025 confirmed live; nothing older is served here (use statcan_census_profile_archive_* for older bulk boundary/data downloads instead). Only the lang edition of each product is listed: French services (e.g. "Fichiers_des_limites_cartographiques") carry French layer names and field aliases.
- Keywords
- statcan, geography, boundary files, geospatial, arcgis, census geography, cartographic, digital boundary file
- Mots-clés
- Statistique Canada, géographie, fichiers des limites, géospatial, géographie du recensement, limites cartographiques, fichier numérique des limites, couches cartographiques, cartes
| Parameter | Type | Default |
|---|---|---|
year | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_geo_list_services", "arguments": {"year": "…"}}statcan_geo_list_spatial_layers List the layers of a StatCan map-app dataset or of the National Road Network.
Use for finding the layer_id to query. dataset picks the service: "infc" (Index of Neighbourhood Characteristics / CSGE app: Canadian Index of Multiple Deprivation 2021 by dissemination area, Proximity Measures, Spatial Access Measures 2022, CanBICS, CanALE, and Linkable Open Data Environment facilities: cultural, educational, recreational, infrastructure, transit stops), "hna" (Housing Needs Assessment by province and census subdivision, change in stock 2021-2023), "qol" (Quality of Life indicators 2025 by province, CSD, CMA and census division) or "nrn" (National Road Network: one layer per province and road class, plus ferry connections, toll points and blocked passages). For "nrn", province ("ON") and road_class ("Local roads") narrow the list. Group layers are listed (is_group=true) but hold no rows. The infc/hna/qol service addresses are undocumented and read from StatCan's map-app config file at runtime; a clear error says so if StatCan changes it. Free under the Statistics Canada Open Licence. The tool's text is English only, so lang has no effect.
- Keywords
- statcan, geoanalytics, infc, hna, qol, national road network, nrn, housing needs assessment, quality of life, deprivation index, proximity measures, transit stops, layers
- Mots-clés
- Statistique Canada, géoanalytique, indice de défavorisation multiple, évaluation des besoins en logement, qualité de vie, réseau routier national, mesures de proximité, arrêts de transport en commun, couches
| Parameter | Type | Default |
|---|---|---|
dataset | "infc" | "hna" | "qol" | "nrn" | required |
province | str | null | null |
road_class | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_geo_list_spatial_layers", "arguments": {"dataset": "…"}}statcan_geo_query_layer Query one geography layer's features by attribute or location, optionally with geometry.
Use for finding a geography's DGUID/UID by name (e.g. where="CSDNAME='Toronto'"), finding which area contains a point ("which census tract / dissemination area / CSD is at this lat/lon": pass lat and lon, WGS84 degrees, and pick the layer for the level wanted), listing the areas touching a rectangle (bbox = "min_lon,min_lat,max_lon,max_lat"), or retrieving boundary polygons for mapping. distance_m widens a point to a radius in metres. A spatial filter combines with where and out_fields (e.g. out_fields="CTUID,DGUID" keeps the answer small) and is echoed back in spatial_filter. where is a standard SQL-style predicate against the layer's own field names from statcan_geo_get_layer_detail (e.g. "PRUID='35' AND CSDNAME LIKE '%Toronto%'"); leave the default "1=1" to match every feature in the layer. Leave return_geometry false (the default) for a lightweight attribute-only query -- polygon boundaries can be large, and most lookups only need the UID/DGUID/name columns. When return_geometry is true, geometry is reprojected to out_sr (WGS84 lat/lon, EPSG:4326, by default -- the service's native spatial reference is EPSG:3347, Statistics Canada Lambert). Each layer enforces its own maxRecordCount as a hard per-request cap regardless of result_record_count (6000 confirmed for 2021's Cartographic boundary layers); check exceeded_transfer_limit on the result and page further with result_offset if more features remain. Confirmed live: this host intermittently returns HTTP 500 on an otherwise-valid request (roughly one in three to five calls, a load-balanced backend with some unhealthy nodes) -- already mitigated by this client's normal retry behavior, so a rare persisting failure is a genuine outage, not a malformed request. The language comes from service, so lang has no effect here.
- Keywords
- statcan, geography, query, boundary, dguid, csd, da, fsa, cma, arcgis, geospatial, polygon, geojson, point in polygon, latitude longitude, census tract lookup, bounding box
- Mots-clés
- Statistique Canada, géographie, requête, limites, DGUID, SDR, AD, RTA, RMR, géospatial, polygone, GeoJSON, point dans un polygone, latitude et longitude, secteur de recensement, aire de diffusion, rectangle englobant
| Parameter | Type | Default |
|---|---|---|
year | str | required |
service | str | required |
layer_id | int | required |
where | str | "1=1" |
out_fields | str | "*" |
return_geometry | bool | false |
out_sr | int | 4326 |
result_offset | int | 0 |
result_record_count | int | 100 |
lat | float | null | null |
lon | float | null | null |
bbox | str | null | null |
distance_m | float | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_geo_query_layer", "arguments": {"year": "…", "service": "…", "layer_id": "…"}}statcan_geo_query_spatial_layer Query rows from the StatCan map-app datasets (infc, hna, qol) or the National Road Network.
Use for neighbourhood deprivation (Canadian Index of Multiple Deprivation) or proximity/access measures for the dissemination area at a lat/lon, the transit stops or facilities within distance_m metres of a point, housing-need and change-in-stock indicators for a municipality (hna), quality-of-life indicators by province, CMA, CSD or census division (qol), and road segments of a province by road class (nrn). layer_id comes from statcan_geo_list_spatial_layers; for "nrn" you can give province ("ON") and road_class ("Local roads") instead. Filter by attribute with where, by location with lat and lon (WGS84; the row whose area contains the point) or bbox ("min_lon,min_lat,max_lon,max_lat"), optionally distance_m as a radius around the point, and cut the columns with out_fields ("DAUID,DGUID"). Geometry is off by default. At most 2,000 rows come back per call (the services allow 2,000 to 50,000); page with result_offset while exceeded_transfer_limit is true. Undocumented infc/hna/qol endpoints, read from StatCan's map-app config at runtime (see provenance.limits); the NRN host answers HTTP 500 now and then and the client retries. Statistics Canada Open Licence. The tool's text is English only, so lang has no effect.
- Keywords
- statcan, deprivation index, cimd, proximity measures, spatial access, housing needs assessment, quality of life, transit stops, national road network, nrn, road segments, lat lon lookup, point in polygon, geoanalytics
- Mots-clés
- Statistique Canada, indice de défavorisation multiple, mesures de proximité, accès spatial, évaluation des besoins en logement, qualité de vie, arrêts de transport en commun, réseau routier national, segments routiers, latitude et longitude, point dans un polygone
| Parameter | Type | Default |
|---|---|---|
dataset | "infc" | "hna" | "qol" | "nrn" | required |
layer_id | int | null | null |
province | str | null | null |
road_class | str | null | null |
where | str | "1=1" |
out_fields | str | "*" |
return_geometry | bool | false |
out_sr | int | 4326 |
result_offset | int | 0 |
result_record_count | int | 100 |
lat | float | null | null |
lon | float | null | null |
bbox | str | null | null |
distance_m | float | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_geo_query_spatial_layer", "arguments": {"dataset": "…"}}Indicators 1
statcan_indicators_get_indicators Get current StatCan indicators (population, CPI, GDP, trade, etc.) with growth rates.
Use for quick current-value lookups for named indicators (e.g. "population", "consumer price index", "GDP", "unemployment rate") -- the same feeds that power My StatCan, statcan.gc.ca's home page, and The Daily's own indicator widgets. dataset="economic" is a curated subset of major economic indicators; "homepage" is the subset shown on StatCan's own home page; "all" covers every tracked indicator (2,362 confirmed live). Each result carries its reference period, a growth-rate summary versus the prior period, and a link to the Daily article that released it. geo_code filters to one geography using the feed's own numbering: 0 Canada, 1 NL, 2 PEI, 3 NS, 4 NB, 5 QC, 6 ON, 7 MB, 8 SK, 9 AB, 10 BC, 11 YT, 12 NT, 13 NU (so BC is 10, not the SGC code 59). A province SGC code the feed does not use (24, 35, 46, 47, 48, 59-62) is mapped for you and noted in provenance.limits; any other code is rejected with the valid list.
- Keywords
- StatCan, indicator, current value, latest statistics, growth rate, population, CPI, GDP, unemployment
- Mots-clés
- Statistique Canada, indicateur, valeur actuelle, dernières statistiques, taux de croissance, population, IPC, PIB, taux de chômage, emploi, inflation, indice des prix à la consommation
| Parameter | Type | Default |
|---|---|---|
dataset | "all" | "economic" | "homepage" | "all" |
query | str | "" |
geo_code | int | null | null |
lang | "en" | "fr" | "en" |
limit | int | 20 |
call_tool {"name": "statcan_indicators_get_indicators", "arguments": {}}Open databases (LODE): facilities, buildings, addresses 6
statcan_lode_describe Show a LODE database's fields, types, descriptions and ZIP contents.
Use for which columns a database has before querying: the record layout in the ZIP, a first-record sample, the GeoPackage schema (read when the archive is under 60 MB) and the product page's variable list.
- Keywords
- data dictionary, record layout, fields, columns, variables, schema, GeoPackage layers, facility type
- Mots-clés
- dictionnaire de données, disposition des enregistrements, champs, colonnes, variables, schéma, couches GeoPackage, type d'installation
| Parameter | Type | Default |
|---|---|---|
database | str | required |
file | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_lode_describe", "arguments": {"database": "…"}}statcan_lode_list_databases List the LODE open databases with versions and licences.
Use for which open facility, building and address datasets exist (healthcare ODHF, sports ODSRF, buildings ODB, schools ODEF, cultural ODCAF, addresses ODA) plus remoteness, proximity and the National Address Register. Returns keys for the other LODE tools.
- Keywords
- open database, LODE, healthcare facilities, hospitals, building footprints, schools, recreation facilities, remoteness, proximity
- Mots-clés
- base de données ouvertes, ECDO, établissements de santé, hôpitaux, empreintes d'immeubles, écoles, installations sportives, éloignement, proximité
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_lode_list_databases", "arguments": {}}statcan_lode_list_files List a LODE database's ZIP downloads with sizes, formats and provinces.
Use for download links, sizes and formats of one database key (odhf, odsrf, odb, odef, odcaf, oda, odi, pmd, remoteness, sam, nar), which file covers which province, and which can be queried. Sizes come from HEAD requests paced at 2 seconds each; sizes=false skips them.
- Keywords
- download links, ZIP, file size, GeoJSON, GeoPackage, CSV, GeoParquet, provinces, open licence, release date
- Mots-clés
- liens de téléchargement, fichier ZIP, taille du fichier, GeoJSON, GeoPackage, CSV, provinces, licence ouverte, date de diffusion
| Parameter | Type | Default |
|---|---|---|
database | str | required |
sizes | bool | true |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_lode_list_files", "arguments": {"database": "…"}}statcan_lode_list_zip List the files inside a LODE ZIP without downloading it (HTTP range).
Use for what a large archive holds, such as the National Address Register (1.67 GB, Locations and Addresses CSVs per province), the transit database, or any link from the file listing. Reads a few KB.
- Keywords
- National Address Register, NAR, ZIP contents, archive, address files, range request, large file, GTFS
- Mots-clés
- Registre national des adresses, RNA, contenu du ZIP, archive, fichiers d'adresses, requête par plage, gros fichier, GTFS
| Parameter | Type | Default |
|---|---|---|
url | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_lode_list_zip", "arguments": {"url": "…"}}statcan_lode_preview_member Read the first rows of a CSV inside a LODE ZIP, or look up rows, by HTTP range.
Use for peeking at National Address Register or Proximity Measures files without downloading the archive, or finding rows where a column equals a value (match, e.g. {"postal_code": "K1A0B1"}) within the first scan_mb MB (default 8, max 40) of the compressed member; small territories scan completely, large provinces only in part, and the result says so. url and member come from the ZIP listing.
- Keywords
- address lookup, National Address Register, NAR, postal code, preview rows, CSV member, range read, civic address
- Mots-clés
- recherche d'adresse, Registre national des adresses, RNA, code postal, aperçu des lignes, fichier CSV, lecture par plage, adresse civique
| Parameter | Type | Default |
|---|---|---|
url | str | required |
member | str | required |
match | dict[str, str] | null | null |
rows | int | 10 |
scan_mb | float | 8 |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_lode_preview_member", "arguments": {"url": "…", "member": "…"}}statcan_lode_query Query a LODE open database by province, place, type, name or bounding box.
Use for hospitals in Alberta (odhf, province AB, type Hospital), arenas in a city (odsrf), buildings in a bbox west,south,east,north (odb with province PE), schools (odef), museums (odcaf), addresses (oda), a community's remoteness (remoteness) or proximity (pmd). province takes AB, Alberta or 48; csd a name or 7-digit code; type exact, name substring, ignoring case and accents; filters match any column. Returns up to limit (max 500) records with WGS 84 coordinates, the total matched and the file read. First call downloads the ZIP to a disk cache (cap 300 MB, MAPLE_LODE_MAX_DOWNLOAD_MB); retry if it times out. odb and oda need province; file picks a ZIP, member a data file inside it.
- Keywords
- query open database, hospitals, clinics, pharmacies, schools, arenas, museums, building footprints, bounding box, census subdivision, facilities by type, remoteness, ODHF, ODSRF, ODB
- Mots-clés
- interroger base de données ouvertes, hôpitaux, cliniques, pharmacies, écoles, arénas, musées, empreintes d'immeubles, boîte englobante, subdivision de recensement, installations par type
| Parameter | Type | Default |
|---|---|---|
database | str | required |
province | str | null | null |
csd | str | null | null |
type | str | null | null |
name | str | null | null |
bbox | list[float] | null | null |
filters | dict[str, str] | null | null |
file | str | null | null |
member | str | null | null |
layer | str | null | null |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_lode_query", "arguments": {"database": "…"}}Public use microdata files (PUMF) 5
statcan_pumf_get_codebook Read a PUMF's variables, labels, value codes and weight variables.
Use for which variable measures something (query matches names, labels and value labels, e.g. "tenure", "smok"), what each code means, column positions for fixed-width files, and which weights to use (final and bootstrap/replicate). Reads only the codebook files inside the ZIP. url comes from statcan_pumf_list_files.
- Keywords
- codebook, data dictionary, variables, value labels, survey weights, bootstrap weights, record layout, PUMF
- Mots-clés
- dictionnaire de données, variables, étiquettes de valeurs, poids d'enquête, poids bootstrap, FMGD, disposition, Statistique Canada
| Parameter | Type | Default |
|---|---|---|
url | str | required |
query | str | null | null |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_pumf_get_codebook", "arguments": {"url": "…"}}statcan_pumf_list_files List a PUMF's free ZIP downloads (years, files and formats).
Use for the download links for one PUMF, e.g. 71M0001X (monthly LFS files by year) or 98M0001X (Census individuals and hierarchical files, 1991-2021). Next: statcan_pumf_get_codebook with a ZIP url.
- Keywords
- PUMF download, microdata file, ZIP, survey year, edition, catalogue number, Statistics Canada, year
- Mots-clés
- téléchargement FMGD, fichier de microdonnées, ZIP, année d'enquête, numéro de catalogue, édition, Statistique Canada, année
| Parameter | Type | Default |
|---|---|---|
catalogue_number | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_pumf_list_files", "arguments": {"catalogue_number": "…"}}statcan_pumf_list_zip List what is inside a PUMF ZIP without downloading it.
Use for seeing the data files, user guides and codebook files in a StatCan PUMF ZIP (read with HTTP range requests, a few KB), and their uncompressed sizes. File names are listed as stored in the ZIP, so lang has no effect.
- Keywords
- ZIP contents, PUMF files, user guide, record layout, codebook, data file size, data file, archive
- Mots-clés
- contenu du ZIP, fichiers FMGD, guide de l'utilisateur, dictionnaire de données, taille, disposition des enregistrements, fichier de données, archive ZIP
| Parameter | Type | Default |
|---|---|---|
url | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_pumf_list_zip", "arguments": {"url": "…"}}statcan_pumf_search Find Statistics Canada public use microdata files (PUMFs) by topic.
Use for which surveys publish respondent-level microdata on a topic (e.g. "health", "labour", "spending"), with catalogue numbers such as 71M0001X (Labour Force Survey) or 98M0001X (Census). Next: statcan_pumf_list_files for the downloads.
- Keywords
- PUMF, microdata, public use microdata file, survey microdata, respondent records, Labour Force Survey, CCHS, census
- Mots-clés
- FMGD, microdonnées, fichier de microdonnées à grande diffusion, données d'enquête, EPA, ESCC, recensement, Statistique Canada
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_pumf_search", "arguments": {}}statcan_pumf_tabulate Compute a weighted table from PUMF microdata (totals, shares or means).
Use for population estimates from survey microdata, e.g. labour force status by province from the LFS, or mean hourly earnings. rows are up to 3 codebook variables to group by; filters keep only the listed codes (e.g. {"PROV": ["48"]}); share gives percentages within each group of all but the last row variable. Uses the survey weight (default: the codebook's main weight) and returns unweighted counts, flagging small cells. Standard errors and CVs come from the survey's documented replicate weights where verified (2021 Census individuals). The first call downloads the file (may take a minute or two; retry if it times out).
- Keywords
- weighted estimate, tabulation, crosstab, microdata analysis, survey weight, population estimate, PUMF, LFS
- Mots-clés
- estimation pondérée, totalisation, tableau croisé, microdonnées, poids d'enquête, estimation de population, FMGD, Statistique Canada
| Parameter | Type | Default |
|---|---|---|
url | str | required |
rows | list[str] | required |
statistic | "total" | "share" | "mean" | "total" |
value_variable | str | null | null |
filters | dict[str, list[str]] | null | null |
weight | str | null | null |
data_file | str | null | null |
min_count | int | 30 |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_pumf_tabulate", "arguments": {"url": "…", "rows": "…"}}Classifications and concordances 11
rdaas_get_classification Get full detail for one StatCan classification: background, version, harmonization status, and its level structure.
Use for understanding a classification (e.g. NAICS) before drilling into its categories.
- Keywords
- statcan, classification, detail, naics, rdaas, levels, version, background
- Mots-clés
- Statistique Canada, classification, détail, SCIAN, CNP, niveaux hiérarchiques, version, structure de la classification, norme statistique
| Parameter | Type | Default |
|---|---|---|
classification_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "rdaas_get_classification", "arguments": {"classification_id": "…"}}rdaas_get_classification_categories_detailed Get the detailed category tree for one classification.
Use for listing every code/category within a classification (e.g. all NAICS sectors and subsectors). Paged: limit (default 100, max 1000) and offset; query keeps categories whose code or descriptor contains the text. total_count and provenance.limits say what was left out. Confirmed live: RDaaS itself returns no category data for the CURRENT released NAICS (2022.1.0) specifically -- retired NAICS versions and the NAICS Trade Variant return full data, so this is not a NAICS-wide gap. If you hit this empty case on current NAICS, use rdaas_get_concordance_maps on the "NAICS Canada 2017.3.0 to 2022.1.0" concordance instead -- its target_code/target_descriptor fields are the same current-NAICS codes and descriptions.
- Keywords
- statcan, classification, categories, codes, naics, rdaas, tree, detailed
- Mots-clés
- Statistique Canada, classification, catégories, codes, SCIAN, CNP, arborescence, hiérarchie, liste détaillée des codes
| Parameter | Type | Default |
|---|---|---|
classification_id | str | required |
query | str | "" |
limit | int | 100 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "rdaas_get_classification_categories_detailed", "arguments": {"classification_id": "…"}}rdaas_get_classification_exclusions Get documented exclusions (terms explicitly NOT covered) for one classification.
Use for checking whether a term is deliberately excluded from a classification rather than simply missing.
- Keywords
- statcan, exclusions, classification, rdaas, excluded, terms, naics, Statistics Canada
- Mots-clés
- Statistique Canada, exclusions, classification, termes exclus, activités exclues, SCIAN, CNP, non couvert
| Parameter | Type | Default |
|---|---|---|
classification_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "rdaas_get_classification_exclusions", "arguments": {"classification_id": "…"}}rdaas_get_classification_index_entry Get one specific index entry by its small integer index_id (not its @id URL — use the indexId field from rdaas_get_classification_indexes).
Use for retrieving a single term-to-code mapping already identified via rdaas_get_classification_indexes.
- Keywords
- statcan, index entry, classification, rdaas, term, code, Statistics Canada, NAICS
- Mots-clés
- Statistique Canada, entrée d'index, titre d'index, classification, terme, code, correspondance, identifiant, appellation
| Parameter | Type | Default |
|---|---|---|
classification_id | str | required |
index_id | int | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "rdaas_get_classification_index_entry", "arguments": {"classification_id": "…", "index_id": "…"}}rdaas_get_classification_indexes List all index entries (alternate terms mapped to a code) for one classification.
Use for finding which code a plain-language term maps to. Pass query (matches the term or the code description) -- the NAICS 2022 index has tens of thousands of entries (8 MB), so the list is paged: limit (default 100, max 1000) and offset; total_count and provenance.limits say what was left out.
- Keywords
- statcan, index, classification, rdaas, terms, alternate names, naics, Statistics Canada
- Mots-clés
- Statistique Canada, index, classification, termes, appellations, titres d'index, SCIAN, CNP, correspondance de termes
| Parameter | Type | Default |
|---|---|---|
classification_id | str | required |
query | str | "" |
limit | int | 100 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "rdaas_get_classification_indexes", "arguments": {"classification_id": "…"}}rdaas_get_concordance Get detail for one concordance: its source and target classifications.
Use for confirming which two classification versions a concordance connects before requesting its code maps.
- Keywords
- statcan, concordance, detail, rdaas, source, target, classification, Statistics Canada
- Mots-clés
- Statistique Canada, concordance, détail, classification source, classification cible, correspondance, versions, SCIAN
| Parameter | Type | Default |
|---|---|---|
concordance_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "rdaas_get_concordance", "arguments": {"concordance_id": "…"}}rdaas_get_concordance_maps Get the full code-to-code mapping table for one concordance.
Use for converting a code from one classification version to its equivalent(s) in another version.
- Keywords
- statcan, code map, concordance, rdaas, mapping, convert, naics, Statistics Canada
- Mots-clés
- Statistique Canada, correspondance de codes, concordance, conversion, SCIAN, table de conversion, codes, passage d'une version à l'autre
| Parameter | Type | Default |
|---|---|---|
concordance_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "rdaas_get_concordance_maps", "arguments": {"concordance_id": "…"}}rdaas_get_search_filters Get the valid audience/status filter values for classification or concordance search (`kind`).
Use for discovering what values audience/status accept; pass them as the audience/status arguments of rdaas_search_classifications or rdaas_search_concordances.
- Keywords
- statcan, rdaas, filters, search, audience, status, classification, concordance, Statistics Canada
- Mots-clés
- Statistique Canada, filtres de recherche, public cible, statut, classification, concordance, valeurs valides, critères de recherche, normes statistiques
| Parameter | Type | Default |
|---|---|---|
kind | "classification" | "concordance" | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "rdaas_get_search_filters", "arguments": {"kind": "…"}}rdaas_get_term_exclusion Get one term-exclusion record by id.
Use for retrieving detail on a specific excluded term identified elsewhere.
- Keywords
- statcan, term exclusion, rdaas, excluded, definition, lookup, classification, reference data
- Mots-clés
- Statistique Canada, exclusion de terme, terme exclu, activité exclue, définition, recherche, classification, données de référence
| Parameter | Type | Default |
|---|---|---|
term_exclusion_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "rdaas_get_term_exclusion", "arguments": {"term_exclusion_id": "…"}}rdaas_search_classifications Search StatCan's classifications (e.g. NAICS, the Standard Geographical Classification, occupational classifications).
Use for finding the classification id for a topic before requesting its full detail, categories, or concordances. audience and status (lists) filter results; valid values come from rdaas_get_search_filters (e.g. status ["RELEASED"] for current versions only).
- Keywords
- statcan, naics, classification, search, rdaas, standard, geographical, occupational, codes, NOC, national occupational classification, occupation, SOC, industry classification
- Mots-clés
- Statistique Canada, classification, recherche, SCIAN, codes SCIAN, Système de classification des industries de l'Amérique du Nord, CNP, codes de professions, Classification nationale des professions, Classification géographique type, CGT, norme de classification, profession, métier
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
start | int | 0 |
limit | int | 10 |
audience | list[str] | null | null |
status | list[str] | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "rdaas_search_classifications", "arguments": {}}rdaas_search_concordances Search StatCan's concordances: correspondence tables between two classification versions (e.g. NAICS 2012 to NAICS 2017).
Use for finding a concordance id before requesting its code maps. audience and status (lists) filter results; valid values come from rdaas_get_search_filters.
- Keywords
- statcan, concordance, correspondence, rdaas, naics, version, mapping, Statistics Canada
- Mots-clés
- Statistique Canada, concordance, tableau de correspondance, SCIAN, version, conversion de codes, recherche, passage entre versions
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
start | int | 0 |
limit | int | 10 |
audience | list[str] | null | null |
status | list[str] | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "rdaas_search_concordances", "arguments": {}}Definitions, methods and analysis 3
statcan_reference_search_analysis Search StatCan's Analysis catalogue: analytical articles, journals and periodicals.
Use for finding analytical publications, "Stats in brief" (many of these are also Daily articles republished with a catalogue number), and journal/periodical series -- distinct from statcan_reference_search_documents (methodology/definitions catalogue), from actual data (WDS/SDMX/RDaaS), and from The Daily's release bulletin (statcan_daily_*). Covers 10,841+ documents. Each result carries a catalogue number (e.g. "46-28-0001"), a category (e.g. "Journals and periodicals"), a description, and a release date. An empty query returns the full unfiltered catalogue (paginate with page/count to browse it).
- Keywords
- StatCan, analysis, analytical article, stats in brief, journal, periodical, working paper, insights
- Mots-clés
- Statistique Canada, analyse, article analytique, coup d'œil sur, revue, périodique, document de travail, études
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
lang | "en" | "fr" | "en" |
count | int | 10 |
page | int | 0 |
call_tool {"name": "statcan_reference_search_analysis", "arguments": {}}statcan_reference_search_data Search StatCan's Data catalogue: tables plus PUMFs, geographic and other bulk files.
Use for finding a data product's catalogue number, especially one with no WDS/SDMX discovery path of its own -- most notably Public Use Microdata Files (PUMFs; category "Public use microdata", e.g. catalogue number 71M0001X for the Labour Force Survey PUMF, 98M0001X for the Census). Most other results here are ordinary table PIDs also reachable via statcan_wds_*/statcan_sdmx_*, so prefer those tools for routine table search -- use this one when the product itself (a PUMF, a boundary file, a bulk archive) is the target, not a table's time series. Covers 13,342+ items. For a PUMF, pass its catalogue_number to statcan_pumf_list_files for the download ZIPs. An empty query returns the full unfiltered catalogue (paginate with page/count to browse it).
- Keywords
- StatCan, PUMF, public use microdata file, geographic boundary file, bulk data, data product, Statistics Canada, download
- Mots-clés
- Statistique Canada, FMGD, fichier de microdonnées à grande diffusion, fichier de limites géographiques, données en bloc, produit de données, téléchargement, cartes géographiques
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
lang | "en" | "fr" | "en" |
count | int | 10 |
page | int | 0 |
call_tool {"name": "statcan_reference_search_data", "arguments": {}}statcan_reference_search_documents Search StatCan's Reference resources catalogue: definitions, data sources, and methods.
Use for finding methodology guides, technical reference documents, survey documentation, geographic file specifications, and other "Definitions, data sources and methods"-style publications -- distinct from actual data (WDS/SDMX/RDaaS) and from The Daily's release bulletin (statcan_daily_*). Covers 2,031 documents. Each result carries a catalogue number (e.g. "16-511-X"), a category (e.g. "Surveys and statistical programs – Documentation", "Geographic files and documentation"), a description, and a release date. An empty query returns the full unfiltered catalogue (paginate with page/count to browse it).
- Keywords
- StatCan, definitions, data sources and methods, DSDM, methodology, technical reference guide, survey documentation, catalogue number
- Mots-clés
- Statistique Canada, définitions, sources de données et méthodes, méthodologie, guide de référence technique, documentation d'enquête, numéro au catalogue, publications techniques
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
lang | "en" | "fr" | "en" |
count | int | 10 |
page | int | 0 |
call_tool {"name": "statcan_reference_search_documents", "arguments": {}}Sustainable Development Goals 3
statcan_sdg_get_indicator_data Get one SDG indicator's observations (year, value, and any disaggregations).
Use for retrieving an SDG indicator's actual time series. Each observation's disaggregations field carries whatever breakdown columns that specific indicator publishes (e.g. Geography, Pillar) -- these vary per indicator and are not fixed across the framework, confirmed live. Rows are capped at limit (default 200, max 2000; some indicators have 6,000+ rows): narrow with start_year/end_year or filters (column name -> exact value, e.g. {"Geography": "Alberta"}) and page with offset; provenance.limits says when rows were left out. A Global-framework indicator Canada does not report returns zero observations.
- Keywords
- statcan, SDG, indicator data, time series, sustainable development goals, observations, Statistics Canada, indicator values
- Mots-clés
- ODD, données d'indicateur, série chronologique, objectifs de développement durable, observations, Statistique Canada, valeurs de l'indicateur, Programme 2030
| Parameter | Type | Default |
|---|---|---|
framework | "canada" | "global" | required |
code | str | required |
lang | "en" | "fr" | "en" |
limit | int | 200 |
offset | int | 0 |
start_year | int | null | null |
end_year | int | null | null |
filters | dict[str, str] | null | null |
call_tool {"name": "statcan_sdg_get_indicator_data", "arguments": {"framework": "…", "code": "…"}}statcan_sdg_get_indicator_metadata Get one SDG indicator's goal/target, description, units, and data sources.
Use for understanding what an indicator (e.g. "12-1-1") actually measures before requesting its data with statcan_sdg_get_indicator_data. code comes from statcan_sdg_search_indicators; the same code can mean a different indicator in the "canada" vs. "global" framework, so pass the same framework used to find it.
- Keywords
- statcan, SDG, indicator metadata, goal, target, definition, source, sustainable development
- Mots-clés
- Statistique Canada, ODD, métadonnées d'indicateur, objectif, cible, définition, source, développement durable
| Parameter | Type | Default |
|---|---|---|
framework | "canada" | "global" | required |
code | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_sdg_get_indicator_metadata", "arguments": {"framework": "…", "code": "…"}}statcan_sdg_search_indicators Search StatCan's Sustainable Development Goals indicators by name.
Use for finding an indicator's code before requesting its metadata or data. framework selects which indicator set: "canada" (86 indicators, Canada's own national reporting framework) or "global" (251 indicators, Canada's reporting against the UN's own Global Indicator Framework) -- distinct, differently-numbered indicator sets on the same "Open SDG" platform, confirmed live; pick the one matching what the caller means by "SDG indicator X.Y.Z". Leave query empty to list every indicator in that framework. This data has no WDS/SDMX cube/PID equivalent -- it is not otherwise reachable through any other tool in this codebase.
- Keywords
- statcan, SDG, sustainable development goals, indicator, UN, 2030 agenda, goal, target
- Mots-clés
- Statistique Canada, ODD, objectifs de développement durable, indicateur, ONU, Programme 2030, objectif, cible, Carrefour de données des ODD
| Parameter | Type | Default |
|---|---|---|
framework | "canada" | "global" | required |
query | str | "" |
lang | "en" | "fr" | "en" |
limit | int | 10 |
call_tool {"name": "statcan_sdg_search_indicators", "arguments": {"framework": "…"}}SDMX API: filtered series 4
sdmx_get_data Get filtered, server-side-sliced observations for a StatCan table.
Use for fetching only the dimension combination you need rather than the full table. key is a dot-separated string of member ids, one per non-time dimension, in dimension-position order (empty segment = wildcard; use sdmx_get_key_for_dimension instead of a wildcard on a >30-code dimension). With no period arguments the LATEST 100 observations per series are returned (not the oldest); pass last_n_observations for another count or start_period/end_period (e.g. 2024-01) for a range -- the two cannot be combined. Each series keeps at most 500 newest rows and a response at most 200 series; provenance.limits records any cut.
- Keywords
- statcan, sdmx, data, filtered, key, dimensions, query, observations, slice
- Mots-clés
- Statistique Canada, SDMX, données filtrées, clé, dimensions, requête, observations, extraction, série chronologique
| Parameter | Type | Default |
|---|---|---|
product_id | int | required |
key | str | required |
start_period | str | null | null |
end_period | str | null | null |
last_n_observations | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "sdmx_get_data", "arguments": {"product_id": "…", "key": "…"}}sdmx_get_key_for_dimension Build a complete OR key covering every leaf code of one dimension.
Use for querying a dimension with more than ~30 codes (e.g. detailed geography or industry) — StatCan's SDMX API returns a sparse, unpredictable sample if that dimension is left wildcarded instead. Splice the returned or_key into the dot-separated key at this dimension's position before calling sdmx_get_data.
- Keywords
- statcan, sdmx, wildcard, or key, large dimension, leaf codes, sparse sample, geography, wildcard dimension
- Mots-clés
- Statistique Canada, SDMX, caractère de remplacement, clé partielle, plusieurs codes, grande dimension, codes terminaux, échantillon partiel, géographie, membres de dimension
| Parameter | Type | Default |
|---|---|---|
product_id | int | required |
dimension_position | int | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "sdmx_get_key_for_dimension", "arguments": {"product_id": "…", "dimension_position": "…"}}sdmx_get_structure Get the SDMX dimension structure for a StatCan table: each non-time dimension's codelist, with parent/child code relationships.
Use for understanding a table's dimensions before building an SDMX query key, or before calling sdmx_get_key_for_dimension on a large dimension. Codes are paged per dimension (limit default 100, offset); code_query keeps codes whose name contains the text and dimension_position returns a single dimension; each dimension's code_count is its full size and provenance.limits says what was left out. If StatCan's SDMX structure document is empty or cut off (some Labour Force Survey tables), the structure is built from WDS metadata instead, with identical member ids.
- Keywords
- statcan, sdmx, structure, dimensions, codelist, dsd, keys, Statistics Canada
- Mots-clés
- Statistique Canada, SDMX, structure, dimensions, liste de codes, définition de structure de données, clés, classification, membres
| Parameter | Type | Default |
|---|---|---|
product_id | int | required |
dimension_position | int | null | null |
code_query | str | "" |
limit | int | 100 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "sdmx_get_structure", "arguments": {"product_id": "…"}}sdmx_get_vector_data Get filtered SDMX observations for a known vector ID.
Use for fetching one specific series via SDMX when you already have its vector ID (resolves the vector to a productId/coordinate internally, then builds the matching SDMX key).
- Keywords
- statcan, sdmx, vector, data, observations, series, query, Statistics Canada
- Mots-clés
- Statistique Canada, SDMX, vecteur, données, observations, série, requête, identifiant de vecteur, série chronologique
| Parameter | Type | Default |
|---|---|---|
vector_id | int | required |
start_period | str | null | null |
end_period | str | null | null |
last_n_observations | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "sdmx_get_vector_data", "arguments": {"vector_id": "…"}}SDMX spaces: energy information and shared data 4
sdmx_space_get_data Get observations from a dataflow of the CCEI (energy) or shared SDMX space, as series with their attributes (SDMX-CSV 2.0).
Use for ECCC National Inventory greenhouse gas emissions by province and IPCC category, GHG projections, air pollutants, NRCan energy efficiency indicators, ISC long-term advisories, CITH internal trade. key has one segment per dimension in key_order order (see sdmx_space_get_structure), '+' for several codes, empty for a wildcard: A.CA_AB.0.CO2EQ. A whole large flow ("all", or only wildcards) is refused because the service times out; filter at least one dimension. With no period argument the LATEST 12 observations per series are returned; last_n_observations changes that, start_period/end_period (2020, 2020-03, 2020-Q1) give a range. Caps: 500 rows per series (newest kept), 200 series, max_rows (default 1000, max 5000) in total; provenance.limits records any cut. Flows are NonProduction annotated.
- Keywords
- statcan, sdmx, data, observations, ccei, greenhouse gas, emissions, projections, air pollutants, ISC advisories, internal trade
- Mots-clés
- Statistique Canada, SDMX, données, observations, CCIE, gaz à effet de serre, émissions, projections, polluants atmosphériques, avis sur l'eau potable, commerce intérieur
| Parameter | Type | Default |
|---|---|---|
flow | str | required |
key | str | required |
space | "ccei" | "stcshared" | "ccei" |
start_period | str | null | null |
end_period | str | null | null |
last_n_observations | int | null | null |
max_rows | int | 1000 |
lang | "en" | "fr" | "en" |
call_tool {"name": "sdmx_space_get_data", "arguments": {"flow": "…", "key": "…"}}sdmx_space_get_structure Browse one dataflow of the CCEI or shared SDMX space: its dimensions in key order, the codes that have data, the period range and the size.
Use for building a key for sdmx_space_get_data. flow is a dataflow id (GHG_IPCC_TABLE), agency,id (CCEI,GHG_IPCC_TABLE) or agency,id,version. key_order lists the dimensions as the dot-separated key expects them. Each dimension's codes are only those with data (codelist_size is the whole codelist) and are paged by limit/offset; dimension returns one dimension and code_query keeps codes whose name contains the text (for example Alberta, or CO2). Also gives start_period, end_period and the observation count. Flagged non_production for every flow so far.
- Keywords
- statcan, sdmx, structure, dimensions, codes, codelist, key, ccei, energy information, dataflow, availability
- Mots-clés
- Statistique Canada, SDMX, structure, dimensions, codes, liste de codes, clé, CCIE, information sur l'énergie, flux de données, disponibilité
| Parameter | Type | Default |
|---|---|---|
flow | str | required |
space | "ccei" | "stcshared" | "ccei" |
dimension | str | "" |
code_query | str | "" |
limit | int | 100 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "sdmx_space_get_structure", "arguments": {"flow": "…"}}sdmx_space_list_flows List the dataflows of one of Statistics Canada's extra SDMX spaces: `ccei` (Canadian Centre for Energy Information, 245 flows) or `stcshared` (shared space, 238 flows), filtered by words and agency.
Use for finding a dataflow id in the energy information space (ECCC greenhouse gas inventory and projections, air pollutants, black carbon, NRCan energy efficiency indicators) or the shared space (CITH internal trade, quality of life, rural, PCEIP education and employment, MEA, ISC advisories). query needs every word in the id, name or description; agency is e.g. CCEI, STC, CA1.CCEI, CITH, QOL, PCEIP, RURAL, MEA. Returns flow (agency,id,version) to pass to sdmx_space_get_structure and sdmx_space_get_data. Unlike sdmx_space_search it sees every flow, including QOL and MEA. Every flow is annotated NonProductionDataflow; provenance.licence carries the Statistics Canada Open Licence note and the partner-department caveat. The main table service is sdmx_get_data.
- Keywords
- statcan, sdmx, ccei, energy information, greenhouse gas, dataflows, stcshared, CITH, internal trade, ISC advisories, ECCC, NRCan
- Mots-clés
- Statistique Canada, SDMX, CCIE, information sur l'énergie, gaz à effet de serre, flux de données, commerce intérieur, avis sur l'eau potable, qualité de vie, ECCC, RNCan
| Parameter | Type | Default |
|---|---|---|
space | "ccei" | "stcshared" | "ccei" |
query | str | "" |
agency | str | "" |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "sdmx_space_list_flows", "arguments": {}}sdmx_space_search Full-text and facet search over the dataflows of Statistics Canada's CCEI (energy) and shared SDMX spaces, using the sdmx-sfs search service.
Use for finding a dataflow by topic words, such as greenhouse gas emissions by province, GHG projections, air pollutants, black carbon, energy efficiency, electricity, internal trade or rural indicators. Hits give flow (agency,id,version), the dimension names and last update; facets lists topic, geography and frequency values with a filter_value to pass back in filters (for example {"Frequency": ["0|Annual#A#"]}). tenant narrows the shared space to rural, cith or pceip. Only indexed flows are searched (122 of 245 in ccei; none of QOL or MEA in stcshared): use sdmx_space_list_flows for the rest. limit + offset is capped at 50.
- Keywords
- statcan, sdmx, search, ccei, energy, greenhouse gas, emissions, air pollutants, black carbon, energy efficiency, facets, dataflows
- Mots-clés
- Statistique Canada, SDMX, recherche, CCIE, énergie, gaz à effet de serre, émissions, polluants atmosphériques, carbone noir, efficacité énergétique, facettes, flux de données
| Parameter | Type | Default |
|---|---|---|
query | str | required |
space | "ccei" | "stcshared" | "ccei" |
tenant | "ccei" | "rural" | "cith" | "pceip" | null | null |
filters | dict[str, list[str]] | null | null |
limit | int | 10 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "sdmx_space_search", "arguments": {"query": "…"}}Surveys, metadata and microdata holdings (RDC, RTRA) 4
statcan_surveys_get_survey_metadata Get a survey's IMDB metadata: status, frequency, description, and subjects.
Use for the genuine "Definitions, data sources and methods" content for one specific survey or statistical program -- its active/inactive status, collection frequency, a plain-language description, and its subject classifications -- found via statcan_surveys_search_surveys. This comes from IMDB (Integrated Metadata Base), a separate, older system from the Reference/ Analysis catalogues; its full methodology sections (target population, sampling, data sources, data accuracy) are linked via detail_url rather than fully parsed here, since they are long prose sections better read directly than flattened into fields.
- Keywords
- StatCan, IMDB, survey metadata, methodology, target population, data quality, survey status, survey frequency
- Mots-clés
- Statistique Canada, BMDI, métadonnées d'enquête, méthodologie, population cible, statut de l'enquête, fréquence, description de l'enquête
| Parameter | Type | Default |
|---|---|---|
survey_id | int | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "statcan_surveys_get_survey_metadata", "arguments": {"survey_id": "…"}}statcan_surveys_search_rdc_holdings Search the microdata held at StatCan's Research Data Centres (RDCs).
Use for "is survey X available in a Research Data Centre, and which cycles?" -- the official holdings list (about 350 rows: survey or linked file, cycles or years held, acronym, IMDB record number). The record number is the id of statcan_surveys_get_survey_metadata, so each holding links to its survey record (detail_url); several linked files share the generic number 8006, which names no survey. This lists what exists, not data: RDC use needs an approved project and security clearance. query needs every word to appear in the name, acronym, cycles or record number (accents ignored). For the remote option see statcan_surveys_search_rtra_datasets; public files are statcan_pumf_search.
- Keywords
- Research Data Centre, RDC, Canadian RDC Network, microdata holdings, restricted microdata, linked data, secure access, survey cycles, T1 Family File, Canadian Community Health Survey, record number
- Mots-clés
- Centre de données de recherche, CDR, microdonnées détaillées, fichiers couplés, accès sécurisé, cycles d'enquête, numéro d'enregistrement, Statistique Canada, données de recherche, enquête
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
lang | "en" | "fr" | "en" |
limit | int | 20 |
call_tool {"name": "statcan_surveys_search_rdc_holdings", "arguments": {}}statcan_surveys_search_rtra_datasets Search datasets offered through StatCan's Real Time Remote Access (RTRA).
Use for the settings of each RTRA dataset (about 360 rows from 70 surveys and administrative sources): tag name used in the RTRA program, dataset name, rounding base for counts, weight variable, and the variables deleted from the remote version, plus links to the IMDB survey records (sdds_id is the id of statcan_surveys_get_survey_metadata; instance_id is one cycle's page). deleted_variable keeps datasets that remove a given variable code (e.g. "PROVBIR"). query needs every word to appear in the survey, cycle, tag, dataset or weight name. RTRA lets registered users run SAS or Stata code on StatCan's server and get rounded output; this lists the setup, not data. For secure on-site access see statcan_surveys_search_rdc_holdings.
- Keywords
- Real Time Remote Access, RTRA, remote access, rounding base, weight variable, deleted variables, disclosure control, microdata, tag name, Canadian Community Health Survey, Canadian Cancer Registry
- Mots-clés
- Système d'accès à distance en temps réel, ADTR, accès à distance, base d'arrondissement, variable de pondération, variables supprimées, contrôle de la divulgation, microdonnées, préfixe, Statistique Canada
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
lang | "en" | "fr" | "en" |
deleted_variable | str | null | null |
limit | int | 20 |
call_tool {"name": "statcan_surveys_search_rtra_datasets", "arguments": {}}statcan_surveys_search_surveys Search StatCan's A-Z directory of surveys and statistical programs (~899 confirmed live).
Use for finding a survey's numeric ID (needed by statcan_surveys_get_survey_metadata) by name -- covers both active and inactive/discontinued surveys and statistical programs. Distinct from statcan_reference_search_documents/search_analysis (documents about surveys) and from statcan_daily_* (release bulletin) -- this is the master list of the surveys/programs themselves. An empty query returns the full directory.
- Keywords
- StatCan, survey, statistical program, survey directory, survey ID, Statistics Canada, data source, survey list
- Mots-clés
- Statistique Canada, enquête, programme statistique, répertoire des enquêtes, numéro d'enquête, source de données, liste des enquêtes, enquêtes statistiques
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
lang | "en" | "fr" | "en" |
limit | int | 20 |
call_tool {"name": "statcan_surveys_search_surveys", "arguments": {}}Web Data Service: tables and vectors 12
wds_get_bulk_vector_data_by_range Get observations for multiple vectors released within a date range.
Use for bulk historical retrieval across several series at once, filtered by release date (not reference period). start_release_datetime/end_release_datetime are "YYYY-MM-DDTHH:MM" (e.g. "2024-01-01T08:30"); a bare date is widened to the start/end of that day. Vectors WDS cannot serve are listed in failed.
- Keywords
- statcan, bulk, vectors, date range, release date, history, wds, Statistics Canada
- Mots-clés
- Statistique Canada, extraction en bloc, vecteurs, plusieurs vecteurs, plage de dates, date de diffusion, historique, séries chronologiques
| Parameter | Type | Default |
|---|---|---|
vector_ids | list[int] | required |
start_release_datetime | str | required |
end_release_datetime | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "wds_get_bulk_vector_data_by_range", "arguments": {"vector_ids": "…", "start_release_datetime": "…", "end_release_datetime": "…"}}wds_get_changed_cube_list List StatCan tables (cubes) that changed on a given date.
Use for detecting which tables were updated, e.g. after the daily 8:30am ET release. date is YYYY-MM-DD (default: today, Eastern).
- Keywords
- statcan, changed, updated, cube, table, release, today, wds
- Mots-clés
- Statistique Canada, tableaux modifiés, mises à jour, tableau, diffusion, aujourd'hui, actualisation, nouvelles données
| Parameter | Type | Default |
|---|---|---|
date | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "wds_get_changed_cube_list", "arguments": {}}wds_get_changed_series_data Get just the newly-changed data points for one series, identified by vector ID or by table + coordinate.
Use for fetching only what changed rather than the full latest-N window, after wds_get_changed_series_list flags a vector. Pass exactly one form: vector_id, or product_id + coordinate (resolved to its vector first, so the series always belongs to that table). A series that did not change today gives a "nothing found" error.
- Keywords
- statcan, changed, vector, coordinate, delta, updated data, wds, Statistics Canada, revisions
- Mots-clés
- Statistique Canada, données modifiées, vecteur, coordonnée, écart, données mises à jour, série, changements, tableau, révisions
| Parameter | Type | Default |
|---|---|---|
vector_id | int | null | null |
product_id | int | str | null | null |
coordinate | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "wds_get_changed_series_data", "arguments": {}}wds_get_changed_series_list List StatCan series that changed (new release) today.
Use for detecting updated series for a scheduled refresh. WDS documents this method as always reflecting today's changes — it does not accept a date parameter (unlike wds_get_changed_cube_list).
- Keywords
- statcan, changed, updated, series, release, today, wds, refresh
- Mots-clés
- Statistique Canada, séries modifiées, mises à jour, série, diffusion, aujourd'hui, actualisation, nouvelles données
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "wds_get_changed_series_list", "arguments": {}}wds_get_code_sets Get StatCan's code-set descriptions: scalar factors, frequency, symbol, status, unit of measure, survey, subject, classification type, security level, and terminated codes.
Use for decoding any numeric code returned by another WDS tool, e.g. a scalarFactorCode, frequencyCode or subject code. The full set is ~300 kB, so each category returns at most limit entries (default 100); pick one category and/or filter descriptions with query. counts gives each category's full size.
- Keywords
- statcan, code sets, decode, scalar factor, frequency, symbol, status, uom, subject, survey, wds, lookup
- Mots-clés
- Statistique Canada, ensembles de codes, décoder, facteur d'échelle, fréquence, symbole, statut, unité de mesure, sujet, enquête, référence
| Parameter | Type | Default |
|---|---|---|
category | "scalar" | "frequency" | "symbol" | "status" | "uom" | "survey" | "subject" | "classification_type" | "security_level" | "terminated" | null | null |
query | str | null | null |
limit | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "wds_get_code_sets", "arguments": {}}wds_get_cube_metadata Get metadata for one StatCan table: dimensions, member trees, frequency, date range, and footnotes.
Use for understanding a table's structure before requesting data, finding the member IDs that make up a coordinate. product_id is the 8-digit productId or the table number (18-10-0004, 18-10-0004-01). Large tables have thousands of members, so each dimension returns at most member_limit members (default 100) and footnotes are capped at footnote_limit; provenance.limits says what was cut. Narrow with dimension (a position, e.g. 1 for geography), member_query (words in a member name) and member_offset.
- Keywords
- statcan, metadata, dimensions, members, productId, cube, structure, footnotes, wds, coordinate, table number
- Mots-clés
- Statistique Canada, métadonnées, dimensions, membres, structure du tableau, notes de bas de page, coordonnée, numéro de tableau, description du tableau
| Parameter | Type | Default |
|---|---|---|
product_id | int | str | required |
dimension | int | null | null |
member_query | str | null | null |
member_limit | int | 100 |
member_offset | int | 0 |
footnote_limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "wds_get_cube_metadata", "arguments": {"product_id": "…"}}wds_get_data_by_reference_period_range Get observations for vectors between two dates (a time series for a vector over a reference-period range).
Use for retrieving a specific historical window (e.g. 2015-01-01 to 2020-12-01) rather than "latest N." start_ref_period/end_ref_period are "YYYY-MM-DD"; a "YYYY-MM" month is widened to its first/last day. Vectors WDS cannot serve are listed in failed.
- Keywords
- statcan, reference period, range, between two dates, time series for a vector, history, vectors, wds, date range, Statistics Canada
- Mots-clés
- Statistique Canada, période de référence, plage, plage de dates, historique, vecteurs, données historiques, série chronologique entre deux dates
| Parameter | Type | Default |
|---|---|---|
vector_ids | list[int] | required |
start_ref_period | str | required |
end_ref_period | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "wds_get_data_by_reference_period_range", "arguments": {"vector_ids": "…", "start_ref_period": "…", "end_ref_period": "…"}}wds_get_data_from_cube_coord Get the latest N observations for a table + coordinate pair.
Use for fetching data when you have a productId/coordinate but not yet the vector ID.
- Keywords
- statcan, coordinate, observations, latest, data, wds, productId, Statistics Canada
- Mots-clés
- Statistique Canada, coordonnée, observations, dernières données, données récentes, numéro de tableau, tableau, dernières périodes
| Parameter | Type | Default |
|---|---|---|
product_id | int | str | required |
coordinate | str | required |
latest_n | int | 12 |
lang | "en" | "fr" | "en" |
call_tool {"name": "wds_get_data_from_cube_coord", "arguments": {"product_id": "…", "coordinate": "…"}}wds_get_data_from_vectors Get the latest N observations for one or more StatCan vectors.
Use for fetching recent values of one or more known time series. Vectors WDS cannot serve are listed in failed; the others still come back. Note: scalarFactorCode in each observation is NOT pre-applied to value: multiply value by the observation's scale_multiplier if a scaled figure is needed.
- Keywords
- statcan, vector, observations, latest, data, time series, wds, values
- Mots-clés
- Statistique Canada, vecteur, observations, dernières données, données récentes, série chronologique, valeurs, dernières périodes
| Parameter | Type | Default |
|---|---|---|
vector_ids | list[int] | required |
latest_n | int | 12 |
lang | "en" | "fr" | "en" |
call_tool {"name": "wds_get_data_from_vectors", "arguments": {"vector_ids": "…"}}wds_get_full_table_download Get the download URL for a full StatCan table as CSV (default) or SDMX/XML (`format="sdmx"`).
Use for bulk/offline analysis of an entire table rather than individual series, in CSV or SDMX format — hands back a URL, does not fetch the file. lang picks the CSV language edition. An unknown table number is an error, not a dead link.
- Keywords
- statcan, csv, sdmx, xml, download, full table, bulk, export, wds, Statistics Canada
- Mots-clés
- Statistique Canada, CSV, SDMX, XML, téléchargement, tableau complet, téléchargement en bloc, exportation, données complètes, fichier du tableau
| Parameter | Type | Default |
|---|---|---|
product_id | int | str | required |
format | "csv" | "sdmx" | "csv" |
lang | "en" | "fr" | "en" |
call_tool {"name": "wds_get_full_table_download", "arguments": {"product_id": "…"}}wds_get_series_info Resolve a StatCan series either way: a vector ID to its productId and coordinate, or a productId + coordinate to its stable vector ID.
Use for figuring out which table and dimension-position a known vector belongs to, or converting a table/dimension-position pair (from wds_get_cube_metadata) into a vector ID for later reuse. Pass exactly one form: vector_id, or product_id + coordinate. Also returns the series title, frequency, decimals, scalar factor and unit-of-measure codes.
- Keywords
- statcan, vector, coordinate, resolve, productId, series info, wds, Statistics Canada, conversion, identifier
- Mots-clés
- Statistique Canada, vecteur, coordonnée, résoudre, conversion, information de série, identifiant de série, numéro de tableau, numéro de vecteur
| Parameter | Type | Default |
|---|---|---|
vector_id | int | null | null |
product_id | int | str | null | null |
coordinate | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "wds_get_series_info", "arguments": {}}wds_search_cubes Search Statistics Canada's ~8,000 data tables (cubes) by title keyword or table number, or list every table when `query` is omitted.
Use for finding a StatCan table's productId when you only know a topic (GDP by industry, CPI, the monthly unemployment rate for Alberta) or a number such as "18-10-0004", discovering which StatCan tables cover a subject before requesting metadata or data. Every word must be in a title, else the best partial matches come back. limit (default 25, max 500) and offset page the tables; total_count is the number matching. real_time marks real-time (revision-history) tables; statcan_delta_list_real_time_tables pairs the 19 with their regular tables.
- Keywords
- statcan, find a StatCan table, statistics canada, table, cube, search, productId, discover, wds, catalogue, browse, list, inventory, all cubes, full list, tables, labour force, monthly unemployment rate, employment, GDP by industry, CPI, consumer price index, population estimates quarterly, retail trade, wages, trade, interprovincial migration, time series, real-time table, Alberta, by province, which table has
- Mots-clés
- Statistique Canada, StatCan, chercher un tableau, trouver un tableau, quel tableau, tableau de données, recherche, tableaux, numéro de tableau, découverte, catalogue, parcourir, liste, inventaire, population active, taux de chômage mensuel, emploi, PIB par industrie, produit intérieur brut, IPC, indice des prix à la consommation, permis de bâtir, permis de construire, estimations de population trimestrielles, commerce de détail, salaires, commerce, migration interprovinciale, séries chronologiques, tableau en temps réel, révisions, espérance de vie, mortalité
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
limit | int | 25 |
offset | int | 0 |
lite | bool | true |
lang | "en" | "fr" | "en" |
call_tool {"name": "wds_search_cubes", "arguments": {}}Federal and national
Health Canada: drugs, natural health products, medical devices and adverse reactions
hc_drug_ hc_nhp_ hc_device_ hc_vigilance_
Health Canada health products, tools prefixed hc_: the Drug Product Database (hc_drug_: search drug products by DIN, brand, company, active ingredient, status, schedule or ATC class…
Full description
Health Canada health products, tools prefixed hc_: the Drug Product Database (hc_drug_: search drug products by DIN, brand, company, active ingredient, status, schedule or ATC class; full product records with ingredients and strengths, schedules, routes, dosage forms, packaging and status history), licensed natural health products (hc_nhp_: search by product or company, NPN records with medicinal ingredients, doses, purposes and risks), medical device licences (hc_device_: licences, devices and identifiers by name or company, updated daily) and Canada Vigilance adverse reaction reports (hc_vigilance_: one report with its drugs, code tables, and a reaction-term search over the monthly extract), in English or French.
Drug Product Database 3
hc_drug_get_product Full Drug Product Database record for one drug product, by DIN or drug code.
Use for what a DIN is: brand name, company and its address, current status and date, original market date, active ingredients with strengths, schedules (prescription, narcotic, CDSA class), dosage forms, routes of administration, ATC therapeutic class, packaging, pharmaceutical standard, and veterinary species. For a product the company discontinued, also the last lot number and its expiry date.
- Keywords
- DIN details, drug monograph data, active ingredient strength, dosage form, route of administration, drug schedule, ATC code, drug packaging, Health Canada drug record
- Mots-clés
- fiche du médicament, numéro DIN, concentration de l'ingrédient actif, forme posologique, voie d'administration, annexe du médicament, code ATC, emballage, statut du produit, Santé Canada
| Parameter | Type | Default |
|---|---|---|
din | str | "" |
drug_code | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "hc_drug_get_product", "arguments": {}}hc_drug_search_ingredients Active ingredient names in the Drug Product Database, with product counts.
Use for checking how Health Canada spells an active ingredient (salt forms such as 'DOXEPIN (DOXEPIN HYDROCHLORIDE)'), how many drug products contain it, and their usual strengths, before searching products by ingredient with hc_drug_search_products. With lang='fr' the names are the French ones ('Acétaminophène') and the search matches French spellings.
- Keywords
- active ingredient, medicinal ingredient, drug substance, generic name, INN, drug strength, salt form, molecule, DPD ingredient
- Mots-clés
- ingrédient actif, principe actif, substance médicamenteuse, dénomination commune, DCI, concentration du médicament, sel, molécule, Santé Canada
| Parameter | Type | Default |
|---|---|---|
name | str | required |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "hc_drug_search_ingredients", "arguments": {"name": "…"}}hc_drug_search_products Search Health Canada's Drug Product Database (DPD) for drug products.
Use for finding drugs approved in Canada by DIN (Drug Identification Number), brand name, company (DIN owner), active ingredient, status (marketed, approved, dormant, cancelled), schedule (prescription, non-prescription, narcotics and controlled drugs under the CDSA, Schedule D biologics, homeopathic) or ATC class (code prefix such as 'N06A' or words such as 'antidepressants'), for human, veterinary, disinfectant and radiopharmaceutical products. Filters combine; counts by status come with every result. About 58,000 products, all statuses. Pass a drug_code or DIN to hc_drug_get_product for ingredients, strengths, forms, routes and packaging.
- Keywords
- Drug Product Database, DPD, DIN lookup, drug identification number, prescription drugs Canada, generic drugs, marketed drugs, pharmaceutical company products, ATC classification, controlled substances
- Mots-clés
- Base de données sur les produits pharmaceutiques, BDPP, numéro d'identification du médicament, DIN, médicaments sur ordonnance, médicaments génériques, médicaments commercialisés, fabricant pharmaceutique, classification ATC, drogues contrôlées, Santé Canada
| Parameter | Type | Default |
|---|---|---|
din | str | "" |
brand | str | "" |
ingredient | str | "" |
company | str | "" |
status | "approved" | "marketed" | "cancelled_pre_market" | "cancelled_post_market" | "dormant" | "cancelled_unreturned_annual" | "cancelled_safety_issue" | "authorized_interim_order" | "interim_order_revoked" | "restricted_access" | "interim_order_expired" | "cancelled_biocides" | null | null |
schedule | str | "" |
atc | str | "" |
product_class | "human" | "veterinary" | "disinfectant" | "radiopharmaceutical" | null | null |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "hc_drug_search_products", "arguments": {}}Licensed natural health products 2
hc_nhp_get_product Licence record of one natural health product, by NPN.
Use for what a natural health product contains and is licensed for: medicinal ingredients with quantity, potency, extract ratio and source material, non-medicinal ingredients, route, recommended doses by population, recommended uses (purposes), and cautions, warnings, contraindications and known adverse reactions, with every brand name and the licence holder. Uses and warnings are shown as the company filed them, which may be English even with lang='fr'.
- Keywords
- NPN lookup, natural product licence, medicinal ingredients, recommended dose, recommended use, contraindications, cautions and warnings, herbal product label, DIN-HM
- Mots-clés
- numéro NPN, licence de produit naturel, ingrédients médicinaux, dose recommandée, usage recommandé, contre-indications, mises en garde, étiquette de produit à base de plantes, Santé Canada
| Parameter | Type | Default |
|---|---|---|
npn | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "hc_nhp_get_product", "arguments": {"npn": "…"}}hc_nhp_search_products Search licensed natural health products (LNHPD) by product name, NPN or company.
Use for finding vitamins, minerals, herbal remedies, probiotics, homeopathic medicines and other natural health products licensed by Health Canada, with their Natural Product Number (NPN or DIN-HM), licence holder, dosage form, licence date and whether the licence is active. query matches any brand name of a licence or the start of an NPN; company matches the licence holder. About 153,000 licences and 307,000 brand names. The first search of the day reads the whole table (about a minute). Pass an NPN to hc_nhp_get_product for ingredients, doses, uses and warnings.
- Keywords
- natural health products, NPN, natural product number, LNHPD, vitamins, herbal supplements, homeopathic medicine, dietary supplements, probiotics, licence holder
- Mots-clés
- produits de santé naturels, NPN, numéro de produit naturel, BDPSNH, vitamines, suppléments à base de plantes, remèdes homéopathiques, suppléments alimentaires, probiotiques, titulaire de licence, Santé Canada
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
company | str | "" |
active_only | bool | true |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "hc_nhp_search_products", "arguments": {}}Medical device licences 3
hc_device_get_licence One medical device licence with its devices and model numbers.
Use for what a medical device licence covers: every device (trade name) on it with the date it was added or removed, their model or catalogue numbers (for licences with up to 25 devices), the licence status, class and type, and the manufacturer's name and address.
- Keywords
- device licence number, MDALL licence, licensed devices list, model number, catalogue number, manufacturer address, device trade name, licence status
- Mots-clés
- numéro d'homologation, homologation d'instrument médical, liste des instruments, numéro de modèle, numéro de catalogue, adresse du fabricant, nom commercial, statut de l'homologation, Santé Canada
| Parameter | Type | Default |
|---|---|---|
licence_number | int | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "hc_device_get_licence", "arguments": {"licence_number": "…"}}hc_device_search_devices Search licensed medical devices by trade name or model number (MDALL).
Use for finding a specific medical device by the name on the product (e.g. 'Dexcom G7', 'hip stem') or by a model, catalogue or part number on its label, with the licence number it is sold under and the dates it was added to or removed from that licence. Give name or identifier, not both. Active devices only unless active_only is false.
- Keywords
- medical device search, trade name, model number, catalogue number, device identifier, device licence, MDALL device, labelled product
- Mots-clés
- recherche d'instrument médical, nom commercial, numéro de modèle, numéro de catalogue, identifiant d'instrument, homologation, produit étiqueté, appareil médical, Santé Canada
| Parameter | Type | Default |
|---|---|---|
name | str | "" |
identifier | str | "" |
active_only | bool | true |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "hc_device_search_devices", "arguments": {}}hc_device_search_licences Search Health Canada medical device licences (MDALL) by device name or company.
Use for whether a medical device is licensed for sale in Canada: licence number, licence name, device class (2, 3 or 4 by risk; class I devices need no licence), licence type (single device, family, system, test kit), first issue date, cancellation date and the manufacturer. name matches the licence name (e.g. 'insulin pump', 'pacemaker', 'COVID-19 test'); company matches the manufacturer. Active licences only unless active_only is false (74,000 licences since 1999). Counts by class come with every result. Pass a licence number to hc_device_get_licence for its devices and model numbers.
- Keywords
- medical device licence, MDALL, device class, Class II III IV, licensed medical devices, manufacturer, diagnostic test kit, implant, Health Canada device approval
- Mots-clés
- homologation des instruments médicaux, LIMH, instruments médicaux homologués, classe d'instrument, fabricant, trousse de diagnostic, implant, homologation de Santé Canada
| Parameter | Type | Default |
|---|---|---|
name | str | "" |
company | str | "" |
active_only | bool | true |
risk_class | 2 | 3 | 4 | null | null |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "hc_device_search_licences", "arguments": {}}Canada Vigilance adverse reaction reports 3
hc_vigilance_get_report One Canada Vigilance adverse reaction report, with every product on it.
Use for the details of a suspected side effect report to Health Canada: dates received, report type and source, patient sex, age, weight and height, MedDRA reaction terms and system organ classes, seriousness and its criteria (death, hospitalization, disability, life threatening), outcome, and each drug or health product with its role (suspect or concomitant), dose, route, frequency and indication. Report ids come from hc_vigilance_search_reactions or the online database. A report records a suspected association, not proof.
- Keywords
- adverse reaction report, side effect report, Canada Vigilance, adverse drug reaction, AER number, suspect drug, pharmacovigilance, MedDRA term, serious adverse event
- Mots-clés
- déclaration d'effet indésirable, effet secondaire, Canada Vigilance, réaction indésirable à un médicament, médicament suspect, pharmacovigilance, terme MedDRA, effet indésirable grave, Santé Canada
| Parameter | Type | Default |
|---|---|---|
report_id | int | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "hc_vigilance_get_report", "arguments": {"report_id": "…"}}hc_vigilance_list_codes Code tables of the Canada Vigilance adverse reaction database.
Use for the labels behind Canada Vigilance codes: report outcome (recovered, fatal...), seriousness, report source (hospital, community, manufacturer...), sex, and report type (spontaneous, study, published, mandatory hospital), in English or French.
- Keywords
- Canada Vigilance codes, outcome codes, seriousness codes, report source, report type, adverse reaction database lookup, pharmacovigilance code list, data dictionary
- Mots-clés
- codes de Canada Vigilance, codes de résultat, gravité, source de la déclaration, type de déclaration, dictionnaire de données, liste de codes, pharmacovigilance, Santé Canada
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "hc_vigilance_list_codes", "arguments": {}}hc_vigilance_search_reactions Find Canada Vigilance adverse reaction reports by reaction term (monthly extract).
Use for which suspected side effect reports to Health Canada mention a reaction (MedDRA preferred term, English or French, e.g. 'myocarditis', 'anaphylactic', 'Céphalée') or a system organ class ('Cardiac disorders'), with counts per term and organ class, and the matching report ids, newest (highest id) first; min_report_id keeps only newer reports. Reads the reactions file of the monthly extract (data since 1965) as a stream, about 100 MB, so a new search takes about a minute; repeats are cached for a day. complete is false when the max_scan_mb ceiling stopped the read. Search by drug or by year is not offered: the extract's drug and date tables sit after the first 185 MB of a 355 MB file that canada.ca serves only as one compressed stream. Read dates and suspect drugs per report with hc_vigilance_get_report.
- Keywords
- adverse reaction search, side effects reported, Canada Vigilance extract, MedDRA preferred term, system organ class, pharmacovigilance data, adverse event counts, drug safety signal
- Mots-clés
- recherche d'effets indésirables, effets secondaires déclarés, extrait de Canada Vigilance, terme privilégié MedDRA, classe de systèmes d'organes, pharmacovigilance, nombre de déclarations, innocuité des médicaments, Santé Canada
| Parameter | Type | Default |
|---|---|---|
reaction | str | "" |
system_organ_class | str | "" |
min_report_id | int | 0 |
limit | int | 50 |
max_scan_mb | int | 120 |
lang | "en" | "fr" | "en" |
call_tool {"name": "hc_vigilance_search_reactions", "arguments": {}}Federal and national
Innovation, Science and Economic Development Canada
ised_cipo_ ised_clean_growth_ ised_corporations_ ised_ip_horizons_ ised_spectrum_
Innovation, Science and Economic Development Canada (ISED), from five separate sources.
Full description
Innovation, Science and Economic Development Canada (ISED), from five separate sources. Corporations Canada's federal corporation lookup API (ised-isde.canada.ca/cc/lgcy/api/corporations, tools prefixed ised_corporations_): look up one federal corporation by its numeric corporation ID or 9-digit business number, returning current status, names, addresses, director limits, annual return filing history, and incorporation/by-law activities. The Spectrum Management System's licence site data (an Esri-hosted ArcGIS FeatureServer, tools prefixed ised_spectrum_): ~840,000 wireless spectrum licence site records (licensee, service type, transmit/receive frequencies, tower location and height, antenna specifications), described as refreshed monthly but last edited 2024-02-08. The Canadian Trademarks Database (CIPO)'s search API (ised-isde.canada.ca/cipo/trademark-search/srch, tools prefixed ised_cipo_): search over 2 million Canadian trademark records (registered, pending, expunged, or abandoned) by owner name, mark text, goods/services text, application/registration number, Nice classification, or Vienna design code, returning mark name/type, status, Nice classes, and logo image URLs. CIPO's IP Horizons researcher datasets (tools prefixed ised_ip_horizons_): the bulk files of the full patent, industrial design and trademark registers (newest open releases 2024-10-11 for patents and 2024-11-20 for trademarks), listed by table, patent-number range and release from their open.canada.ca packages, plus the patent and industrial design data dictionaries (bilingual variable names, types and descriptions), and patent lookup by number or search by owner/inventor name, IPC class, title and filing date over the patent main, party and IPC tables, downloaded on first use into a local Parquet cache (MAPLE_IP_HORIZONS_CACHE_DIR). The Trademarks Database endpoint is not documented publicly -- it backs the search UI's own XHR calls -- but is a plain unauthenticated JSON POST with no session requirement, confirmed live. It has no pagination beyond the requested max_return count. The Clean Growth Hub's federal clean technology investment figures for 2016-2024 (tools prefixed ised_clean_growth_), published only as a web page and PDF, read into numbers: headline totals, value by year and subsector, and share of agreements by province. ISED's bulk statistical datasets (Financial Performance Data, historical insolvency statistics, and a bulk CSV export of the same federal-corporations register) are ordinary CKAN datasets published by the 'ic' organization on open.canada.ca, already reachable via ckan_search_datasets(fq='organization:ic') on the federal CKAN module -- no dedicated module needed for those.
Trademarks (CIPO) 1
ised_cipo_search_trademarks Search the Canadian Trademarks Database (CIPO) by one field.
Use for finding registered/pending/expunged/abandoned Canadian trademarks by owner name, mark text, goods/services description, application or registration number, Nice classification, Vienna design-code, or CIPO status. Returns application number, mark name and type, current status, Nice classes, and any logo image URLs. An empty criteria is a deliberate match-all against the entire register (over 2 million records). For nice_classification give one or more class numbers 0-45 ("9" or "9, 35": marks in any of them); for cipo_status give status names or the search form's codes separated by commas ("Registered", "Expunged, Abandoned", "19"); number fields take digits only (registration numbers may keep a prefix such as "TMA700000"). Anything else raises an error rather than matching the whole register. Results are ranked by the upstream API and max_return only caps how many top-ranked matches come back in one call -- there is no way to page past that count. The search API answers in English only (status and mark-type labels), confirmed live 2026-09-23, so lang changes only this server's own messages and notes.
- Keywords
- CIPO, ISED, trademark, brand, mark, owner, applicant, Nice classification, Vienna code, trademark status, registered, abandoned, expunged
- Mots-clés
- Office de la propriété intellectuelle du Canada (OPIC), ISDE, recherche de marques de commerce, marque de commerce, marque déposée, propriétaire de la marque, requérant, classification de Nice, code de Vienne, statut de la marque, marque enregistrée, abandonnée, radiée
| Parameter | Type | Default |
|---|---|---|
search_field | "all" | "trademark" | "trademark_description" | "owner_name" | "old_owner_name" | "goods" | "services" | "application_number" | "original_application_number" | "registration_number" | "international_registration_number" | "nice_classification" | "cipo_status" | "disclaimer" | "vienna_code" | "vienna_description" | required |
criteria | str | "" |
max_return | int | 20 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ised_cipo_search_trademarks", "arguments": {"search_field": "…"}}Clean technology investment 1
ised_clean_growth_get_federal_investment Get federal clean technology investment 2016-2024 (Clean Technology Data Strategy) as data.
Use for how much the federal government has committed to cleantech projects: total ($29 billion), number of agreements, median agreement, for-profit share, non-repayable share, and totals by purpose (development, business support, adoption); agreement value by year; share of agreements by province or territory; value by cleantech subsector; plus the page's methodology notes. The Clean Growth Hub publishes these only as a web page and PDF; this tool reads them into numbers (dollars, not billions). For project-level records, query the grants and contributions DataStore table named in records_resource_id with ckan_datastore_search(portal='federal'). lang picks English or French labels and notes; the numbers are the same.
- Keywords
- clean technology, cleantech, federal investment, Clean Growth Hub, CTDS, green funding, grants and contributions, renewable energy, subsector, ISED, NRCan
- Mots-clés
- technologies propres, investissement fédéral, Carrefour de la croissance propre, Stratégie de données sur les technologies propres, financement vert, subventions et contributions, énergie renouvelable, sous-secteur, technologies vertes, ISDE, RNCan
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "ised_clean_growth_get_federal_investment", "arguments": {}}Federal corporations 1
ised_corporations_get_corporation Look up one federal corporation by its Corporations Canada id or business number.
Use for getting a federal (not provincial) corporation's current status, legal/operating names, registered addresses, director limits, annual-return filing history, and incorporation/by-law activities, given its numeric corporation id or 9-digit business number (as found in another dataset or a filing). This is a single-record lookup, not a name search: it accepts only a numeric corporation id or business number and rejects a company name, and there is no name search in this server (Corporations Canada has no documented endpoint for one).
- Keywords
- Corporations Canada, ISED, ISDE, federal corporation, business number, BN, corporate registry, director, annual return, incorporation, by-laws, company status
- Mots-clés
- Corporations Canada, Innovation, Sciences et Développement économique Canada (ISDE), société par actions de régime fédéral, société fédérale, numéro d'entreprise, NE, registre des sociétés, administrateurs, rapport annuel, constitution en société, règlements administratifs, statut de la société
| Parameter | Type | Default |
|---|---|---|
id_or_business_number | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ised_corporations_get_corporation", "arguments": {"id_or_business_number": "…"}}Patents and IP bulk data 4
ised_ip_horizons_get_dictionary Get the IP Horizons data dictionary for CIPO patent or industrial design bulk data.
Use for understanding the columns of the IP Horizons patent or industrial design tables before downloading them: each variable's English and French name, type and description, grouped by table (e.g. patent 'main', 'interested_party', 'ipc_classification'), plus coverage-period, delimiter and encoding notes. CIPO publishes no dictionary for the trademark files. Every field carries both languages, so lang has no effect.
- Keywords
- IP Horizons, CIPO, data dictionary, codebook, patent variables, industrial design, column definitions, field descriptions, metadata, schema
- Mots-clés
- Horizons PI, OPIC, dictionnaire de données, livre de codes, variables des brevets, dessin industriel, définitions des colonnes, description des champs, métadonnées
| Parameter | Type | Default |
|---|---|---|
ip_type | "patent" | "industrial_design" | required |
table | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "ised_ip_horizons_get_dictionary", "arguments": {"ip_type": "…"}}ised_ip_horizons_get_patent Look up one Canadian patent by number in CIPO's IP Horizons data.
Use for a Canadian patent or application's title (EN/FR), filing and grant dates, status, PCT numbers, and its owners, inventors, applicants and agents with their city and country. Set include_classifications=True to add its IPC classes, which reads a much larger file. Data is as of CIPO's newest open release (2024-10-11 when checked on 2026-10-03; release_date and provenance.as_of give it), not live. The first call downloads the needed table (tens to hundreds of MB) into a local cache; if it times out, the download continues and a retry a few minutes later answers from the cache. lang has no effect: titles come in both languages.
- Keywords
- patent lookup, patent number, Canadian patent, CIPO, IP Horizons, patent owner, inventor, applicant, filing date, grant date, IPC class, intellectual property
- Mots-clés
- recherche de brevet, numéro de brevet, brevet canadien, OPIC, Horizons PI, titulaire du brevet, inventeur, demandeur, date de dépôt, date d'octroi, classe CIB, propriété intellectuelle
| Parameter | Type | Default |
|---|---|---|
patent_number | int | required |
include_classifications | bool | false |
lang | "en" | "fr" | "en" |
call_tool {"name": "ised_ip_horizons_get_patent", "arguments": {"patent_number": "…"}}ised_ip_horizons_list_files List CIPO's IP Horizons bulk data files for patents, industrial designs or trademarks.
Use for finding the download links for Canada's complete patent, industrial design or trademark registers as researcher bulk data, by table (e.g. patent 'main', 'claim', 'abstract', 'disclosure', 'interested_party', 'priority_claim', 'ipc_classification') and patent-number range. Each file is a ZIP of one pipe-delimited UTF-8 CSV; large tables are split by patent number. Releases are not regular: the newest open release was 2024-10-11 for patents and 2024-11-20 for trademarks (checked 2026-10-03), so provenance.as_of gives the release date read. latest_only=True keeps each table's newest release folder only. Pair with ised_ip_horizons_get_dictionary for column meanings; for a live search of individual trademarks use ised_cipo_search_trademarks. Resource names on open.canada.ca are inconsistent, so table and range come from each download URL. Both languages share one file set, so lang has no effect.
- Keywords
- IP Horizons, CIPO, patent data, bulk download, industrial design, trademark data, intellectual property, inventor, applicant, IPC classification, patent claims, researcher dataset
- Mots-clés
- Horizons PI, OPIC, données sur les brevets, téléchargement en vrac, dessin industriel, marques de commerce, propriété intellectuelle, inventeur, demandeur, classification CIB, revendications
| Parameter | Type | Default |
|---|---|---|
ip_type | "patent" | "industrial_design" | "trademark" | required |
table | str | null | null |
latest_only | bool | true |
lang | "en" | "fr" | "en" |
call_tool {"name": "ised_ip_horizons_list_files", "arguments": {"ip_type": "…"}}ised_ip_horizons_search_patents Search Canadian patents by owner/inventor name, IPC class, title or filing date.
Use for finding the Canadian patents of a company or inventor (party_name, a case-insensitive substring; party_type narrows to owner, inventor, applicant or agent), patents in a technology class (ipc like 'H01M', 'H01M 8' or 'H01M 8/04'), by title words (English or French; accents are ignored, since French titles are stored unaccented), or by filing-date range. Filters combine with AND. Returns the newest matches by filing date and the total match count across all ~3.2 million records since 1869. Data is as of CIPO's newest open release (2024-10-11 when checked on 2026-10-03; release_date and provenance.as_of give it), so later filings are absent. Each filter type downloads its table once into a local cache on first use; the IPC table is ~740 MB and can take many minutes, so a first call may time out while the download continues in the background; retry later. Follow up with ised_ip_horizons_get_patent for parties and classes. lang has no effect.
- Keywords
- patent search, Canadian patents, patent owner, assignee, inventor, company patents, IPC classification, technology class, filing date, CIPO, IP Horizons, innovation
- Mots-clés
- recherche de brevets, brevets canadiens, titulaire, cessionnaire, inventeur, brevets d'une entreprise, classification CIB, domaine technologique, date de dépôt, OPIC, Horizons PI
| Parameter | Type | Default |
|---|---|---|
party_name | str | null | null |
party_type | "owner" | "inventor" | "applicant" | "agent" | null | null |
ipc | str | null | null |
title | str | null | null |
filed_from | str | null | null |
filed_to | str | null | null |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ised_ip_horizons_search_patents", "arguments": {}}Spectrum licences 1
ised_spectrum_query_licences Query wireless spectrum licence site records from ISED's Spectrum Management System.
Use for finding radio/wireless spectrum licence sites by licensee, service type, location, or frequency, out of ~840,000 records. Filter with an ArcGIS SQL where clause on fields such as LICENSEE, SERVICE, PROV (two-letter code), TRANSMIT_FREQ and RECEIVE_FREQ (MHz), LATITUDE, LONGITUDE, STUCT_HT (structure/tower height), TX_PWR (transmit power), e.g. "PROV='AB' AND SERVICE='CELL'". SERVICE holds a band code, not a name (a LIKE '%Cellular%' finds nothing); the 18 codes (checked live 2026-10-03): 3500B (3500 MHz flexible use), 600B (600 MHz), AWS (AWS-1, 1.7/2.1 GHz), AWS-3, AWS-4, BRS (Broadband Radio Service, 2500 MHz), BWA24 and BWA38 (broadband wireless access, 24 and 38 GHz), CELL (cellular, 800 MHz), FCFS38 (38 GHz first-come first-served), FWA (fixed wireless access, 3500 MHz), MBS (Mobile Broadband Service, 700 MHz), PCS (1900 MHz), PCSG (PCS G block), PS49 (public safety, 4.9 GHz), RAC (railway radio of the Railway Association of Canada, VHF/UHF), WBS (Wireless Broadband Service, 3650-3700 MHz), WCS (Wireless Communications Service, 2300 MHz). LAST_MOD_DATE and LAST_UPLOAD_DATE come back as ISO dates. The service says it is refreshed monthly, but the hosted copy was last edited 2024-02-08; provenance.as_of gives the date.
- Keywords
- ISED, ISDE, spectrum, radio licence, wireless, telecommunications, frequency, licensee, transmitter, antenna, tower, Spectrum Management System, SMS
- Mots-clés
- ISDE, spectre radioélectrique, licence de spectre, licence radio, sans fil, télécommunications, fréquence, titulaire de licence, émetteur, antenne, pylône, tour de télécommunication, Système de gestion du spectre, SGS
| Parameter | Type | Default |
|---|---|---|
where | str | null | null |
out_fields | str | "*" |
order_by | str | null | null |
limit | int | 10 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ised_spectrum_query_licences", "arguments": {}}Federal and national
Natural Resources Canada: wildland fire information (CWFIS)
cwfis_
Canadian Wildland Fire Information System (NRCan): satellite fire hotspots (last 24 hours or archive since 1994), current-season estimated fire perimeters, daily fire weather stations with Fire Weather Index (FWI) components, station fire-weather forecasts…
Full description
Canadian Wildland Fire Information System (NRCan): satellite fire hotspots (last 24 hours or archive since 1994), current-season estimated fire perimeters, daily fire weather stations with Fire Weather Index (FWI) components, station fire-weather forecasts, fire danger class at a point, the National Fire Database of large fires (200 ha and over, 1980-2023) and the weekly national wildfire situation reports (fires, area burned, preparedness level, 1998 onward).
cwfis_get_fire_danger Fire danger class (Low to Extreme) at a latitude/longitude from the national danger grid.
Use for how dangerous is wildfire risk at this location today, fire danger rating for a town, low/moderate/high/very high/extreme.
- Keywords
- fire danger rating, wildfire risk today, danger class, extreme fire danger, fire danger map, point lookup, CWFIS, NRCan, forest fire risk
- Mots-clés
- cote de danger d'incendie, risque de feu aujourd'hui, classe de danger, danger extrême, carte du danger, point, SCIFV, RNCan, feu de forêt
| Parameter | Type | Default |
|---|---|---|
latitude | float | required |
longitude | float | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "cwfis_get_fire_danger", "arguments": {"latitude": "…", "longitude": "…"}}cwfis_get_fire_perimeters Current-season estimated fire perimeters (M3 hotspot-cluster polygons), largest first.
Use for biggest fires this season, current fire footprint in a region.
- Keywords
- fire perimeter, wildfire polygon, current season, M3, active fire size, area burned this year, CWFIS, NRCan, fire map, GeoJSON
- Mots-clés
- périmètre d'incendie, polygone de feu, saison en cours, superficie brûlée cette année, feux actifs, carte des feux, SCIFV, RNCan, GeoJSON
| Parameter | Type | Default |
|---|---|---|
bbox | list[float] | null | null |
min_area_ha | float | null | null |
include_geometry | bool | false |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cwfis_get_fire_perimeters", "arguments": {}}cwfis_get_fire_weather_forecast Modelled FWI and fire weather values for the coming days at a fire-weather station.
Use for fire danger for the coming days, FWI outlook at a station.
- Keywords
- FWI outlook, wildfire outlook, fire danger next days, SCRIBE, fire weather station, wildfire, CWFIS, NRCan
- Mots-clés
- prévision météo-incendie, prévision IFM, danger d'incendie prévu, perspectives feux de forêt, prochains jours, feu de végétation, Indice Forêt-Météo, SCIFV, RNCan
| Parameter | Type | Default |
|---|---|---|
station_name | str | required |
limit | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cwfis_get_fire_weather_forecast", "arguments": {"station_name": "…"}}cwfis_get_hotspots Satellite fire hotspots (VIIRS, MODIS, SLSTR) with fire weather values per detection.
Use for where fires are burning right now, active fire detections in a province, hotspot counts on a past date, fire intensity (FRP, HFI) and FWI.
- Keywords
- hotspots, active fires, satellite fire detection, VIIRS, MODIS, wildfire today, fire radiative power, FRP, CWFIS, NRCan, fire season
- Mots-clés
- points chauds, feux actifs, détection satellite, incendie de forêt, feux de végétation, puissance radiative du feu, feux en cours, SCIFV, RNCan, saison des feux
| Parameter | Type | Default |
|---|---|---|
agency | str | null | null |
bbox | list[float] | null | null |
min_frp | float | null | null |
start_date | str | null | null |
end_date | str | null | null |
canada_only | bool | true |
sort_by | "latest" | "frp" | "latest" |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cwfis_get_hotspots", "arguments": {}}cwfis_get_situation_report One national wildfire situation report with narrative text, in English or French.
Use for the current national wildfire situation, preparedness level, how the season went, priority fires.
- Keywords
- national wildfire situation, preparedness level, season summary, priority fires, fire season review, CIFFC, wildfire report Canada, CWFIS
- Mots-clés
- situation nationale des feux, niveau de préparation, bilan de la saison, feux prioritaires, rapport sur les feux de forêt au Canada, préparation nationale, SCIFV, RNCan
| Parameter | Type | Default |
|---|---|---|
report_type | "in_season" | "end_of_season" | "in_season" |
date_on_or_before | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "cwfis_get_situation_report", "arguments": {}}cwfis_get_weather_stations Fire weather stations with the latest Fire Weather Index (FWI) system values.
Use for today's fire weather index near a town, FWI by station, drought code and fine fuel moisture, wildfire risk indices for a province.
- Keywords
- Fire Weather Index, FWI, FFMC, DMC, drought code, buildup index, ISI, fire weather station, fire danger, wildfire risk, CWFIS, NRCan
- Mots-clés
- Indice Forêt-Météo, IFM, indice de sécheresse, indice de propagation initiale, station météo incendie, danger d'incendie, risque de feu, SCIFV, RNCan
| Parameter | Type | Default |
|---|---|---|
province | str | null | null |
name | str | null | null |
latitude | float | null | null |
longitude | float | null | null |
radius_km | float | 50.0 |
limit | int | 20 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cwfis_get_weather_stations", "arguments": {}}cwfis_list_situation_reports List weekly national wildfire situation reports (1998 onward) with national totals.
Use for national area burned to date, fires so far this season versus the 10-year average, season totals by year.
- Keywords
- national situation report, area burned to date, number of fires, 10-year average, season summary, CIFFC, wildfire statistics Canada, CWFIS
- Mots-clés
- rapport de situation national, superficie brûlée à ce jour, nombre de feux, moyenne sur 10 ans, bilan de saison, statistiques feux de forêt Canada, SCIFV, RNCan
| Parameter | Type | Default |
|---|---|---|
report_type | "all" | "end_of_season" | "all" |
start_date | str | null | null |
end_date | str | null | null |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cwfis_list_situation_reports", "arguments": {}}cwfis_search_large_fires National Fire Database (NFDB) large-fire points: fires of 200 ha or more, 1980-2023.
Use for largest wildfires in history, large fires by province and year, lightning versus human-caused fires, fire size and dates.
- Keywords
- National Fire Database, NFDB, large fires, historical wildfires, fire size hectares, fire cause lightning human, biggest fire, CWFIS, NRCan
- Mots-clés
- Base nationale de données sur les feux de forêt, BNDFF, grands incendies, incendies historiques, taille des incendies, incendie causé par la foudre, incendie d'origine humaine, plus grand incendie, SCIFV, RNCan
| Parameter | Type | Default |
|---|---|---|
year_from | int | null | null |
year_to | int | null | null |
agency | str | null | null |
min_size_ha | float | null | null |
cause | "N" | "H" | "U" | "H-PB" | null | null |
name | str | null | null |
sort_by | "size" | "date" | "size" |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cwfis_search_large_fires", "arguments": {}}Federal and national
Canada Mortgage and Housing Corporation
cmhc_dt_ cmhc_
Canada Mortgage and Housing Corporation (CMHC), via two separate platforms.
Full description
Canada Mortgage and Housing Corporation (CMHC), via two separate platforms. The Housing Market Information Portal (HMIP, www03.cmhc-schl.gc.ca/hmip-pimh, tools prefixed cmhc_): rental market survey vacancy rates and rents, new housing construction (starts/completions), secondary rental market, seniors' rental housing, and population/household/core-housing-need indicators, for Canada and by province, as historical time series or a current cross-tabulation -- no hardcoded table catalogue, categories and breakdowns are discovered live and data is fetched through HMIP's own CSV export. The 'Data Tables' document catalogue (www.cmhc-schl.gc.ca, tools prefixed cmhc_dt_): official per-edition Excel table publications for Rental Market Survey, Household Characteristics, and related surveys, with direct download links resolved through the site's own resolver API for any historical geography/edition, not just the current one; in English or French (French titles, slugs and files, paired with the English tables through CMHC's own language links).
Data tables (Excel) 3
cmhc_dt_get_download_url Resolve one CMHC data table's official Excel download link for a geography/edition.
Use for getting the direct, official download URL for a specific published edition of a CMHC data table (e.g. October 2022 rather than the current default) - geography_id/edition_id come from cmhc_dt_get_table's geographies/editions lists; omit either to get the most recent edition / first geography option. A single-file table (document_id set in cmhc_dt_get_table) takes neither id. Raises a clear error if the id is not one of that table's known options, rather than silently returning nothing. slug may be English or French; lang="fr" gives the French file.
- Keywords
- cmhc, housing, download link, excel file, data table, historical edition, geography, publication, direct link, xlsx
- Mots-clés
- Société canadienne d'hypothèques et de logement (SCHL), logement, lien de téléchargement, fichier Excel, tableau de données, édition historique, géographie, publication, lien direct
| Parameter | Type | Default |
|---|---|---|
category | str | required |
slug | str | required |
geography_id | str | null | null |
edition_id | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "cmhc_dt_get_download_url", "arguments": {"category": "…", "slug": "…"}}cmhc_dt_get_table Get one CMHC data table's description, geography/edition options, and default download link.
Use for confirming what a table covers and which geography_id/ edition_id values cmhc_dt_get_download_url will accept for it, before requesting a specific historical edition or geography. slug is an English or French slug from cmhc_dt_list_tables. Many tables (most household-characteristics ones) are a single file: document_id is set and geographies/editions are empty. lang="fr" reads the French page (French title, labels and file).
- Keywords
- cmhc, housing, data table, detail, description, geography, edition, publication date, document type, metadata
- Mots-clés
- Société canadienne d'hypothèques et de logement (SCHL), logement, tableau de données, détail, description, géographie, édition, date de publication, type de document, métadonnées
| Parameter | Type | Default |
|---|---|---|
category | str | required |
slug | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "cmhc_dt_get_table", "arguments": {"category": "…", "slug": "…"}}cmhc_dt_list_tables List CMHC's officially-published data tables in a category.
Use for browsing what official Excel table publications CMHC has for a topic, before fetching one table's detail or download link. category must be one of "rental-market", "household- characteristics", or "canadian-housing-survey-data-tables" (the last currently returns no tables - its own tables live elsewhere and are not yet mapped). Read docs://cmhc/well-known-categories for a sample of well-known table slugs in the first two categories. With lang="fr" each table comes back as its French twin (French title, slug and path, the English slug in english_slug), paired through CMHC's own language links; a table without a French page keeps its English title with a note. French category names ("donnees-sur-le-marche-locatif", "caracteristiques-des-menages") are accepted too.
- Keywords
- cmhc, housing, data tables, publications, excel, download, rental market, household characteristics, canadian housing survey, catalogue, list
- Mots-clés
- Société canadienne d'hypothèques et de logement (SCHL), logement, tableaux de données, publications, Excel, téléchargement, marché locatif, caractéristiques des ménages, enquête canadienne sur le logement, catalogue, liste
| Parameter | Type | Default |
|---|---|---|
category | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "cmhc_dt_list_tables", "arguments": {"category": "…"}}Housing Market Information Portal 4
cmhc_get_table_data Get CMHC housing data for a category as a table (time series or cross-tab).
Use for fetching actual CMHC Rental Market Survey vacancy rates/ rents, housing starts/completions (mises en chantier, achèvements), seniors' rental housing data, or any other category's numeric data - e.g. national historical rental vacancy rates by bedroom type, or current vacancy rates broken down by province. Pass row_field="TIMESERIES" for a historical time series (one row per period) or a province/centre-breakdown field from cmhc_get_table_options for a current cross-tabulation (one row per province/centre). Each returned cell carries CMHC's own reliability flag (a/b/c/d = Excellent/Very good/Good/Poor) alongside the value, value: 0 for a real, counted zero (flagged "-" by CMHC), or value: null with the raw marker in flag when data was suppressed ("**"/"n/a") or not applicable ("++") - see docs://cmhc/gotchas for the full legend. category_level_1/ category_level_2/column_field/row_field must come from cmhc_list_categories/cmhc_get_table_options first - an unrecognized combination raises a clear error rather than guessing. The result's available_filters lists extra narrowing dimensions this particular table supports beyond column_field/row_field (e.g. season: April/October, dwelling_type_desc_en: Row/Apartment for a Rental Market Survey table) - these genuinely change the returned values, not just a label; pass a subset as filters (e.g. {"dwelling_type_desc_en": "Row"}) on a follow-up call to narrow to just that slice. An unrecognized filter key/value raises a clear error rather than being silently ignored.
- Keywords
- cmhc, housing, hmip, rental market, vacancy rate, rent, average rent, housing starts, completions, time series, historical, data, table, province, bedroom type, reliability flag, filter, dwelling type, season
- Mots-clés
- Société canadienne d'hypothèques et de logement (SCHL), logement, Portail de l'information sur le marché de l'habitation (PIMH), marché locatif, taux d'inoccupation, loyer, loyer moyen, mises en chantier, achèvements, série chronologique, historique, données, tableau, province, type de chambre, indicateur de fiabilité, filtre, type de logement, saison
| Parameter | Type | Default |
|---|---|---|
category_level_1 | str | required |
category_level_2 | str | required |
column_field | str | required |
row_field | str | required |
geography_type | str | "Country" |
geography_id | str | "1" |
filters | dict[str, str] | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "cmhc_get_table_data", "arguments": {"category_level_1": "…", "category_level_2": "…", "column_field": "…", "row_field": "…"}}cmhc_get_table_options Get the valid breakdown options for a CMHC category before requesting data.
Use for finding which column_field/row_field pairs cmhc_get_table_data will accept for a given category (e.g. "Bedroom Type" vs "Year of Construction" as the column breakdown, "Historical Time Periods" for a time series vs "Provinces" for a current cross-tabulation) - a category/geography this doesn't return an option for will not resolve in cmhc_get_table_data either.
- Keywords
- cmhc, housing, hmip, table options, column field, row field, breakdown, bedroom type, time series, historical, provinces, discover, housing starts
- Mots-clés
- Société canadienne d'hypothèques et de logement (SCHL), logement, Portail de l'information sur le marché de l'habitation (PIMH), options de tableau, champ colonne, champ ligne, répartition, type de chambre, série chronologique, historique, provinces, découvrir, mises en chantier
| Parameter | Type | Default |
|---|---|---|
category_level_1 | str | required |
category_level_2 | str | required |
geography_type | str | "Country" |
geography_id | str | "1" |
lang | "en" | "fr" | "en" |
call_tool {"name": "cmhc_get_table_options", "arguments": {"category_level_1": "…", "category_level_2": "…"}}cmhc_list_categories List CMHC housing-data categories available at a geography.
Use for discovering what CMHC covers before requesting data - new housing construction (housing starts / mises en chantier, and completions / achèvements), primary and secondary rental market (vacancy rates, rents), seniors' rental housing, population/households/housing stock, and core housing need. Read docs://cmhc/well-known-categories first - it already lists the common categories with their exact spelling. geography_type/geography_id default to "Country"/"1" (Canada); pass a province id from cmhc_list_provinces for province-level categories instead. Category names are language-dependent strings (not fixed codes) - the values this returns for lang="fr" must be passed back with lang="fr" to other cmhc_ tools.
- Keywords
- cmhc, housing, hmip, category, discover, rental market, vacancy rate, rent, housing starts, completions, seniors housing, core housing need, mortgage, corporation
- Mots-clés
- Société canadienne d'hypothèques et de logement (SCHL), logement, Portail de l'information sur le marché de l'habitation (PIMH), catégorie, découvrir, marché locatif, taux d'inoccupation, loyer, mises en chantier, achèvements, logements pour personnes âgées, besoins impérieux, hypothèque
| Parameter | Type | Default |
|---|---|---|
geography_type | str | "Country" |
geography_id | str | "1" |
lang | "en" | "fr" | "en" |
call_tool {"name": "cmhc_list_categories", "arguments": {}}cmhc_list_provinces List Canadian provinces/territories with their CMHC HMIP geography id.
Use for getting a geography_id (with geography_type="Province") to pass to cmhc_list_categories/cmhc_get_table_options/ cmhc_get_table_data for province-level data instead of national Canada-wide data. CMA/city-level geography is not yet supported by this module - only Canada and provinces.
- Keywords
- cmhc, housing, hmip, province, territory, geography, geography id, list, canada
- Mots-clés
- Société canadienne d'hypothèques et de logement (SCHL), logement, Portail de l'information sur le marché de l'habitation (PIMH), province, territoire, géographie, identifiant géographique, liste, Canada
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "cmhc_list_provinces", "arguments": {}}Federal and national
Environment and Climate Change Canada
eccc_coverages_ eccc_
Environment and Climate Change Canada / Meteorological Service of Canada, via the MSC GeoMet-OGC-API (api.weather.gc.ca): weather alerts, current conditions and surface observations (SWOB), city forecasts, air quality health index (AQHI)…
Full description
Environment and Climate Change Canada / Meteorological Service of Canada, via the MSC GeoMet-OGC-API (api.weather.gc.ca): weather alerts, current conditions and surface observations (SWOB), city forecasts, air quality health index (AQHI), climate stations/daily/hourly/monthly observations and 1981-2010 normals, hydrometric (water level/flow) stations and real-time/historical data, marine forecasts, and long-term climate extremes. One generic OGC API - Features client covers all ~100 collections this server publishes rather than a bespoke tool per dataset. The eccc_coverages_ tools read the gridded climate projections (CanDCS-U6 CMIP6 SSP scenarios, CMIP5 and DCS RCP scenarios, climate indices, SPEI drought index, CanGRD anomalies) as tidy rows for a point or area.
Climate projections (gridded) 3
eccc_coverages_describe Describe one ECCC gridded climate coverage: variables, units, scenarios, axes, time range.
Use for checking what a climate:* collection holds before asking for data: its variables with units, emission scenarios, ensemble percentiles, seasons, 20/30-year averaging windows, first and last year or month, grid resolution and extent, with a dataset note. Ids look like climate:candcsu6:projected:annual:absolute or climate:indices:projected; find them with eccc_coverages_search.
- Keywords
- climate projection metadata, variables, units, scenarios, percentiles, ensemble, time range, grid resolution, coverage description, cmip6, environment canada
- Mots-clés
- métadonnées des projections climatiques, variables, unités, scénarios d'émissions, percentiles, ensemble de modèles, période couverte, résolution de la grille, Environnement et Changement climatique Canada (ECCC), Environnement Canada
| Parameter | Type | Default |
|---|---|---|
collection_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "eccc_coverages_describe", "arguments": {"collection_id": "…"}}eccc_coverages_get_data Get climate projection values for a point or area as tidy rows (time, value, unit, scenario).
Use for future (or historical modelled) temperature, precipitation, degree days, hot days or drought index at a place in Canada, e.g. annual mean temperature in Edmonton 2015-2100 under SSP5-8.5, or the 2071-2100 change in summer precipitation. Give a point (lat, lon: the nearest grid cell with data is used, and point_distance_km says how far it is) or a bbox [west, south, east, north] (one row per cell). variables defaults to the collection's first variable; scenarios and seasons default to all; percentiles defaults to the ensemble median (50th); averaging_periods (e.g. "2071-2100") defaults to all windows; start/end are YYYY (or YYYY-MM for monthly sets) and default to the full range. Each row names its variable, scenario, percentile, season and window, so several scenarios can be compared in one call. One upstream request is made per variable x scenario x percentile x season x window (at most 40), and a call is refused above about 250,000 grid values; max_rows (up to 10000) caps the rows returned, with truncated and total_rows. Rows include the ECCC licence in provenance.
- Keywords
- climate projections, future temperature, future precipitation, climate change by city, cmip6 point data, ssp585, rcp8.5, 2050, 2080, heating degree days, drought index, time series, environment canada
- Mots-clés
- projections climatiques, température future, précipitations futures, changements climatiques par ville, scénario d'émissions, série chronologique, degrés-jours de chauffage, indice de sécheresse, horizon 2050, Environnement et Changement climatique Canada (ECCC), Environnement Canada
| Parameter | Type | Default |
|---|---|---|
collection_id | str | required |
lat | float | null | null |
lon | float | null | null |
bbox | list[float] | null | null |
variables | list[str] | null | null |
scenarios | list[str] | null | null |
percentiles | list[float] | null | null |
seasons | list[str] | null | null |
averaging_periods | list[str] | null | null |
start | str | null | null |
end | str | null | null |
max_rows | int | 1000 |
lang | "en" | "fr" | "en" |
call_tool {"name": "eccc_coverages_get_data", "arguments": {"collection_id": "…"}}eccc_coverages_search Find ECCC gridded climate projection and climate analysis datasets (coverages).
Use for picking the right climate-projection collection before fetching values: CanDCS-U6 (CMIP6, SSP1-2.6/2-4.5/5-8.5), CMIP5 and DCS (RCP2.6/4.5/8.5), downscaled climate indices (heating and cooling degree days, hot days, growing season), SPEI drought index and CanGRD observed anomalies. query words must all appear (id, title, description, variable names); scenario (e.g. "SSP585", "RCP8.5"), variable (id such as "tas" or a title word such as "precipitation"), timeframe, frequency and year (a year the data covers) narrow further. Each result lists its variables, scenarios, percentiles, seasons, 20/30-year windows and time range. Then call eccc_coverages_get_data.
- Keywords
- climate projections, climate change scenarios, cmip6, cmip5, candcs-u6, downscaled, ssp, rcp, future temperature, future precipitation, climate indices, degree days, spei, drought, cangrd, environment canada, climate data canada
- Mots-clés
- projections climatiques, scénarios de changements climatiques, modèles climatiques, réduction d'échelle, température future, précipitations futures, indices climatiques, degrés-jours, sécheresse, données climatiques, Environnement et Changement climatique Canada (ECCC), Environnement Canada
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
scenario | str | null | null |
variable | str | null | null |
timeframe | "historical" | "projected" | null | null |
frequency | "annual" | "seasonal" | "monthly" | null | null |
year | int | null | null |
limit | int | 20 |
lang | "en" | "fr" | "en" |
call_tool {"name": "eccc_coverages_search", "arguments": {}}Weather, water and climate observations 4
eccc_get_collection Get one MSC GeoMet collection's description, spatial extent, and queryable properties.
Use for confirming what a collection covers and which property names you can filter/sort/select by (e.g. province and alert_type for weather-alerts, STATION_NUMBER for hydrometric-realtime) before calling eccc_query_items - an unknown property name is silently ignored upstream and returns zero rows rather than an error, so checking here first avoids that trap.
- Keywords
- environment canada, eccc, msc, geomet, collection, detail, metadata, queryables, properties, schema, extent, bbox
- Mots-clés
- Environnement et Changement climatique Canada, ECCC, Environnement Canada, Service météorologique du Canada (SMC), GeoMet, collection, détail, métadonnées, propriétés interrogeables, schéma, étendue géographique
| Parameter | Type | Default |
|---|---|---|
collection_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "eccc_get_collection", "arguments": {"collection_id": "…"}}eccc_list_collections List every MSC GeoMet OGC API collection (~100).
Use for a full inventory scan. Prefer eccc_search_collections for a topic search, or docs://eccc/well-known-collections for the collections that matter most - this returns the entire catalogue, including the downscaled-climate-projection families (climate:*), which are gridded coverages read with eccc_coverages_get_data.
- Keywords
- environment canada, eccc, msc, geomet, weather, climate, list, inventory, all collections, catalogue, full list
- Mots-clés
- Environnement et Changement climatique Canada, ECCC, Environnement Canada, Service météorologique du Canada (SMC), GeoMet, météo, climat, liste, inventaire, toutes les collections, catalogue, liste complète
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "eccc_list_collections", "arguments": {}}eccc_query_items Query rows (GeoJSON features) from one MSC GeoMet collection.
Use for fetching actual weather alerts, current surface observations (SWOB), AQHI readings/forecasts, climate normals or daily/hourly observations, hydrometric water level/flow, or any other MSC GeoMet collection's data - one generic query works across every collection (see docs://eccc/well-known-collections for good starting collection_id values and example filters). bbox is [west, south, east, north] in decimal degrees (WGS84). datetime_filter accepts a single RFC3339 date or datetime or an interval ("start/end", ".." for an open end) - support genuinely varies by collection and is not predictable from the collection's own metadata (confirmed: hydrometric-realtime supports it, weather-alerts does not and raises an error) - omit it and filter by filters/bbox instead if it fails. filters are exact-match property=value pairs (e.g. {"province": "ON"} or {"STATION_NUMBER": "05BL023"}) combined with AND. fields limits which properties come back (omit for all). sortby is a property name, prefixed with - for descending (e.g. "-publication_datetime"). limit is capped at 1000 per request and rows stop at about 1 MB (note gives the next offset) - several collections here have hundreds of thousands of rows, so page with offset. Read docs://eccc/gotchas before relying on datetime_filter or on climate-stations' LATITUDE/LONGITUDE properties.
- Keywords
- environment canada, eccc, msc, geomet, weather alert, weather forecast, snow, rain, temperature, tomorrow, current conditions, swob, observation, aqhi, air quality, climate normal, hydrometric, water level, flow, marine forecast, query, data, filter, bbox, station
- Mots-clés
- Environnement Canada, Environnement et Changement climatique Canada, ECCC, Service météorologique du Canada (SMC), GeoMet, météo, prévisions météo, prévisions, alerte météo, alertes météorologiques, conditions actuelles, observation, cote air santé (CAS), qualité de l'air, normale climatique, hydrométrique, rivière, cours d'eau, hydrogramme, niveau d'eau, débit, débit journalier, prévision maritime, requête, données, filtre, station
| Parameter | Type | Default |
|---|---|---|
collection_id | str | required |
bbox | list[float] | null | null |
datetime_filter | str | null | null |
filters | dict[str, str] | null | null |
fields | list[str] | null | null |
sortby | str | null | null |
limit | int | 10 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "eccc_query_items", "arguments": {"collection_id": "…"}}eccc_search_collections Search MSC GeoMet's ~100 weather/climate/water OGC API collections by keyword.
Use for finding a collection id when you only know a topic - e.g. "alert", "aqhi", "climate normal", "hydrometric", "swob", "marine", "snowfall". The query matches English and French text ("alerte" finds weather-alerts); lang="fr" returns French titles. Read docs://eccc/well-known-collections first - it already lists the collection ids that matter most, with example filters for each.
- Keywords
- environment canada, eccc, msc, geomet, weather, climate, collection, search, find, discover, dataset, catalogue
- Mots-clés
- Environnement et Changement climatique Canada, ECCC, Environnement Canada, Service météorologique du Canada (SMC), GeoMet, météo, climat, collection, recherche, trouver, jeu de données, catalogue
| Parameter | Type | Default |
|---|---|---|
query | str | required |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "eccc_search_collections", "arguments": {"query": "…"}}Federal and national
Bank of Canada
boc_
Bank of Canada Valet API: exchange rates, key interest rates (policy rate, prime rate), CPI/inflation measures, commodity price indexes, and other statistical series and series groups.
Full description
Bank of Canada Valet API: exchange rates, key interest rates (policy rate, prime rate), CPI/inflation measures, commodity price indexes, and other statistical series and series groups. Single flat REST/JSON API, no sub-API split needed.
boc_get_group Get a Bank of Canada Valet group's description and member series.
Use for discovering all the series in a themed group before fetching their observations together, e.g. FX_RATES_DAILY (daily exchange rates for ~27 currencies) or CPI_MONTHLY (Total CPI plus core-inflation measures such as CPI-trim, CPI-median, CPI-common).
- Keywords
- bank of canada, boc, valet, group, detail, member series, cpi, exchange rates, commodity prices, metadata
- Mots-clés
- Banque du Canada, valet, groupe, détail, séries membres, IPC, taux de change, prix des produits de base, métadonnées
| Parameter | Type | Default |
|---|---|---|
name | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "boc_get_group", "arguments": {"name": "…"}}boc_get_group_observations Get observations for every series in a Bank of Canada Valet group.
Use for fetching all series in a themed group at once, e.g. every daily exchange rate in FX_RATES_DAILY or the full CPI_MONTHLY family (Total CPI, CPI-trim, CPI-median, CPI-common), without listing each series name individually. start_date/end_date and recent/recent_weeks/recent_months/ recent_years are mutually exclusive, same as boc_get_observations. With no window, the most recent dates are kept within about 200 KB (FX_RATES_DAILY's full history is over 1 MB); provenance.limits says how many dates were left out.
- Keywords
- bank of canada, boc, valet, group, observations, data, exchange rates, cpi, inflation, commodity prices, time series, history, recent, date range
- Mots-clés
- Banque du Canada, valet, groupe, observations, données, taux de change, IPC, inflation, prix des produits de base, série chronologique, historique, plage de dates
| Parameter | Type | Default |
|---|---|---|
group_name | str | required |
start_date | str | null | null |
end_date | str | null | null |
recent | int | null | null |
recent_weeks | int | null | null |
recent_months | int | null | null |
recent_years | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "boc_get_group_observations", "arguments": {"group_name": "…"}}boc_get_observations Get observations for one or more Bank of Canada Valet series.
Use for fetching exchange rate history, interest rate history, CPI/inflation history, or commodity price history for one or more named series in a single call (series_names accepts multiple codes at once, e.g. ["FXUSDCAD", "FXEURCAD"]). start_date/end_date (each "YYYY-MM-DD") and recent/recent_weeks/recent_months/recent_years are mutually exclusive - Valet rejects mixing them. Series requested together are merged into one row per date only when they share the same publication frequency; mixing frequencies (e.g. a daily FX rate with monthly CPI) returns separate rows, each carrying only its own series - check each row's values keys rather than assuming every requested series appears in every row. With no window, the full history comes back trimmed to the most recent dates (about 200 KB); provenance.limits says how many dates were left out.
- Keywords
- bank of canada, boc, valet, observations, data, exchange rate, interest rate, policy rate, prime rate, cpi, inflation, commodity price, time series, history, recent, date range
- Mots-clés
- Banque du Canada, valet, observations, données, taux de change, taux d'intérêt, taux directeur, taux préférentiel, IPC, inflation, prix des matières premières, série chronologique, historique, plage de dates
| Parameter | Type | Default |
|---|---|---|
series_names | list[str] | required |
start_date | str | null | null |
end_date | str | null | null |
recent | int | null | null |
recent_weeks | int | null | null |
recent_months | int | null | null |
recent_years | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "boc_get_observations", "arguments": {"series_names": "…"}}boc_get_series Get the label and description for one Bank of Canada Valet series.
Use for confirming what a series code actually measures before requesting its observations, e.g. FXUSDCAD (USD/CAD daily exchange rate), V39079 (target for the overnight rate / policy rate), V80691311 (prime rate), V41690973 (Total CPI).
- Keywords
- bank of canada, boc, valet, series, detail, metadata, description, label, lookup
- Mots-clés
- Banque du Canada, valet, série, détail, métadonnées, description, libellé, recherche par code, consulter, code de série
| Parameter | Type | Default |
|---|---|---|
name | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "boc_get_series", "arguments": {"name": "…"}}boc_search_groups Search or list Bank of Canada Valet's series groups (~2,500).
Use for finding a themed group of related series (e.g. daily exchange rates, the CPI family including CPI-trim/median/common, weekly/monthly/annual commodity price indexes) when you want several related series at once rather than one series name. Pass query for a keyword search (top limit matches, default 25, max 200). Omit query to page through the groups (limit default 50, max 1000).
- Keywords
- bank of canada, boc, valet, group, series group, search, find, cpi, exchange rates, commodity prices, discover, list, groups, inventory, catalogue, full list
- Mots-clés
- Banque du Canada, valet, groupe, groupe de séries, recherche, trouver, IPC, taux de change, prix des produits de base, IPPB, découvrir, liste, groupes, inventaire, catalogue, liste complète, parcourir
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
limit | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "boc_search_groups", "arguments": {}}boc_search_series Search or list Bank of Canada Valet's ~16,000 statistical series.
Use for finding a Valet series name when you only know a topic - exchange rates, interest rates (policy rate, prime rate), CPI/ inflation measures, commodity prices, and hundreds of other monetary/financial series. Pass query for a keyword search (top limit matches, default 25, max 200). Omit query to page through the catalogue in name order (limit default 50, max 1000); total_count is the full number and provenance.limits says what was cut.
- Keywords
- bank of canada, boc, valet, series, search, find, exchange rate, interest rate, policy rate, prime rate, five-year mortgage rate, bond yield, cpi, inflation, commodity price, discover, list, inventory, all series, catalogue, full list
- Mots-clés
- Banque du Canada, valet, série, recherche, trouver, taux de change, taux d'intérêt, taux directeur, taux préférentiel, taux hypothécaire, rendement des obligations, IPC, inflation, prix des matières premières, découvrir, liste, inventaire, toutes les séries, catalogue, liste complète, parcourir
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
limit | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "boc_search_series", "arguments": {}}Federal and national
Canadian Dairy Commission
cdc_
Canadian Dairy Commission (cdc-ccl.ca), tools prefixed cdc_: special milk class component prices ($/kg butterfat, protein, other solids for classes 3(d), 4(a), 4(m), 5(a), 5(b), 5(c), monthly since 2002, from the CDC's yearly CSV files), the butter support price since 2010…
Full description
Canadian Dairy Commission (cdc-ccl.ca), tools prefixed cdc_: special milk class component prices ($/kg butterfat, protein, other solids for classes 3(d), 4(a), 4(m), 5(a), 5(b), 5(c), monthly since 2002, from the CDC's yearly CSV files), the butter support price since 2010, the national milk production target (total quota, kg butterfat, monthly since 2017), the Harmonized Milk Classification System, and the CDC market data file on AAFC's open-data server (farm milk production by province since 2016, milk class sales in litres, kg and dollars for the ten provinces and East/West regions since July 2020, farms shipping milk). cdc_list_datasets also lists the provincial milk marketing boards and national poultry and egg agencies checked on 2026-09-26: their data are PDFs (Dairy Farmers of Ontario, Les Producteurs de lait du Quebec, Alberta Milk, Chicken and Turkey Farmers of Canada), behind a captcha or broken TLS (BC Milk Marketing Board, Canadian Hatching Egg Producers), or limited by terms (Egg Farmers of Canada), with StatCan tables (wds_) and CKAN tariff-rate-quota lists as alternatives.
cdc_get_butter_support_prices Get the Canadian Dairy Commission's butter support price ($/kg) since 2010.
Use for the price at which the CDC buys and sells butter, set each year (usually effective February 1, sometimes mid-year such as May 2024 or September 2022) after its cost of production study and consultations. Each row keeps the published label ("2024 (May)", "2024 (mai)" with lang="fr") and an effective date. The CDC has not bought skim milk powder since 2017, so there is no powder support price. lang switches labels, notes and the linked page; values are identical in both languages.
- Keywords
- butter support price, support price, butter price, Canadian Dairy Commission, CDC, dairy policy, farm gate milk price, supply management
- Mots-clés
- prix de soutien du beurre, prix de soutien, prix du beurre, Commission canadienne du lait, CCL, politique laitière, prix du lait à la ferme, gestion de l'offre
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "cdc_get_butter_support_prices", "arguments": {}}cdc_get_component_prices Get CDC special milk class component prices ($/kg butterfat, protein, other solids), monthly.
Use for the price of milk components in classes 3(d) (restaurant pizza mozzarella), 4(a) (butter, powders), 4(m) (animal feed), and 5(a), 5(b), 5(c) (dairy ingredients for further processing and confectionery), from January 2002 to the latest announced month. year_from/year_to pick calendar years (default: the current year); milk_class filters one class ("5(a)", "5a", "3D"). Rows are sorted by month and class; a price the CDC does not set (0 or blank in its file) is None. In classes 4(a), 4(m), 5(b) and 5(c) the CDC prices protein and other solids together as solids non-fat, so protein_per_kg equals other_solids_per_kg there (as published, checked against pricing_history_2026.csv). For the butter support price use cdc_get_butter_support_prices; for class definitions, cdc_get_milk_classes. lang switches notes and the linked page.
- Keywords
- milk price, component pricing, special milk class, butterfat price, protein price, other solids, class 5, class 4(a), Canadian Dairy Commission, dairy ingredients, SMCPP
- Mots-clés
- prix du lait, prix des composants, classes spéciales, prix de la matière grasse, prix des protéines, autres solides, classe 5, classe 4(a), Commission canadienne du lait, ingrédients laitiers
| Parameter | Type | Default |
|---|---|---|
year_from | int | null | null |
year_to | int | null | null |
milk_class | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "cdc_get_component_prices", "arguments": {}}cdc_get_milk_classes Get the Harmonized Milk Classification System: which products belong to each milk class.
Use for looking up what dairy products fall in classes 1 to 5 and their subclasses (1(a) fluid milk, 2(a) yogurt, 3(a)-3(d) cheeses, 4(a) butter and powders, 4(m) animal feed, 5(a)-5(c) ingredients for further processing), which provincial boards use to bill milk components. milk_class filters by class or prefix ("3", "3(c)", "4a"). lang="fr" returns the French product descriptions.
- Keywords
- milk class, harmonized milk classification, dairy product classes, class 1 fluid milk, cheese class, butter, yogurt, Canadian Dairy Commission
- Mots-clés
- classe de lait, classification harmonisée du lait, classes de produits laitiers, lait de consommation, crème, fromage, beurre, yogourt, Commission canadienne du lait
| Parameter | Type | Default |
|---|---|---|
milk_class | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "cdc_get_milk_classes", "arguments": {}}cdc_get_national_quota Get Canada's national milk production target (total quota), monthly, in kg of butterfat.
Use for the monthly total quota the CDC sets for Canada under the Canadian Milk Supply Management Committee, from January 2017 (the CDC publishes earlier years only by email request). Default: the latest year. Rows give year, month, kilograms of butterfat, the figure exactly as published and, for 2017-2018, the change from a year earlier. Notes flag months the pages omit (December 2018) and figures that are not valid numbers (March 2023). For actual farm production by province use cdc_query_market_data(dataset= "production"). lang switches notes and the linked pages.
- Keywords
- national milk production target, total quota, milk quota, butterfat, dairy production, supply management, CMSMC, Canadian Dairy Commission
- Mots-clés
- cible nationale de production laitière, quota total, quota de lait, matière grasse, production laitière, gestion de l'offre, CCGAL, Commission canadienne du lait
| Parameter | Type | Default |
|---|---|---|
year_from | int | null | null |
year_to | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "cdc_get_national_quota", "arguments": {}}cdc_list_datasets List the Canadian Dairy Commission datasets available here, and the marketing boards checked.
Use for seeing which dairy supply management data this server reaches (component prices, butter support price, national total quota, milk classes, production and milk class sales) and which tool returns each; and learning why provincial milk marketing boards (Dairy Farmers of Ontario, Les Producteurs de lait du Québec, Alberta Milk, BC Milk Marketing Board) and the national egg, chicken, turkey and hatching egg agencies have no tool (PDF only, captcha, or terms), with StatCan tables to use instead. No upstream call is made. lang="fr" returns French titles, notes and names (organizations without an official French name keep their own).
- Keywords
- Canadian Dairy Commission, CDC, dairy, supply management, marketing board, milk, quota, egg farmers, chicken farmers, turkey, catalogue
- Mots-clés
- Commission canadienne du lait, CCL, produits laitiers, gestion de l'offre, office de commercialisation, lait, quota, Producteurs de lait du Québec, producteurs d'œufs, producteurs de poulet, dindon, volaille, catalogue
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "cdc_list_datasets", "arguments": {}}cdc_query_market_data Query CDC market data: milk production by province, milk class sales, farms shipping milk.
Use for monthly farm milk production in litres by province (dataset="production", since January 2016); monthly milk sales by class and subclass for the ten provinces ("sales_p10") or the East and West pools ("sales_by_region", with region), since July 2020, as litres, kg and dollars of butterfat, protein and other solids (segment, e.g. "butterfat_revenue"); and farms shipping milk on August 1 by province ("farms"). Filters: province (two-letter code), milk_class ("4", "4A", "3(b)"), dates as YYYY, YYYY-MM or YYYY-MM-DD. Newest rows first, up to limit (max 5000). Revenue divided by kg sold gives an average price per kg. lang="fr" returns French labels (region "Est"/"Ouest" is accepted too).
- Keywords
- milk production, dairy sales, milk class sales, butterfat sales, dairy farms, P10, milk pool, Canadian Dairy Commission, provincial milk production
- Mots-clés
- production de lait, production laitière par province, ventes de produits laitiers, ventes par classe, ventes de matière grasse, fermes laitières, producteurs de lait, P10, mise en commun du lait, Commission canadienne du lait
| Parameter | Type | Default |
|---|---|---|
dataset | "production" | "sales_p10" | "sales_by_region" | "farms" | required |
province | str | null | null |
region | str | null | null |
milk_class | str | null | null |
segment | "volume" | "butterfat_sales" | "butterfat_revenue" | "protein_sales" | "protein_revenue" | "other_solids_sales" | "other_solids_revenue" | "farm_count" | null | null |
date_from | str | null | null |
date_to | str | null | null |
limit | int | 500 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cdc_query_market_data", "arguments": {"dataset": "…"}}Federal and national
ECCC Data Catalogue files (NPRI, GHGRP, NAPS)
eccc_datamart_
Environment and Climate Change Canada Data Catalogue file tree (tools prefixed eccc_datamart_), data-donnees.az.ec.gc.ca: browse folders (air, climate, ice, substances, water, species, sites, weather and others) with file sizes and modified dates…
Full description
Environment and Climate Change Canada Data Catalogue file tree (tools prefixed eccc_datamart_), data-donnees.az.ec.gc.ca: browse folders (air, climate, ice, substances, water, species, sites, weather and others) with file sizes and modified dates; search the dataset folders by words (bilingual titles); describe a CSV or Excel file (sheets, header guess, columns, preview, read-me and data dictionary files in the same folder); read rows with column selection, exact filters, a text filter and paging (files up to 40 MB; ZIP archives, Word, PDF and images are listed but not opened). Convenience lookups: National Pollutant Release Inventory (NPRI) releases, disposals and transfers by facility for the single-year tables (2020 onward), and Greenhouse Gas Reporting Program (GHGRP) facility emissions by gas from 2004, filtered by facility, company, province, substance, NAICS and year. Covers NAPS air monitoring year folders from 1974, oil sands air, water and wildlife monitoring, and ECCC research data. Open Government Licence - Canada (commercial use allowed, attribution required). The folder and file endpoints are the ones the catalogue's own web page uses; they are undocumented. For weather, climate stations and hydrometric data use eccc_.
eccc_datamart_browse List a folder of the Environment and Climate Change Canada Data Catalogue.
Use for walking ECCC's open data file tree at data-donnees.az.ec.gc.ca: top folders air, climate, ice, instruments, managementoversight, partnerships, regulatee, sites, species, substances, water and weather; dataset folders such as the National Pollutant Release Inventory (NPRI), Greenhouse Gas Reporting Program (GHGRP), National Air Pollution Surveillance (NAPS) year folders from 1974, oil sands monitoring. Each entry has its kind (folder, table, documentation, archive, other), bilingual display name, size as listed (rounded, e.g. 36 MiB), modified date, whether eccc_datamart_read_file can read it, and the download link. The folder's open.canada.ca record is linked when it has one. path is a folder path ("/substances/monitor"), or a catalogue page or file URL. Licence: Open Government Licence - Canada (commercial use allowed, attribution). lang picks the display names.
- Keywords
- ECCC, Environment Canada, data catalogue, Data Mart, file tree, browse folder, NPRI, GHGRP, NAPS, oil sands monitoring, open data files, downloads
- Mots-clés
- Environnement et Changement climatique Canada, ECCC, Environnement Canada, catalogue de données, arborescence de fichiers, parcourir un dossier, INRP, PDGES, SNPA, surveillance des sables bitumineux, fichiers de données ouvertes, téléchargements
| Parameter | Type | Default |
|---|---|---|
path | str | "/" |
limit | int | 200 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "eccc_datamart_browse", "arguments": {}}eccc_datamart_describe_file Describe a CSV or Excel file of the ECCC Data Catalogue before reading it.
Use for seeing a file's sheets with declared size, the guessed header row, column names and the first rows, plus the read-me, data dictionary and metadata files of the same folder (with the start of a small CSV or TXT read-me, such as the GHGRP 'Lisez Moi - Read Me' notes). path is a file path from eccc_datamart_browse (or its download URL). Reads .csv, .tsv, .txt, .xlsx and .xls files up to 40 MB, in UTF-8 or Windows-1252. ZIP archives (NAPS integrated data, the 175 MB NPRI database), Word data dictionaries, PDFs and images are not opened: the error gives their download link. Licence: Open Government Licence - Canada.
- Keywords
- ECCC, describe file, columns, header, sheets, CSV, Excel, data dictionary, read me, metadata, preview
- Mots-clés
- Environnement et Changement climatique Canada, ECCC, décrire un fichier, colonnes, en-tête, feuilles, CSV, Excel, dictionnaire de données, lisez-moi, métadonnées, aperçu
| Parameter | Type | Default |
|---|---|---|
path | str | required |
sheet | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "eccc_datamart_describe_file", "arguments": {"path": "…"}}eccc_datamart_ghgrp_facilities Look up Greenhouse Gas Reporting Program (GHGRP) facility emissions, 2004 onward.
Use for greenhouse gas emissions of large emitters by facility and year: a facility's emissions over time, the largest emitters in a province or industry (oil sands, refineries, cement, steel, power plants, pipelines), emissions by gas (CO2, CH4, N2O, HFC, PFC, SF6, in tonnes CO2e) and total CO2e. Filters: year (or year to year_to; default every year), facility and company (words in the name, legal or trade), province (code or name), naics (code prefix), ghgrp_id (e.g. G10001), npri_id. order largest ranks by total CO2e; total_co2e_sum adds up every match. Facility public contact details in the file are left out. Licence: Open Government Licence - Canada.
- Keywords
- GHGRP, greenhouse gas emissions, facility emissions, large emitters, CO2, methane, carbon dioxide equivalent, climate, industrial emissions, oil sands
- Mots-clés
- PDGES, émissions de gaz à effet de serre, GES par installation, grands émetteurs, CO2, méthane, équivalent dioxyde de carbone, climat, émissions industrielles, sables bitumineux, Programme de déclaration des gaz à effet de serre, Environnement et Changement climatique Canada (ECCC)
| Parameter | Type | Default |
|---|---|---|
year | int | null | null |
year_to | int | null | null |
facility | str | null | null |
company | str | null | null |
province | str | null | null |
naics | str | null | null |
ghgrp_id | str | null | null |
npri_id | str | null | null |
order | "file" | "largest" | "file" |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "eccc_datamart_ghgrp_facilities", "arguments": {}}eccc_datamart_npri_facilities Look up National Pollutant Release Inventory (NPRI) data by facility and substance.
Use for pollutant releases to air, water and land, disposals and transfers reported by a facility or company in one year (single-year tables, 2020 to the latest, default latest): which substances a plant or mine released, the largest emitters of a substance (PM2.5, nitrogen oxides, sulphur dioxide, mercury, VOCs) in a province, facilities in a NAICS industry. Filters: facility and company (words in the name, accents ignored), province (code or name), substance (name in English or French, or CAS number), naics (code prefix), npri_id. order largest ranks by grand total in tonnes. Each record gives units (tonnes, kg, grams, g TEQ), air, water, land and road dust, disposals, transfers and grand total, NAICS and coordinates. Years 1993-2019 are only in bulk files too large for this reader (the note says where). Reads a 34-38 MB CSV, so the first call takes about 30 seconds. Licence: Open Government Licence - Canada.
- Keywords
- NPRI, National Pollutant Release Inventory, pollutant releases, facility emissions, air emissions, toxic substances, disposals, transfers, industrial polluters
- Mots-clés
- INRP, Inventaire national des rejets de polluants, rejets de polluants, émissions des installations, émissions atmosphériques, substances toxiques, éliminations, transferts, pollueurs industriels, Environnement et Changement climatique Canada (ECCC)
| Parameter | Type | Default |
|---|---|---|
year | int | null | null |
facility | str | null | null |
company | str | null | null |
province | str | null | null |
substance | str | null | null |
naics | str | null | null |
npri_id | str | null | null |
order | "file" | "largest" | "file" |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "eccc_datamart_npri_facilities", "arguments": {}}eccc_datamart_read_file Read rows of a CSV or Excel file in the ECCC Data Catalogue.
Use for getting the values in any ECCC table file: NPRI ten-year tables by province, industry and substance, GHGRP data tables, air pollutant emissions inventory, oil sands monitoring results, NAPS annual summaries, research data files. path comes from eccc_datamart_browse. columns picks columns, filters keeps rows whose column equals the value (case-insensitive), contains keeps rows with that text anywhere, offset and limit page (total_rows counts every match). header_row (1-based) and header_rows (1 to 5) fix headers the guess misses. Values come back as text, as published. Files up to 40 MB (the 34-38 MB NPRI single-year CSVs fit; prefer the CSV copy over the XLSX one, it reads much faster); larger files, ZIP archives and non-table files are refused with their download link. Licence: Open Government Licence - Canada, attribution included.
- Keywords
- ECCC, read file, rows, CSV, Excel, filter, environmental data, emissions table, monitoring data, Data Mart
- Mots-clés
- Environnement et Changement climatique Canada, ECCC, lire un fichier, lignes, CSV, Excel, filtre, données environnementales, tableau des émissions, données de surveillance
| Parameter | Type | Default |
|---|---|---|
path | str | required |
sheet | str | null | null |
columns | list[str] | null | null |
filters | dict[str, str] | null | null |
contains | str | null | null |
header_row | int | null | null |
header_rows | int | 1 |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "eccc_datamart_read_file", "arguments": {"path": "…"}}eccc_datamart_search Search the ECCC Data Catalogue's dataset folders by words (English or French).
Use for finding which folder of data-donnees.az.ec.gc.ca holds a dataset: pollutant releases, greenhouse gas emissions, air pollutant emissions inventory, acid rain and precipitation chemistry, mercury, oil sands rivers and lakes, benthic invertebrates, fish contaminants, seabirds and species at risk, sea ice, climate scenarios. Matches words (prefixes count) against folder names and their English and French titles across the first three levels (topic / function / dataset, about 500 folders); topic keeps one top folder (substances, air, climate, species, sites, ice, weather...). The folder list is built from about 60 listings on first use and kept for a day. Then open a hit with eccc_datamart_browse.
- Keywords
- ECCC data catalogue search, find dataset, environmental data, pollutant, emissions, oil sands monitoring, wildlife, contaminants, research data
- Mots-clés
- recherche dans le catalogue de données d'ECCC, trouver un jeu de données, données environnementales, polluants, émissions, qualité de l'air, qualité de l'eau, faune, contaminants, Environnement et Changement climatique Canada
| Parameter | Type | Default |
|---|---|---|
query | str | required |
topic | str | null | null |
limit | int | 20 |
lang | "en" | "fr" | "en" |
call_tool {"name": "eccc_datamart_search", "arguments": {"query": "…"}}Federal and national
Immigration, Refugees and Citizenship Canada
ircc_monthly_ ircc_
Immigration, Refugees and Citizenship Canada (IRCC). ircc_: Express Entry rounds of invitations (draw history, CRS cutoffs, invitations, pool distribution). ircc_monthly_: the Monthly IRCC Updates tables, January 2015 to the latest month: permanent residents by province, CMA…
Full description
Immigration, Refugees and Citizenship Canada (IRCC). ircc_: Express Entry rounds of invitations (draw history, CRS cutoffs, invitations, pool distribution). ircc_monthly_: the Monthly IRCC Updates tables, January 2015 to the latest month: permanent residents by province, CMA, census subdivision, citizenship, category, occupation, age and gender; study and work permit holders; temporary-to-permanent transitions; Express Entry admissions and invitations; asylum claimants. Counts are rounded to 5 and 1-4 suppressed. Other IRCC datasets are reachable through the federal ckan_ tools filtered to organization:cic.
Monthly IRCC Updates 3
ircc_monthly_describe_table Describe one IRCC monthly table: its dimensions, values and time span.
Use for learning the dimension keys (e.g. 'province_territory', 'immigration_category_main_category', 'country_of_citizenship') and their exact values before filtering or grouping with ircc_monthly_query, and the first and last month covered (most tables run from January 2015 to the latest month). table_id comes from ircc_monthly_list_tables, e.g. 'ODP-PR-PT_IMMCAT'. Downloads the whole file (up to about 30 MB), cached for hours.
- Keywords
- IRCC table columns, dimensions, categories, province, country of citizenship, immigration category, coverage, codebook
- Mots-clés
- colonnes du tableau IRCC, dimensions, catégories, province, pays de citoyenneté, catégorie d'immigration, région métropolitaine de recensement (RMR), période couverte, dictionnaire de données, Immigration, Réfugiés et Citoyenneté Canada (IRCC)
| Parameter | Type | Default |
|---|---|---|
table_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ircc_monthly_describe_table", "arguments": {"table_id": "…"}}ircc_monthly_list_tables List IRCC's monthly immigration statistics tables (Monthly IRCC Updates).
Use for finding the table to query for monthly counts of permanent residents (admissions by province, census metropolitan area, census subdivision, country of citizenship, immigration category, occupation, age, gender, French-speaking), Express Entry admissions and invited candidates, study permit holders (including by designated learning institution), work permit holders (TFWP, International Mobility Program, post-graduation work permits), transitions from temporary to permanent residence, and asylum claimants. query keeps tables whose id, title or dataset contain every word. Archived series (Syrian, Afghan, resettled refugees) are left out unless include_archived. Pass a table_id to ircc_monthly_describe_table, then ircc_monthly_query.
- Keywords
- immigration, permanent residents, admissions, newcomers, study permits, international students, work permits, temporary foreign workers, asylum claimants, refugees, IRCC monthly data
- Mots-clés
- immigration, résidents permanents, admissions, nouveaux arrivants, permis d'études, étudiants étrangers, permis de travail, permis de travail postdiplôme, travailleurs étrangers temporaires, Entrée express, demandeurs d'asile, réfugiés, données mensuelles d'Immigration, Réfugiés et Citoyenneté Canada (IRCC)
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
include_archived | bool | false |
lang | "en" | "fr" | "en" |
call_tool {"name": "ircc_monthly_list_tables", "arguments": {}}ircc_monthly_query Query and total an IRCC monthly immigration table.
Use for monthly, quarterly or yearly counts of permanent residents, study and work permit holders, temporary-to-permanent transitions or asylum claimants, for a province, city (CMA or census subdivision), country of citizenship, immigration category or occupation. filters maps a dimension key to one value in English or French, e.g. {"province_territory": "Alberta"}. period sums to 'month', 'quarter' or 'year' (default: the table's finest). group_by lists the dimensions to keep; others are summed over (group_by=[] gives one total per period; omitted keeps every dimension). sort 'value_desc' ranks the largest groups (top countries); 'period' keeps the most recent limit rows in time order. Counts are rounded to 5 and 1-4 are suppressed ('--'), counted as 0 and reported per row in suppressed_cells, so sums are approximate. Tables overlap: the permanent resident tables are the same people cut by province, citizenship, age, gender, CMA or occupation, and Express Entry and French-speaking admissions are subsets of them, so total within one table and never add tables together.
- Keywords
- immigrants per month, permanent resident admissions by province, new permanent residents, international students by country, work permits by province, asylum claims, immigration trend, IRCC time series
- Mots-clés
- immigrants par mois, admissions de résidents permanents par province, nouveaux résidents permanents, étudiants étrangers par pays, permis de travail par province, demandes d'asile, passage du statut temporaire à la résidence permanente, tendance de l'immigration, série chronologique IRCC
| Parameter | Type | Default |
|---|---|---|
table_id | str | required |
filters | dict[str, str] | null | null |
year_from | int | null | null |
year_to | int | null | null |
period | "month" | "quarter" | "year" | null | null |
group_by | list[str] | null | null |
sort | "period" | "value_desc" | "period" |
limit | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ircc_monthly_query", "arguments": {"table_id": "…"}}Express Entry rounds 3
ircc_get_express_entry_round Get one Express Entry round of invitations by its draw number.
Use for looking up a specific round found with ircc_list_express_entry_rounds, or a round number a user already knows. draw_number is a string, not an int: most rounds are plain numbers ("444"), but two rounds IRCC ran on the same day (2018-05-30) are published as "91a" and "91b" rather than separate sequential numbers.
- Keywords
- Express Entry, round, draw number, invitation, CRS cutoff, immigration, permanent residence, IRCC
- Mots-clés
- Entrée express, ronde d'invitations, numéro de ronde, numéro de tirage, invitation à présenter une demande, note minimale SCG, score limite, immigration, résidence permanente, Immigration, Réfugiés et Citoyenneté Canada (IRCC)
| Parameter | Type | Default |
|---|---|---|
draw_number | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ircc_get_express_entry_round", "arguments": {"draw_number": "…"}}ircc_get_latest_express_entry_round Get the most recent Express Entry round of invitations.
Use for answering "what is the current CRS cutoff score" or "when was the last Express Entry draw" without knowing a draw number.
- Keywords
- Express Entry, latest round, current CRS cutoff, most recent draw, today, this week, immigration, permanent residence, IRCC
- Mots-clés
- Entrée express, dernière ronde d'invitations, note minimale SCG actuelle, score limite actuel, tirage le plus récent, aujourd'hui, cette semaine, immigration, résidence permanente, Immigration, Réfugiés et Citoyenneté Canada (IRCC)
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "ircc_get_latest_express_entry_round", "arguments": {}}ircc_list_express_entry_rounds List Express Entry rounds of invitations, newest first.
Use for tracking CRS (Comprehensive Ranking System) cutoff score history, invitations issued per round, and candidate-pool score distribution over time. program filters by a case-insensitive substring match against the round's name and invited program(s), e.g. "Canadian Experience Class" or "Provincial Nominee". since (an ISO date) filters to rounds on or after that date. The upstream feed has no server-side filtering, so MapleStats fetches the full history once (cached for hours, since new rounds appear roughly weekly) and filters/limits locally.
- Keywords
- Express Entry, rounds of invitations, CRS, Comprehensive Ranking System, cutoff score, draw, invitations issued, immigration, permanent residence, Canadian Experience Class, Federal Skilled Worker, Provincial Nominee Program, category-based selection, IRCC
- Mots-clés
- Entrée express, rondes d'invitations, SCG, Système de classement global, note minimale, score limite, tirage, invitations émises, immigration, résidence permanente, catégorie de l'expérience canadienne, Programme des travailleurs qualifiés (fédéral), Programme des candidats des provinces, sélection fondée sur les catégories, Immigration, Réfugiés et Citoyenneté Canada (IRCC)
| Parameter | Type | Default |
|---|---|---|
program | str | null | null |
since | str | null | null |
limit | int | 20 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ircc_list_express_entry_rounds", "arguments": {}}Federal and national
Elected officials and districts, via Open North Represent
represent_
Elected officials and electoral districts from Open North's Represent API (unofficial, not a government site): look up the MP, MLA and mayor or councillor for a postal code or a latitude/longitude, search 3,800 representatives by name, office, district, party or level…
Full description
Elected officials and electoral districts from Open North's Represent API (unofficial, not a government site): look up the MP, MLA and mayor or councillor for a postal code or a latitude/longitude, search 3,800 representatives by name, office, district, party or level, and list the 524 boundary sets with their licence and last-updated date. Free up to 60 requests a minute; representative data is scraped from official sites and its licence is unverified.
represent_list_boundary_sets List electoral boundary sets with their licence and last-updated date.
Use for finding which boundary sets exist (524: federal and provincial electoral districts, municipal wards, census divisions and subdivisions), judging how stale one is (last_updated, possibly_stale) and reading its licence_url before reuse. Filter by domain (Canada, a province, or a city such as "Toronto") or by name (e.g. "ward"). With with_details true, up to 25 sets per call are fetched individually because the list itself carries no licence or date; page with offset. Source is Open North (unofficial); licences differ per set.
- Keywords
- boundary sets, electoral districts, wards, ridings, licence, last updated, stale, shapefile source, census subdivisions, open government licence
- Mots-clés
- ensembles de limites, circonscriptions, quartiers, licence, dernière mise à jour, périmé, source géographique, subdivisions de recensement, licence du gouvernement ouvert
| Parameter | Type | Default |
|---|---|---|
domain | str | null | null |
name | str | null | null |
with_details | bool | true |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "represent_list_boundary_sets", "arguments": {}}represent_list_representative_sets List the 121 sets of representatives (House of Commons, legislatures, city councils).
Use for finding the slug of a legislature or council to pass to represent_search_representatives (representative_set), and checking which cities and provinces are covered at all. level is federal, provincial or municipal. Coverage is partial: only some municipal councils are included, and sets carry no update date. Source is Open North (unofficial).
- Keywords
- representative sets, legislature, city council, House of Commons, coverage, which cities, municipal council list, assembly, provincial legislature
- Mots-clés
- ensembles d'élus, assemblée législative, conseil municipal, Chambre des communes, couverture, quelles villes, liste des conseils, assemblée nationale
| Parameter | Type | Default |
|---|---|---|
level | "federal" | "provincial" | "municipal" | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "represent_list_representative_sets", "arguments": {}}represent_lookup_point Find the representatives and electoral districts at a latitude and longitude.
Use for the exact riding, ward and representatives of a location (e.g. latitude 45.524, longitude -73.596), when a postal code is too coarse or a geocoded address is at hand. A point falls in exactly one district per boundary set. Each set's licence and last-updated date are included. Source is Open North (unofficial, 60 requests a minute); representative data is scraped and its licence is unverified.
- Keywords
- latitude, longitude, coordinates, point lookup, riding, ward, electoral district, boundary, elected officials, MP, MLA, mayor, geocode
- Mots-clés
- latitude, longitude, coordonnées, recherche par point, circonscription, quartier, district électoral, limites, élus, député, maire, géocodage
| Parameter | Type | Default |
|---|---|---|
latitude | float | required |
longitude | float | required |
include_set_details | bool | true |
lang | "en" | "fr" | "en" |
call_tool {"name": "represent_lookup_point", "arguments": {"latitude": "…", "longitude": "…"}}represent_lookup_postcode Find the MP, MLA and mayor or councillors for a Canadian postal code.
Use for who represents a postal code (e.g. T5J0N3, H3B 4W8), and which federal, provincial and municipal electoral districts it falls in, with each district set's licence and last-updated date. A postal code can match several districts (see notes); for exact results use represent_lookup_point. sets optionally limits districts to comma-separated boundary set slugs (e.g. federal-electoral-districts-2023-representation-order, the current federal map; federal-electoral-districts with no year is the old 2013 order). With sets, only representatives of the current sets come back. Source is Open North (unofficial, 60 requests a minute); representative data is scraped from official sites, its licence is unverified and some records are stale. Complements the ourcommons_ tools.
- Keywords
- postal code, postcode, elected officials, representative, MP, MLA, mayor, councillor, riding, electoral district, ward, who is my MP
- Mots-clés
- code postal, élus, représentant, député, maire, conseiller, circonscription, district électoral, quartier, qui est mon député
| Parameter | Type | Default |
|---|---|---|
postcode | str | required |
sets | str | null | null |
include_set_details | bool | true |
lang | "en" | "fr" | "en" |
call_tool {"name": "represent_lookup_postcode", "arguments": {"postcode": "…"}}represent_search_representatives Search about 3,800 Canadian elected officials by name, office, district, party or level.
Use for finding a representative by name (substring, e.g. "Carney"), all mayors (office "Mayor"), all MLAs of a party, councillors of a district or city, or every federal or provincial member. level is federal, provincial or municipal; representative_set is a set slug from represent_list_representative_sets (e.g. toronto-city-council). party is a substring of the party name; common abbreviations and French or English names also work (NDP/NPD, UCP, CAQ, PLQ, PQ, QS, BQ, PC, Green/Vert, Liberal/Libéral). Each record shows contact details, offices and the official page it was scraped from (source_url); records are unverified and some sets are stale. Source is Open North (unofficial). Complements ourcommons_.
- Keywords
- search representatives, elected officials, MP, MLA, mayor, councillor, party, politician, contact, email, constituency office, municipal council
- Mots-clés
- chercher élus, représentants, député, maire, conseiller, parti, politicien, courriel, bureau de circonscription, conseil municipal, assemblée nationale
| Parameter | Type | Default |
|---|---|---|
name | str | null | null |
office | str | null | null |
district | str | null | null |
party | str | null | null |
level | "federal" | "provincial" | "municipal" | null | null |
representative_set | str | null | null |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "represent_search_representatives", "arguments": {}}Federal and national
Borealis: Beyond 20/20 tables and ODESI
borealis_
Beyond 20/20 (.ivt) statistical tables on Borealis, the Canadian Dataverse Repository (borealisdata.ca, tools prefixed borealis_): about 3,300 IVT files deposited by Canadian university libraries…
Full description
Beyond 20/20 (.ivt) statistical tables on Borealis, the Canadian Dataverse Repository (borealisdata.ca, tools prefixed borealis_): about 3,300 IVT files deposited by Canadian university libraries, mostly Statistics Canada data that exists only in this format: historical censuses 1665-1871, Census of Population tabulations 1996-2021, Census of Agriculture 2001, the Labour Force Historical Review 1997-2008, Canadian Business Patterns and Business Counts, justice surveys and HART housing tabulations. Search by words in the dataset or file name; each hit returns its download URL, size, whether it needs a Borealis login, and an R snippet that reads it with canivt. StatCan's own 2006-2016 census tables are covered by statcan_census_tables_. It also searches the ODESI collection (borealis_odesi_ tools): DDI metadata for Statistics Canada public use microdata files (PUMFs), public opinion polls, aggregate and census data, with the study description, variable names and labels, and which files are public or restricted. The DLI-licensed collection is skipped because its files need a login at a DLI-member institution.
borealis_odesi_get_dataset Get an ODESI dataset's DDI study description and which files are public or restricted.
Use for the full description of one dataset found with borealis_odesi_search_datasets: abstract, time period, geography, unit of analysis, universe, sampling, terms of use, citation, and the files with download links. Says plainly how many files anyone can download without a login (public_files, with size and link) and how many are restricted to DLI-member institutions (names only, no link given). Public here means no Borealis login; the terms of use can still limit redistribution (many PUMFs are for non-profit research and teaching). persistent_id is a DOI such as "doi:10.5683/SP3/TVVQPG". For variable names and labels use borealis_odesi_search_variables. lang="fr" gives the access summary, errors and provenance in French; the DDI text is as deposited.
- Keywords
- ODESI, DDI, codebook, PUMF download, dataset metadata, terms of use, restricted files, DLI licence, Borealis, DOI, poll
- Mots-clés
- ODESI, DDI, livre de codes, téléchargement FMGD, métadonnées du jeu de données, conditions d'utilisation, fichiers restreints, licence IDD, Borealis, DOI
| Parameter | Type | Default |
|---|---|---|
persistent_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "borealis_odesi_get_dataset", "arguments": {"persistent_id": "…"}}borealis_odesi_search_datasets Search ODESI on Borealis for StatCan public use microdata files (PUMFs), polls and census data.
Use for finding microdata described in DDI by Canadian university libraries: StatCan PUMFs (Labour Force, Canadian Community Health, General Social, Census PUMFs), Canadian public opinion polls (CORA: Environics Focus Canada, Gallup), StatCan aggregate tables, census collections and international data. collection narrows to "pumfs", "polls", "aggregate", "census", "other" or "international"; the default "all_public" covers all of them. Every word of the query must match the title, description or keywords; page with start. The DLI-licensed collection (about 414 datasets, e.g. the Postal Code Conversion File) is skipped on purpose: its data files are restricted to DLI-member institutions. A hit does not say which files are open; call borealis_odesi_get_dataset with its persistent_id for that. lang="fr" gives notes, errors and provenance in French; titles are as deposited.
- Keywords
- ODESI, Borealis, Dataverse, DDI, PUMF, public use microdata file, Labour Force microdata, public opinion poll, CORA, Data Liberation Initiative, codebook, social science data
- Mots-clés
- ODESI, Borealis, Dataverse, DDI, FMGD, fichier de microdonnées à grande diffusion, microdonnées d'enquête, sondage d'opinion publique, Initiative de démocratisation des données, livre de codes, données des sciences sociales
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
collection | "all_public" | "pumfs" | "polls" | "aggregate" | "census" | "other" | "international" | "all_public" |
limit | int | 20 |
start | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "borealis_odesi_search_datasets", "arguments": {}}borealis_odesi_search_variables List or search the variables (names and labels) in one ODESI dataset's DDI codebook.
Use for checking whether a PUMF or poll holds a variable ("unemployment", "union", "province") before downloading it, from the variable-level DDI that Borealis builds for tabular data files. Every word of the query must match the variable name or label; an empty query lists the first variables. Datasets whose data were not ingested as tabular files have no variable-level DDI: the result is empty with a note saying so, not an error. persistent_id is a DOI from borealis_odesi_search_datasets. lang="fr" gives notes, errors and provenance in French; labels are as deposited.
- Keywords
- ODESI, DDI, variable list, variable labels, codebook, PUMF variables, poll questions, microdata dictionary, Borealis, Dataverse, microdata variables
- Mots-clés
- ODESI, DDI, liste des variables, étiquettes de variables, livre de codes, variables FMGD, questions de sondage, dictionnaire de données, microdonnées, Borealis
| Parameter | Type | Default |
|---|---|---|
persistent_id | str | required |
query | str | "" |
limit | int | 30 |
lang | "en" | "fr" | "en" |
call_tool {"name": "borealis_odesi_search_variables", "arguments": {"persistent_id": "…"}}borealis_search_ivt Find Beyond 20/20 (.ivt) statistical tables on Borealis, with R code to read them.
Use for Statistics Canada tables that exist only as Beyond 20/20 files and were deposited on Borealis (the Canadian Dataverse) by university libraries: historical censuses 1665-1871, Census of Population tabulations 1996-2021, Census of Agriculture 2001, the Labour Force Historical Review 1997-2008, Canadian Business Patterns and Business Counts, justice surveys, HART housing tabulations. Every word of the query must match the dataset or file. Each hit gives the download URL, size, whether a Borealis login is needed, and an R snippet using canivt (mountainMath), the only maintained IVT reader. An empty query lists IVT files by relevance. lang="fr" gives notes, errors and provenance in French; dataset titles are as deposited (English or French).
- Keywords
- Beyond 20/20, IVT, Borealis, Dataverse, Data Liberation Initiative, historical census, Canadian Business Patterns, Labour Force Historical Review, canivt, custom tabulation, research data repository, university data library
- Mots-clés
- Beyond 20/20, IVT, Borealis, Dataverse, Initiative de démocratisation des données, recensement historique, Structure des industries canadiennes, Revue chronologique de la population active, totalisation personnalisée
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
limit | int | 20 |
lang | "en" | "fr" | "en" |
call_tool {"name": "borealis_search_ivt", "arguments": {}}Federal and national
Canadian Grain Commission
cgc_
Canadian Grain Commission (grainscanada.gc.ca, tools prefixed cgc_): Grain Statistics Weekly by crop year from 2013-14 (producer deliveries, shipments and stocks at primary and process elevators by province, terminal receipts, exports, stocks and disposition by port and grade…
Full description
Canadian Grain Commission (grainscanada.gc.ca, tools prefixed cgc_): Grain Statistics Weekly by crop year from 2013-14 (producer deliveries, shipments and stocks at primary and process elevators by province, terminal receipts, exports, stocks and disposition by port and grade, feed grains, producer cars, imported grains, stock summary; thousands of tonnes, updated each Thursday) and monthly grain exports from licensed facilities by grain, grade, port and destination country since January 2013. Filters, weekly or summed results, English or French labels.
cgc_exports_describe List the grains, ports and destination countries in the CGC's monthly grain exports file.
Use for the values cgc_exports_query filters on (42 grain names including imported and 'US' grains, grades, elevator types PRIMARY, TERMINALS and CONTAINER, port regions, world regions, about 150 destination countries) and the months covered (January 2013 to the latest month, usually a few weeks behind). lang="fr" lists the French names ('R.P. de Chine', 'Silos Terminaux', 'Conteneurs').
- Keywords
- grain exports, destination countries, export markets, Canadian Grain Commission, licensed facilities, container exports, ports, wheat, canola
- Mots-clés
- exportations de grain, pays de destination, marchés d'exportation, Commission canadienne des grains, installations agréées, conteneurs, ports, céréales, blé, canola
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "cgc_exports_describe", "arguments": {}}cgc_exports_query Get monthly Canadian grain exports by grain and destination country from the Canadian Grain Commission.
Use for how much wheat, durum, canola, barley, oats, peas, lentils or soybeans Canada exported to China, Japan, the United States, Mexico or any other country, by month, calendar year or crop year (August to July), from licensed primary, terminal and container facilities, since January 2013. Filters take one value or a list (cgc_exports_describe lists them); region is the port region, elevator PRIMARY, TERMINALS or CONTAINER. With frequency 'month' and no group_by, rows are as published; otherwise values are summed per period over every column not in group_by (e.g. frequency='crop_year', group_by=['destination']), and months shows partial periods. Rows come in period order, largest first within a period; past limit the oldest periods are dropped. total_ktonnes sums every match. Thousands of tonnes. China is 'China P.R.' in the file ('China' also works). With lang="fr" names are French: elevator 'Silos des Prairies', 'Silos Terminaux' or 'Conteneurs', destination 'R.P. de Chine' ('Chine' also works), 'Japon', 'États-Unis', and the unit is 'milliers de tonnes'; filters ignore case, accents, hyphens and spaces, and an unknown name lists the ones containing it.
- Keywords
- grain exports by country, canola exports to China, wheat exports, export destinations, monthly exports, crop year exports, Canadian Grain Commission, pulse exports, lentil exports, trade
- Mots-clés
- exportations de grain par pays, exportations de canola vers la Chine, exportations de blé, destinations d'exportation, exportations mensuelles, campagne agricole, Commission canadienne des grains, céréales, légumineuses, lentilles, commerce
| Parameter | Type | Default |
|---|---|---|
grain | str | list[str] | null | null |
destination | str | list[str] | null | null |
region | str | list[str] | null | null |
elevator | str | list[str] | null | null |
global_region | str | list[str] | null | null |
grade | str | list[str] | null | null |
year_from | int | null | null |
year_to | int | null | null |
frequency | "month" | "year" | "crop_year" | "month" |
group_by | list["grain" | "grade" | "elevator" | "region" | "global_region" | "destination"] | null | null |
limit | int | 200 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cgc_exports_query", "arguments": {}}cgc_weekly_describe List what the Canadian Grain Commission's Grain Statistics Weekly holds for a crop year.
Use for the first step before cgc_weekly_query: the weeks published so far (grain week and the Sunday it ends), and per worksheet its metrics, periods, grains, regions and grades. Worksheets: Primary (producer deliveries, shipments, stocks, condo storage by prairie province), Process (deliveries, shipments, milled grain and stocks at process elevators), Terminal Receipts, Terminal Exports, Terminal Stocks and Terminal Disposition (by port: Vancouver, Prince Rupert, Churchill, Thunder Bay, Bay & Lakes, St. Lawrence, and by grade), Primary Shipment Distribution, Feed Grains, Feed Grains Shipment Distribution, Producer Cars, Imported Grains, Summary (stocks by elevator type). crop_year is e.g. '2025-26' (August to July), from 2013-14; default: the latest. Values are thousands of tonnes. lang="fr" reads the French file: worksheet, metric, period, grain and region names are then French ('Silos primaires', 'Terminaux - exportations', 'Semaine en cours').
- Keywords
- Canadian Grain Commission, CGC, grain statistics weekly, GSW, crop year, grain handling, primary elevators, terminal elevators, grain stocks, canola, wheat
- Mots-clés
- Commission canadienne des grains, CCG, statistiques hebdomadaires sur le grain, campagne agricole, manutention du grain, silos primaires, silos terminaux, silos-élévateurs, stocks de grain, céréales, canola, blé
| Parameter | Type | Default |
|---|---|---|
crop_year | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "cgc_weekly_describe", "arguments": {}}cgc_weekly_query Get weekly grain deliveries, shipments, exports and stocks from the Canadian Grain Commission.
Use for producer deliveries of wheat, canola, barley, oats, peas or lentils to primary elevators by province; terminal exports and receipts by port (Vancouver, Prince Rupert, Thunder Bay, St. Lawrence) and grade; grain stocks in commercial storage; weekly or crop-year-to-date grain movement. worksheet is required (e.g. 'Primary', 'Terminal Exports', 'Summary'; cgc_weekly_describe lists them and their values). period is 'Current Week' (that week alone) or 'Crop Year' (to date). Filters take one value or a list. Omit group_by for the published rows; pass it (e.g. ['grain']) to sum the other columns per week, e.g. deliveries over all provinces; summing requires one metric and one period. latest_week_only keeps the newest week. Rows come in week order; past limit the latest are kept. Thousands of tonnes; rows without a region are national totals. From crop year 2013-14; updated each Thursday. With lang="fr" every name is French, e.g. worksheet 'Silos primaires', metric 'Livraisons', period 'Semaine en cours' or 'Campagne agricole', grain 'Blé', region 'Saskatchewan'; filters ignore case, accents, hyphens and spaces.
- Keywords
- grain deliveries, grain exports, grain stocks, primary elevator, terminal elevator, port of Vancouver, canola deliveries, wheat exports, crop year to date, thousand tonnes
- Mots-clés
- livraisons de grain, livraisons des producteurs, exportations de grain, stocks de grain, silo primaire, silo terminal, silo-élévateur, port de Vancouver, livraisons de canola, exportations de blé, céréales, orge, campagne agricole, milliers de tonnes
| Parameter | Type | Default |
|---|---|---|
worksheet | str | required |
crop_year | str | null | null |
metric | str | list[str] | null | null |
period | str | list[str] | null | null |
grain | str | list[str] | null | null |
grade | str | list[str] | null | null |
region | str | list[str] | null | null |
week_from | int | null | null |
week_to | int | null | null |
latest_week_only | bool | false |
group_by | list["worksheet" | "metric" | "period" | "grain" | "grade" | "region"] | null | null |
limit | int | 200 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cgc_weekly_query", "arguments": {"worksheet": "…"}}Federal and national
Department of Finance Canada
finance_
Department of Finance Canada, tools prefixed finance_: the Fiscal Reference Tables (finance_frt_), one Excel workbook per edition 2019-2025 in English or French with about 55 tables: federal revenues, expenses, budgetary balance…
Full description
Department of Finance Canada, tools prefixed finance_: the Fiscal Reference Tables (finance_frt_), one Excel workbook per edition 2019-2025 in English or French with about 55 tables: federal revenues, expenses, budgetary balance, public debt charges and debt since 1966-67 (Public Accounts), each province and territory's revenue, spending, deficit and net debt since 1990-91, government finance statistics for all levels of government, and G7 comparisons of revenue, spending, balance and debt; and The Fiscal Monitor (finance_fiscal_monitor_), the monthly federal year-to-date revenues, expenses, budgetary balance and financial requirement since January 2021. Canada.ca terms apply: non-commercial reproduction with attribution.
finance_fiscal_monitor_get_tables Read The Fiscal Monitor's tables for a month (federal year to date).
Use for the federal government's budgetary balance for the month and the fiscal year to date, revenues by source (personal, corporate and non-resident income tax, GST, EI premiums), expenses by type (Old Age Security, Canada Health Transfer, Canada Child Benefit, public debt charges), expenses by object, and the financial source or requirement, each against the same period a year earlier, plus the data behind the issue's charts. period is YYYY-MM (default the newest issue); table picks one ('2', 'Table 3', 'Chart 1'), else all are returned. Numbers are in $ millions unless the column says otherwise; negatives appear as negatives.
- Keywords
- federal deficit year to date, monthly budget balance, federal revenues and expenses, Fiscal Monitor tables, GST revenue, public debt charges monthly, Canada federal finances, financial requirement
- Mots-clés
- déficit fédéral cumulatif, solde budgétaire mensuel, revenus et charges fédéraux, tableaux de la revue financière, recettes de TPS, frais de la dette publique, finances fédérales, besoins financiers, ministère des Finances Canada
| Parameter | Type | Default |
|---|---|---|
period | str | "" |
table | str | "" |
lang | "en" | "fr" | "en" |
call_tool {"name": "finance_fiscal_monitor_get_tables", "arguments": {}}finance_fiscal_monitor_list_issues List the monthly issues of The Fiscal Monitor (Finance Canada).
Use for which months of federal fiscal results are published, with each issue's release date and page, newest first, since January 2021. Some issues cover two months (April and May) and are listed under their first month. Read one with finance_fiscal_monitor_get_tables.
- Keywords
- Fiscal Monitor, monthly federal fiscal results, federal deficit this year, year-to-date budgetary balance, Finance Canada monthly report, federal revenues monthly, government of Canada finances, fiscal update
- Mots-clés
- revue financière, résultats financiers mensuels, déficit fédéral cumulatif, solde budgétaire depuis le début de l'exercice, rapport mensuel des Finances, revenus fédéraux mensuels, finances du gouvernement du Canada, mise à jour financière, ministère des Finances Canada
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "finance_fiscal_monitor_list_issues", "arguments": {}}finance_frt_get_table Read one Fiscal Reference Tables table: every year, every column.
Use for the numbers behind a federal or provincial fiscal question, such as federal revenues and expenses by year (Table 1), personal and corporate income tax revenue (Table 3), public debt charges (Table 13), a province's deficit and net debt (Tables 18 to 30, Alberta is 26), all provinces combined (31, 32), or G7 net debt (54). Rows are keyed by the published column names with the fiscal or calendar year first; units are listed in info.units (millions of dollars, per cent of GDP) and footnotes in notes. last keeps only the most recent rows.
- Keywords
- federal budget balance by year, deficit history table, provincial deficit, net debt by province, federal revenue by source, program spending history, public accounts data, G7 government debt
- Mots-clés
- solde budgétaire fédéral par année, tableau historique du déficit, déficit provincial, dette nette par province, revenus fédéraux par source, dépenses de programmes, comptes publics, dette publique du G7, ministère des Finances Canada
| Parameter | Type | Default |
|---|---|---|
table | int | required |
edition | int | null | null |
last | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "finance_frt_get_table", "arguments": {"table": "…"}}finance_frt_list_tables List the tables in Finance Canada's Fiscal Reference Tables.
Use for finding long historical series of government finances in Canada: federal revenues, program expenses, budgetary deficit or surplus, public debt charges, accumulated deficit and interest-bearing debt since 1966-67 (Public Accounts); each province's and territory's revenues, federal transfers, spending, deficit and net debt since 1990-91; revenue, expense and balance sheets of all levels of government (national accounts, since 1991); and G7 comparisons of revenue, spending, balance, net and gross debt (% of GDP, since 1980). Editions 2019 to 2025 (default the newest), each about 55 tables. query filters titles and column names ('debt', 'Alberta', 'G7'). Then read one with finance_frt_get_table.
- Keywords
- Fiscal Reference Tables, federal deficit history, federal debt, provincial net debt, government revenue and spending, public debt charges, debt-to-GDP, fiscal history Canada
- Mots-clés
- tableaux de référence financiers, historique du déficit fédéral, dette fédérale, dette nette provinciale, revenus et dépenses publics, frais de la dette publique, ratio dette-PIB, finances publiques, ministère des Finances Canada
| Parameter | Type | Default |
|---|---|---|
edition | int | null | null |
query | str | "" |
lang | "en" | "fr" | "en" |
call_tool {"name": "finance_frt_list_tables", "arguments": {}}Federal and national
Elections Canada: federal general election results
elections_results_
Federal general election results from Elections Canada's official voting results (elections.ca), tools prefixed elections_results_: the 38th to 45th general elections (2004 to 2025).
Full description
Federal general election results from Elections Canada's official voting results (elections.ca), tools prefixed elections_results_: the 38th to 45th general elections (2004 to 2025). Every candidate's votes and share by electoral district (winners flagged), turnout and ballots by province, seats by party and gender, valid votes by party and province, riding-level turnout with the elected candidate, and returning officers, straight from the official CSV tables. elections_results_get_historical adds every general election from 1867 to 2015 by riding (party totals from the Winer and Ferris CC0 data set on Scholars Portal Dataverse), and elections_results_get_historical_candidates gives every candidate's name, party and votes by riding for general elections and by-elections since 1867 (Sevi's CC0 'Who Runs?' data set on Harvard Dataverse, compiled from ParlInfo). Official by-election tables are not covered (the Library of Parliament's history site blocks automated access). Poll-by-poll results stay on ckan_ (organization 'elections') and candidate finance is in elections_financial_returns_.
elections_results_get_historical Get federal election results by riding for every general election since 1867 (1st to 42nd).
Use for historical federal results before 2004 (or to compare 1867 to 2015): each riding's electors, ballots, rejected ballots, candidates, seats, and votes by party, largest first, with the party that led the vote. election is the general election number (1 = 1867, 20 = 1945, 36 = 1997, 42 = 2015); leave it out to search every election. province, constituency (also matches the riding's older name) and party (a mnemonic such as Lib, C, NDP, BQ, or part of a party name) are accent-insensitive filters. Source: the Winer and Ferris data set on Scholars Portal Dataverse (CC0), which holds party totals, not candidate names (use elections_results_get_historical_candidates for those), and ends in 2015; use elections_results_get_table for official Elections Canada results of the 38th to 45th. The data set is in English only: lang="fr" gives errors, notes and provenance in French and leaves the rows as published.
- Keywords
- historical election results, federal, Confederation, 1867, riding, constituency, party, Liberal, Conservative, CCF, Progressive Conservative, Social Credit, Bloc, votes, turnout, history
- Mots-clés
- résultats électoraux historiques, fédéral, Confédération, 1867, circonscription, parti, libéral, conservateur, CCF, Crédit social, Bloc, votes, participation, histoire
| Parameter | Type | Default |
|---|---|---|
election | int | null | null |
province | str | null | null |
constituency | str | null | null |
party | str | null | null |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "elections_results_get_historical", "arguments": {}}elections_results_get_historical_candidates Get every candidate's name, party and votes by riding for federal elections since 1867.
Use for who ran and who won in a riding before 2004 (the 36th and 37th general elections, 1997 and 2000, have no Elections Canada data files), candidate names, party, votes and share of votes, incumbents, gender and occupation, tracking one person across elections by candidate_id, and by-elections. election is the parliament number (1 = 1867, 35 = 1993, 36 = 1997, 37 = 2000, 44 = 2021) and year the election year; leave both out to search every election; giving both with a year in which that election was not held is an input error. province, riding, candidate (name) and party are accent-insensitive substring filters. The data set is in English only: lang="fr" gives errors, notes and provenance in French and leaves the rows as published. election_type is general (default), by-election or all. Source: Sevi's "Who Runs?" data set on Harvard Dataverse (CC0), compiled from ParlInfo; it is not an official publication, so use elections_results_get_table for the official 38th to 45th and elections_results_get_historical for party totals by riding.
- Keywords
- historical candidates, federal election, 1997, 2000, 1993, candidate names, riding, winner, elected, party, votes, incumbent, by-election, MP, Reform, Canadian Alliance, Progressive Conservative
- Mots-clés
- candidats historiques, élection fédérale, 1997, 2000, 1993, noms des candidats, circonscription, gagnant, élu, parti, votes, sortant, élection partielle, député, Réforme, Alliance canadienne
| Parameter | Type | Default |
|---|---|---|
election | int | null | null |
year | int | null | null |
province | str | null | null |
riding | str | null | null |
candidate | str | null | null |
party | str | null | null |
winners_only | bool | false |
election_type | "general" | "by-election" | "all" | "general" |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "elections_results_get_historical_candidates", "arguments": {}}elections_results_get_table Get official federal election results from Elections Canada for one general election.
Use for who won a riding (table candidates with winners_only, or district_results for the elected candidate), every candidate's votes and share of votes in a riding, provincial turnout (turnout), seats by party and gender (seats), valid votes and vote share by party and province (votes_by_party, vote_share_by_party), and returning officers. election is the general election number (45 = April 28, 2025, 44 = 2021, 43 = 2019, 42 = 2015, 41 = 2011, 40 = 2008, 39 = 2006, 38 = 2004). province, district (name in either language, or riding number) and party are accent-insensitive substring filters; a filter needs a matching column in that table. Rows are text exactly as published, in English and French.
- Keywords
- election results, riding, electoral district, candidate, votes, winner, elected, MP, party, Liberal, Conservative, NDP, Bloc, Green, seats, turnout, federal, Elections Canada
- Mots-clés
- résultats électoraux, circonscription, candidat, votes, gagnant, élu, député, parti, libéral, conservateur, NPD, Bloc québécois, sièges, participation, fédéral, Élections Canada
| Parameter | Type | Default |
|---|---|---|
election | int | required |
table | "turnout" | "seats" | "votes_by_party" | "vote_share_by_party" | "district_results" | "candidates" | "returning_officers" | required |
province | str | null | null |
district | str | null | null |
party | str | null | null |
winners_only | bool | false |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "elections_results_get_table", "arguments": {"election": "…", "table": "…"}}elections_results_list_elections List the federal general elections and result tables available (38th to 45th, 2004 to 2025).
Use for seeing which federal general elections have official results here (with polling dates), which tables exist (turnout, seats, votes by party, riding results, every candidate), and what is not covered (elections before 2004, by-elections, poll-by-poll). No upstream call is made.
- Keywords
- federal election, general election, results, Elections Canada, official voting results, 2025, 2021, 2019, 2015, vote, riding, turnout
- Mots-clés
- élection fédérale, élections générales, résultats, Élections Canada, résultats officiels du vote, circonscription, participation, scrutin
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "elections_results_list_elections", "arguments": {}}Federal and national
Financial Consumer Agency of Canada: comparison tools
fcac_
Financial Consumer Agency of Canada comparison tools (itools-ioutils.fcac-acfc.gc.ca, tools prefixed fcac_): credit cards offered in a province (about 95 in Ontario: annual fees, purchase, cash advance and balance transfer rates, foreign conversion fee, minimum income, rewards…
Full description
Financial Consumer Agency of Canada comparison tools (itools-ioutils.fcac-acfc.gc.ca, tools prefixed fcac_): credit cards offered in a province (about 95 in Ontario: annual fees, purchase, cash advance and balance transfer rates, foreign conversion fee, minimum income, rewards, insurance) and chequing and savings accounts (monthly fees and how to waive them, included transactions, interest rate tiers, withdrawal, transfer, overdraft, NSF and other fees, low-cost and no-cost accounts). Data comes from the financial institutions and is read live (EN/FR); only products submitted to FCAC are listed.
fcac_get_bank_account Every fee of one chequing or savings account, from FCAC's Account Comparison Tool.
Use for one account's monthly fee and how to waive it, included transactions, interest rate tiers, and the fees once included transactions run out: withdrawals (branch, ATM, other bank's ATM, abroad), transfers and Interac e-Transfers, overdraft protection, non-sufficient funds (NSF), debit purchases abroad, bill payments, cheque images and statements. product_id comes from fcac_search_bank_accounts; pass the same province, account_type, currency and groups used there, because the tool only opens an account from its result list. Every section is under sections.
- Keywords
- bank account fees, NSF fee, overdraft fee, ATM fee, e-Transfer fee, monthly fee waiver, minimum balance, savings interest rate, FCAC, chequing account
- Mots-clés
- frais de compte bancaire, frais d'insuffisance de fonds, chèque sans provision, frais de découvert, frais de guichet, frais de retrait, virement Interac, forfait bancaire, solde minimum, taux d'intérêt épargne, ACFC, compte-chèques
| Parameter | Type | Default |
|---|---|---|
product_id | str | required |
province | "AB" | "BC" | "MB" | "NB" | "NL" | "NS" | "NT" | "NU" | "ON" | "PE" | "QC" | "SK" | "YT" | required |
account_type | "chequing" | "savings" | "chequing" |
currency | "CAD" | "USD" | "other" | "CAD" |
groups | list["senior" | "gis_recipient" | "rdsp_beneficiary" | "youth" | "student" | "newcomer" | "indigenous" | "social_assistance" | "disability_tax_credit"] | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "fcac_get_bank_account", "arguments": {"product_id": "…", "province": "…"}}fcac_get_credit_card Full details of one credit card from FCAC's Credit Card Comparison Tool.
Use for one card's annual fees (first and additional card), purchase, cash advance and balance transfer interest rates, foreign currency conversion fee, minimum personal and household income (0 when FCAC says "Not required", null only when not stated), reward categories and how to redeem them, other benefits, and included insurance (travel medical, trip cancellation, rental car, and more). product_id comes from fcac_search_credit_cards; pass the same province, currency, student and secured values used there, because the tool only opens a card from its result list. Every section of the page is also returned under sections.
- Keywords
- credit card details, cash advance rate, balance transfer rate, foreign transaction fee, minimum income, card insurance, annual fee, FCAC, card benefits, rewards program
- Mots-clés
- détails de carte de crédit, taux d'avance de fonds, taux de transfert de solde, frais de conversion de devises, revenu minimum, assurance voyage, assurance carte, frais annuels, ACFC, avantages
| Parameter | Type | Default |
|---|---|---|
product_id | str | required |
province | "AB" | "BC" | "MB" | "NB" | "NL" | "NS" | "NT" | "NU" | "ON" | "PE" | "QC" | "SK" | "YT" | required |
currency | "CAD" | "USD" | "other" | "CAD" |
student | bool | false |
secured | bool | false |
lang | "en" | "fr" | "en" |
call_tool {"name": "fcac_get_credit_card", "arguments": {"product_id": "…", "province": "…"}}fcac_search_bank_accounts Compare chequing or savings accounts in a province, from FCAC's Account Comparison Tool.
Use for bank and credit union accounts available in a province (two-letter code) with their monthly fee (chequing), interest rate (savings), included transactions and whether they fall under the Commitment on Low-Cost and No-Cost Accounts (about 61 chequing and 38 savings accounts in Ontario). groups adds accounts offered to 'senior', 'gis_recipient', 'rdsp_beneficiary', 'youth', 'student', 'newcomer', 'indigenous', 'social_assistance' or 'disability_tax_credit' customers. Filter by words in the name, institution, maximum monthly fee (dollars) or low_cost_only. Default order is FCAC's (most included transactions first). Pass a product_id with the same options to fcac_get_bank_account for every fee. Read live; lang="fr" returns FCAC's French names and labels (numbers are the same), and query and institution then match the French names, ignoring case, accents and apostrophe style.
- Keywords
- bank account, chequing account, savings account, monthly fee, bank fees, low-cost account, no-fee account, interest rate, FCAC, compare accounts, credit union, transactions
- Mots-clés
- compte bancaire, compte-chèques, compte chèque, compte d'épargne, forfait bancaire, frais mensuels, frais bancaires, compte à frais modiques, compte sans frais, taux d'intérêt, ACFC, coopérative de crédit, caisse populaire
| Parameter | Type | Default |
|---|---|---|
province | "AB" | "BC" | "MB" | "NB" | "NL" | "NS" | "NT" | "NU" | "ON" | "PE" | "QC" | "SK" | "YT" | required |
account_type | "chequing" | "savings" | "chequing" |
currency | "CAD" | "USD" | "other" | "CAD" |
groups | list["senior" | "gis_recipient" | "rdsp_beneficiary" | "youth" | "student" | "newcomer" | "indigenous" | "social_assistance" | "disability_tax_credit"] | null | null |
query | str | "" |
institution | str | "" |
max_monthly_fee | float | null | null |
low_cost_only | bool | false |
sort | "monthly_fee" | "institution" | "name" | null | null |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "fcac_search_bank_accounts", "arguments": {"province": "…"}}fcac_search_credit_cards Compare credit cards offered in a province, from FCAC's Credit Card Comparison Tool.
Use for which credit cards are available in a province (two-letter code, e.g. 'ON', 'QC') and what they cost: annual fee, purchase interest rate and reward categories, for every card the financial institutions list with the Financial Consumer Agency of Canada (about 95 in Ontario). Filter by words in the card or bank name, institution, maximum annual fee (dollars), maximum purchase rate (percent) and rewards ('cash_back', 'travel', 'groceries', 'gas', 'general_merchandise'; every one given must apply). student=True adds student cards; secured=True lists secured cards instead. Default order is FCAC's (annual fee, low to high). Pass a product_id with the same province and options to fcac_get_credit_card for cash advance and balance transfer rates, foreign conversion fee, minimum income and insurance. Read live; lang="fr" returns FCAC's French names, labels and reward categories (numbers are the same), and query and institution then match the French names, ignoring case, accents and apostrophe style.
- Keywords
- credit card, interest rate, annual fee, APR, rewards card, cash back, travel rewards, low interest card, FCAC, compare cards, bank fees, consumer finance
- Mots-clés
- carte de crédit, comparer les cartes de crédit, taux d'intérêt, frais annuels, carte sans frais annuels, récompenses, remise en argent, points de récompense, carte à faible taux, carte étudiante, carte de crédit garantie, Agence de la consommation en matière financière du Canada (ACFC), frais bancaires
| Parameter | Type | Default |
|---|---|---|
province | "AB" | "BC" | "MB" | "NB" | "NL" | "NS" | "NT" | "NU" | "ON" | "PE" | "QC" | "SK" | "YT" | required |
currency | "CAD" | "USD" | "other" | "CAD" |
student | bool | false |
secured | bool | false |
query | str | "" |
institution | str | "" |
max_annual_fee | float | null | null |
max_purchase_rate | float | null | null |
rewards | list["cash_back" | "travel" | "groceries" | "gas" | "general_merchandise"] | null | null |
sort | "annual_fee" | "purchase_rate" | "institution" | "name" | null | null |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "fcac_search_credit_cards", "arguments": {"province": "…"}}Federal and national
House of Commons open data
ourcommons_
House of Commons open data (ourcommons.ca, the official XML feeds), tools prefixed ourcommons_: current Members of Parliament by province, party and constituency…
Full description
House of Commons open data (ourcommons.ca, the official XML feeds), tools prefixed ourcommons_: current Members of Parliament by province, party and constituency; one member's roles and history by person id (every seat with dates, caucus changes, parliamentary positions, committee memberships, parliamentary associations, and the election candidate record with results, going back to 1997 for former members); party standings by province; and the Ministry (Cabinet) in order of precedence. Terms: House of Commons open data disclaimer. Not covered: members' expenditure reports (they need a document id from the page) and the Library of Parliament's ParlInfo, which blocks automated access.
ourcommons_get_member_roles Get one Member of Parliament's full record: seats, caucus, committees, positions and elections.
Use for an MP's career on the House of Commons record: every seat held with dates, party changes, parliamentary positions (Speaker, secretary, critic), committee memberships, parliamentary associations, and the election candidate history with results (Elected, Re-Elected, Defeated). person_id comes from ourcommons_list_members (or the id in a member's ourcommons.ca page address); former members work too, with history from the 1990s.
- Keywords
- MP career, member roles, committee membership, election history, caucus, parliamentary secretary, Speaker, re-elected, defeated, person id
- Mots-clés
- carrière d'un député, rôles, comités, historique électoral, caucus, secrétaire parlementaire, président de la Chambre, réélu, défait
| Parameter | Type | Default |
|---|---|---|
person_id | int | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ourcommons_get_member_roles", "arguments": {"person_id": "…"}}ourcommons_get_ministry Get the current Ministry (federal Cabinet) in order of precedence, with titles and start dates.
Use for who is Prime Minister and which minister holds which portfolio now, with the date each took office and their province.
- Keywords
- Cabinet, Ministry, ministers, Prime Minister, portfolio, order of precedence, federal government, minister of finance
- Mots-clés
- Conseil des ministres, ministère, ministres, premier ministre, portefeuille, ordre de préséance, gouvernement fédéral, ministre des Finances
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "ourcommons_get_ministry", "arguments": {}}ourcommons_get_party_standings Get current party standings in the House of Commons, by party and by province or territory.
Use for seats held now by each party (Liberal, Conservative, Bloc, NDP, Green, independents), and how each province or territory's seats split between parties. Vacant seats appear as party 'Vacant'.
- Keywords
- party standings, seats, House of Commons, current, Liberal, Conservative, majority, minority, province, distribution of seats
- Mots-clés
- répartition des sièges, partis, Chambre des communes, actuel, libéral, conservateur, majorité, minorité, province
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "ourcommons_get_party_standings", "arguments": {}}ourcommons_list_members List current Members of Parliament from the House of Commons, filtered by place, party or name.
Use for finding who represents a riding, all MPs of a party or province, or an MP's person id (needed by ourcommons_get_member_roles). Filters are accent-insensitive substring matches: province (e.g. Alberta, British Columbia or Colombie-Britannique, or a code such as BC), party (Liberal/Libéral, Conservative/Conservateur, Bloc Québécois, NDP/NPD, Green Party/Parti vert), constituency and name. Province and party work in English or French with either lang; results show the names in the feed's language. The official feed of sitting members.
- Keywords
- Member of Parliament, MP, riding, constituency, House of Commons, party, caucus, representative, federal, who represents, ourcommons
- Mots-clés
- député, députée, circonscription, Chambre des communes, parti, caucus, représentant, fédéral, qui représente, ourcommons
| Parameter | Type | Default |
|---|---|---|
province | str | null | null |
party | str | null | null |
constituency | str | null | null |
name | str | null | null |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ourcommons_list_members", "arguments": {}}Federal and national
National Forestry Database (CCFM)
nfd_
National Forestry Database (nfdp.ccfm.org, Canadian Council of Forest Ministers, tools prefixed nfd_): 25 tables by province and territory, 1940 to 2025.
Full description
National Forestry Database (nfdp.ccfm.org, Canadian Council of Forest Ministers, tools prefixed nfd_): 25 tables by province and territory, 1940 to 2025. Forest fires (number and area burned by cause, month and fire size class, property losses), insects (defoliated area), roundwood harvest (volume by category, species group and tenure; area by harvesting method), wood supply, regeneration (site preparation, scarification, seeding, planting, stand tending), timber revenues and pest control (insecticides and herbicides). List tables, describe a table (dimensions, units, data dictionary, data-quality codes), query rows with province, year and category filters or sum them, and read the agencies' comments and footnotes. English or French labels. Open Government Licence - Canada.
nfd_describe_table Describe one National Forestry Database table: columns, units, jurisdictions and quality codes.
Use for the step before nfd_query_table. Gives the table's data dictionary (title, source agency, last update), the unit of the value, the years each province or territory covers, every category column (dimensions, e.g. cause, month, tenure, species group, treatment, product) with its values, the data-quality codes in use (a actual, E and e estimated, p preliminary, r revised, u and U not available, n not applicable, s too small) and checked quirks of that file. table_id is the number from nfd_list_tables, e.g. '3.2.1' (area burned by cause), '5.1' (roundwood volume harvested), '6.4' (seedlings planted), '7' (timber revenues). lang="fr" gives French labels.
- Keywords
- NFD table description, forest fire cause classes, tenure, species group, data dictionary, data qualifier, hectares burned, harvest categories, forestry data codebook, jurisdictions covered
- Mots-clés
- description de tableau, dictionnaire de données, qualificatifs de données, origine des incendies, groupe d'espèces, tenure, hectares brûlés, catégories de récolte, provinces et territoires, Base nationale de données forestières
| Parameter | Type | Default |
|---|---|---|
table_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "nfd_describe_table", "arguments": {"table_id": "…"}}nfd_list_tables List the National Forestry Database tables (forest fires, harvest, wood supply, pests).
Use for the first step before nfd_describe_table or nfd_query_table: the 25 tables of the Canadian Council of Forest Ministers' National Forestry Database with their number, topic and title, and links to the CSV, Excel, data dictionary and comments files. Topics: Wood Supply (2), Forest Fires (3.1.1 number of fires and 3.2.1 area burned by cause, month and fire size class; 3.3 property losses), Forest Insects (4), Harvest (5.1 volume, 5.2 area), Regeneration (6.1 to 6.6: site preparation, scarification, seeding, planting, stand tending), Revenues (7) and Pest Control (8.1 insecticides, 8.2 herbicides). section keeps tables whose topic or title contains the text, e.g. 'fires' or 'planted'. lang="fr" gives French titles.
- Keywords
- National Forestry Database, NFD, CCFM, forest statistics, forest fires, area burned, timber harvest, wood supply, reforestation, insect defoliation, pesticide use, forestry tables, Canadian Forest Service
- Mots-clés
- Base nationale de données forestières, BNDF, CCMF, statistiques forestières, incendies de forêt, superficie brûlée, récolte de bois, approvisionnement en bois, reboisement, défoliation par les insectes, pesticides, Service canadien des forêts
| Parameter | Type | Default |
|---|---|---|
section | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "nfd_list_tables", "arguments": {}}nfd_query_table Get National Forestry Database rows: wildfire, harvest, planting, insects, revenues by province.
Use for area burned and number of wildfires by cause (human or natural), month or fire size class; timber harvested (cubic metres) by category, species group and tenure; area harvested by method; wood supply; seedlings planted and area planted, seeded, scarified or tended; insect defoliation by species; timber revenues; insecticide and herbicide use, by province or territory and year (1940 to 2025 by table; 1990 on for fires). province is a code or name ('BC', 'Alberta', 'Colombie-Britannique'); filters maps a column from nfd_describe_table to a value or list, e.g. {'cause': 'Natural cause'} or {'tenure': ['Provincial land', 'Private land']}. group_by (e.g. ['year'], ['jurisdiction'], ['year', 'cause']) sums values over the other columns; without it rows come as published, with null for a missing figure and its quality code, never 0. Rows are in year order; past limit the latest rows are dropped. Every row carries its unit. lang="fr" gives French labels.
- Keywords
- wildfire area burned by province, number of fires by cause, forest fires Canada, timber harvest volume, roundwood harvested, seedlings planted, insect defoliation, mountain pine beetle, forest revenues, herbicide use, National Forestry Database, hectares
- Mots-clés
- superficie brûlée par province, nombre d'incendies par origine, incendies de forêt au Canada, volume de bois récolté, bois rond, semis plantés, défoliation par les insectes, dendroctone du pin, revenus forestiers, herbicides, Base nationale de données forestières, hectares
| Parameter | Type | Default |
|---|---|---|
table_id | str | required |
province | str | list[str] | null | null |
year_from | int | null | null |
year_to | int | null | null |
filters | dict[str, str | list[str] | null] | null | null |
group_by | list[str] | null | null |
drop_missing | bool | false |
limit | int | 200 |
lang | "en" | "fr" | "en" |
call_tool {"name": "nfd_query_table", "arguments": {"table_id": "…"}}nfd_table_comments Read the agencies' comments and footnotes for a National Forestry Database table.
Use for how a province or territory compiled a series: definition changes, years carried forward, methods, what a footnote letter on a label means ('*b'), e.g. why a harvest or wood supply figure changed. Comments come per jurisdiction and year; identical text is merged with the years it applies to. Six fire tables (3.1.1 to 3.2.3) have none. province takes a code or name; lang="fr" reads the French sheet.
- Keywords
- forestry data comments, footnotes, methodology notes, data notes by province, allowable annual cut, definitions, series break, National Forestry Database, harvest methods, data caveats
- Mots-clés
- commentaires sur les données, renvois, notes méthodologiques, notes par province, possibilité annuelle de coupe, définitions, rupture de série, Base nationale de données forestières, méthodes de récolte, limites des données
| Parameter | Type | Default |
|---|---|---|
table_id | str | required |
province | str | list[str] | null | null |
year_from | int | null | null |
year_to | int | null | null |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "nfd_table_comments", "arguments": {"table_id": "…"}}Federal and national
Parliamentary Budget Officer
pbo_
Office of the Parliamentary Budget Officer (pbo-dpb.ca, tools prefixed pbo_): search PBO's 860+ publications (reports, notes, legislative costing notes, cost estimates of bills and motions, archived work since 2008) and read one with its tables: cost estimates over five years…
Full description
Office of the Parliamentary Budget Officer (pbo-dpb.ca, tools prefixed pbo_): search PBO's 860+ publications (reports, notes, legislative costing notes, cost estimates of bills and motions, archived work since 2008) and read one with its tables: cost estimates over five years, economic and fiscal projections, Estimates analysis. Tables come from PBO's structured PBOML documents, present for costing notes since 2021 and most reports since 2025; older items link to their PDF only. Also the register of 1,100+ information requests PBO sent to federal departments since 2008, with deadlines, status and outcome (disclosed, in part, refused), counted by department. Use is personal and non-commercial, unaltered, with attribution to PBO.
pbo_get_information_request Read one PBO information request with links to its letters.
Use for the details of one request from pbo_search_information_requests: department, dates, status, outcome and note, and the request letter and the department's replies (mostly PDF) in the requested language. request_id is PBO's number, e.g. 'IR0959', 'RI0929' or 'IR0080a'. The first request-register call in a session takes about 30 seconds: PBO's API cannot look a request up by its number and ignores filters, so all ~29 register pages are read at one per second, then kept for 6 hours (later calls answer in under a second).
- Keywords
- PBO information request, request letter, reply letter, departmental response, disclosure, Parliamentary Budget Officer, IR number, request details
- Mots-clés
- demande d'information du DPB, lettre de demande, lettre de réponse, réponse du ministère, communication, directeur parlementaire du budget, numéro de demande, détails
| Parameter | Type | Default |
|---|---|---|
request_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "pbo_get_information_request", "arguments": {"request_id": "…"}}pbo_get_publication Read one PBO publication with its tables and text.
Use for getting the numbers in a PBO costing or report: five-year cost estimates of a measure, projected revenues and spending, economic projections (GDP, unemployment, interest rates), Estimates breakdowns. publication_id is PBO's id, e.g. 'LEG-2526-012-S' or 'RP-2627-002-S', from pbo_search_publications. Tables come from PBO's structured PBOML document: 'table' ones have rows keyed by column label, 'html' ones rows of cells, 'kvlist' ones key/value pairs, each with sources and notes. Costing notes since 2021 and most reports since 2025 have them; older publications return has_structured_content false and a PDF link. Charts are images without data. Reuse is personal and non-commercial, unaltered, crediting PBO.
- Keywords
- PBO tables, cost estimate figures, costing results, fiscal impact, revenue projection, spending projection, economic projection, Parliamentary Budget Officer
- Mots-clés
- tableaux du DPB, estimation des coûts, incidence financière, projection des revenus, projection des dépenses, projection économique, directeur parlementaire du budget, résultats de l'évaluation
| Parameter | Type | Default |
|---|---|---|
publication_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "pbo_get_publication", "arguments": {"publication_id": "…"}}pbo_search_information_requests Search the register of information requests PBO sent to federal departments.
Use for what data the Parliamentary Budget Officer asked departments for, and whether they answered: all 1,100+ requests since 2008 with the department, request date, deadline, extension, status and outcome (all disclosed, disclosed in part, nothing disclosed, information does not exist). Counts by outcome, status and department come with every result, so it answers "how often did National Defence refuse PBO" or "which requests are overdue". query matches words in the request summary (English and French, accents ignored); department an acronym (FIN, DND, CRA, TBS) or part of a name; status 'open' keeps every pending request, and open ones carry days_past_deadline; since/until bound the request date (YYYY, YYYY-MM or YYYY-MM-DD). 25 per page, newest first. Pass an id to pbo_get_information_request for the letters. The first call in a session takes about 30 seconds while the whole register is read (the API ignores filters); it is then kept 6 hours.
- Keywords
- Parliamentary Budget Officer, PBO information request, access to information, departmental disclosure, refused request, overdue request, government transparency, data request, PBO mandate
- Mots-clés
- directeur parlementaire du budget, DPB, demande d'information, communication de renseignements, refus de communiquer, demande en retard, transparence gouvernementale, ministère fédéral
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
department | str | "" |
status | "completed" | "pending" | "pending_correspondence" | "pending_data" | "canceled" | str | null | null |
disposition | "all_disclosed" | "disclosed_in_part" | "nothing_disclosed" | "does_not_exist" | null | null |
since | str | "" |
until | str | "" |
page | int | 1 |
lang | "en" | "fr" | "en" |
call_tool {"name": "pbo_search_information_requests", "arguments": {}}pbo_search_publications Search Parliamentary Budget Officer (PBO) publications.
Use for finding PBO's independent cost estimates of bills, motions and budget measures, legislative costing notes, economic and fiscal outlooks, reports on the Estimates, federal spending, program costs, tax changes and the public service. With a query, PBO's own search ranks results; without one, the newest come first. types keeps some kinds: RP report, NT note, LEG legislative costing note, ES cost estimate, OA additional analysis, LIBARC archived (2008-2021). 15 per page. Pass a result's id to pbo_get_publication for its tables.
- Keywords
- Parliamentary Budget Officer, PBO, cost estimate, costing note, fiscal cost, bill costing, economic and fiscal outlook, federal budget analysis, Estimates, fiscal sustainability
- Mots-clés
- directeur parlementaire du budget, DPB, estimation des coûts, note d'évaluation, coût financier, projet de loi, perspectives économiques et financières, budget fédéral, budget des dépenses, viabilité financière
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
types | list["RP" | "NT" | "LEG" | "ES" | "OA" | "LIBARC"] | null | null |
page | int | 1 |
lang | "en" | "fr" | "en" |
call_tool {"name": "pbo_search_publications", "arguments": {}}Federal and national
World Bank World Development Indicators (Canada and peers)
worldbank_
World Bank World Development Indicators (WDI), centred on Canada: search the 1,500 WDI indicators by words or topic, read an indicator's definition, and fetch Canada's annual series (GDP, growth, inflation, unemployment, trade, population, emissions and more, many from 1960)…
Full description
World Bank World Development Indicators (WDI), centred on Canada: search the 1,500 WDI indicators by words or topic, read an indicator's definition, and fetch Canada's annual series (GDP, growth, inflation, unemployment, trade, population, emissions and more, many from 1960), optionally compared with G7 or OECD member countries or the OECD members aggregate. CC BY 4.0.
worldbank_get_canada_series Get Canada's annual World Bank WDI series, optionally beside G7 or OECD peers.
Use for how Canada compares internationally on one indicator over time: real GDP growth (NY.GDP.MKTP.KD.ZG), GDP per capita at PPP (NY.GDP.PCAP.PP.KD), inflation (FP.CPI.TOTL.ZG), unemployment (SL.UEM.TOTL.ZS), exports (NE.EXP.GNFS.ZS), population (SP.POP.TOTL), CO2 emissions per capita (EN.GHG.CO2.PC.CE.AR5). Canada is always included, first. compare_with takes "G7", "OECD" (the World Bank's OECD members aggregate), "OECD_MEMBERS" (all 38) or ISO3 codes of OECD members ("USA", "AUS"); other countries are refused. Years: start_year/end_year, or most_recent (the last N years with a value). With comparisons the result gives Canada's rank (1 = highest). Canadian sources (StatCan, Bank of Canada) are better for Canada's own latest figures.
- Keywords
- world bank, Canada compared, international comparison, G7 comparison, OECD comparison, peer countries, cross-country, ranking, GDP per capita, annual series, Canada vs United States
- Mots-clés
- Banque mondiale, Canada comparé, comparaison internationale, comparaison avec le G7, comparaison avec l'OCDE, pays comparables, classement du Canada, PIB par habitant, série annuelle, Canada et États-Unis
| Parameter | Type | Default |
|---|---|---|
indicator | str | required |
compare_with | list[str] | null | null |
start_year | int | null | null |
end_year | int | null | null |
most_recent | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "worldbank_get_canada_series", "arguments": {"indicator": "…"}}worldbank_get_indicator Get the definition and original source of one World Bank WDI indicator.
Use for checking what a World Development Indicators code measures and who compiles it (e.g. NY.GDP.PCAP.PP.KD is GDP per capita at constant PPP dollars from the World Bank's national accounts; SL.UEM.TOTL.ZS is the ILO modelled unemployment rate, not Statistics Canada's Labour Force Survey rate) before comparing Canada with other countries.
- Keywords
- world bank, WDI, indicator definition, methodology, source organization, metadata, ILO modelled estimate, purchasing power parity, international data
- Mots-clés
- Banque mondiale, WDI, définition de l'indicateur, méthodologie, organisme source, métadonnées, estimation modélisée de l'OIT, parité de pouvoir d'achat, données internationales
| Parameter | Type | Default |
|---|---|---|
indicator | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "worldbank_get_indicator", "arguments": {"indicator": "…"}}worldbank_list_topics List the World Bank WDI topics (themes) with how many indicators each has.
Use for browsing World Development Indicators by theme before a search (economy and growth, trade, health, education, environment, climate change, energy, financial sector, public sector, labour and social protection, science and technology), to pick the topic for worldbank_search_indicators.
- Keywords
- world bank, WDI topics, themes, indicator categories, international indicators, browse, economy and growth, climate change, trade, health, education
- Mots-clés
- Banque mondiale, thèmes WDI, catégories d'indicateurs, indicateurs internationaux, parcourir, économie et croissance, changement climatique, échanges commerciaux, santé, éducation
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "worldbank_list_topics", "arguments": {}}worldbank_search_indicators Find a World Bank World Development Indicators code to compare Canada internationally.
Use for finding the WDI code for an international comparison of Canada (GDP per capita, real GDP growth, inflation, unemployment, exports as a share of GDP, government debt, CO2 emissions, life expectancy, R&D spending, population ageing). query matches every word against the name, code and definition; topic (an id or name from worldbank_list_topics, e.g. 3 or "Economy & Growth") narrows to one theme. Then call worldbank_get_canada_series with the code.
- Keywords
- world bank, world development indicators, WDI, international comparison, indicator code, cross-country, G7, OECD countries, peer countries, global ranking, GDP per capita, development indicators
- Mots-clés
- Banque mondiale, Indicateurs du développement dans le monde (IDM), comparaison internationale, code d'indicateur, comparaison entre pays, pays du G7, pays de l'OCDE, pays comparables, classement mondial, PIB par habitant, indicateurs internationaux
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
topic | str | null | null |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "worldbank_search_indicators", "arguments": {}}Federal and national
Canada Gazette
gazette_
Canada Gazette: list recent issues of Part I (notices and proposed regulations) and Part II (registered regulations, SOR/SI), list an issue's notices by section, department and act, and read a notice's text, in English or French.
gazette_get_issue List every notice or regulation in one Canada Gazette issue.
Use for seeing what was published on a date (default: the latest issue), grouped by section (government notices, commissions, proposed regulations, miscellaneous notices) with the department and act for Part I, or the SOR/SI instruments for Part II. issue_date is YYYY-MM-DD from gazette_list_issues.
- Keywords
- Canada Gazette issue, table of contents, notices, regulations, department, act, SOR, SI, publication date
- Mots-clés
- édition de la Gazette du Canada, table des matières, avis, règlements, ministère, loi, DORS, TR
| Parameter | Type | Default |
|---|---|---|
part | 1 | 2 | 1 |
issue_date | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "gazette_get_issue", "arguments": {}}gazette_get_notice Read the text of one Canada Gazette notice or regulation.
Use for the wording of a notice, proposed regulation (with its Regulatory Impact Analysis Statement) or registered regulation. url comes from gazette_get_issue; the language follows the URL (open the French issue for French text).
- Keywords
- Canada Gazette notice text, regulation text, RIAS, regulatory impact, proposed regulation, order, Canada Gazette, notice
- Mots-clés
- texte de l'avis, texte du règlement, REIR, résumé de l'étude d'impact, projet de règlement, décret, Gazette du Canada, avis
| Parameter | Type | Default |
|---|---|---|
url | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "gazette_get_notice", "arguments": {"url": "…"}}gazette_list_issues List recent Canada Gazette issues (Part I notices, Part II regulations).
Use for finding an issue date to open with gazette_get_issue. Part I (weekly, Saturdays) carries government notices, commission notices and proposed regulations; Part II (every second Wednesday) carries registered regulations (SOR) and statutory instruments (SI).
- Keywords
- Canada Gazette, government notices, proposed regulations, regulations, SOR, orders in council, official publication, Part I
- Mots-clés
- Gazette du Canada, avis du gouvernement, projets de règlement, règlements, DORS, décrets, publication officielle, Partie I
| Parameter | Type | Default |
|---|---|---|
part | 1 | 2 | 1 |
limit | int | 10 |
lang | "en" | "fr" | "en" |
call_tool {"name": "gazette_list_issues", "arguments": {}}Federal and national
Canadian Food Inspection Agency
cfia_
Canadian Food Inspection Agency animal disease tables on inspection.canada.ca, tools prefixed cfia_: yearly counts of confirmed herds and flocks per federally reportable terrestrial animal disease, 2011 to the current year (updated on the 10th of each month…
Full description
Canadian Food Inspection Agency animal disease tables on inspection.canada.ca, tools prefixed cfia_: yearly counts of confirmed herds and flocks per federally reportable terrestrial animal disease, 2011 to the current year (updated on the 10th of each month; the CKAN copy stops at 2021); one row per confirmation, with date, province and animal type, for chronic wasting disease, scrapie, bovine tuberculosis, cysticercosis, BSE, trichinellosis and avian influenza before 2021; and every highly pathogenic avian influenza infected premises since December 2021 (current or released, province, municipality, commercial or not, WOAH class, control zone) with the CFIA's status by province table (birds impacted). Read from the HTML pages, which have no data file behind them; rabies, aquatic animal diseases and food testing are CKAN datasets (cfia-acia).
cfia_avian_influenza Get highly pathogenic avian influenza (HPAI, bird flu) infected premises in Canada from CFIA.
Use for every poultry and bird premises the CFIA has confirmed with avian influenza since December 2021 (about 660): premises id, date detected, province, municipality, commercial or non-commercial, WOAH poultry or non-poultry, primary control zone and its order, and whether it is still under CFIA quarantine (status="current") or released. Filter by province (code or name), date_from/date_to (YYYY, YYYY-MM or YYYY-MM-DD) and premises_type; counts gives current and released premises by province, month, year or premises type. The result also carries the CFIA's status-by-province table with the estimated birds impacted. Newest first, up to limit (default 25, max 1000). lang="fr" gives French municipalities, zones (ZCP) and labels; dates follow the English page.
- Keywords
- avian influenza, bird flu, HPAI, H5N1, infected premises, poultry outbreak, CFIA, quarantine, control zone, birds impacted, flocks
- Mots-clés
- influenza aviaire, grippe aviaire, IAHP, H5N1, lieux infectés, éclosion, volailles, ACIA, quarantaine, zone de contrôle primaire, oiseaux touchés
| Parameter | Type | Default |
|---|---|---|
status | "current" | "released" | "all" | "all" |
province | str | null | null |
date_from | str | null | null |
date_to | str | null | null |
premises_type | "commercial" | "non_commercial" | "captive_wild" | null | null |
counts_by | "province" | "month" | "year" | "premises_type" | "province" |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cfia_avian_influenza", "arguments": {}}cfia_disease_detections List each confirmed CFIA detection of a reportable animal disease: date, province, species.
Use for when and where chronic wasting disease was confirmed in farmed deer and elk (monthly, 2011 to now), scrapie in sheep and goat flocks, bovine tuberculosis and cysticercosis in cattle herds, BSE cases (with the animal's age), trichinellosis, and avian influenza in poultry before 2021. disease takes a name or abbreviation in English or French (default: all seven); filter by year, province (code or name) or animal_type ("elk", "wapiti", "goat"); counts_by groups rows by year, YYYY-MM month, province or animal type. herds counts the herds a row stands for ("Elk (3 herds)"), matching the yearly totals of cfia_reportable_diseases. For avian influenza since December 2021 use cfia_avian_influenza. lang="fr" gives French locations, animal types and notes; dates follow the English pages.
- Keywords
- chronic wasting disease, CWD, scrapie, bovine tuberculosis, BSE, mad cow, cysticercosis, detections, herds infected, deer, elk, CFIA
- Mots-clés
- maladie débilitante chronique, MDC, tremblante, tuberculose bovine, ESB, vache folle, cysticercose, détections, troupeaux infectés, cerf, wapiti, ACIA
| Parameter | Type | Default |
|---|---|---|
disease | str | null | null |
year_from | int | null | null |
year_to | int | null | null |
province | str | null | null |
animal_type | str | null | null |
counts_by | "year" | "month" | "province" | "animal_type" | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "cfia_disease_detections", "arguments": {}}cfia_reportable_diseases Get yearly counts of federally reportable terrestrial animal diseases in Canada (CFIA).
Use for how many farmed herds or flocks were confirmed with a federally reportable disease each year from 2011 to the current year (avian influenza, chronic wasting disease, equine infectious anemia, bovine tuberculosis, scrapie, cysticercosis, BSE, Newcastle disease, anthrax, anaplasmosis, trichinellosis), as published by the CFIA and updated on the 10th of each month (current_as_of gives the month end the counts run to). disease accepts a name in either language or an abbreviation ("CWD", "maladie débilitante chronique", "BSE", "tremblante"), ignoring case, accents and apostrophes; totals_by adds sums by year or by disease. Each row names the tool with one row per detection (cfia_disease_detections, cfia_avian_influenza). Rabies and aquatic diseases are CKAN datasets (organization cfia-acia). lang="fr" reads the French page (French disease names and notes).
- Keywords
- reportable disease, animal disease, CFIA, chronic wasting disease, avian influenza, equine infectious anemia, bovine tuberculosis, scrapie, BSE, livestock health, herds infected
- Mots-clés
- maladie à déclaration obligatoire, maladies animales, ACIA, maladie débilitante chronique, influenza aviaire, anémie infectieuse des équidés, tuberculose bovine, tremblante, ESB, santé animale, troupeaux infectés
| Parameter | Type | Default |
|---|---|---|
year_from | int | null | null |
year_to | int | null | null |
disease | str | null | null |
totals_by | "year" | "disease" | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "cfia_reportable_diseases", "arguments": {}}Federal and national
Canadian Institute for Health Information
cihi_
Canadian Institute for Health Information Indicator Library: search ~200 health-system indicators (hospital mortality and readmissions, wait times, ED visits, health spending, patient outcomes), read an indicator's description and data availability…
Full description
Canadian Institute for Health Information Indicator Library: search ~200 health-system indicators (hospital mortality and readmissions, wait times, ED visits, health spending, patient outcomes), read an indicator's description and data availability, and query its data table by place, reporting level, time frame and breakdown, in English or French (French names searched, English and French slugs paired from CIHI's own site).
cihi_get_indicator Get a CIHI indicator's description, data availability, update date, and topics.
Use for understanding what an indicator measures and which years and places it covers before reading its data. indicator is an English or French slug (or page URL) from cihi_search_indicators; lang="fr" returns the French page, lang="en" the English one.
- Keywords
- CIHI, indicator definition, methodology, data availability, update frequency, health system, health indicator, definition
- Mots-clés
- ICIS, définition de l'indicateur, méthodologie, disponibilité des données, fréquence de mise à jour, système de santé, indicateur de santé, définition
| Parameter | Type | Default |
|---|---|---|
indicator | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "cihi_get_indicator", "arguments": {"indicator": "…"}}cihi_get_indicator_data Read a CIHI indicator's data table (by place, reporting level, year, and breakdown).
Use for rates and values such as 30-day stroke mortality in Alberta, or readmission rates by hospital. place is a substring of "Place or organization"; filters match columns exactly, e.g. {"Reporting level": "Province/Territory", "Time frame": "2024–2025", "Level 1 breakdown": "Not applicable"}. The last limit matching rows in file order come back (default 40, max 2000), held to about 200 KB, with the cut noted in provenance.limits. columns picks the columns to return (names as in the file); without it, columns blank in every returned row are left out and listed in empty_columns. The first read of an indicator downloads its workbook (about 2 MB; 20-50 s measured live), later reads are cached for a day. indicator is an English or French slug; lang="fr" reads CIHI's French file, with French column names (and French place filters, e.g. "Colombie").
- Keywords
- CIHI, health data, hospital mortality rate, readmission rate, province, hospital, fiscal year, risk-adjusted rate
- Mots-clés
- ICIS, données sur la santé, taux de mortalité, taux de réadmission, province, hôpital, exercice, taux ajusté
| Parameter | Type | Default |
|---|---|---|
indicator | str | required |
place | str | null | null |
filters | dict[str, str] | null | null |
table | str | null | null |
columns | list[str] | null | null |
limit | int | 40 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cihi_get_indicator_data", "arguments": {"indicator": "…"}}cihi_search_indicators Search CIHI's Indicator Library of ~200 health-system indicators.
Use for finding an indicator's slug, e.g. "stroke mortality", "readmission", "wait times", "emergency department", "hospital stays", "public spending". Every word must appear in the name (case and accents ignored). With lang="fr" the French names are searched ("mortalité accident vasculaire", "réadmission à l'hôpital"; articles such as de, la, l' are ignored, plurals match) and French slugs come back with the paired English one in english_slug; an indicator with no French page is listed by its English name with a note.
- Keywords
- CIHI, health indicators, hospital, mortality, readmission, wait times, emergency department, health system performance
- Mots-clés
- ICIS, indicateurs de santé, hôpital, mortalité, réadmission, temps d'attente, urgences, rendement du système de santé
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
lang | "en" | "fr" | "en" |
call_tool {"name": "cihi_search_indicators", "arguments": {}}Federal and national
Elections Canada: candidate financial returns
elections_financial_returns_
Elections Canada Political Financing (elections.ca/WPAPPS/WPF): search federal election candidates by name, party, or province, then retrieve any of the 13 parts of a candidate's official campaign financial return (declaration, contributions received, loans, expenses, transfers…
Full description
Elections Canada Political Financing (elections.ca/WPAPPS/WPF): search federal election candidates by name, party, or province, then retrieve any of the 13 parts of a candidate's official campaign financial return (declaration, contributions received, loans, expenses, transfers, bank reconciliation) as structured line-item data. Covers the Candidates political entity only; distinct from the bulk poll-by-poll results and donor-contribution CKAN datasets already reachable via ckan_* (portal="federal").
elections_financial_returns_get_financial_return_part Retrieve one part of a federal election candidate's official Complete Financial Return -- declaration, contributions received, loans, expenses, transfers, or bank reconciliation.
Use for auditing a candidate's campaign expenses or donors; the declared official agent; unpaid claims or loans; bank reconciliation totals; any line item from an official candidate financial return filed under the Canada Elections Act.
- Keywords
- elections canada, campaign finance, financial return, candidate expenses, contributions received, official agent, election spending, political financing, donor, campaign loan
- Mots-clés
- Élections Canada, financement de campagne, rapport financier, dépenses de candidat, contributions reçues, agent officiel, dépenses électorales, financement politique, donateur, prêt de campagne, don, dons, contributions politiques, donateurs, financement des partis
| Parameter | Type | Default |
|---|---|---|
candidate_client_id | str | required |
part | str | required |
election_id | str | required |
act | "after_2019" | "2015_2019" | "2007_2014" | "2004_2006" | "after_2019" |
return_status | "submitted" | "amended" | "submitted" |
lang | "en" | "fr" | "en" |
call_tool {"name": "elections_financial_returns_get_financial_return_part", "arguments": {"candidate_client_id": "…", "part": "…", "election_id": "…"}}elections_financial_returns_list_elections List general elections and by-elections available for a candidate financial-return search under a given Canada Elections Act period.
Use for finding the election_id to pass into elections_financial_returns_search_candidates or elections_financial_returns_get_financial_return_part; discovering recent or upcoming by-elections not yet known by name.
- Keywords
- elections canada, election list, by-election, general election, candidate, political financing, act period, election id, writ, campaign return
- Mots-clés
- Élections Canada, liste des élections, élection partielle, élection générale, candidat, financement politique, période de la loi, identifiant d'élection, bref, rapport de campagne, don, dons, contributions politiques, donateurs, financement des partis
| Parameter | Type | Default |
|---|---|---|
act | "after_2019" | "2015_2019" | "2007_2014" | "2004_2006" | "after_2019" |
lang | "en" | "fr" | "en" |
call_tool {"name": "elections_financial_returns_list_elections", "arguments": {}}elections_financial_returns_search_candidates Search federal election candidates on Elections Canada's Political Financing portal, returning each match's client_id, party, and electoral district for use with elections_financial_returns_get_financial_return_part.
Use for finding a specific candidate's internal id before pulling their campaign financial return; browsing candidates by party or province for one election; discovering valid party_id/province_id values via the result's available_parties/available_provinces.
- Keywords
- elections canada, candidate search, political financing, campaign return, client id, party, electoral district, province, financial disclosure
- Mots-clés
- Élections Canada, recherche de candidats, financement politique, rapport de campagne, identifiant, parti, circonscription, province, divulgation financière, don, dons, contributions politiques, donateurs, financement des partis
| Parameter | Type | Default |
|---|---|---|
election_id | str | required |
act | "after_2019" | "2015_2019" | "2007_2014" | "2004_2006" | "after_2019" |
last_name | str | "" |
first_name | str | "" |
party_id | str | "-1" |
province_id | str | "-1" |
district_id | str | "-1" |
return_status | "submitted" | "amended" | "submitted" |
offset | int | 0 |
limit | int | 300 |
lang | "en" | "fr" | "en" |
call_tool {"name": "elections_financial_returns_search_candidates", "arguments": {"election_id": "…"}}Federal and national
Fisheries and Oceans Canada: tides and water levels
dfo_iwls_
Fisheries and Oceans Canada tides and water levels (Canadian Hydrographic Service IWLS API): search ~1,575 tide stations, station details and datums, observed water levels, water-level predictions, and high/low tide times for any window of up to 7 days.
dfo_iwls_get_station Get one DFO tide station's details: location, region, datums, and available series.
Use for checking whether a station is tidal or a tide-table reference port and converting its chart-datum levels to CGVD2013 or CGVD28 with the datum offsets.
- Keywords
- DFO, tide station, chart datum, CGVD2013, geodetic datum, station metadata, hydrographic, reference port
- Mots-clés
- MPO, station marégraphique, zéro des cartes, CGVD2013, niveau de référence géodésique, métadonnées, port de référence, niveau d'eau
| Parameter | Type | Default |
|---|---|---|
station_code | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "dfo_iwls_get_station", "arguments": {"station_code": "…"}}dfo_iwls_get_water_levels Get tide times, predicted water levels, or observed water levels for one station.
Use for high and low tide times ("wlp-hilo", the default), predicted levels ("wlp"), or official observed levels ("wlo") in metres above chart datum. start/end are ISO dates or UTC datetimes (default: now to +24 h); a date-only end includes that whole day; the window is capped at 7 days. resolution (e.g. "ONE_MINUTE") is ignored for high/low tides (default past one day: SIXTY_MINUTES).
- Keywords
- tides, tide table, high tide, low tide, water level, prediction, observed, DFO, harbour, marine forecast
- Mots-clés
- marées, table des marées, pleine mer, basse mer, niveau d'eau, prédiction, observé, MPO, port, prévision maritime
| Parameter | Type | Default |
|---|---|---|
station_code | str | required |
series_code | str | "wlp-hilo" |
start | str | null | null |
end | str | null | null |
resolution | "ONE_MINUTE" | "FIVE_MINUTES" | "FIFTEEN_MINUTES" | "SIXTY_MINUTES" | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "dfo_iwls_get_water_levels", "arguments": {"station_code": "…"}}dfo_iwls_search_stations Search Canada's ~1,575 tide and water-level stations (Fisheries and Oceans Canada).
Use for finding a station's five-digit code (e.g. "07120" Victoria Harbour) before fetching tides or water levels. query matches the station name, alternative name, or exact code; series_code narrows to stations publishing that series ("wlo" observed, "wlp" predicted, "wlp-hilo" high/low tides). lang="fr" returns French series names.
- Keywords
- DFO, Canadian Hydrographic Service, tide station, tides, water level, harbour, port, coast, marine, tide gauge
- Mots-clés
- MPO, Pêches et Océans, Service hydrographique du Canada, station marégraphique, marées, niveau d'eau, port, côte, marégraphe
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
operating_only | bool | true |
series_code | str | null | null |
limit | int | 20 |
lang | "en" | "fr" | "en" |
call_tool {"name": "dfo_iwls_search_stations", "arguments": {}}Federal and national
Health Canada Pest Management Regulatory Agency: pesticide registry
pmra_
Health Canada Pest Management Regulatory Agency pesticide registry, tools prefixed pmra_: search about 21,800 registered and historical pest control products by name, registration number, active ingredient, registrant or product type…
Full description
Health Canada Pest Management Regulatory Agency pesticide registry, tools prefixed pmra_: search about 21,800 registered and historical pest control products by name, registration number, active ingredient, registrant or product type; one product with its active ingredients (CAS number, re-evaluation status), sites of use and pests; and Canada's maximum residue limits (MRLs, ppm) by pesticide and food commodity. Daily CSV extracts of the Pesticide Product Information Database, English or French, Open Government Licence - Canada.
pmra_get_product One pesticide product by its registration number, with its ingredients.
Use for the full record of a registered pest control product: status and expiry, registrant, sites of use (crops, lawns, buildings), target pests, and each active ingredient with its CAS number, whether it is under re-evaluation, and how many food commodities carry a maximum residue limit for it (see pmra_get_residue_limits). Read fresh from the registry. Sites and pests are cut at 2,000 characters by the source; lists_truncated says when.
- Keywords
- pesticide label details, registration number lookup, PCP act, CAS number, re-evaluation, target pests, sites of use, pesticide active ingredients, registrant
- Mots-clés
- fiche du produit antiparasitaire, numéro d'homologation, numéro CAS, réévaluation, organismes nuisibles, sites d'utilisation, principes actifs, titulaire d'homologation, Agence de réglementation de la lutte antiparasitaire (ARLA), Santé Canada
| Parameter | Type | Default |
|---|---|---|
registration_number | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "pmra_get_product", "arguments": {"registration_number": "…"}}pmra_get_residue_limits Canada's maximum residue limits (MRLs) for pesticides on food.
Use for the legal maximum pesticide residue, in parts per million, allowed on a food sold in Canada: glyphosate on wheat or oats, chlorpyrifos on apples, every pesticide with an MRL on blueberries. chemical is the common name (exact match first, else a substring); commodity matches food names ('apples', 'pommes' with lang='fr'). About 25,000 limits for 339 chemicals, each with the regulatory action that set it (an EMRL or PMRL document, or the Canada Gazette).
- Keywords
- maximum residue limit, MRL, pesticide residues in food, ppm, food safety pesticides, glyphosate limit, residue tolerance, Health Canada MRL database
- Mots-clés
- limite maximale de résidus, LMR, résidus de pesticides dans les aliments, ppm, salubrité des aliments, denrée alimentaire, tolérance de résidus, glyphosate, Agence de réglementation de la lutte antiparasitaire (ARLA), Santé Canada
| Parameter | Type | Default |
|---|---|---|
chemical | str | "" |
commodity | str | "" |
limit | int | 200 |
lang | "en" | "fr" | "en" |
call_tool {"name": "pmra_get_residue_limits", "arguments": {}}pmra_search_products Search Health Canada's register of pesticide products (PMRA).
Use for whether a pesticide, herbicide, insecticide, fungicide, disinfectant or insect repellent is registered in Canada, its PCP registration number, registrant, marketing type (commercial, domestic, restricted) and active ingredients. About 7,800 current and 14,000 historical (cancelled) products. query matches product names (both languages) and the registration number; active_ingredient matches ingredient names ('glyphosate', 'chlorpyrifos', 'DEET'); registrant and product_type ('herbicide') narrow further. Counts by product type come with every result. Pass a registration number to pmra_get_product for sites of use, pests and ingredient details. Open Government Licence - Canada; data refreshed daily.
- Keywords
- pesticide registration, PCP number, registered pesticides, herbicide products, Roundup, active ingredient, Pest Management Regulatory Agency, Health Canada pesticides, insecticide
- Mots-clés
- homologation des pesticides, numéro d'homologation, produits antiparasitaires, Agence de réglementation de la lutte antiparasitaire (ARLA), herbicide homologué, principe actif, insecticide, Santé Canada pesticides, produit phytosanitaire
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
registration_number | str | "" |
active_ingredient | str | "" |
registrant | str | "" |
product_type | str | "" |
status | "current" | "historical" | "all" | "current" |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "pmra_search_products", "arguments": {}}Federal and national
Natural Resources Canada: energy use
nrcan_energy_use_
Natural Resources Canada energy-use data (Office of Energy Efficiency): the Comprehensive Energy Use Database (energy use and GHG emissions by sector and province, 2000 onward) and survey tables from the Survey of Household Energy Use (SHEU, SHEU-CMA)…
Full description
Natural Resources Canada energy-use data (Office of Energy Efficiency): the Comprehensive Energy Use Database (energy use and GHG emissions by sector and province, 2000 onward) and survey tables from the Survey of Household Energy Use (SHEU, SHEU-CMA), commercial and institutional buildings (SCIEU), multi-unit residential buildings, arenas, industrial consumption (ICE) and appliance shipments. List a product's tables, then read any table in English or French.
nrcan_energy_use_get_table Read one NRCan energy-use table (header rows, data rows, and notes).
Use for household energy use by region and fuel, energy intensity, GHG emissions by sector and energy source over time, heating system shares, and commercial or industrial energy use. table_key comes from nrcan_energy_use_list_tables. lang="fr" returns NRCan's French table. Survey tables print a quality letter after each value; the legend is in notes.
- Keywords
- NRCan, energy consumption, petajoules, GHG emissions, household energy use survey, heating, natural gas, electricity
- Mots-clés
- Ressources naturelles Canada (RNCan), consommation d'énergie, pétajoules, émissions de GES, enquête sur les ménages, chauffage, gaz naturel, électricité
| Parameter | Type | Default |
|---|---|---|
table_key | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "nrcan_energy_use_get_table", "arguments": {"table_key": "…"}}nrcan_energy_use_list_products List NRCan's energy-use products: the Comprehensive Energy Use Database and energy surveys.
Use for choosing what to read. Surveys: Survey of Household Energy Use (SHEU 2019/2015, also by CMA), multi-unit residential buildings, commercial and institutional buildings (SCIEU), arenas, industrial consumption (ICE), appliance shipments. The comprehensive database covers energy use and GHG emissions by sector and province since 2000.
- Keywords
- NRCan, energy use, energy consumption, household energy survey, SHEU, GHG emissions, energy efficiency, residential, buildings
- Mots-clés
- Ressources naturelles Canada (RNCan), consommation d'énergie, utilisation de l'énergie, enquête sur les ménages, émissions de GES, efficacité énergétique, base de données, énergie
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "nrcan_energy_use_list_products", "arguments": {}}nrcan_energy_use_list_tables List the tables of one NRCan energy-use product, with titles and table keys.
Use for finding a table, e.g. product="sheu_2019" (household space heating, appliances, dwelling characteristics), or product="comprehensive" with sector ("res", "com", "id", "tran", "agr", "agg") and jurisdiction ("ca", "ab", "on", ...). Titles come from NRCan's English menus; read a table in French with nrcan_energy_use_get_table(lang="fr").
- Keywords
- NRCan, energy use tables, household energy, heating, appliances, sector, province, energy database
- Mots-clés
- Ressources naturelles Canada (RNCan), tableaux, consommation d'énergie, chauffage, appareils, secteur, province, base de données
| Parameter | Type | Default |
|---|---|---|
product | str | required |
sector | str | null | null |
jurisdiction | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "nrcan_energy_use_list_tables", "arguments": {"product": "…"}}Federal and national
Patented Medicine Prices Review Board
pmprb_
Patented Medicine Prices Review Board annual reports on canada.ca, tools prefixed pmprb_: every table and chart data table in the 2018 to 2024 reports (Patented Medicines Price Index against CPI since 2005…
Full description
Patented Medicine Prices Review Board annual reports on canada.ca, tools prefixed pmprb_: every table and chart data table in the 2018 to 2024 reports (Patented Medicines Price Index against CPI since 2005, foreign-to-Canadian list price ratios for the PMPRB11 and OECD countries, patented medicine sales since 1990, sales drivers, R&D spending and R&D-to-sales ratios by company, province and type of research, price review outcomes), read from the HTML in English or French with numbers parsed; and the 2020 and 2021 lists of patented medicines reported (DIN, brand, ingredient, ATC, company, price review status). No data files exist behind these pages. NPDUIS drug plan data is CIHI's (cihi_).
pmprb_get_report_table Read a table from a PMPRB annual report, with numbers parsed.
Use for the figures behind a PMPRB table or chart: PMPI and CPI index and rates of change by year, foreign-to-Canadian price ratios by country, patented medicine sales and share of GDP by year, R&D expenditures by company or province. year is the report year (2018 to 2024); table is a title start like 'Figure 1' or 'Table 5' ('Tableau 5' works too) or the index from pmprb_list_report_tables. A title can own several tables (a chart drawn from two, or sub-tables with their own caption); all are returned. Numbers drop '$' and '%', so read units from the column name or label.
- Keywords
- PMPRB table, patented medicine price index, price ratio by country, patented drug sales, R&D-to-sales ratio, pharmaceutical statistics, annual report data, drug price trends
- Mots-clés
- tableau du CEPMB, indice des prix des médicaments brevetés, ratio des prix par pays, ventes de médicaments brevetés, ratio R-D/ventes, statistiques pharmaceutiques, rapport annuel, tendances des prix des médicaments
| Parameter | Type | Default |
|---|---|---|
year | int | required |
table | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "pmprb_get_report_table", "arguments": {"year": "…", "table": "…"}}pmprb_list_report_tables List the data tables in PMPRB's annual reports on patented medicine prices.
Use for finding patented drug price statistics from the Patented Medicine Prices Review Board, 2018 to 2024 reports: the Patented Medicines Price Index (PMPI) against CPI since 2005, how Canadian list prices compare with the PMPRB11 and OECD countries (median and highest international price ratios), patented medicine sales since 1990 and their drivers, sales by therapeutic class, biosimilar uptake, R&D spending and R&D-to-sales ratios by company, province and type of research, and price review outcomes. With year, lists that report's tables (each chart's data table included); with only query, searches titles and columns across every year; with neither, lists the reports. Pass a year and a table's label or index to pmprb_get_report_table.
- Keywords
- PMPRB, patented medicine prices, drug prices, pharmaceutical prices, international price comparison, PMPI, pharmaceutical R&D, drug sales, patented drugs
- Mots-clés
- CEPMB, prix des médicaments brevetés, prix des médicaments, comparaison internationale des prix, IPMB, dépenses de R-D pharmaceutique, ventes de médicaments, médicaments brevetés
| Parameter | Type | Default |
|---|---|---|
year | int | null | null |
query | str | "" |
lang | "en" | "fr" | "en" |
call_tool {"name": "pmprb_list_report_tables", "arguments": {}}pmprb_search_patented_medicines Search the list of patented medicines reported to PMPRB (2020 or 2021).
Use for whether a drug was under PMPRB price jurisdiction, which company reported it, and its price review status: within guidelines, does not trigger an investigation, under investigation, under review, voluntary compliance undertaking, notice of hearing. About 1,200 drug products a year with DIN, brand name, medicinal ingredient, ATC class and dosage form. query matches DIN, brand, ingredient or company; atc is a class prefix (L04 immunosuppressants); counts by status come with every result. PMPRB published no list after 2021.
- Keywords
- patented medicines list, DIN, drug price review, excessive pricing investigation, PMPRB jurisdiction, patentee, rights holder, brand name drug, ATC code
- Mots-clés
- liste des médicaments brevetés, DIN, examen du prix, enquête sur les prix excessifs, compétence du CEPMB, breveté, titulaire de droits, médicament de marque, code ATC
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
company | str | "" |
atc | str | "" |
status | "within_guidelines" | "does_not_trigger" | "under_investigation" | "under_review" | "voluntary_compliance_undertaking" | "notice_of_hearing" | "stay_order" | null | null |
year | 2020 | 2021 | 2021 |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "pmprb_search_patented_medicines", "arguments": {}}Federal and national
Public Health Agency of Canada: Health Infobase
phac_infobase_
PHAC Health Infobase: list, describe and query the data files behind the Public Health Agency of Canada's surveillance dashboards (respiratory virus detections and FluWatch+, wastewater, opioid and stimulant harms, supervised consumption sites, substance use surveys, measles…
Full description
PHAC Health Infobase: list, describe and query the data files behind the Public Health Agency of Canada's surveillance dashboards (respiratory virus detections and FluWatch+, wastewater, opioid and stimulant harms, supervised consumption sites, substance use surveys, measles, mpox, tuberculosis, notifiable diseases, vaccine adverse events, chronic disease indicators, archived COVID-19 data), filtered by column values, province and date range, in English or French.
phac_infobase_describe_dataset Describe a PHAC Health Infobase dataset: columns, values, date coverage, last update.
Use for before querying, learning a surveillance file's columns and their most common values (for exact filters), its date range, the provinces or places it covers, when PHAC last updated it, and which suppression markers it uses ("Suppr.", "X", "n/a"; "Mas." and "n.d." in French files). dataset_id comes from phac_infobase_list_datasets; lang="fr" reads the French file when PHAC publishes one (French column names and labels, sometimes decimal commas) and otherwise the English file; file_language says which.
- Keywords
- PHAC, Health Infobase, data dictionary, columns, coverage, last updated, surveillance data, suppressed values, metadata
- Mots-clés
- ASPC, Infobase santé, dictionnaire de données, colonnes, période couverte, dernière mise à jour, données de surveillance, valeurs supprimées, métadonnées
| Parameter | Type | Default |
|---|---|---|
dataset_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "phac_infobase_describe_dataset", "arguments": {"dataset_id": "…"}}phac_infobase_list_datasets List PHAC Health Infobase surveillance datasets (dashboard data files), by topic.
Use for finding public health surveillance data from the Public Health Agency of Canada's Health Infobase dashboards: respiratory virus detections and FluWatch+ (influenza, COVID-19, RSV), wastewater viral load, opioid and stimulant deaths and hospitalizations, supervised consumption sites, substance use surveys, measles, mpox, tuberculosis, notifiable diseases, vaccine adverse events, chronic disease and cancer indicators, archived COVID-19 cases and vaccination. topic is one of respiratory, covid19, wastewater, vaccination, substance_use, infectious_disease, chronic_disease, health_status; query matches words in English or French titles, ignoring case and accents. lang="fr" returns French titles and descriptions for every dataset; languages shows which ones also have a French data file (9 of them), the others are read from the English file. Returns dataset ids for phac_infobase_describe_dataset and phac_infobase_query. The Chronic Disease Surveillance System (CCDSS) data tool has no downloadable file.
- Keywords
- PHAC, Health Infobase, public health surveillance, FluWatch, influenza, COVID-19, RSV, opioid overdose, wastewater, measles, tuberculosis, notifiable diseases
- Mots-clés
- ASPC, Agence de la santé publique du Canada, Infobase santé, surveillance de la santé publique, ÉpiGrippe, grippe, influenza, COVID-19, VRS, virus respiratoires, surdoses d'opioïdes, eaux usées, rougeole, tuberculose, maladies à déclaration obligatoire, vaccination
| Parameter | Type | Default |
|---|---|---|
topic | str | null | null |
query | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "phac_infobase_list_datasets", "arguments": {}}phac_infobase_query Query rows of a PHAC Health Infobase dataset by column values, date range and province.
Use for weekly influenza, COVID-19 and RSV percent positive by province, apparent opioid toxicity deaths by province and year, wastewater viral load for a city, measles cases by province, tuberculosis incidence, and similar surveillance series. filters are exact, case-insensitive column matches, e.g. for opioid_stimulant_harms {"Source": "Deaths", "Specific_Measure": "Overall numbers", "Unit": "Number", "Time_Period": "By year"}; geography accepts a province or territory name (English or French), abbreviation (ON, QC) or PRUID code, or part of a place name (wastewater sites); one that matches nothing is an error listing the places the dataset has. start/end are YYYY, YYYY-MM, YYYY-MM-DD or YYYY Qn (or Tn) on the dataset's date column. The most recent limit matching rows come back, oldest first. Values are returned as published; suppression markers are listed. lang="fr" reads the French file where one exists, whose column names and values are French (e.g. {"Source": "Mortalité", "Unité": "Nombre", "Période_Temps": "Par année"}; quarters "2025 T3"), so take filter names and values from phac_infobase_describe_dataset called with the same lang. Filters also ignore accents and apostrophe style.
- Keywords
- PHAC, Health Infobase, surveillance time series, weekly cases, percent positivity, overdose deaths, province, wastewater, rates per 100, 000
- Mots-clés
- ASPC, Infobase santé, séries chronologiques de surveillance, cas hebdomadaires, pourcentage de positivité, taux de positivité, décès par surdose, province, eaux usées, taux pour 100 000
| Parameter | Type | Default |
|---|---|---|
dataset_id | str | required |
filters | dict[str, str] | null | null |
geography | str | null | null |
start | str | null | null |
end | str | null | null |
columns | list[str] | null | null |
limit | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "phac_infobase_query", "arguments": {"dataset_id": "…"}}Federal and national
Recalls and safety alerts
recalls_
Government of Canada recalls and safety alerts (Health Canada, CFIA, Transport Canada): search food, health product, consumer product and vehicle notices by keyword, agency, category, class and date; count them by year or category…
Full description
Government of Canada recalls and safety alerts (Health Canada, CFIA, Transport Canada): search food, health product, consumer product and vehicle notices by keyword, agency, category, class and date; count them by year or category; and get one notice's affected products, lots, hazard and what to do, in English or French.
recalls_get Get one recall or safety alert's full notice: affected products, lots, hazard and what to do.
Use for the details behind a recall_id from recalls_search, such as the affected products table (brand, product, size, UPC, lot or serial numbers, DIN, expiry), the issue and safety risk text, what consumers should do, distribution provinces, recalling companies, recall class and recall date. layout says which page format was read: 'current' pages fill the typed fields; older 'legacy' notices put their header in details and their body in legacy_text. For vehicle notices, agency_reference holds the Transport Canada recall number for tc_recalls_get. lang="fr" reads the French page (untranslated notices come back in English).
- Keywords
- recall details, affected products, lot number, UPC, hazard, what to do, recalling firm, distribution, recall class, safety alert
- Mots-clés
- détails du rappel, produits visés, numéro de lot, code CUP, danger, que faire, entreprise, distribution, classe de rappel, avis de sécurité
| Parameter | Type | Default |
|---|---|---|
recall_id | int | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "recalls_get", "arguments": {"recall_id": "…"}}recalls_search Search Government of Canada recalls and safety alerts (Health Canada, CFIA, Transport Canada).
Use for finding food recalls (allergens, Listeria, Salmonella, E. coli), drug, natural health product and medical device recalls, consumer product recalls (toys, cribs, electronics, cannabis) and vehicle recall notices on recalls-rappels.canada.ca. query matches every word in the title, product, issue, category and organization, ignoring case, accents, plurals and words such as "aux" or "the" (e.g. "peanut cookies", "biscuits aux arachides"). agency and product_type narrow the source; category is a text match on the category (e.g. "Toys", "Dairy"); recall_class is "Class 1" to "Class 3" (CFIA food; "Classe 1" also works) or "Type I" to "Type III" (Health Canada health products). Dates (YYYY-MM-DD) filter on the notice's last-updated date, the same date the site's search uses. Newest first; archived notices are excluded unless include_archived=True. Pass recall_id to recalls_get for affected lots, UPCs and what to do. For vehicle recalls by make, model and year use tc_recalls_search. lang="fr" searches and returns the French text, so with it query and category must be French (e.g. "jouets", "Produits laitiers"); untranslated notices keep an English title and URL.
- Keywords
- recall, safety alert, food recall, allergen, health product recall, drug recall, medical device, consumer product, Health Canada, CFIA, advisory, product safety
- Mots-clés
- rappel, avis de rappel, rappel alimentaire, rappel d'aliments, allergène, rappel de médicament, instrument médical, produit de consommation, rappel de jouets, Santé Canada, ACIA, avis de sécurité, mise en garde, sécurité des produits, retrait du marché
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
agency | "health_canada" | "cfia" | "transport_canada" | null | null |
product_type | "food" | "health_product" | "consumer_product" | "vehicle" | null | null |
category | str | null | null |
recall_class | str | null | null |
updated_from | str | null | null |
updated_to | str | null | null |
include_archived | bool | false |
limit | int | 25 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "recalls_search", "arguments": {}}recalls_summarize Count Government of Canada recalls and safety alerts by year, agency, product type or category.
Use for statistics such as food recalls per year, allergen recalls by issue (e.g. product_type="food", group_by="issue"), Health Canada recalls by recall class, or which consumer product categories are recalled most. Takes the same filters as recalls_search. year is the last-updated year (the dump has no separate recall date). Unlike recalls_search, archived notices are included by default, so counts cover the full history back to the 1990s; pass include_archived=False to match the site's search. lang="fr" returns French organization, category, issue and class labels (and then takes French query and category text); agency and product_type keys and the "(none)" and "unknown" keys stay as codes.
- Keywords
- recall statistics, recalls per year, count, trend, food recalls, allergen, Health Canada, CFIA, product safety, summary
- Mots-clés
- statistiques de rappels, rappels par année, nombre, tendance, rappels d'aliments, allergène, Santé Canada, ACIA, sécurité des produits, sommaire
| Parameter | Type | Default |
|---|---|---|
group_by | "year" | "agency" | "product_type" | "organization" | "category" | "issue" | "recall_class" | required |
query | str | null | null |
agency | "health_canada" | "cfia" | "transport_canada" | null | null |
product_type | "food" | "health_product" | "consumer_product" | "vehicle" | null | null |
category | str | null | null |
recall_class | str | null | null |
updated_from | str | null | null |
updated_to | str | null | null |
include_archived | bool | true |
top | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "recalls_summarize", "arguments": {"group_by": "…"}}Federal and national
Canada Energy Regulator
cer_
Canada Energy Regulator open data: find CER CSV files (pipeline throughput and capacity, oil/gas/NGL/LNG/refined product exports, pipeline tolls, incidents, refinery runs, Canada's Energy Future projections) and query their rows with column filters and date ranges…
cer_list_datasets Find Canada Energy Regulator datasets and their CSV file URLs.
Use for locating CER data such as "throughput" (pipeline throughput and capacity per pipeline and key point), "exports" (crude oil, natural gas, NGL, LNG, refined products), "tolls", "incident", "refinery", or "energy future" (Canada's Energy Future scenarios). lang="fr" returns the French files and titles.
- Keywords
- CER, Canada Energy Regulator, NEB, pipeline, throughput, capacity, oil exports, natural gas exports, LNG, tolls, incidents
- Mots-clés
- Régie de l'énergie du Canada (REC), Office national de l'énergie (ONE), pipelines, débit des pipelines, capacité, exportations de pétrole brut, exportations de gaz naturel, GNL, droits pipeliniers, incidents, raffineries, Avenir énergétique du Canada
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
limit | int | 10 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cer_list_datasets", "arguments": {}}cer_query_file Read rows from one Canada Energy Regulator CSV file with filters and a date range.
Use for pipeline throughput vs capacity over time (e.g. filters {"Key Point": "International boundary at or near Haskett, Manitoba"}), export volumes by year, or tolls by pipeline. url comes from cer_list_datasets; filters match column values exactly (case-insensitive); start/end are YYYY, YYYY-MM or YYYY-MM-DD on the file's Date/Year column, both inclusive (end="2024" runs to December 31); the most recent limit rows come back. The file's own language decides the column names.
- Keywords
- CER, pipeline throughput, capacity utilization, exports, volumes, tolls, time series, CSV, oil, natural gas
- Mots-clés
- Régie de l'énergie du Canada (REC), débit des pipelines, taux d'utilisation, capacité disponible, exportations, volumes, droits pipeliniers, séries chronologiques, pétrole brut, gaz naturel
| Parameter | Type | Default |
|---|---|---|
url | str | required |
filters | dict[str, str] | null | null |
columns | list[str] | null | null |
start | str | null | null |
end | str | null | null |
limit | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "cer_query_file", "arguments": {"url": "…"}}Federal and national
GC InfoBase
gc_infobase_
GC InfoBase (Treasury Board Secretariat): federal spending and results open datasets.
Full description
GC InfoBase (Treasury Board Secretariat): federal spending and results open datasets. List the files (Main Estimates, Public Accounts authorities and expenditures by vote, standard object and transfer payment, planned and actual spending and FTEs by program, results indicators, federal organizations) and query rows by organization, fiscal year and column values, in English or French.
gc_infobase_list_files List GC InfoBase's federal spending and results files (Treasury Board Secretariat).
Use for finding the file for Main Estimates, Public Accounts (authorities and expenditures by vote, standard object, transfer payments), planned vs actual spending and FTEs by program, departmental results indicators, or the inventory of federal organizations. query filters names; lang="fr" returns the French files.
- Keywords
- GC InfoBase, federal spending, Public Accounts, Main Estimates, departmental results, FTE, programs, Treasury Board
- Mots-clés
- InfoBase du GC, dépenses fédérales, Comptes publics, Budget principal des dépenses, résultats ministériels, ETP, programmes, budget fédéral
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "gc_infobase_list_files", "arguments": {}}gc_infobase_query Query rows of one GC InfoBase file by organization, fiscal year, and column values.
Use for a department's authorities and expenditures, transfer payments, program spending and FTEs, or results targets, e.g. organization="Canada Revenue Agency", fiscal_year="2023-24". organization is a substring match; fiscal_year matches the start year whatever the file's format ("2023-24", "2023-2024", "FY 2023-24"); filters are exact column matches. resource_id comes from gc_infobase_list_files; use a French file for French column names (an English file asked for with lang="fr" keeps its English name and rows, and provenance.limits names the French file). Amounts and counts come back as numbers (listed in numeric_columns); id and code columns stay text.
- Keywords
- federal spending, department budget, expenditures, authorities, transfer payments, program spending, FTE, public accounts
- Mots-clés
- dépenses fédérales, budget ministériel, autorisations, paiements de transfert, dépenses de programme, ETP, comptes publics, InfoBase du GC
| Parameter | Type | Default |
|---|---|---|
resource_id | str | required |
organization | str | null | null |
fiscal_year | str | null | null |
filters | dict[str, str] | null | null |
columns | list[str] | null | null |
limit | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "gc_infobase_query", "arguments": {"resource_id": "…"}}Federal and national
Natural Resources Canada: geolocation and place names
nrcan_geo_
Natural Resources Canada geolocation and place names: locate a place, address or postal code (Geolocator), and search the Canadian Geographical Names Database for official names of cities, lakes, rivers, mountains and parks by text, province, feature type…
Full description
Natural Resources Canada geolocation and place names: locate a place, address or postal code (Geolocator), and search the Canadian Geographical Names Database for official names of cities, lakes, rivers, mountains and parks by text, province, feature type, point radius or bounding box, in English or French.
nrcan_geo_locate Geocode a Canadian place, street address, or postal code to coordinates (NRCan Geolocator).
Use for turning "111 Wellington St Ottawa", "K1A 0A9", or "Parliament Hill" into latitude/longitude, province, and bounding box, e.g. before a spatial query elsewhere. lang="fr" returns French names and categories. The Geolocator matches loosely and has no relevance score: a query it cannot match still returns nearby spellings or unrelated places, so check the returned name.
- Keywords
- geocode, geolocation, address lookup, postal code, FSA, coordinates, latitude longitude, NRCan, geo.ca, place search
- Mots-clés
- géocodage, géolocalisation, adresse, code postal, RTA, coordonnées, latitude longitude, Ressources naturelles Canada (RNCan), recherche de lieu
| Parameter | Type | Default |
|---|---|---|
query | str | required |
limit | int | 10 |
lang | "en" | "fr" | "en" |
call_tool {"name": "nrcan_geo_locate", "arguments": {"query": "…"}}nrcan_geo_search_names Search the Canadian Geographical Names Database for official place names.
Use for official names and locations of cities, towns, lakes, rivers, mountains, parks and other features. Combine query (name text), province ("AB" or SGC code "48"), feature_type (e.g. "CITY", "TOWN", "LAKE", "RIV", "MTN"), a point with radius_km (whole kilometres; default 10), or bbox [west, south, east, north]. lang="fr" returns French feature types. province in results is the SGC code ("48" for Alberta).
- Keywords
- geographic names lookup, place names, toponymy, gazetteer, geographical names, lake, river, mountain, official name, NRCan, CGNDB
- Mots-clés
- noms géographiques, toponymie, répertoire toponymique, lac, rivière, montagne, nom officiel, Ressources naturelles Canada (RNCan), BDTC
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
province | str | null | null |
feature_type | str | null | null |
latitude | float | null | null |
longitude | float | null | null |
radius_km | float | null | null |
bbox | list[float] | null | null |
limit | int | 10 |
lang | "en" | "fr" | "en" |
call_tool {"name": "nrcan_geo_search_names", "arguments": {}}Federal and national
Natural Resources Canada: mineral production
nrcan_minerals_
Natural Resources Canada annual mineral production statistics, tools prefixed nrcan_minerals_: for each reference year from 1990 to the latest preliminary estimate, every metal, non-metal, aggregate and coal commodity (gold, copper, nickel, iron ore, potash, diamonds, uranium…
Full description
Natural Resources Canada annual mineral production statistics, tools prefixed nrcan_minerals_: for each reference year from 1990 to the latest preliminary estimate, every metal, non-metal, aggregate and coal commodity (gold, copper, nickel, iron ore, potash, diamonds, uranium, lithium, sand and gravel...) by province and territory, with quantity produced or shipped and value of shipments, confidential and preliminary flags kept; and one commodity's series across years. English only: NRCan publishes these files in English. Monthly production since 2020 is Statistics Canada table 16-10-0022 (wds_).
nrcan_minerals_get_production Canada's annual mineral production by commodity and province (NRCan).
Use for how much gold, copper, nickel, iron ore, potash, diamonds, uranium, lithium, zinc, coal, salt, sand and gravel or stone a province or territory produced and shipped in a year, and the value of shipments (thousands of dollars), from 1990 to the latest preliminary estimate (the default year). commodity matches names ('gold', 'potash'); province is a code (ON, QC, BC...) or name, 'Canada' for the national total; category keeps values or quantities. Each row says whether it is preliminary, confidential ('x') or not available. Use nrcan_minerals_get_series for one commodity across years. English only (NRCan publishes these files in English; lang has no effect). Monthly production since 2020 is StatCan table 16-10-0022 (wds_).
- Keywords
- mineral production, mining statistics, gold production by province, value of mineral shipments, metal production, NRCan mining, potash output, critical minerals, preliminary estimate
- Mots-clés
- production minérale, statistiques minières, production d'or par province, valeur des expéditions minérales, production de métaux, Ressources naturelles Canada (RNCan), mines, potasse, minéraux critiques
| Parameter | Type | Default |
|---|---|---|
year | int | null | null |
commodity | str | "" |
province | str | "" |
category | "all" | "value" | "quantity" | "all" |
limit | int | 500 |
lang | "en" | "fr" | "en" |
call_tool {"name": "nrcan_minerals_get_production", "arguments": {}}nrcan_minerals_get_series One mineral commodity's production across years, 1990 onward (NRCan).
Use for a long series of Canadian mine output, such as the value of gold shipments in Ontario since 1990, copper quantity shipped in British Columbia, or the grand total value of mineral production in Canada by year. Reads one file per year (a full 1990-2025 series takes about 15 seconds the first time). commodity is an exact name or a partial one that matches a single commodity in each year ('Grand total' for all minerals); years where it is ambiguous or absent are listed. Quantity produced exists from 2019 only. Units changed over time, so read each point's units. English only (lang has no effect).
- Keywords
- mineral production time series, gold output history, mining value of shipments by year, copper production trend, Canada mining history, annual mineral statistics, NRCan, metal output since 1990
- Mots-clés
- série chronologique production minérale, historique de la production d'or, valeur des expéditions par année, tendance de la production de cuivre, histoire minière du Canada, statistiques annuelles, Ressources naturelles Canada (RNCan), production de métaux depuis 1990
| Parameter | Type | Default |
|---|---|---|
commodity | str | required |
province | str | "Canada" |
category | "value" | "quantity_shipped" | "quantity_produced" | "value" |
from_year | int | null | null |
to_year | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "nrcan_minerals_get_series", "arguments": {"commodity": "…"}}Federal and national
Senate of Canada votes
senate_
Senate of Canada recorded votes from sencanada.ca: votes by session with totals and related bill, and how each senator voted.
senate_get_vote Get how each senator voted on one Senate vote.
Use for every senator's yea, nay or abstention, with their group (ISG, CSG, PSG, Conservative) and province. vote_id and session come together from senate_list_votes; a vote_id not in that session's list is NotFound. vote is null for a senator with no recorded vote.
- Keywords
- senator vote, Senate ballot, how did senators vote, Senate group, ISG, CSG, PSG, abstention
- Mots-clés
- vote des sénateurs, Sénat, groupe sénatorial, abstention, appel nominal, GSI, GSC, GPS
| Parameter | Type | Default |
|---|---|---|
vote_id | int | required |
session | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "senate_get_vote", "arguments": {"vote_id": "…", "session": "…"}}senate_list_votes List recorded votes in the Senate of Canada for one session, newest first.
Use for Senate votes on a bill (bill like 'C-6' or 'S-205'), votes whose title contains a word, or all votes in a session (like '45-1', default current; sessions from 42-1), with yeas, nays, abstentions and result. keyword ignores case and accents.
- Keywords
- Senate vote, senators, recorded division, Senate of Canada, upper chamber, third reading, bill, adopted
- Mots-clés
- vote au Sénat, sénateurs, appel nominal, Sénat du Canada, chambre haute, troisième lecture, projet de loi, adopté
| Parameter | Type | Default |
|---|---|---|
session | str | null | null |
keyword | str | null | null |
bill | str | null | null |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "senate_list_votes", "arguments": {}}Federal and national
Transport Canada: vehicle recalls
tc_recalls_
Transport Canada motor vehicle safety recalls: search recalls by make, model and model year, and get a recall's full summary (issue, safety risk, corrective action, units affected, affected models and years) in English or French.
tc_recalls_get Get one Transport Canada vehicle recall: its description, units, and vehicles.
Use for the details behind a recall number from tc_recalls_search (e.g. "2021001"), including the affected makes, models and years. description is Transport Canada's single text covering the issue, the safety risk and the corrective action. lang="fr" returns the French category, system and description.
- Keywords
- recall details, safety risk, corrective action, units affected, Transport Canada, vehicle defect, notification, recall
- Mots-clés
- détails du rappel, risque pour la sécurité, mesure corrective, unités touchées, Transports Canada, défaut du véhicule, rappel, véhicule, numéro de rappel, avis au propriétaire
| Parameter | Type | Default |
|---|---|---|
recall_number | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "tc_recalls_get", "arguments": {"recall_number": "…"}}tc_recalls_search Search Transport Canada motor vehicle safety recalls by make, model, and model year.
Use for checking whether a vehicle has recalls, e.g. make="Honda", model="Civic", year_from=2019, year_to=2020. Results are sorted by recall date, newest first (order="oldest" reverses it), with total_matched and has_more; page through with page. A make that no recall lists is an error. The rows (recall numbers, manufacturer, make and model names as Transport Canada publishes them, dates) are identical with lang="fr": the source does not translate them, and note says so in French. Pass a recall number to tc_recalls_get for the French category, system and description.
- Keywords
- vehicle recall, car recall, Transport Canada, safety recall, make, model, model year, defect, motor vehicle
- Mots-clés
- rappel de véhicule, rappel automobile, Transports Canada, rappel de sécurité, marque, modèle, année-modèle, défaut, rappel de voiture, avis de rappel, véhicule défectueux
| Parameter | Type | Default |
|---|---|---|
make | str | null | null |
model | str | null | null |
year_from | int | null | null |
year_to | int | null | null |
limit | int | 50 |
page | int | 1 |
order | "newest" | "oldest" | "newest" |
lang | "en" | "fr" | "en" |
call_tool {"name": "tc_recalls_search", "arguments": {}}Federal and national
CRA digital economy registry
cra_digital_economy_registry_search
CRA's public registry of digital economy businesses (cross-border digital products/services, platform-based short-term accommodation) registered for the simplified GST/HST under the Excise Tax Act (canada.ca, not CKAN).
Full description
CRA's public registry of digital economy businesses (cross-border digital products/services, platform-based short-term accommodation) registered for the simplified GST/HST under the Excise Tax Act (canada.ca, not CKAN). Search by legal name, trade name, or business number to confirm whether a business may charge GST/HST under the simplified regime.
cra_digital_economy_registry_search Search CRA's public registry of digital economy businesses registered for the simplified GST/HST (cross-border digital products/services and platform-based short-term accommodation), by legal name, trade name, or business number. Leave query empty to see the full registry size.
Use for confirming whether a foreign digital-economy business (an app store, streaming service, short-term rental platform) is registered to charge GST/HST under the simplified regime; looking up a business's registration or de-registration date by name or business number. Dates come back as ISO dates (YYYY-MM-DD), with the page's own wording ("July 1, 2023", "1 juillet 2021") alongside in *_date_text.
- Keywords
- CRA, GST, HST, digital economy, simplified GST/HST, registrant, registry, cross-border, platform, short-term accommodation, business number, tax registration
- Mots-clés
- Agence du revenu du Canada (ARC), TPS, TVH, économie numérique, TPS/TVH simplifiée, inscrit, registre, transfrontalier, plateforme, hébergement de courte durée, numéro d'entreprise, inscription fiscale
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
lang | "en" | "fr" | "en" |
call_tool {"name": "cra_digital_economy_registry_search", "arguments": {}}Federal and national
Canada Border Services Agency: border wait times
cbsa_border_wait_times
Canada Border Services Agency current land border wait times, tools prefixed cbsa_: the wait in minutes at about 30 Canada-U.S. crossings (Peace Bridge, Ambassador Bridge, Pacific Highway, Lacolle and others) for commercial and traveller lanes, Canada-bound and U.S.-bound…
Full description
Canada Border Services Agency current land border wait times, tools prefixed cbsa_: the wait in minutes at about 30 Canada-U.S. crossings (Peace Bridge, Ambassador Bridge, Pacific Highway, Lacolle and others) for commercial and traveller lanes, Canada-bound and U.S.-bound, with each crossing's own update time, filtered by province, crossing or direction, in English or French. Open Government Licence - Canada. Historical wait-time files are open.canada.ca datasets (ckan_, portal 'federal').
cbsa_border_wait_times Current wait times at Canada-U.S. land border crossings (CBSA).
Use for how long the line is right now at the Peace Bridge, Ambassador Bridge, Gordie Howe Bridge, Blue Water Bridge, Rainbow Bridge, Lacolle, Pacific Highway, Douglas (Peace Arch), Coutts, Emerson and about 20 other crossings, for travellers and commercial trucks, entering Canada or the United States. Each crossing comes with its own update time; the file is refreshed every few minutes and cached here for two minutes. province is the Canadian side (ON, QC, BC, NB, MB, SK, AB or a name); crossing matches the office or town ('windsor', 'peace bridge'); direction keeps only Canada-bound or U.S.-bound lanes. CBSA posts Canada-bound waits; most U.S.-bound lanes read 'not_reported'. For trends, the historical files are open.canada.ca datasets (see historical_data). Open Government Licence - Canada.
- Keywords
- border wait times, border crossing delay, CBSA, Canada US border, Peace Bridge wait, Ambassador Bridge, Lacolle, Pacific Highway, border lineup, crossing into the United States
- Mots-clés
- temps d'attente à la frontière, Agence des services frontaliers du Canada (ASFC), poste frontalier, frontière canado-américaine, délai à la douane, file d'attente à la frontière, pont Ambassador, Lacolle, traverser aux États-Unis
| Parameter | Type | Default |
|---|---|---|
province | str | "" |
crossing | str | "" |
direction | "both" | "canada_bound" | "us_bound" | "both" |
lang | "en" | "fr" | "en" |
call_tool {"name": "cbsa_border_wait_times", "arguments": {}}Federal and national
Competition Bureau: merger reviews
competition_bureau_search_mergers
Competition Bureau Canada merger reviews (competition-bureau.canada.ca, tools prefixed competition_bureau_): every merger review the Bureau reports, from the weekly report (about 830 reviews opened since November 2023…
Full description
Competition Bureau Canada merger reviews (competition-bureau.canada.ca, tools prefixed competition_bureau_): every merger review the Bureau reports, from the weekly report (about 830 reviews opened since November 2023, ongoing and concluded) and the archived monthly report (about 1,725 reviews concluded January 2015 to April 2023). Each review has the parties, opened and concluded dates (month only in the archive), the NAICS industry code and the outcome: advance ruling certificate, no action letter, consent agreement, judicial decision, abandoned, other, or ongoing. Search by party name, NAICS prefix, outcome and date. Parties may ask to keep a transaction off the report, and May-October 2023 is covered by neither page.
competition_bureau_search_mergers Search Competition Bureau Canada merger reviews, 2015 to this week.
Use for which mergers and acquisitions the Competition Bureau reviewed and how each ended: advance ruling certificate (ARC), no action letter (NAL), consent agreement (CA), judicial decision (JD), abandoned (TA), other, or still ongoing. Filter by party name (every word must appear), NAICS industry prefix (e.g. '2111' oil and gas extraction, '52' finance), outcome, and concluded month range (YYYY-MM). Covers the weekly report (reviews opened since November 2023, with opened and concluded dates) and the archived report (concluded January 2015 to April 2023, month only). Returns newest first, with outcome counts for all matches. Not every merger: parties may ask to keep one off the report, and May-October 2023 is missing. lang sets the outcome labels.
- Keywords
- merger review, acquisition, Competition Bureau, antitrust, competition law, advance ruling certificate, no action letter, consent agreement, NAICS, M&A, concentration
- Mots-clés
- examen de fusion, acquisition, Bureau de la concurrence, droit de la concurrence, certificat de décision préalable, lettre de non-intervention, consentement, SCIAN, fusions et acquisitions
| Parameter | Type | Default |
|---|---|---|
party | str | "" |
naics | str | null | null |
outcome | "ARC" | "NAL" | "CA" | "JD" | "TA" | "Other" | "Ongoing" | null | null |
concluded_from | str | null | null |
concluded_to | str | null | null |
include_ongoing | bool | true |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "competition_bureau_search_mergers", "arguments": {}}Federal and national
Earthquakes Canada
earthquakes_search
Earthquakes Canada (Natural Resources Canada) event catalogue: search earthquakes in and near Canada by date range, magnitude, region box or distance from a point, or look one up by event ID.
earthquakes_search Search Earthquakes Canada (NRCan) for earthquakes in and near Canada.
Use for recent or historical earthquakes by date range (YYYY-MM-DD, default the last 30 days), magnitude, distance from a point (latitude, longitude, radius_km, e.g. near Vancouver), or a [west, south, east, north] bbox. Pass event_id alone for one event. Results are most recent first, with time (UTC), location, depth and magnitude; the newest limit come back, with has_more true (and total_matches null) when more match. Use nrcan_geo_locate to turn a place into coordinates.
- Keywords
- earthquake, seismic event, tremor, quake, magnitude, epicentre, Earthquakes Canada, NRCan, seismology
- Mots-clés
- séisme, tremblement de terre, secousse sismique, magnitude, épicentre, activité sismique, Séismes Canada, RNCan, sismologie, séisme récent
| Parameter | Type | Default |
|---|---|---|
start | str | null | null |
end | str | null | null |
min_magnitude | float | null | null |
max_magnitude | float | null | null |
latitude | float | null | null |
longitude | float | null | null |
radius_km | float | null | null |
bbox | list[float] | null | null |
event_id | str | null | null |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "earthquakes_search", "arguments": {}}Federal and national
Natural Resources Canada: burned areas
nrcan_nbac_query_fires
Natural Resources Canada's National Burned Area Composite (NBAC): fire polygons, reported/adjusted start and end dates, and adjusted burned area (hectares) for every mapped fire event in Canada since 1972, filterable by year, province/territory…
Full description
Natural Resources Canada's National Burned Area Composite (NBAC): fire polygons, reported/adjusted start and end dates, and adjusted burned area (hectares) for every mapped fire event in Canada since 1972, filterable by year, province/territory, and fire id via an OGC WFS 2.0 CQL_FILTER query.
nrcan_nbac_query_fires Query mapped fire polygons/records from Natural Resources Canada's NBAC.
Use for wildfire start/end dates, adjusted burned area (hectares), fire cause, and (optionally) fire polygon geometry, for any fire event mapped in Canada since 1972. Filter with a standard OGC CQL expression against NBAC's own field names, e.g. "admin_area = 'BC' AND year >= 2017 AND year <= 2024" to get every mapped BC fire from 2017 to 2024. latest_year in the result is the newest fire year in NBAC (later years return nothing). Leave include_geometry false (the default) unless you specifically need the fire polygons: one polygon can be several MB, so with geometry at most 10 fires come back per call and polygons beyond a 2 MB budget are left out (note says which).
- Keywords
- NRCan, National Burned Area Composite, NBAC, wildfire, forest fire, burned area, fire polygon, hectares burned, CWFIS, fire perimeter, fire season, prescribed burn
- Mots-clés
- Ressources naturelles Canada (RNCan), Composite national des zones brûlées, CNZB, feu de forêt, incendie, superficie brûlée, polygone d'incendie, hectares brûlés, SCIFV, périmètre d'incendie, saison des feux, brûlage dirigé
| Parameter | Type | Default |
|---|---|---|
cql_filter | str | null | null |
include_geometry | bool | false |
sort_by | str | null | null |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "nrcan_nbac_query_fires", "arguments": {}}Federal and national
The Canadian Real Estate Association: MLS® Home Price Index links
crea_get_hpi_links
The Canadian Real Estate Association (CREA), tools prefixed crea_: links only for the MLS® Home Price Index (the current monthly zip, confirmed by a HEAD request, and the HPI tool page), CREA's national statistics, quarterly forecasts and housing market snapshot pages…
Full description
The Canadian Real Estate Association (CREA), tools prefixed crea_: links only for the MLS® Home Price Index (the current monthly zip, confirmed by a HEAD request, and the HPI tool page), CREA's national statistics, quarterly forecasts and housing market snapshot pages, the release timing (monthly, around the 15th), the required attribution and a summary of CREA's terms. No CREA values are returned: the terms allow private, non-commercial analysis only, and publishing or displaying the content needs CREA's written consent. Open alternatives (different measures): StatCan New Housing Price Index and CHSP sale prices (wds_), CMHC starts (cmhc_).
crea_get_hpi_links Where to get The Canadian Real Estate Association's (CREA) MLS® Home Price Index and national resale statistics yourself, and the terms that apply. Returns no CREA values: CREA's terms allow downloading for private, non-commercial analysis, but publishing or displaying the content needs CREA's prior written consent, and commercial use is forbidden.
Use for MLS home price index download, CREA resale house prices and benchmark prices, how to cite CREA, whether CREA data can be published, open substitutes for home prices.
- Keywords
- CREA, MLS, home price index, HPI, benchmark price, resale, house prices, real estate, home sales, housing market, attribution, terms of use
- Mots-clés
- Association canadienne de l'immeuble (ACI), MLS, indice des prix des propriétés, IPP, prix de référence, revente, prix des maisons, immobilier, ventes de maisons, marché de l'habitation, courtiers immobiliers, conditions d'utilisation
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "crea_get_hpi_links", "arguments": {}}Provincial · British Columbia
BC Ministry of Environment: air quality, snow, groundwater and streamflow
bc_env_
BC Ministry of Environment monitoring files on www.env.gov.bc.ca (tools prefixed bc_env_): unverified hourly air quality and meteorology for the last 30 days at about 100 provincial, Metro Vancouver and industry stations (PM2.5, ozone, NO2, SO2, TRS, CO and others…
Full description
BC Ministry of Environment monitoring files on www.env.gov.bc.ca (tools prefixed bc_env_): unverified hourly air quality and meteorology for the last 30 days at about 100 provincial, Metro Vancouver and industry stations (PM2.5, ozone, NO2, SO2, TRS, CO and others, raw and reported values), the current Air Quality Health Index with forecasts for 27 areas, automated snow weather stations (snow water equivalent, snow depth, precipitation, air temperature; current season and the hourly archive since 2003), manual snow survey measurements since 1935, groundwater observation well levels (depth to water, daily means back to the 1960s), and the provincial hydrometric network's discharge and stage (about 60 stations not in the Water Survey of Canada network, archives back to the 2000s). Open Government Licence - British Columbia.
bc_env_get_air_parameter_data One air pollutant or weather parameter across all BC stations, hourly.
Use for comparing stations for one parameter (PM25, PM10, O3, NO2, NO, NOx, SO2, TRS, H2S, CO, CH4, THC, NMHC, HF, or TEMP, HUMIDITY, PRECIP, PRESSURE, WSPD_SCLR, WDIR_VECT and other meteorology), e.g. the latest PM2.5 at every station (latest_only=true) or ozone at one station over a week. Each row has the unrounded raw value, the reported value, the instrument and the unit; hours are Pacific Standard Time (UTC-8) with time_utc. Last 30 days, unverified.
- Keywords
- British Columbia, air pollutant, PM2.5 map, latest readings, ozone, instrument, raw value, reported value, meteorology, provincial network
- Mots-clés
- Colombie-Britannique, polluant atmosphérique, PM2, 5, dernières mesures, ozone, instrument, valeur brute, valeur déclarée, météorologie, réseau provincial
| Parameter | Type | Default |
|---|---|---|
parameter | str | required |
station | str | null | null |
start | str | null | null |
end | str | null | null |
latest_only | bool | false |
limit | int | 200 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_env_get_air_parameter_data", "arguments": {"parameter": "…"}}bc_env_get_air_station_data Hourly pollutant and weather readings at one BC monitoring site, last 30 days.
Use for the recent hourly record of one station (name or EMS id from bc_env_list_air_stations), e.g. PM2.5 during a wildfire smoke event in Kamloops or SO2 in Trail, reshaped from the station's wide file into one row per hour and parameter (newest first) with units, plus the published rolling means (PM25_24, O3_8, SO2_24). parameters keeps some columns; start/end (2026-09-15 or 2026-09-15 08:00) filter on the hour in Pacific Standard Time (UTC-8 all year; time_utc is also given). Data are unverified raw values; verified history is only on an ftp server this tool cannot reach.
- Keywords
- British Columbia, hourly pollution, PM2.5, ozone, NO2, SO2, station data, time series, wildfire smoke, raw data, last 30 days
- Mots-clés
- Colombie-Britannique, pollution horaire, PM2, 5, ozone, NO2, SO2, données de station, série chronologique, fumée de feux de forêt, données brutes
| Parameter | Type | Default |
|---|---|---|
station | str | required |
parameters | list[str] | null | null |
start | str | null | null |
end | str | null | null |
limit | int | 200 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_env_get_air_station_data", "arguments": {"station": "…"}}bc_env_get_aqhi Current AQHI and forecasts for British Columbia areas (BC Ministry of Environment).
Use for the AQHI now in each of 27 BC areas (Metro Vancouver NW/NE/SW/SE, Fraser Valley, Victoria, Kamloops, Kelowna (Central Okanagan), Prince George, Williams Lake ...) with the risk category and the forecasts for today, tonight, tomorrow and tomorrow night; with area and history_hours (up to 720), the area's hourly AQHI for the last days, newest first.
- Keywords
- AQHI, British Columbia, BC smoke forecast, risk category, wildfire smoke, Metro Vancouver, Okanagan, Kamloops, Prince George, BC areas
- Mots-clés
- cote air santé, CAS, Colombie-Britannique, prévision de la qualité de l'air, risque pour la santé, fumée, Metro Vancouver, Okanagan, conditions actuelles, horaire
| Parameter | Type | Default |
|---|---|---|
area | str | null | null |
history_hours | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_env_get_aqhi", "arguments": {}}bc_env_get_snow_readings BC snow pillow readings for many stations, reshaped from the wide files, with archive.
Use for one variable across stations or across years: SW (SWE, mm), SD (snow depth, cm), PC (cumulative precipitation, mm), TA (degC), SW_DAILY (daily SWE), and current-season PA, XR, UD, US, UP, UR (pressure, humidity, wind). The source publishes one column per station; this returns one row per time and station (UTC, newest first). stations takes ids or name fragments. A start before the current season reads the archive (hourly since October 2003, daily SWE since 1967) by range requests, e.g. SWE at 2F01AP on 1 April 2023.
- Keywords
- snow water equivalent, SWE history, snow depth, snowpack, British Columbia, archive, hourly, daily, April 1 snowpack, wide to long, tidy
- Mots-clés
- équivalent en eau de la neige, historique, épaisseur de neige, manteau neigeux, Colombie-Britannique, archive, horaire, quotidien, relevé du 1er avril
| Parameter | Type | Default |
|---|---|---|
variable | str | required |
stations | list[str] | null | null |
start | str | null | null |
end | str | null | null |
limit | int | 200 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_env_get_snow_readings", "arguments": {"variable": "…"}}bc_env_get_snow_station_data Current-season readings of one BC automated snow station, with units and grades.
Use for everything one snow pillow station measured since 1 October: SWE (SW, mm), snow depth (SD, cm), TA (degC), cumulative precipitation (PC, mm) and, where present, peak wind, one row per time and variable (newest first, UTC), with the data grade. variables keeps some (e.g. ["SW", "SD"]). For earlier seasons use bc_env_get_snow_readings.
- Keywords
- snow water equivalent, SWE, snow depth, snow pillow, British Columbia, snowpack, data grade, current season, station readings, River Forecast Centre
- Mots-clés
- équivalent en eau de la neige, épaisseur de neige, coussin à neige, Colombie-Britannique, manteau neigeux, données horaires, précipitations, saison en cours
| Parameter | Type | Default |
|---|---|---|
station | str | required |
variables | list[str] | null | null |
start | str | null | null |
end | str | null | null |
limit | int | 200 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_env_get_snow_station_data", "arguments": {"station": "…"}}bc_env_get_snow_surveys Manual snow survey (snow course) measurements in British Columbia.
Use for snow depth (cm), SWE (mm) and density (%) measured by hand at snow courses around the survey dates (1 January to 15 June), for the current season or the archive back to the 1930s, e.g. the 1 April survey at Yellowhead (1A01). query matches course name or number prefix; start/end filter the survey date. Newest first.
- Keywords
- snow survey, snow course, manual measurement, SWE, snowpack, snow depth, density, British Columbia, River Forecast Centre, history, April 1
- Mots-clés
- relevé nivométrique, parcours nivométrique, mesure manuelle, équivalent en eau de la neige, épaisseur de neige, densité, Colombie-Britannique, historique
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
season | "current" | "archive" | "current" |
start | str | null | null |
end | str | null | null |
limit | int | 200 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_env_get_snow_surveys", "arguments": {}}bc_env_get_streamflow Discharge (m3/s) or stage (m) at one BC provincial streamflow gauge.
Use for the flow or gauge-height record of a provincial gauge (id from bc_env_list_streamflow_gauges): the current hydrological year (since 1 October) hourly, or, with start earlier, the yearly archives (back to the 2000s) read by range requests, e.g. 08HA0022 in August 2024. Rows are UTC, newest first, with the grade (Undefined, RISC U, RISC E, Estimated ...).
- Keywords
- discharge, streamflow, creek flow, gauge height, British Columbia, provincial gauge, archive, low flow, freshet, m3/s
- Mots-clés
- débit, écoulement, débit fluvial, hauteur d'eau, niveau d'eau, hydrométrique, Colombie-Britannique, station provinciale, archive, étiage, crue
| Parameter | Type | Default |
|---|---|---|
station | str | required |
parameter | "discharge" | "stage" | "discharge" |
start | str | null | null |
end | str | null | null |
limit | int | 200 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_env_get_streamflow", "arguments": {"station": "…"}}bc_env_get_well_levels Groundwater levels at one BC observation well (depth below ground, metres).
Use for the groundwater record of a well such as OW002 Abbotsford: series "daily" (daily means over the whole record, back to the 1960s for the oldest wells), "hourly" (last 12 months, with approval status Approved or Working) or "all" (every published reading). Values are metres below ground, so a larger number means a deeper level. Hourly times are a fixed UTC-7 clock. start/end filter by date; newest first.
- Keywords
- groundwater level, depth below ground, observation well, piezometric level, aquifer, British Columbia, drought, time series, daily mean, hourly
- Mots-clés
- niveau des eaux souterraines, profondeur de l'eau, puits d'observation, nappe phréatique, aquifère, Colombie-Britannique, sécheresse, série chronologique, moyenne quotidienne
| Parameter | Type | Default |
|---|---|---|
well | str | required |
series | "daily" | "hourly" | "all" | "daily" |
start | str | null | null |
end | str | null | null |
limit | int | 200 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_env_get_well_levels", "arguments": {"well": "…"}}bc_env_list_air_stations List British Columbia pollution monitoring sites reporting this hour.
Use for finding a BC monitoring site and its EMS id before reading its hourly data: about 100 stations run by the province (ENV), Metro Vancouver (MVRD) and industry, with city, coordinates, the parameters each measures (PM25, PM10, O3, NO2, SO2, TRS, H2S, CO, wind) and their units, and the latest hour. query matches name, city or EMS id; parameter keeps stations measuring it (e.g. PM25); owner filters ENV, MVRD or INDUSTRY.
- Keywords
- British Columbia, pollution, monitoring site, PM2.5, ozone, nitrogen dioxide, sulphur dioxide, EMS id, Metro Vancouver, wildfire smoke
- Mots-clés
- Colombie-Britannique, qualité de l'air, station de surveillance, PM2, 5, particules fines, ozone, dioxyde d'azote, dioxyde de soufre, fumée de feux de forêt, Metro Vancouver
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
parameter | str | null | null |
owner | str | null | null |
limit | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_env_list_air_stations", "arguments": {}}bc_env_list_snow_stations List BC automated snow weather stations (snow pillows).
Use for finding an automated snow station id (such as 1A01P Yellowhead Lake or 2F01AP Trout Creek West) before reading SWE or snow depth; about 156 stations with elevation, status, operator (BC ENV, BC Hydro ...) and coordinates. The first digit and letter of the id give the basin (1 Fraser, 2 Columbia, 3 coast, 4 north).
- Keywords
- British Columbia, snow pillow, automated snow weather station, snow survey, River Forecast Centre, snowpack, station list, elevation, basin, BC Hydro
- Mots-clés
- Colombie-Britannique, coussin à neige, station nivométéorologique automatique, relevé nivométrique, Centre de prévision des crues, manteau neigeux, liste des stations, altitude
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
status | str | null | null |
operator | str | null | null |
limit | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_env_list_snow_stations", "arguments": {}}bc_env_list_streamflow_gauges List BC provincial streamflow gauges (Ministry of Environment network).
Use for finding a BC provincial creek gauge, about 60 stations run by the Ministry of Environment and partners (ids like 08HA0022 Koksilah River at Trestle or H08KC0844 Hakai) that are not in the federal WSC network served by eccc_ tools; with the parameters each reports (discharge, stage) and the latest time.
- Keywords
- BC provincial gauge, streamflow, creek flow, discharge, British Columbia, Ministry of Environment, Hakai, flow monitoring, provincial network
- Mots-clés
- station hydrométrique, débit, écoulement fluvial, niveau d'eau, hauteur d'eau, Colombie-Britannique, réseau provincial, jauge, ruisseau
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
limit | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_env_list_streamflow_gauges", "arguments": {}}bc_env_list_wells List BC provincial groundwater observation wells.
Use for finding an observation well id (OW002 ...) by city, address, region (Cariboo, Okanagan, Lower Mainland, Vancouver Island ...) or status (Active, Inactive) before reading its levels; each well has coordinates, aquifer id and material, depth and ground elevation (feet, as in the provincial wells database), the date its data file last changed and a GWELLS link. with_data_only=false also lists wells that have no level files.
- Keywords
- groundwater, observation well, aquifer, GWELLS id, British Columbia, well list, monitoring network, drought, GWELLS, piezometer
- Mots-clés
- eaux souterraines, puits d'observation, aquifère, nappe phréatique, Colombie-Britannique, liste des puits, réseau de surveillance, sécheresse, niveau d'eau
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
status | str | null | null |
region | str | null | null |
with_data_only | bool | true |
limit | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_env_list_wells", "arguments": {}}Provincial · Ontario · Quebec
Electricity: Ontario (IESO) and Quebec (Hydro-Québec)
electricity_
Ontario electricity system data from the IESO public reports: hourly Ontario and market demand (2002 onward), 5-minute real-time demand, hourly generation by fuel (2015 onward), Ontario Zonal Prices (day-ahead hourly, real-time 5-minute…
Full description
Ontario electricity system data from the IESO public reports: hourly Ontario and market demand (2002 onward), 5-minute real-time demand, hourly generation by fuel (2015 onward), Ontario Zonal Prices (day-ahead hourly, real-time 5-minute; successor to HOEP since 2025-05-01) and HOEP monthly averages to 2025, the daily adequacy outlook and intertie schedules and flows; plus Quebec (Hydro-Quebec, CC BY-NC 4.0, non-commercial): 15-minute demand, generation by source, imports and exports, and hourly water flows and daily natural inflows at 94 Hydro-Quebec dams and generating stations. Ontario (IESO) and Québec (Hydro-Québec) only; Alberta is not covered, nor are other provinces.
electricity_ontario_get_adequacy_outlook Ontario's hourly supply-adequacy outlook for one delivery day (today by default).
Use for will Ontario have enough power, reserve margin, forecast peak demand, supply outlook, generator outages.
- Keywords
- Ontario, IESO, adequacy, outlook, reserve margin, excess capacity, forecast demand, supply, outages, reliability, MW
- Mots-clés
- Ontario, Société indépendante d'exploitation du réseau d'électricité (SIERE), suffisance, perspective, marge de réserve, capacité excédentaire, demande prévue, approvisionnement, pannes, fiabilité
| Parameter | Type | Default |
|---|---|---|
date | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "electricity_ontario_get_adequacy_outlook", "arguments": {}}electricity_ontario_get_hoep_history Monthly averages of the Hourly Ontario Energy Price (HOEP), 2002-2025.
Use for historical Ontario electricity spot prices, HOEP by month, price trends before the 2025 market renewal.
- Keywords
- Ontario, IESO, HOEP, hourly Ontario energy price, historical price, monthly average, on-peak, off-peak, weighted average, wholesale
- Mots-clés
- Ontario, Société indépendante d'exploitation du réseau d'électricité (SIERE), prix horaire de l'énergie en Ontario (PHEO), historique des prix, moyenne mensuelle, période de pointe, hors pointe, moyenne pondérée, prix de gros de l'électricité
| Parameter | Type | Default |
|---|---|---|
year | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "electricity_ontario_get_hoep_history", "arguments": {}}electricity_ontario_get_hourly_demand Ontario hourly electricity demand in MW, 2002 to the previous day.
Use for Ontario electricity load, peak demand, daily or seasonal demand profile, demand history, how much power Ontario uses. Electricity data here is Ontario (IESO) and Québec (Hydro-Québec) only; Alberta is not covered.
- Keywords
- Ontario, IESO, electricity demand, hourly demand, peak demand, load, MW, market demand, Ontario demand, power grid, consumption
- Mots-clés
- Ontario, Société indépendante d'exploitation du réseau d'électricité (SIERE), demande d'électricité, demande horaire, pointe, charge, MW, demande du marché, réseau électrique, consommation
| Parameter | Type | Default |
|---|---|---|
year | int | null | null |
start_date | str | null | null |
end_date | str | null | null |
limit | int | 48 |
lang | "en" | "fr" | "en" |
call_tool {"name": "electricity_ontario_get_hourly_demand", "arguments": {}}electricity_ontario_get_intertie_flows Ontario electricity imports and exports by intertie zone (Manitoba, Quebec, New York, ...).
Use for Ontario electricity trade, imports from Quebec, exports to the United States, interprovincial power flows.
- Keywords
- Ontario, IESO, intertie, imports, exports, Quebec, Manitoba, New York, Michigan, Minnesota, flows, schedule, interprovincial, trade
- Mots-clés
- Ontario, Société indépendante d'exploitation du réseau d'électricité (SIERE), interconnexion, importations, exportations, Québec, Manitoba, New York, flux, échanges d'électricité, interprovincial
| Parameter | Type | Default |
|---|---|---|
date | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "electricity_ontario_get_intertie_flows", "arguments": {}}electricity_ontario_get_prices Ontario Zonal Price (CAD/MWh): day-ahead hourly or real-time 5-minute.
Use for Ontario wholesale electricity price, day-ahead price, spot price now, price spikes, congestion and loss components. Prices are Ontario (IESO) only; Alberta pool prices are not covered.
- Keywords
- Ontario, IESO, electricity price, zonal price, OZP, day-ahead, real-time, LMP, CAD/MWh, wholesale, spot, market renewal, congestion
- Mots-clés
- Ontario, Société indépendante d'exploitation du réseau d'électricité (SIERE), prix de l'électricité, prix zonal, prévisionnel, temps réel, prix marginal, $/MWh, gros, marché au comptant, congestion
| Parameter | Type | Default |
|---|---|---|
market | "day_ahead" | "real_time" | "day_ahead" |
date | str | null | null |
hour | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "electricity_ontario_get_prices", "arguments": {}}electricity_ontario_get_realtime_demand Ontario demand every 5 minutes for the latest delivery hour (or a past hour).
Use for right-now Ontario electricity demand, 5-minute load, real-time grid conditions in Ontario.
- Keywords
- Ontario, IESO, real-time demand, 5-minute, current load, live, electricity, MW, dispatch, grid, now
- Mots-clés
- Ontario, Société indépendante d'exploitation du réseau d'électricité (SIERE), demande en temps réel, 5 minutes, charge actuelle, électricité, MW, réseau, maintenant, répartition
| Parameter | Type | Default |
|---|---|---|
date | str | null | null |
hour | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "electricity_ontario_get_realtime_demand", "arguments": {}}electricity_ontario_get_supply_by_fuel Ontario hourly generator output by fuel (nuclear, gas, hydro, wind, solar, biofuel), 2015 onward.
Use for Ontario generation mix, nuclear or wind share, gas-fired output, supply by fuel type, clean electricity share.
- Keywords
- Ontario, IESO, generation mix, supply by fuel, nuclear, gas, hydro, wind, solar, biofuel, output, MW, MWh, energy mix
- Mots-clés
- Ontario, Société indépendante d'exploitation du réseau d'électricité (SIERE), bouquet énergétique, production par combustible, nucléaire, gaz, hydroélectricité, éolien, solaire, MW, MWh
| Parameter | Type | Default |
|---|---|---|
year | int | null | null |
start_date | str | null | null |
end_date | str | null | null |
limit | int | 48 |
lang | "en" | "fr" | "en" |
call_tool {"name": "electricity_ontario_get_supply_by_fuel", "arguments": {}}electricity_quebec_get_demand Quebec electricity demand in MW from Hydro-Quebec open data.
Use for how much electricity Quebec is using now, Quebec peak demand, Hydro-Quebec load history, winter peaks. Electricity data here is Ontario (IESO) and Québec (Hydro-Québec) only; Alberta is not covered.
- Keywords
- Quebec, Hydro-Quebec, electricity demand, load, MW, peak demand, 15-minute, hourly, open data, power grid, consumption
- Mots-clés
- Québec, Hydro-Québec, demande d'électricité, charge, MW, pointe, 15 minutes, horaire, données ouvertes, réseau, consommation
| Parameter | Type | Default |
|---|---|---|
dataset | "recent" | "history" | "recent" |
start_date | str | null | null |
end_date | str | null | null |
limit | int | 48 |
lang | "en" | "fr" | "en" |
call_tool {"name": "electricity_quebec_get_demand", "arguments": {}}electricity_quebec_get_facility_flows Hourly flows (total, turbined, spilled) and daily natural inflows at one Hydro-Quebec generating station or control structure, in m³/s, for the last ten days or so.
Use for hourly flow through a Quebec power station, is a dam spilling now, reservoir inflow trend this week, flow at Beauharnois or Carillon.
- Keywords
- Hydro-Quebec, hourly flow, discharge, turbined flow, spilled flow, natural inflow, dam, generating station, hydroelectric, m3/s, time series
- Mots-clés
- Hydro-Québec, débit horaire, débit turbiné, débit déversé, apport naturel, barrage, centrale, hydroélectricité, série chronologique, m3/s
| Parameter | Type | Default |
|---|---|---|
facility | str | required |
kind | "total" | "turbined" | "spilled" | "inflow" | null | null |
start | str | null | null |
end | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "electricity_quebec_get_facility_flows", "arguments": {"facility": "…"}}electricity_quebec_get_generation Quebec electricity generation by source (hydro, wind, solar, thermal, other) in MW.
Use for Quebec generation mix, hydroelectric output, wind share, thermal generation in Quebec.
- Keywords
- Quebec, Hydro-Quebec, generation, supply, hydroelectric, wind, solar, thermal, energy mix, MW, open data, sources of electricity
- Mots-clés
- Québec, Hydro-Québec, production d'électricité, hydraulique, éolien, solaire, thermique, bouquet énergétique, MW, sources d'électricité
| Parameter | Type | Default |
|---|---|---|
dataset | "recent" | "history" | "recent" |
start_date | str | null | null |
end_date | str | null | null |
limit | int | 48 |
lang | "en" | "fr" | "en" |
call_tool {"name": "electricity_quebec_get_generation", "arguments": {}}electricity_quebec_get_trade Quebec hourly electricity exports and imports by market (incl. wheel-through).
Use for Quebec electricity exports, imports from Ontario or New York, interprovincial and cross-border power trade.
- Keywords
- Quebec, Hydro-Quebec, exports, imports, electricity trade, New England, New Brunswick, New York, Ontario, wheel-through, interties
- Mots-clés
- Québec, Hydro-Québec, exportations, importations, commerce d'électricité, Nouvelle-Angleterre, Nouveau-Brunswick, New York, Ontario, transits, interconnexions
| Parameter | Type | Default |
|---|---|---|
start_date | str | null | null |
end_date | str | null | null |
limit | int | 48 |
lang | "en" | "fr" | "en" |
call_tool {"name": "electricity_quebec_get_trade", "arguments": {}}electricity_quebec_list_facilities Hydro-Quebec generating stations, dams and reservoirs with flow data (94 sites): id, name, administrative region, coordinates and each series with its latest value in m³/s.
Use for flow at a Quebec dam or power station, which Hydro-Quebec plants are spilling, natural inflows to reservoirs, the site id for electricity_quebec_get_facility_flows.
- Keywords
- Hydro-Quebec, dam flow, discharge, turbined flow, spillway, dam, reservoir inflow, generating station, hydroelectric, m3/s, Quebec rivers
- Mots-clés
- Hydro-Québec, débit, débit turbiné, débit déversé, évacuateur de crues, barrage, apport naturel, centrale, réservoir, hydroélectricité, rivières du Québec
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
region | str | null | null |
kind | "total" | "turbined" | "spilled" | "inflow" | null | null |
limit | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "electricity_quebec_list_facilities", "arguments": {}}Provincial · Alberta
Alberta Wildfire: live status
ab_wildfire_
Alberta Wildfire live status (Government of Alberta, open licence): current-season fire locations with status, cause, size class and forest area (active and extinguished, plus same-date comparison with the previous five years), mapped fire perimeters…
Full description
Alberta Wildfire live status (Government of Alberta, open licence): current-season fire locations with status, cause, size class and forest area (active and extinguished, plus same-date comparison with the previous five years), mapped fire perimeters, fire danger rating by point or area, fire bans, restrictions and advisories, and the season statistics against 5, 10 and 25-year averages. Active layers are empty off-season.
ab_wildfire_get_fire_danger Alberta's fire danger rating at a point: Low, Moderate, High, Very High or Extreme, with what the class means.
Use for how dangerous is the wildfire risk at a town, is the fire danger extreme near me, camping or burning conditions in Alberta.
- Keywords
- Alberta, fire danger, fire danger rating, wildfire risk, fire weather index, extreme, very high, high, moderate, low, forest fire danger, Alberta Wildfire
- Mots-clés
- Alberta, danger d'incendie, cote de danger d'incendie, risque de feu de forêt, indice forêt-météo, extrême, très élevé, élevé, modéré, faible, danger de feu de forêt
| Parameter | Type | Default |
|---|---|---|
latitude | float | required |
longitude | float | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_wildfire_get_fire_danger", "arguments": {"latitude": "…", "longitude": "…"}}ab_wildfire_get_fire_perimeters List mapped Alberta wildfire perimeters (polygons), largest first, with the fire's status, cause, estimated and mapped area, and how the outline was captured (GPS, aerial imagery, hybrid).
Use for the outline of an Alberta wildfire, the size of a burned area, mapping extinguished fires, how a perimeter was captured.
- Keywords
- Alberta, wildfire, fire perimeter, burned area, polygon, GeoJSON, fire boundary, extinguished fires, active fires, area hectares, Alberta Wildfire
- Mots-clés
- Alberta, feu de forêt, périmètre du feu, zone brûlée, polygone, GeoJSON, limite du feu, feux éteints, feux actifs, superficie en hectares
| Parameter | Type | Default |
|---|---|---|
state | "active" | "extinguished" | "active" |
fire_number | str | null | null |
cause | str | null | null |
size_class | str | null | null |
forest_area | str | null | null |
min_area_ha | float | null | null |
include_geometry | bool | false |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_wildfire_get_fire_perimeters", "arguments": {}}ab_wildfire_get_fire_restrictions List Alberta fire bans, fire restrictions, fire advisories and forest area closures (plus off-highway-vehicle restrictions when any exist) from the Alberta Fire Ban System, most severe first, province-wide or only those covering a point.
Use for is there a fire ban where I am, which Alberta counties have fire restrictions, campfire rules in a municipality, current fire bans.
- Keywords
- Alberta, fire ban, fire restriction, fire advisory, forest closure, burning ban, campfire, open fire, OHV restriction, county, municipality, national park, Alberta Fire Ban System
- Mots-clés
- Alberta, interdiction de feu, restriction de feu, avis de feu, fermeture de forêt, interdiction de brûlage, feu de camp, feu à ciel ouvert, restriction VTT, comté, municipalité, parc national
| Parameter | Type | Default |
|---|---|---|
latitude | float | null | null |
longitude | float | null | null |
alert_type | str | null | null |
name_contains | str | null | null |
limit | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_wildfire_get_fire_restrictions", "arguments": {}}ab_wildfire_get_fires List Alberta Wildfire fire locations (points) with status, cause, size class, estimated area in hectares and responsible forest area, from Alberta Wildfire's own status map. No API key.
Use for wildfires burning now in Alberta, the biggest fires of the season, lightning versus human-caused fires, fires near a town or in a forest area, how many fires Alberta had this year.
- Keywords
- Alberta, wildfire, forest fire, active fires, fire status, out of control, being held, under control, extinguished, fire cause, lightning, human caused, size class, forest area, mutual aid, fire locations, fire season, Alberta Wildfire
- Mots-clés
- Alberta, feu de forêt, incendie de forêt, feux actifs, statut du feu, hors de contrôle, maîtrisé, éteint, cause du feu, foudre, cause humaine, classe de superficie, zone forestière, entraide, saison des feux
| Parameter | Type | Default |
|---|---|---|
dataset | "current" | "previous_5_years" | "current" |
status | str | null | null |
active_only | bool | false |
fire_type | str | null | null |
cause | str | null | null |
size_class | str | null | null |
forest_area | str | null | null |
fire_year | int | null | null |
carryover | bool | null | null |
start_date | str | null | null |
end_date | str | null | null |
date_basis | "assessed" | "status_changed" | "assessed" |
min_area_ha | float | null | null |
bbox | list[float] | null | null |
latitude | float | null | null |
longitude | float | null | null |
radius_km | float | null | null |
sort_by | "latest" | "largest" | "latest" |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_wildfire_get_fires", "arguments": {}}ab_wildfire_get_season_statistics Alberta Wildfire's season dashboard: active wildfires and area, wildfires and area burned so far this year, new wildfires in the last 24 hours, and the totals as at the same calendar date in each of the last six years next to the 5, 10 and 25-year averages.
Use for how this fire season compares with the average, hectares burned in Alberta so far this year, how many wildfires Alberta has had, new fires in the past day.
- Keywords
- Alberta, wildfire, fire season, season statistics, hectares burned, area burned, year to date, five year average, ten year average, comparison, wildfire count, Alberta Wildfire dashboard
- Mots-clés
- Alberta, feu de forêt, saison des feux, statistiques de la saison, hectares brûlés, superficie brûlée, depuis le début de l'année, moyenne sur cinq ans, moyenne sur dix ans, comparaison, nombre de feux, tableau de bord
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_wildfire_get_season_statistics", "arguments": {}}ab_wildfire_summarize_fire_danger Count Alberta's fire danger rating polygons by class (Low to Extreme), province-wide or for a box [min_lon, min_lat, max_lon, max_lat], with the most severe class present.
Use for is any part of Alberta at extreme fire danger, fire danger across a region, the worst rating in an area.
- Keywords
- Alberta, fire danger, danger rating, wildfire risk, region, province-wide, extreme, very high, fire weather, rating polygons, Alberta Wildfire
- Mots-clés
- Alberta, danger d'incendie, cote de danger, risque de feu de forêt, région, ensemble de la province, extrême, très élevé, météo des incendies, polygones de cote
| Parameter | Type | Default |
|---|---|---|
bbox | list[float] | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_wildfire_summarize_fire_danger", "arguments": {}}ab_wildfire_summarize_fires Count Alberta wildfires and sum their estimated area (hectares) grouped by "status", "cause", "size_class", "forest_area", "fire_type" or "fire_year", with the same filters as ab_wildfire_get_fires. Computed by the server over every matching row, not a sample.
Use for fires by cause this season, area burned by forest area, how many fires are out of control, fire counts by size class, comparing this year with earlier years on the same date.
- Keywords
- Alberta, wildfire, fire statistics, fires by cause, area burned, hectares, lightning, human caused, forest area, size class, fire counts, season totals, Alberta Wildfire
- Mots-clés
- Alberta, feu de forêt, statistiques des feux, feux par cause, superficie brûlée, hectares, foudre, cause humaine, zone forestière, classe de superficie, nombre de feux, bilan de la saison
| Parameter | Type | Default |
|---|---|---|
dataset | "current" | "previous_5_years" | "current" |
group_by | "status" | "cause" | "size_class" | "forest_area" | "fire_type" | "fire_year" | "status" |
status | str | null | null |
active_only | bool | false |
fire_type | str | null | null |
cause | str | null | null |
size_class | str | null | null |
forest_area | str | null | null |
fire_year | int | null | null |
carryover | bool | null | null |
start_date | str | null | null |
end_date | str | null | null |
date_basis | "assessed" | "status_changed" | "assessed" |
min_area_ha | float | null | null |
bbox | list[float] | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_wildfire_summarize_fires", "arguments": {}}Provincial · Alberta
Alberta Economic Dashboard
ab_economic_
Alberta Economic Dashboard (Government of Alberta): list its ~260 curated economic data tables, inspect a table's columns and filter values, fetch filtered time series (labour, CPI, GDP, energy, exports, housing, population, business)…
Full description
Alberta Economic Dashboard (Government of Alberta): list its ~260 curated economic data tables, inspect a table's columns and filter values, fetch filtered time series (labour, CPI, GDP, energy, exports, housing, population, business), and browse the dashboard's key-indicator catalogue with last-update dates. English-only content.
ab_economic_get_data Get time-series rows from an Alberta Economic Dashboard table.
Use for Alberta unemployment, employment, wages, CPI, GDP, exports, energy production, housing and population series. Pass a table and filters from ab_economic_get_indicator_series (preferred), or column values from ab_economic_get_table_fields, e.g. table="UnemploymentRates_14100287", filters={"GeoName": "Alberta", "Sex": "Both sexes", "Age": "15 years and over"}. Dates are inclusive ISO dates; the most recent limit rows (max 2000) come back oldest first.
- Keywords
- Alberta, economic data, time series, unemployment rate, inflation, GDP, exports, oil production, Calgary, Edmonton
- Mots-clés
- Alberta, données économiques, séries chronologiques, taux de chômage, emploi, salaires, inflation, PIB, exportations, production pétrolière, Calgary, Edmonton
| Parameter | Type | Default |
|---|---|---|
table | str | required |
filters | dict[str, str] | null | null |
start_date | str | null | null |
end_date | str | null | null |
limit | int | 120 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_economic_get_data", "arguments": {"table": "…"}}ab_economic_get_indicator_series Get the official API series published on one Alberta Economic Dashboard indicator page.
Use for the recommended route to Alberta data. Each indicator page (e.g. "Unemployment Rate", "Housing Starts", "Farm Cash Receipts") publishes named API links such as "Unemployment rate in Alberta" or "... by Industry"; each comes back as a table plus filters to pass straight to ab_economic_get_data.
- Keywords
- Alberta, economic dashboard, indicator, API, series, official data link, unemployment, housing starts, CPI
- Mots-clés
- Alberta, tableau de bord économique, indicateur, API, série officielle, lien de données officiel, taux de chômage, mises en chantier, IPC, recettes monétaires agricoles
| Parameter | Type | Default |
|---|---|---|
indicator | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_economic_get_indicator_series", "arguments": {"indicator": "…"}}ab_economic_get_table_fields Get an Alberta Economic Dashboard table's columns and their filter values.
Use for learning which columns (GeoName, Sex, Age, Industry, ...) and values to pass as filters to ab_economic_get_data, plus the indicator's name and frequency.
- Keywords
- Alberta, economic dashboard, table schema, columns, dimensions, filter values, metadata, field names
- Mots-clés
- Alberta, tableau de bord économique, structure du tableau, colonnes, dimensions, valeurs de filtre, métadonnées, noms de champs
| Parameter | Type | Default |
|---|---|---|
table | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_economic_get_table_fields", "arguments": {"table": "…"}}ab_economic_list_indicators List the Alberta Economic Dashboard's key indicators by topic, with last-update dates.
Use for seeing what Alberta's government tracks (agriculture, consumer spending, construction, energy, jobs, business, exports, productivity, population, GDP) and what was updated recently. Then get an indicator's published series with ab_economic_get_indicator_series.
- Keywords
- Alberta, economic dashboard, key indicators, economy, latest data, Government of Alberta, snapshot, updates
- Mots-clés
- Alberta, tableau de bord économique de l'Alberta, indicateurs clés, indicateurs économiques, économie albertaine, données récentes, gouvernement de l'Alberta, mises à jour, conjoncture
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_economic_list_indicators", "arguments": {}}ab_economic_list_tables List or search the Alberta Economic Dashboard's ~260 data tables.
Use for finding the table behind an Alberta indicator, e.g. query="Unemployment", "CPI", "AESO", "RigCount", "Exports", or a StatCan table number such as "14100287". Names ending in an 8-10 digit number mirror that StatCan table with Alberta-focused cuts.
- Keywords
- Alberta, economic data, tables, labour force, CPI, exports, energy, housing starts, population, rig count
- Mots-clés
- Alberta, données économiques, tableaux de données, population active, IPC, exportations, énergie, mises en chantier, population, nombre d'appareils de forage, tableau de Statistique Canada
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_economic_list_tables", "arguments": {}}Provincial · British Columbia
BC Registrar of Lobbyists: registrations and activity reports
bc_lobbyists_
British Columbia lobbyists registry (Office of the Registrar of Lobbyists), tools prefixed bc_lobbyists_: search registrations (client, consultant firm, lobbyists, topics, ministries targeted, active or ended…
Full description
British Columbia lobbyists registry (Office of the Registrar of Lobbyists), tools prefixed bc_lobbyists_: search registrations (client, consultant firm, lobbyists, topics, ministries targeted, active or ended, period) and lobbying activity reports since 2020-05-04 (who met which senior public office holder, which ministry, on what subject), count activity by client, ministry, office holder, subject or month, and list the registry's subject matters, intended outcomes and ministries. Monthly open data under the ORL Open Data Licence; addresses, telephone numbers, political contribution flags, gifts and lobbyists' past public offices are left out because the licence grants no rights to Personal Information. The federal registry is blocked to automated access (see the roadmap).
bc_lobbyists_get_registration Read one BC lobbyist registration in full: every lobbyist, topic and ministry.
Use for the complete record of a registration found with bc_lobbyists_search_registrations: all lobbyists named, every topic of lobbying in the filer's words with its subject matters and intended outcomes (legislation, regulation, program or policy, contract or grant), ministries and entities to be contacted, client description and website, start and end dates. registration is the record id ('R-56584653'), the registration number ('9997-443-56') or just 'filer-client' ('9997-443') for the current version of that pair. An older version's number or id resolves to the current one.
- Keywords
- lobbyist registration detail, BC lobbying registration number, lobbying topics, intended outcomes, ministries contacted, registrar of lobbyists record, lobbyists named, registration return
- Mots-clés
- détail d'une inscription de lobbyiste, numéro d'inscription, Colombie-Britannique, sujets de lobbying, résultats visés, ministères visés, registraire des lobbyistes, lobbyistes nommés, déclaration d'inscription
| Parameter | Type | Default |
|---|---|---|
registration | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_lobbyists_get_registration", "arguments": {"registration": "…"}}bc_lobbyists_list_codes List the BC lobbyists registry's subject matters, intended outcomes or ministries.
Use for the exact words the registry uses before filtering: subject_matters (Forestry, Health, Energy, Housing, COVID-19 and about 50 more, for the subject_matter filter), intended_outcomes (the seven BC-xx outcomes of the 2020 Act and the six legacy IO-xx ones: legislation, regulation, program or policy, contract or grant, privatization, arranging a meeting) or ministries (every ministry, agency or 'Member(s) of the BC Legislative Assembly' named in activity reports, with the number of reports naming it, for the agency filter). query keeps names holding every word.
- Keywords
- BC lobbying subject matters, lobbying intended outcomes, ministries lobbied, registry codes, lobbying topics list, provincial entities, Lobbyists Transparency Act outcomes, code list
- Mots-clés
- sujets de lobbying, résultats visés, ministères visés, codes du registre, liste des sujets, organismes provinciaux, loi sur la transparence du lobbying, Colombie-Britannique, liste de codes
| Parameter | Type | Default |
|---|---|---|
kind | "subject_matters" | "intended_outcomes" | "ministries" | required |
query | str | "" |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_lobbyists_list_codes", "arguments": {"kind": "…"}}bc_lobbyists_search_activity_reports Search BC lobbying activity reports: who lobbied which public office holder.
Use for the monthly reports lobbyists file about communications with senior public office holders in British Columbia since 2020-05-04: the meeting date, the client, the lobbyists, each office holder reached (name, title, ministry or MLA), and the topic and subject matter. Find who lobbied a minister, deputy minister or ministry, what a client lobbied on, which meetings a lobbyist reported, and lobbying on a subject in a period. query words must all appear in the client, people, ministries or topics; office_holder matches a name or title ('Deputy Minister'); agency a ministry ('Health', 'Office of the Premier', 'Legislative Assembly'); date_from and date_to (YYYY-MM-DD) bound the meeting date; arranged_only true keeps reports about arranging a meeting. Newest first. A report is a filing, not a meeting; use bc_lobbyists_summarize_activity for counts.
- Keywords
- BC lobbying activity report, who met minister, lobbyist meetings, senior public office holder, deputy minister lobbying, ministry lobbied, lobbying communications, British Columbia lobbying disclosure, meeting date
- Mots-clés
- rapport d'activité de lobbying, qui a rencontré le ministre, rencontres de lobbyistes, titulaire de charge publique supérieure, sous-ministre, ministère visé, communications de lobbying, Colombie-Britannique, divulgation du lobbying, date de la rencontre
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
client_name | str | "" |
lobbyist | str | "" |
office_holder | str | "" |
agency | str | "" |
subject_matter | str | "" |
kind | "consultant" | "in_house" | null | null |
date_from | str | null | null |
date_to | str | null | null |
arranged_only | bool | null | null |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_lobbyists_search_activity_reports", "arguments": {}}bc_lobbyists_search_registrations Search British Columbia lobbyist registrations (clients, consultants, topics).
Use for who is registered to lobby the BC government, for whom and on what: a company or association's registrations (client or organization), a consulting firm's clients, one lobbyist's registrations, lobbying topics and subject matters (forestry, health, energy, housing), the ministries to be contacted, and whether a registration is still active. Current version of each registration since 2010, under the Lobbyists Transparency Act (from 2020-05-04) or the earlier Act. Words in query must all appear in the client, firm, lobbyist names, topics or client description; client_name, lobbyist, firm (consulting firm or filer), agency (ministry) and subject_matter (a registry subject like 'Forestry') narrow it; date_from and date_to (YYYY-MM-DD) keep registrations active at any time in that period. For who actually met whom use bc_lobbyists_search_activity_reports. Addresses, phone numbers, contribution flags and gifts are not included (ORL licence).
- Keywords
- BC lobbyist registry, lobbyist registration, British Columbia lobbying, consultant lobbyist, in-house lobbyist, lobbying client, Registrar of Lobbyists, Lobbyists Transparency Act, lobbying topics, who lobbies
- Mots-clés
- registre des lobbyistes, inscription de lobbyiste, Colombie-Britannique, lobbying, lobbyiste-conseil, lobbyiste interne, client du lobbyiste, registraire des lobbyistes, loi sur la transparence du lobbying, sujets de lobbying, qui fait du lobbying
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
client_name | str | "" |
lobbyist | str | "" |
firm | str | "" |
subject_matter | str | "" |
agency | str | "" |
kind | "consultant" | "in_house" | null | null |
status | "active" | "ended" | null | null |
date_from | str | null | null |
date_to | str | null | null |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_lobbyists_search_registrations", "arguments": {}}bc_lobbyists_summarize_activity Count BC lobbying activity reports by client, ministry, office holder, subject or month.
Use for rankings and trends in BC lobbying since 2020-05-04: the clients reporting the most lobbying, the ministries or office holders lobbied most, the busiest subjects (health, forestry, energy, housing), the most active lobbyists, and monthly or yearly volume. group_by is client, ministry, office_holder, subject_matter, lobbyist, month or year; the filters are those of bc_lobbyists_search_activity_reports (all optional), so 'reports per ministry for one client in 2025' is one call. Counts are distinct reports, not meetings; rows for a report with several ministries or subjects add up to more than the total. top caps the rows: for client, ministry, office_holder, subject_matter and lobbyist they are the top largest counts, largest first; for month and year they are the top most recent periods (a contiguous trend, not the busiest periods), oldest to newest. groups_total gives the number of groups before the cap.
- Keywords
- BC lobbying statistics, most lobbied ministry, top lobbying clients, lobbying by subject, lobbying trend by month, lobbying volume, count of lobbying reports, who lobbies most, lobbying ranking
- Mots-clés
- statistiques sur le lobbying, ministère le plus visé, clients les plus actifs, lobbying par sujet, tendance mensuelle, volume de lobbying, nombre de rapports de lobbying, Colombie-Britannique, classement du lobbying
| Parameter | Type | Default |
|---|---|---|
group_by | "client" | "ministry" | "office_holder" | "subject_matter" | "lobbyist" | "month" | "year" | required |
query | str | "" |
client_name | str | "" |
lobbyist | str | "" |
office_holder | str | "" |
agency | str | "" |
subject_matter | str | "" |
kind | "consultant" | "in_house" | null | null |
date_from | str | null | null |
date_to | str | null | null |
arranged_only | bool | null | null |
top | int | 20 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_lobbyists_summarize_activity", "arguments": {"group_by": "…"}}Provincial · Alberta
Open Alberta files
ab_opendata_
Open Alberta file reader (tools prefixed ab_opendata_): the Excel and CSV files published on open.alberta.ca, whose DataStore has no active resources, so the files are the only route to the numbers.
Full description
Open Alberta file reader (tools prefixed ab_opendata_): the Excel and CSV files published on open.alberta.ca, whose DataStore has no active resources, so the files are the only route to the numbers. Search the portal's open datasets that have .xlsx, .xls or .csv files (filters: organization, text, format) with title, ministry, licence, resources with format and size, and last-modified date; list the organizations; describe a file's sheets and columns; read a file with column selection, exact filters, a text filter, a guessed (or given) header row and paging. Covers Alberta Health indicator tables, Treasury Board and Finance (economic review, indicators at a glance, population projections), Education results, Assisted Living and Social Services caseloads (AISH, Income Support), Municipal Affairs financial returns, energy royalties, traffic volumes and collisions, vital statistics, post-secondary data. Nearly every dataset is under the Open Government Licence - Alberta (commercial use allowed with attribution); a dataset under any other licence is flagged. Discovery uses the portal's CKAN API and file reads wait 10 seconds between requests. Use ckan_ with portal=ab for the rest of the catalogue (resources that are links, maps, PDFs).
ab_opendata_describe_resource List the sheets and columns of an Open Alberta Excel or CSV file.
Use for looking inside a file before reading it: every sheet name with its declared row and column counts, the guessed header row, the column names and the first rows after the header. Many Alberta workbooks open with a notes or cover sheet, put title rows above the table or run years across columns, so check this before ab_opendata_read_resource. url is a resource URL from ab_opendata_search_datasets (a /dataset/<id>/resource/<id>/download/ link on open.alberta.ca); .xlsx, .xls and .csv are read, and the real format is detected from the file because the portal's labels are sometimes wrong. The result carries the licence and the attribution statement to cite. Pace: one request per 10 seconds.
- Keywords
- Open Alberta, sheets, columns, header row, Excel, xlsx, xls, CSV, file structure, preview, workbook, Alberta government data
- Mots-clés
- Open Alberta, feuilles, colonnes, ligne d'en-tête, Excel, xlsx, xls, CSV, structure d'un fichier, aperçu, classeur, données du gouvernement de l'Alberta
| Parameter | Type | Default |
|---|---|---|
url | str | required |
sheet | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_opendata_describe_resource", "arguments": {"url": "…"}}ab_opendata_get_dataset Get one Open Alberta dataset with every resource, its licence and update cycle.
Use for seeing all the files of a dataset found by ab_opendata_search_datasets (yearly workbooks, CSV and XLSX copies of one table, former versions), each with format, size, last-modified date, whether this module can read it, and the licence. dataset is the slug, the dataset id, or the open.alberta.ca/dataset page URL. Files that are links to other sites (regional dashboard exports, maps, PDFs) are listed with readable false.
- Keywords
- Open Alberta, dataset, resources, files, licence, update frequency, metadata, Excel, CSV, Alberta government, Open Government Licence
- Mots-clés
- Open Alberta, jeu de données, ressources, fichiers, licence, fréquence de mise à jour, métadonnées, Excel, CSV, gouvernement de l'Alberta, Licence du gouvernement ouvert
| Parameter | Type | Default |
|---|---|---|
dataset | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_opendata_get_dataset", "arguments": {"dataset": "…"}}ab_opendata_list_organizations List the Alberta ministries and agencies that publish Excel or CSV datasets.
Use for getting the organization slug (health, treasuryboardandfinance, education, municipalaffairs, energy-and-minerals, assisted-living-and-social- services, transportation-and-economic-corridors, servicealberta, advancededucation and others) to pass as organization to ab_opendata_search_datasets, with the number of datasets each has with files. Ministries are renamed after reorganizations, so older datasets can sit under a former name.
- Keywords
- Open Alberta, organizations, ministries, departments, agencies, Alberta Health, Treasury Board and Finance, Education, Municipal Affairs, publishers, dataset counts
- Mots-clés
- Open Alberta, organisations, ministères, organismes, Alberta Health, Conseil du Trésor et Finances, Éducation, Affaires municipales, éditeurs, nombre de jeux de données, gouvernement de l'Alberta
| Parameter | Type | Default |
|---|---|---|
format | "xlsx" | "xls" | "csv" | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_opendata_list_organizations", "arguments": {}}ab_opendata_read_resource Read rows of an Open Alberta Excel (.xlsx, .xls) or CSV file.
Use for getting the numbers: AISH and Income Support monthly caseloads, Alberta Health indicators by zone, population projections, post-secondary enrolment, municipal financial returns and tax rates, oil sands royalty and project data, highway traffic volumes, live births and deaths, wildfire records. url is a resource URL from ab_opendata_search_datasets. With several sheets and no sheet, the largest is read only when it holds most of the workbook (a notes sheet beside the table); otherwise no rows come back, only the sheet list, so pick one (same rule as ckan_read_resource). A CSV has no sheets: leave sheet unset. header_row is guessed (the first row with three filled cells) and can be set as a 1-based row number; header_rows (1 to 5) joins that many rows into the column names when a header spans several rows (years above labels, as in highway traffic volumes); layouts are kept as published, every value is text, and columns are named from the header (blank ones column_N). columns picks columns, filters keeps rows whose column equals the value exactly (case-insensitive, e.g. {"Zone": "Calgary"}), contains keeps rows with that text in any cell, and offset and limit page the result (total_rows counts every match). The result carries the licence and, for Open Government Licence - Alberta datasets, the attribution statement to cite. Pace: one request per 10 seconds.
- Keywords
- Open Alberta, read file, Excel, xlsx, xls, CSV, rows, filter, caseload, population projections, traffic volume, royalties, wildfire, Alberta Health
- Mots-clés
- Open Alberta, lire un fichier, Excel, xlsx, xls, CSV, lignes, filtre, dossiers, projections de population, volume de circulation, redevances, feux de forêt, Alberta Health
| Parameter | Type | Default |
|---|---|---|
url | str | required |
sheet | str | null | null |
columns | list[str] | null | null |
filters | dict[str, str] | null | null |
contains | str | null | null |
header_row | int | null | null |
header_rows | int | 1 |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_opendata_read_resource", "arguments": {"url": "…"}}ab_opendata_search_datasets Search Open Alberta (open.alberta.ca) datasets that have Excel or CSV files.
Use for finding the file behind an Alberta government number: AISH and Income Support caseloads, Alberta Health indicator tables, Treasury Board and Finance (economic review indicators at a glance, population projections), Education and post-secondary results, Municipal Affairs financial returns, energy royalties, traffic volumes and collisions, vital statistics (births, deaths). Each dataset shows title, ministry (organization), licence, last-modified date, update frequency and its resources with format, size and file URL (for ab_opendata_describe_resource and ab_opendata_read_resource). query is free text; organization is a slug (see ab_opendata_list_organizations); format keeps xlsx, xls or csv; ogl_alberta_only drops the rare dataset under another licence (those are flagged, with a plain note that other terms apply). The portal's DataStore has no active resources, so files are the only route to rows. sort modified or title, or an offset, drops the organization counts (portal limitation). Pace: one request per 10 seconds.
- Keywords
- Open Alberta, Alberta government, open.alberta.ca, dataset search, Excel, CSV, AISH, Income Support, Alberta Health, Treasury Board and Finance, Open Government Licence Alberta, ministry
- Mots-clés
- Open Alberta, gouvernement de l'Alberta, données ouvertes Alberta, recherche de jeux de données, Excel, CSV, AISH, soutien du revenu, Alberta Health, Conseil du Trésor et Finances, Licence du gouvernement ouvert – Alberta, ministère
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
organization | str | null | null |
format | "xlsx" | "xls" | "csv" | null | null |
ogl_alberta_only | bool | false |
sort | "relevance" | "modified" | "title" | "relevance" |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ab_opendata_search_datasets", "arguments": {}}Provincial · British Columbia
DriveBC: road events on BC highways
drivebc_
DriveBC road events on British Columbia's provincial highways (Open511 API, Open Government Licence - British Columbia): active construction and maintenance, incidents and road conditions with severity, road, direction, lane state, schedule and location, filtered by type…
Full description
DriveBC road events on British Columbia's provincial highways (Open511 API, Open Government Licence - British Columbia): active construction and maintenance, incidents and road conditions with severity, road, direction, lane state, schedule and location, filtered by type, severity, district, highway, bounding box or text; one event in full with its geometry; counts by type, severity, district or road; and the 11 Ministry districts. English only.
drivebc_get_event One active DriveBC road event in full, with its GeoJSON geometry (the point or the closed stretch of highway as a line) and the linear reference in km.
Use for the exact extent of a closure, map a road event, full text and schedule of one incident.
- Keywords
- DriveBC, road event, closure extent, geometry, GeoJSON, incident detail, British Columbia highway, Open511, schedule
- Mots-clés
- DriveBC, événement routier, étendue de la fermeture, géométrie, GeoJSON, détail d'incident, route de la Colombie-Britannique, Open511, horaire
| Parameter | Type | Default |
|---|---|---|
event_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "drivebc_get_event", "arguments": {"event_id": "…"}}drivebc_list_areas The 11 BC Ministry of Transportation and Transit districts DriveBC uses as Open511 areas (id, name, GeoNames link), with the number of active road events in each now.
Use for the district names and ids for a DriveBC filter, which district a region belongs to, a quick count of events per district.
- Keywords
- DriveBC, districts, areas, Lower Mainland, Vancouver Island, Okanagan, British Columbia, Open511, highway districts
- Mots-clés
- DriveBC, districts, zones, Lower Mainland, île de Vancouver, Okanagan, Colombie-Britannique, Open511, districts routiers, ministère des Transports de la Colombie-Britannique
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "drivebc_list_areas", "arguments": {}}drivebc_search_events Active road events on British Columbia's provincial highways from DriveBC (Open511): construction and maintenance, incidents (crashes, hazards, fires) and road conditions, each with severity, road, direction, lane state (for example CLOSED), schedule, district and location.
Use for is a BC highway closed, current road work on the Coquihalla or Highway 1, incidents near a place, travel conditions in a district.
- Keywords
- DriveBC, road closures, highway conditions, construction, incidents, British Columbia, Open511, traffic events, road work, Coquihalla, travel advisory
- Mots-clés
- DriveBC, fermetures de routes, route fermée, état des routes, conditions routières, travaux routiers, chantiers, incidents, accident de la route, Colombie-Britannique, Open511, circulation, entraves, autoroute, Coquihalla, avis aux voyageurs
| Parameter | Type | Default |
|---|---|---|
event_type | "CONSTRUCTION" | "INCIDENT" | "ROAD_CONDITION" | "WEATHER_CONDITION" | "SPECIAL_EVENT" | null | null |
severity | "MINOR" | "MODERATE" | "MAJOR" | "UNKNOWN" | null | null |
subtype | str | null | null |
area | str | null | null |
road | str | null | null |
bbox | list[float] | null | null |
query | str | null | null |
limit | int | 25 |
lang | "en" | "fr" | "en" |
call_tool {"name": "drivebc_search_events", "arguments": {}}drivebc_summarize_events Counts of active DriveBC road events grouped by district (area), event type, severity, road or subtype, with the number of MAJOR events in each group, after optional filters.
Use for which BC districts have the most road work, how many major incidents are open now, which highways have the most events.
- Keywords
- DriveBC, road events count, closures by district, highway incidents summary, British Columbia, Open511, construction count, major events
- Mots-clés
- DriveBC, nombre d'événements routiers, fermetures par district, sommaire des incidents, Colombie-Britannique, Open511, nombre de chantiers, événements majeurs
| Parameter | Type | Default |
|---|---|---|
group_by | "event_type" | "severity" | "area" | "road" | "subtype" | "area" |
event_type | "CONSTRUCTION" | "INCIDENT" | "ROAD_CONDITION" | "WEATHER_CONDITION" | "SPECIAL_EVENT" | null | null |
severity | "MINOR" | "MODERATE" | "MAJOR" | "UNKNOWN" | null | null |
area | str | null | null |
road | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "drivebc_summarize_events", "arguments": {}}Provincial · Ontario
Ontario Energy Board
oeb_
Ontario Energy Board open data (oeb.ca): RRR filings by electricity and natural gas distributor (system reliability SAIDI/SAIFI, customers, demand and revenue, capital, labour, billing accuracy, LEAP and OESP low-income programs, trial balance, net metering)…
Full description
Ontario Energy Board open data (oeb.ca): RRR filings by electricity and natural gas distributor (system reliability SAIDI/SAIFI, customers, demand and revenue, capital, labour, billing accuracy, LEAP and OESP low-income programs, trial balance, net metering), distributor scorecards and complaints, current electricity and gas rates by utility, historical RPP prices, distribution rates databases, licences and open applications, 2021 yearbook. Open Government Licence - Ontario.
oeb_describe_dataset Describe one OEB open data dataset: its files (numbered, with release: 'current' or the date of an archived release) and, for one file, the fields with example values, the record count, the years and the distributors.
Use for seeing which measures an RRR file has before querying it.
- Keywords
- OEB, Ontario Energy Board, dataset fields, columns, RRR file, data dictionary, archived release, distributors list, years covered
- Mots-clés
- CEO, Commission de l'énergie de l'Ontario, champs, colonnes, variables, fichier RRR, dictionnaire de données, publication archivée, liste des distributeurs, années couvertes, description du jeu de données
| Parameter | Type | Default |
|---|---|---|
dataset | str | required |
file | str | null | null |
release | str | null | null |
sheet | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "oeb_describe_dataset", "arguments": {"dataset": "…"}}oeb_list_datasets List the Ontario Energy Board's open data datasets, with description, file types, update frequency, last-updated date and number of current and archived files; `query` keeps those whose title or description has every word.
Use for finding which OEB file holds Ontario utility reliability, customers, revenue, capital, labour, billing or low-income data.
- Keywords
- Ontario Energy Board, OEB, open data, RRR, reporting and record-keeping requirements, electricity distributors, local distribution company, LDC, natural gas utilities, yearbook, utility datasets
- Mots-clés
- Commission de l'énergie de l'Ontario, CEO, données ouvertes, exigences de rapport et de tenue de dossiers, distributeurs d'électricité, sociétés de distribution locale, services publics d'électricité, services publics de gaz naturel, annuaire des distributeurs, jeux de données des services publics, Ontario
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "oeb_list_datasets", "arguments": {}}oeb_query_dataset Read rows of an OEB open data file, filtered by distributor name, year and other columns, with the measures you name: e.g. SAIDI and SAIFI of Hydro Ottawa in 2024, customers by rate class, revenue, FTEs, LEAP grants.
Use for Ontario electricity and gas utility statistics by company and year.
- Keywords
- Ontario utility reliability, SAIDI, SAIFI, power outages, distributor customers, demand and revenue, capital expenditures, labour FTE, billing accuracy, LEAP, OESP, net metering, scorecard, OEB
- Mots-clés
- fiabilité des services publics ontariens, fiabilité du réseau électrique, SAIDI, SAIFI, pannes de courant, interruptions de service, clients des distributeurs, demande et revenus, dépenses en immobilisations, effectifs, exactitude de la facturation, facturation nette, fiche de rendement, CEO
| Parameter | Type | Default |
|---|---|---|
dataset | str | required |
distributor | str | null | null |
year | int | null | null |
fields | list[str] | null | null |
where | dict[str, str] | null | null |
file | str | null | null |
release | str | null | null |
sheet | str | null | null |
max_rows | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "oeb_query_dataset", "arguments": {"dataset": "…"}}oeb_rates Ontario electricity and natural gas rates from the OEB: current rates by utility (residential or general service under 50 kW electricity, residential natural gas), with each field's description and unit from the OEB's data keys, or the historical Regulated Price Plan prices (time-of-use, tiered, ultra-low overnight) by effective date.
Use for monthly fixed charge, distribution and transmission rates of an Ontario utility, or how time-of-use prices changed.
- Keywords
- Ontario electricity rates, hydro rates, time-of-use prices, TOU, tiered prices, ultra-low overnight, Regulated Price Plan, RPP, natural gas rates, delivery charge, distribution charge, OEB
- Mots-clés
- tarifs d'électricité de l'Ontario, prix de l'électricité, facture d'électricité, prix selon l'heure, prix par paliers, très bas prix de nuit, grille tarifaire réglementée, tarifs du gaz naturel, frais de livraison, frais de distribution, CEO
| Parameter | Type | Default |
|---|---|---|
table | "electricity_residential" | "electricity_general_service" | "natural_gas_residential" | "rpp_time_of_use" | "rpp_tiered" | "rpp_ultra_low_overnight" | required |
distributor | str | null | null |
max_rows | int | 200 |
lang | "en" | "fr" | "en" |
call_tool {"name": "oeb_rates", "arguments": {"table": "…"}}Provincial · Quebec · Alberta · British Columbia · Saskatchewan · Manitoba
Provincial general election results: Quebec, Alberta, British Columbia, Saskatchewan, Manitoba
elections_provincial_
Provincial general election results by electoral district for Quebec, Alberta, British Columbia, Saskatchewan and Manitoba, tools prefixed elections_provincial_.
Full description
Provincial general election results by electoral district for Quebec, Alberta, British Columbia, Saskatchewan and Manitoba, tools prefixed elections_provincial_. Quebec: every candidate's votes and share by riding for the 14 general elections from 1973 to 2022 (Elections Quebec open data). Alberta: votes by party in each electoral division, with the winning candidate's name, for the 2008 to 2023 general elections (Elections Alberta official results). British Columbia: every candidate's votes by electoral district for the 2005 to 2024 general elections, summed from the poll-level open data (Elections BC Open Data Licence). Saskatchewan: every candidate's votes by constituency for the 2011 to 2024 general elections, summed from Elections Saskatchewan's poll-by-poll files (the site states no terms or licence). Manitoba: every candidate's votes by electoral division, with registered voters, rejected ballots and turnout, for the seven general elections from 1999 to 2023, and poll-by-poll votes by voting area in one division (elections_provincial_get_voting_areas), from Elections Manitoba's downloads (the site states no terms or licence). Seats and votes by party are computed from the same rows and reconcile with the legislature (125, 87, 93, 61 and 57 seats in the latest elections). Ontario is not built: Elections Ontario's terms of use forbid scraping its results site. Federal results are in elections_results_.
elections_provincial_get_results Get provincial general election results by electoral district (QC, AB, BC, SK, MB).
Use for who won a provincial riding (winners_only), every candidate's votes and share in a district (Quebec, British Columbia, Saskatchewan, Manitoba), votes by party in an Alberta electoral division (the winner is named), district electors, turnout and rejected ballots where published. province is qc, ab, bc, sk or mb; election is the polling day (2022-10-03) or just its year (2022), and defaults to the latest. district (name or number or code), party (name or abbreviation, e.g. CAQ, UCP, NDP, PC) and candidate are accent-insensitive substring filters. Ontario is not available. By-elections are not included. District, party and candidate names are given as each source publishes them (English except for Quebec); lang="fr" gives errors, notes, attribution and provenance in French.
- Keywords
- provincial election results, riding, electoral district, electoral division, candidate, votes, winner, elected, MLA, MNA, party, CAQ, Parti Quebecois, Liberal, UCP, NDP, BC NDP, Saskatchewan Party, Sask Party, Progressive Conservative, Manitoba NDP, Saskatchewan, Manitoba, Quebec, Alberta, British Columbia
- Mots-clés
- résultats électoraux provinciaux, circonscription, candidat, votes, gagnant, élu, député, parti, CAQ, Parti québécois, libéral, Québec solidaire, Saskatchewan Party, progressiste-conservateur, Saskatchewan, Manitoba, Québec, Alberta, Colombie-Britannique
| Parameter | Type | Default |
|---|---|---|
province | str | required |
election | str | null | null |
district | str | null | null |
party | str | null | null |
candidate | str | null | null |
winners_only | bool | false |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "elections_provincial_get_results", "arguments": {"province": "…"}}elections_provincial_get_seats Get seats and votes by party for one provincial general election (QC, AB, BC, SK, MB).
Use for the seat count and popular vote of each party in a provincial election (for example the CAQ's 90 of 125 Quebec seats in 2022, the UCP's 49 of 87 in Alberta in 2023, the BC NDP's 47 of 93 in 2024, the Saskatchewan Party's 34 of 61 in 2024, the Manitoba NDP's 34 of 57 in 2023), computed from the district results, with candidates per party and share of valid votes. province is qc, ab, bc, sk or mb; election is the polling day or its year, and defaults to the latest. Party names are given as each source publishes them; lang="fr" gives errors, notes, attribution and provenance in French.
- Keywords
- seats by party, popular vote, vote share, election outcome, legislature, majority, minority, provincial election, Quebec, Alberta, British Columbia, Saskatchewan, Manitoba, seat count
- Mots-clés
- sièges par parti, vote populaire, part des votes, résultat électoral, législature, majorité, minorité, élection provinciale, Québec, Alberta, Colombie-Britannique, Saskatchewan, Manitoba, nombre de sièges
| Parameter | Type | Default |
|---|---|---|
province | str | required |
election | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "elections_provincial_get_seats", "arguments": {"province": "…"}}elections_provincial_get_voting_areas Get poll-by-poll results by voting area in one Manitoba electoral division.
Use for every candidate's votes in each voting area (poll) of a Manitoba electoral division, with the polling place, registered voters, rejected and declined ballots per area, and the advance, absentee, homebound and write-in polls, for the general elections of 1999 to 2023 (Elections Manitoba's statements of votes by voting area). district names one division (an accent-insensitive substring such as "fort rouge"); election is the polling day or its year and defaults to 2023; voting_area (e.g. 12 or Adv-1), party and candidate filter the rows. The response compares the areas' sum with the division's official total, which differs for a few divisions. Names are as Elections Manitoba publishes them (English); lang="fr" gives errors, notes, attribution and provenance in French.
- Keywords
- poll by poll results, voting area, polling division, poll, polling station, advance poll, Manitoba election, Elections Manitoba, electoral division, neighbourhood vote, precinct results, MLA
- Mots-clés
- résultats par bureau de vote, section de vote, bureau de scrutin, vote par anticipation, élection manitobaine, Élections Manitoba, circonscription, division électorale, résultats détaillés, député
| Parameter | Type | Default |
|---|---|---|
district | str | required |
province | str | "mb" |
election | str | null | null |
voting_area | str | null | null |
party | str | null | null |
candidate | str | null | null |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "elections_provincial_get_voting_areas", "arguments": {"district": "…"}}elections_provincial_list_elections List the provincial general elections with results here (QC, AB, BC, SK, Manitoba).
Use for seeing which provincial general elections can be read (Quebec 1973 to 2022, Alberta 2008 to 2023, British Columbia 2005 to 2024, Saskatchewan 2011 to 2024, Manitoba 1999 to 2023), with polling day, seats, what each row holds, and which provinces are not available and why (Ontario: Elections Ontario's terms forbid scraping). No upstream call is made.
- Keywords
- provincial election, general election, results, Quebec, Alberta, British Columbia, Saskatchewan, Manitoba, Ontario, Elections Quebec, Elections Alberta, Elections BC, Elections Saskatchewan, Elections Manitoba, legislature, riding, electoral district, electoral division, MLA, MNA
- Mots-clés
- élection provinciale, élections générales, résultats, Québec, Alberta, Colombie-Britannique, Saskatchewan, Manitoba, Ontario, Élections Québec, circonscription, division électorale, député, Assemblée nationale, scrutin
| Parameter | Type | Default |
|---|---|---|
province | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "elections_provincial_list_elections", "arguments": {}}Provincial · Alberta
Alberta Energy Regulator
aer_
Alberta Energy Regulator (AER) statistical reports (www.aer.ca): ST1 daily well-licence lists (raw report text) and monthly/yearly archive links, and ST3 monthly production-volume/price XLSX download links (butane, ethane, gas, NGL, oil, propane, sulphur, oil prices).
Full description
Alberta Energy Regulator (AER) statistical reports (www.aer.ca): ST1 daily well-licence lists (raw report text) and monthly/yearly archive links, and ST3 monthly production-volume/price XLSX download links (butane, ethane, gas, NGL, oil, propane, sulphur, oil prices). Distinct from open.alberta.ca's CKAN catalogue already covered by ckan_* (portal="ab").
aer_get_production_volumes_link Resolve AER's ST3 current-month production-volume/price XLSX download link for one product, confirming it exists.
Use for getting the latest monthly Alberta oil, gas, NGL or sulphur production spreadsheet, or AER's oil price workbook.
- Keywords
- Alberta, AER, ST3, production volumes, oil, gas, NGL, butane, ethane, propane, sulphur, oil prices, monthly statistics, energy resource industry
- Mots-clés
- Alberta, AER, Alberta Energy Regulator, organisme de réglementation de l'énergie de l'Alberta, ST3, volumes de production, production pétrolière, gaz naturel, LGN, butane, éthane, propane, soufre, prix du pétrole, statistiques mensuelles, industrie énergétique
| Parameter | Type | Default |
|---|---|---|
product | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "aer_get_production_volumes_link", "arguments": {"product": "…"}}aer_get_well_licence_archive_link Resolve AER's ST1 well-licence archive ZIP download link for a given year (or one month of the current year), confirming it exists.
Use for finding the download for historical Alberta well licences by year or month, for bulk analysis outside this server.
- Keywords
- Alberta, AER, well licence archive, ST1, historical well licences, ZIP, oil and gas history, monthly archive, yearly archive
- Mots-clés
- Alberta, AER, Alberta Energy Regulator, organisme de réglementation de l'énergie de l'Alberta, archive des permis de puits, ST1, historique des permis de forage, archive mensuelle, archive annuelle, fichier ZIP, pétrole et gaz
| Parameter | Type | Default |
|---|---|---|
year | int | required |
month | int | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "aer_get_well_licence_archive_link", "arguments": {"year": "…"}}aer_get_well_licences_daily Fetch AER's ST1 "Well Licences Issued - Daily List" report text for the latest date with one weekday (well name, licence number, unique identifier, licensee, substance, field, and more, per licence).
Use for which new oil and gas wells AER licensed on a given day this week, and who the licensee is.
- Keywords
- Alberta, AER, Alberta Energy Regulator, ST1, well licence, well licences issued, oil and gas, drilling, licensee, daily report, mineral rights, field
- Mots-clés
- Alberta, AER, Alberta Energy Regulator, organisme de réglementation de l'énergie de l'Alberta, ST1, permis de puits, nouveaux puits, permis délivrés, pétrole et gaz, forage, titulaire de permis, rapport quotidien, droits miniers, champ pétrolier
| Parameter | Type | Default |
|---|---|---|
day | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "aer_get_well_licences_daily", "arguments": {}}Provincial · British Columbia
BC Geographic Warehouse
bcgw_
BC Geographic Warehouse (BCGW), British Columbia's public geospatial data service (openmaps.gov.bc.ca), via standard OGC WFS 2.0: current wildfire perimeters/status, mining tenure (mineral/placer claims) by owner or area…
Full description
BC Geographic Warehouse (BCGW), British Columbia's public geospatial data service (openmaps.gov.bc.ca), via standard OGC WFS 2.0: current wildfire perimeters/status, mining tenure (mineral/placer claims) by owner or area, and a generic layer-query tool reaching any of BCGW's thousands of layers by type_name (discoverable via ckan_* with portal="bc").
bcgw_get_active_wildfires Query current BC wildfire perimeters and status from the BC Wildfire Service's mapped fire layer, largest fires first.
Use for checking active/recent wildfire status, size in hectares, and mapped perimeter for any fire tracked by the BC Wildfire Service. status is free text matched against real values like "Out of Control", "Being Held", "Under Control", "Out" -- there is no fixed enum. Without a status, fires that are "Out" (most of the layer) are left out; set include_out true to list them too. Leave include_geometry false unless the fire polygon itself is needed.
- Keywords
- British Columbia, BC, wildfire, forest fire, fire perimeter, fire status, fire centre, hectares burned, BC Wildfire Service, active fire, out of control, being held
- Mots-clés
- Colombie-Britannique, feu de forêt, incendie, périmètre d'incendie, statut du feu, hectares brûlés, service des incendies de forêt, feu actif, feux de forêt en cours, hors de contrôle, maîtrisé
| Parameter | Type | Default |
|---|---|---|
status | str | null | null |
fire_year | int | null | null |
min_size_hectares | float | null | null |
include_out | bool | false |
include_geometry | bool | false |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bcgw_get_active_wildfires", "arguments": {}}bcgw_get_mining_tenure Query acquired BC mineral/placer mining tenure (claims) by type, owner, or minimum area.
Use for mining rights research, resource-extraction analysis, and prospecting-zone identification -- claim name, tenure type (mineral/placer), owner, area in hectares, issue/expiry dates. tenure_type is "mineral" or "placer". owner_name matches the start of a word in the registered owner's name, case-insensitively ("teck" finds "TECK RESOURCES LIMITED", not "BIATECKI"). Owners include individual free miners, whose names are part of this public registry.
- Keywords
- British Columbia, BC, mining, mineral tenure, placer claim, mining claim, prospecting, mining rights, owner, hectares, tenure number, resource extraction
- Mots-clés
- Colombie-Britannique, exploitation minière, titre minier, claim de placer, droits miniers, propriétaire, hectares, numéro de titre, prospection, extraction de ressources
| Parameter | Type | Default |
|---|---|---|
tenure_type | str | null | null |
owner_name | str | null | null |
min_area_hectares | float | null | null |
include_geometry | bool | false |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bcgw_get_mining_tenure", "arguments": {}}bcgw_query_layer Query any BC Geographic Warehouse (BCGW) layer directly by its type_name (e.g. "WHSE_LAND_AND_NATURAL_RESOURCE.PROT_RESTRICTED_AREAS_SP"), for any dataset not covered by a curated bcgw_* tool.
Use for pulling features from any BC government map layer (parks, land status, forestry, environment and more) with a CQL filter.
- Keywords
- British Columbia, BC, BCGW, BC Geographic Warehouse, WFS, geospatial, layer, feature, CQL filter, data catalogue, generic query, openmaps
- Mots-clés
- Colombie-Britannique, BC Geographic Warehouse, entrepôt de données géographiques, WFS, données géospatiales, couche cartographique, entité géographique, filtre CQL, catalogue de données, requête générique
| Parameter | Type | Default |
|---|---|---|
type_name | str | required |
cql_filter | str | null | null |
property_names | str | null | null |
include_geometry | bool | false |
sort_by | str | null | null |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bcgw_query_layer", "arguments": {"type_name": "…"}}Provincial · Northwest Territories
NWT Bureau of Statistics
nwt_stats_
NWT Bureau of Statistics (statsnwt.ca), tools prefixed nwt_stats_: about 630 Excel files (.xlsx and legacy .xls) on 49 topic pages (GDP, exports and imports, business conditions, labour force, earnings and wages, income, consumer price index, community price indexes…
Full description
NWT Bureau of Statistics (statsnwt.ca), tools prefixed nwt_stats_: about 630 Excel files (.xlsx and legacy .xls) on 49 topic pages (GDP, exports and imports, business conditions, labour force, earnings and wages, income, consumer price index, community price indexes, population estimates by community, projections, vital statistics, housing, police-reported crime, health, language, alcohol and cannabis, traditional activities, the 1996 to 2021 censuses, NWT Community Survey tables and a statistical profile of each community), listed with the agency's own titles and headings, searched across topics, and read sheet by sheet with a guessed header row, column filters and paging. Sheets keep the agency's layout. The Bureau's entries on opendata.gov.nt.ca only link these pages; they carry the Open Government Licence - Northwest Territories.
nwt_stats_list_files List the Excel tables on one NWT Bureau of Statistics topic page.
Use for browsing what the Northwest Territories Bureau of Statistics publishes on a topic and getting each file's URL for nwt_stats_read_file. Without topic, returns the 49 topic slugs with titles and page links (gdp, business-dynamics, exports-imports, labour-force, earnings-wages, income, cpi, community-price-index, population, population-communities, population-projections, vital-statistics, housing, crime, language, alcohol-cannabis, traditional-activities, census-2021 ... census-1996, community-data with a statistical profile per community, surveys, and more). With topic, lists that page's .xlsx and .xls files with the agency's own title, the heading above the link (release date, survey, quarter or community) and nearby text. File titles are English only (lang changes the topic titles, notes and licence line).
- Keywords
- Northwest Territories, NWT, Bureau of Statistics, statsnwt, Yellowknife, territorial statistics, Excel tables, topics, census, community profile, population, labour force
- Mots-clés
- Territoires du Nord-Ouest, T.N.-O., Bureau de la statistique des Territoires du Nord-Ouest, statistiques territoriales, tableaux Excel, sujets, recensement, profil des collectivités, Yellowknife, estimations de la population, population active, produit intérieur brut, IPC, état civil
| Parameter | Type | Default |
|---|---|---|
topic | str | null | null |
limit | int | 100 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "nwt_stats_list_files", "arguments": {}}nwt_stats_read_file Read one sheet of an NWT Bureau of Statistics Excel file (.xlsx or .xls).
Use for getting the numbers of a table found with nwt_stats_list_files or nwt_stats_search_files. Every sheet is listed with its size; a one-sheet file (or one sheet holding most of the cells) is read directly, otherwise no rows come back until sheet names one. Layouts are kept as published: a title above the table, years across columns, a two-row header (pass header_rows=2), notes at the bottom. header_row (1-based) overrides the guessed header and header_row_candidates suggests others. filters keeps rows whose column equals a value (case-insensitive), contains keeps rows with that text in any cell, columns picks columns; all values are text. Only links on statsnwt.ca are read.
- Keywords
- Northwest Territories, NWT, Excel, sheet, workbook, xlsx, xls, table rows, header row, GDP, population, CPI, census
- Mots-clés
- Territoires du Nord-Ouest, T.N.-O., fichier Excel, feuille de calcul, classeur, lire un tableau, lignes du tableau, ligne d'en-tête, filtrer des colonnes, PIB, population, IPC, recensement
| Parameter | Type | Default |
|---|---|---|
url | str | required |
sheet | str | null | null |
header_row | int | null | null |
header_rows | int | 1 |
filters | dict[str, str] | null | null |
contains | str | null | null |
columns | list[str] | null | null |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "nwt_stats_read_file", "arguments": {"url": "…"}}nwt_stats_search_files Search the NWT Bureau of Statistics Excel tables by words in their titles.
Use for finding a Northwest Territories table without knowing its topic: GDP by industry, exports, business conditions by quarter, labour force by community, average weekly earnings, consumer price index, community price index, population by community, births and deaths, housing core need, crime incidents, Indigenous languages, cannabis and alcohol sales, a 2021 Census table, a community's statistical profile (e.g. "Aklavik", "Hay River profile"). Keeps files whose title, nearby text, heading, topic or file name contains every word of query (case and accents ignored). The first search reads every topic page (about a minute); later ones are cached for six hours. topic narrows to one page.
- Keywords
- Northwest Territories, NWT, search tables, statistics, GDP, CPI, community price index, population by community, census, labour, housing, cannabis, Excel
- Mots-clés
- Territoires du Nord-Ouest, chercher un tableau, statistiques des T.N.-O., PIB par industrie, exportations, IPC, indice des prix des collectivités, population par collectivité, naissances et décès, recensement, emploi, rémunération hebdomadaire moyenne, besoins impérieux en matière de logement, criminalité, langues autochtones, ventes d'alcool et de cannabis, fichiers Excel
| Parameter | Type | Default |
|---|---|---|
query | str | required |
topic | str | null | null |
limit | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "nwt_stats_search_files", "arguments": {"query": "…"}}Provincial · British Columbia
BC Stats Excel tables
bc_stats_
BC Stats Excel tables (tools prefixed bc_stats_): the provincial statistics agency's workbooks that the BC data catalogue (catalogue.data.gov.bc.ca) publishes as .xlsx, mostly with no DataStore rows: monthly Labour Force Survey data tables…
Full description
BC Stats Excel tables (tools prefixed bc_stats_): the provincial statistics agency's workbooks that the BC data catalogue (catalogue.data.gov.bc.ca) publishes as .xlsx, mostly with no DataStore rows: monthly Labour Force Survey data tables, GDP by industry and the BC Economic Accounts, monthly and annual tourism indicators, population estimates and projections, consumer price index tables, bankruptcies, business counts, international commodity exports, housing starts, building permits. Files are listed from the catalogue's BC Stats organization with the agency's own titles, licence and update cycle, and read sheet by sheet with a guessed header row, an optional text filter and paging. Sheets keep the agency's layout (title rows, multi-row headers, years across columns). Use ckan_ with portal=bc for the rest of the catalogue.
bc_stats_list_files List the Excel (.xlsx) tables BC Stats publishes on the BC data catalogue.
Use for finding a British Columbia statistics workbook that has no queryable DataStore rows (monthly Labour Force Survey data tables, GDP by industry, BC Economic Accounts, monthly and annual tourism indicators, population estimates and projections, consumer price index, bankruptcies, business counts, international commodity exports, housing starts, building permits) and its file URL for bc_stats_read_file. Each file carries the agency's own title, its licence, update cycle, size, and the formats the dataset also has. query keeps files whose title or dataset title contains every word; dataset keeps one catalogue dataset by name or title. Use ckan_ tools with portal=bc for CSV resources and the rest of the catalogue.
- Keywords
- BC Stats, British Columbia, Excel, xlsx, Labour Force Survey, GDP by industry, tourism indicators, population projections, CPI, bankruptcies, provincial statistics, data catalogue
- Mots-clés
- BC Stats, Colombie-Britannique, Excel, xlsx, Enquête sur la population active, PIB par industrie, comptes économiques, indicateurs touristiques, estimations de population, projections de population, IPC, faillites, nombre d'entreprises, exportations, mises en chantier, permis de bâtir, permis de construire, statistiques provinciales, catalogue de données, données ouvertes
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
dataset | str | null | null |
limit | int | 100 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_stats_list_files", "arguments": {}}bc_stats_read_file Read one sheet of a BC Stats Excel file listed by bc_stats_list_files.
Use for getting the numbers in a BC Stats workbook: monthly labour force characteristics (employment, unemployment rate, by age, industry, CMA), GDP by industry in current and chained dollars, tourism indicators, BC population estimates and projections to 2046, CPI by category, bankruptcies by CMA. Without sheet, the first sheet that is not a notes page ('READ ME', 'Notes', 'Contents') is returned and provenance.limits names it (every sheet name with its row and column counts is in the result). Layouts are kept as published: title rows can precede the table, headers can span several rows and years can run across columns, so header_row is a guess (the first row with three filled cells) that you can override with a 1-based row number; every value is text. contains keeps rows with that text in any cell (case-insensitive), e.g. a year or an industry; use offset and limit to page. The result carries the file's licence; attribute BC Stats.
- Keywords
- BC Stats, British Columbia, Excel, sheet, xlsx, Labour Force Survey, unemployment rate, GDP by industry, tourism, population projections, CPI, monthly, annual, table
- Mots-clés
- BC Stats, Colombie-Britannique, Excel, feuille de calcul, xlsx, Enquête sur la population active, taux de chômage, emploi, PIB par industrie, dollars enchaînés, tourisme, estimations de population, projections de population, IPC, faillites, mises en chantier, permis de bâtir, mensuel, annuel, tableau
| Parameter | Type | Default |
|---|---|---|
url | str | required |
sheet | str | null | null |
contains | str | null | null |
header_row | int | null | null |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "bc_stats_read_file", "arguments": {"url": "…"}}Provincial · Quebec
Institut de la statistique du Québec
isq_
Institut de la statistique du Québec (statistique.quebec.ca, tools prefixed isq_): search about 7,000 detailed tables and read one.
Full description
Institut de la statistique du Québec (statistique.quebec.ca, tools prefixed isq_): search about 7,000 detailed tables and read one. Most are ISQ's own data found nowhere else: Québec health surveys (youth, care experience), the culture and communications observatory (cinema, performing arts, books, music), arts council statistics, investment and R&D surveys, income and population by MRC and municipality, plus ISQ tabulations of StatCan data for Québec. Labels are mostly French; values keep ISQ's flags (r revised, p provisional, x confidential, F unreliable).
isq_get_table Read one Institut de la statistique du Québec table: metadata and data.
Use for getting the values of a table found with isq_search_tables. table is the page slug, the ISQ table number, or the page URL; lang picks which language's page a slug belongs to (French by default, since every table has a French page). Dynamic tables return rows, one dict per row keyed by column label (header levels joined with ' / ', e.g. '2025' or 'Moins de 1 verre / (%)'), numbers parsed from French format, and flags with ISQ's signs per value (r revised, p provisional, x confidential, F unreliable; see flag_legend), plus the table's notes and sources. When a table states each row's unit, it is the 'Unité' column (e.g. '$/hab' or 'M$'). Static tables return cells as published and an Excel link. Page through long tables with offset and max_rows. ISQ's data engine is French only: with lang 'en' the title follows the English page, but labels, units and notes stay French.
- Keywords
- Quebec table data, ISQ values, time series, regional statistics, survey estimates, confidence interval, MRC data, Quebec statistics
- Mots-clés
- données du tableau, ISQ, valeurs, série chronologique, statistiques régionales, estimations d'enquête, intervalle de confiance, MRC
| Parameter | Type | Default |
|---|---|---|
table | str | required |
offset | int | 0 |
max_rows | int | 200 |
lang | "en" | "fr" | "fr" |
call_tool {"name": "isq_get_table", "arguments": {"table": "…"}}isq_search_tables Search the Institut de la statistique du Québec's detailed tables.
Use for finding Québec statistics ISQ publishes and StatCan does not: regional and MRC or municipal data (population, disposable income), Québec health surveys (youth in secondary school, care experience), culture and communications (cinema attendance, performing arts, books, music, visual arts), arts council grants, investment and R&D surveys, agriculture, and ISQ tabulations of StatCan data for Québec. Matches every word of query (French or English, accents optional) against about 7,000 table page names. lang 'fr' or 'en' keeps one language's pages (many tables are French only); with 'all', a slug that has both a French and an English page is one hit (languages lists both). Pass a result's table to isq_get_table.
- Keywords
- Quebec statistics, ISQ, regional data, MRC, administrative region, health survey, culture statistics, cinema, disposable income, Québec tables
- Mots-clés
- statistiques du Québec, ISQ, Institut de la statistique du Québec, données régionales, MRC, région administrative, enquête de santé, statistiques de la culture, cinéma, revenu disponible, taux de chômage, tableaux statistiques
| Parameter | Type | Default |
|---|---|---|
query | str | required |
lang | "en" | "fr" | "all" | "all" |
limit | int | 25 |
call_tool {"name": "isq_search_tables", "arguments": {"query": "…"}}Provincial · Newfoundland and Labrador
Newfoundland and Labrador Statistics Agency
nl_stats_
Newfoundland and Labrador Statistics Agency (stats.gov.nl.ca), tools prefixed nl_stats_: about 140 Excel files across 15 topics (population and migration, labour force, consumer price index, GDP, trade, industry, income, health, education, employment insurance, minimum wage…
Full description
Newfoundland and Labrador Statistics Agency (stats.gov.nl.ca), tools prefixed nl_stats_: about 140 Excel files across 15 topics (population and migration, labour force, consumer price index, GDP, trade, industry, income, health, education, employment insurance, minimum wage, personal finance, transportation, charitable donations, income support), listed from the agency's topic pages and read sheet by sheet from the .xlsx and .xls files (monthly labour and price series, quarterly population since 1971, census division and St. John's CMA estimates). This is the provincial statistics agency, not the province's open-data portal (nl_opendata_). Sheets keep the agency's own layout: title rows and years across columns are returned as published, with a guessed header row.
nl_stats_list_files List the Excel tables published by the Newfoundland and Labrador Statistics Agency.
Use for finding a Newfoundland and Labrador statistics table (quarterly population since 1971, labour force by month, consumer price index, GDP, international trade, income, health, education, employment insurance, minimum wage, census division and St. John's CMA estimates) and its file URL for nl_stats_read_file. topic is one of the slugs in the result (population, labour, cpi, gdp, trade, industry, income, health, education, ei, minimumwage, personalfinance, transportation, charitabledonations, incomesupport); query keeps files whose title, heading or URL contains every word. Results come a page at a time (limit, default 40, up to 200; offset for the next page); total_files counts every match. The agency's own descriptions are English only.
- Keywords
- Newfoundland and Labrador, NL, Statistics Agency, population, labour force, unemployment, CPI, GDP, trade, St. John's, census division, Excel, provincial statistics, minimum wage
- Mots-clés
- Terre-Neuve-et-Labrador, agence de la statistique, statistiques provinciales, population trimestrielle, migration, population active, taux de chômage, IPC, PIB, commerce international, revenu, assurance-emploi, salaire minimum, St. John's, division de recensement, tableaux Excel
| Parameter | Type | Default |
|---|---|---|
topic | str | null | null |
query | str | null | null |
limit | int | 40 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "nl_stats_list_files", "arguments": {}}nl_stats_read_file Read one sheet of a Newfoundland and Labrador Statistics Agency Excel file.
Use for getting the numbers in a table found with nl_stats_list_files: monthly labour force and CPI series, quarterly population and migration, GDP by industry, trade by partner. Reads both .xlsx and legacy .xls. Without sheet, a workbook whose sheets are named after months (the "Current Month" labour files: Jan2026, Feb2026, ...) returns the newest month's sheet, any other workbook its first sheet; sheet_chosen_by and provenance.limits say which, and every sheet name with its row and column counts is in the result. The agency's layouts are kept as published: a title row can precede the header, and years or months can run across columns, so header_row is a guess (the first row with three filled cells) that you can override with a 1-based row number; header_rows (1 to 5) joins that many rows per column for a header split over rows (e.g. "Employment" above "Total", "Full-Time", "Part-Time", then a units row). Every value is text. contains keeps rows with that text in any cell (case-insensitive), e.g. a year or an industry.
- Keywords
- Newfoundland and Labrador, Excel, sheet, table, monthly, quarterly, population, labour force, CPI, GDP, trade, xlsx, xls, series
- Mots-clés
- Terre-Neuve-et-Labrador, fichier Excel, feuille de calcul, lire un tableau, série mensuelle, série trimestrielle, population, migration, population active, chômage, IPC, PIB par industrie, commerce par partenaire
| Parameter | Type | Default |
|---|---|---|
url | str | required |
sheet | str | null | null |
contains | str | null | null |
header_row | int | null | null |
header_rows | int | 1 |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "nl_stats_read_file", "arguments": {"url": "…"}}Provincial · Yukon
Yukon Bureau of Statistics
yukon_stats_
Yukon Bureau of Statistics tables on open.yukon.ca, tools prefixed yukon_stats_: about 100 CSV tables in ten datasets (population estimates by age and sex, median age, vital statistics, rent and vacancy rates, building permits, motor fuel and residential heating fuel prices…
Full description
Yukon Bureau of Statistics tables on open.yukon.ca, tools prefixed yukon_stats_: about 100 CSV tables in ten datasets (population estimates by age and sex, median age, vital statistics, rent and vacancy rates, building permits, motor fuel and residential heating fuel prices, community spatial price index, Whitehorse real estate, aircraft movements, businesses and workers, employment insurance benefits, crime, school enrolment, and the 2011, 2016 and 2021 Census profiles by community), listed from the portal and read row by row with exact-value filters and column selection. Open Government Licence - Yukon. File reads are paced at one request per 10 seconds.
yukon_stats_list_tables List the CSV tables of the Yukon Bureau of Statistics (about 100, incl. three Census profiles).
Use for finding a Yukon statistics table (population estimates by age and sex, median age, vital statistics, rent and vacancy rates, building permits, fuel prices, community spatial price index, Whitehorse real estate, aircraft movements, businesses and workers, employment insurance benefits, crime, school enrolment, 2011/2016/2021 Census profile tables) and its URL for yukon_stats_query_table. query keeps tables whose title or dataset contains every word; dataset matches a dataset name or title (e.g. economic-statistics, demographic-statistics, census-2021).
- Keywords
- Yukon, Bureau of Statistics, Whitehorse, population, rent, vacancy, building permits, fuel prices, census, community, territory, CSV
- Mots-clés
- Yukon, Bureau de la statistique du Yukon, Whitehorse, estimations de la population, âge médian, loyer médian, taux d'inoccupation, permis de bâtir, permis de construire, prix de l'essence, prix des carburants, indice spatial des prix, immobilier, assurance-emploi, criminalité, effectifs scolaires, profil du recensement, collectivité, territoire, tableaux CSV
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
dataset | str | null | null |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "yukon_stats_list_tables", "arguments": {}}yukon_stats_query_table Read rows of a Yukon Bureau of Statistics CSV table, filtered and with chosen columns.
Use for getting Yukon figures such as monthly population by age and sex, median rent and vacancy by community, building permit values, fuel prices by community, or a Census 2021 profile table. url must be a table URL exactly as yukon_stats_list_tables gives it (other URLs are refused, since the portal would serve a table by its resource id under any file name). filters are exact, case-insensitive matches on column values (for example {"region": "Whitehorse", "year": "2025"}); columns picks and orders the columns. Rows are text. The long 'footnotes' column is dropped and other cells are cut at 300 characters. The first read of a large file can take a while (the portal asks for a 10 second pause between requests); later reads use the cache. Open Government Licence - Yukon.
- Keywords
- Yukon, Bureau of Statistics, rows, filter, population, rent, vacancy, permits, prices, census, Whitehorse, community, monthly
- Mots-clés
- Yukon, Bureau de la statistique du Yukon, lire un tableau, lignes, filtrer, population par âge et sexe, loyer médian, taux d'inoccupation, valeur des permis de bâtir, prix des carburants, profil du recensement 2021, Whitehorse, collectivité, données mensuelles
| Parameter | Type | Default |
|---|---|---|
url | str | required |
filters | dict[str, str] | null | null |
columns | list[str] | null | null |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "yukon_stats_query_table", "arguments": {"url": "…"}}Municipal · Ontario · Quebec · Alberta · British Columbia · Saskatchewan · Manitoba · New Brunswick · Nova Scotia · Prince Edward Island · Newfoundland and Labrador · Yukon · Northwest Territories
Transit schedules (static GTFS)
transit_
Static GTFS schedules of open Canadian transit agencies (STM bus, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, 12 BC Transit systems, and in Quebec exo trains and buses, RTC, STL, STS, STQ ferries and five smaller networks…
Full description
Static GTFS schedules of open Canadian transit agencies (STM bus, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, 12 BC Transit systems, and in Quebec exo trains and buses, RTC, STL, STS, STQ ferries and five smaller networks, plus about 100 more agencies from Statistics Canada's 2025 Canadian Public Transit Network Database): list agencies and feeds, search routes and stops, a stop's scheduled departures on a date, and a route's trips and frequency by hour. Read on demand from the agency's own zip by HTTP range (BC Transit's host cannot serve ranges, so its zips are downloaded whole and held in memory for ten minutes); nothing is written to disk.
transit_get_feed_info One agency's GTFS feed: publisher, version, the dates the schedule covers, the number of routes and stops, and the size of each file in the zip.
Use for how current is a transit schedule, how many routes and stops an agency has, what a GTFS feed contains.
- Keywords
- transit, GTFS, feed info, schedule validity, feed version, routes count, stops count, STM, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, BC Transit, static schedule
- Mots-clés
- le flux GTFS d'une agence, métadonnées du flux, horaire à jour, période couverte par l'horaire, version du flux, combien de lignes d'autobus, combien d'arrêts, contenu du fichier GTFS, STM, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, BC Transit
| Parameter | Type | Default |
|---|---|---|
agency | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "transit_get_feed_info", "arguments": {"agency": "…"}}transit_get_route_summary A route's service on one date: trips run, first and last departure and headsigns per direction, stops served (as stop ids, parent stations and distinct names) and the number of trips and average headway (minutes between buses) by hour of the day.
Use for how frequent is a bus route, hours of service, how many trips a route runs per day, how many stops a line has.
- Keywords
- transit, route summary, frequency, headway, service hours, trips per day, stops served, GTFS, STM, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, BC Transit, bus frequency
- Mots-clés
- transport en commun, résumé de ligne, fréquence, intervalle entre passages, heures de service, voyages par jour, arrêts desservis, GTFS, STM, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, BC Transit
| Parameter | Type | Default |
|---|---|---|
agency | str | required |
route | str | required |
service_date | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "transit_get_route_summary", "arguments": {"agency": "…", "route": "…"}}transit_get_stop_departures Scheduled (timetable, not real-time) departures at one stop on a service date: route, headsign, trip and the time, soonest first. A station id includes its child platforms.
Use for when is the next bus at a stop, the timetable of a stop on a date, how often a stop is served, first and last service.
- Keywords
- transit, schedule, timetable, departures, next bus, stop times, GTFS stop_times, service date, STM, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, BC Transit, scheduled arrival
- Mots-clés
- transport en commun, horaire, passages prévus, prochain autobus, heures de passage, stop_times GTFS, date de service, STM, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, BC Transit, heure d'arrivée prévue
| Parameter | Type | Default |
|---|---|---|
agency | str | required |
stop | str | required |
service_date | str | null | null |
start_time | str | null | null |
route | str | null | null |
limit | int | 20 |
lang | "en" | "fr" | "en" |
call_tool {"name": "transit_get_stop_departures", "arguments": {"agency": "…", "stop": "…"}}transit_list_agencies The transit agencies whose published static GTFS schedule this server reads (STM Montreal buses, OC Transpo Ottawa, Calgary Transit, VIA Rail, GO Transit, UP Express, twelve BC Transit systems such as Victoria, Kelowna and Kamloops, and in Quebec exo's commuter trains and ten bus sectors, RTC Québec City, STL Laval, STS Sherbrooke, STQ ferries, Trois-Rivières, Rimouski, Rouyn-Noranda and Salaberry-de-Valleyfield), with each feed's URL, licence, required attribution line, update cadence and a live check that the zip answers. STL Laval's own terms bar commercial use without its written permission.
Use for which transit schedules are available, licence and credit line for a transit feed, is the agency's GTFS zip reachable.
- Keywords
- transit, GTFS, static schedule, STM, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, BC Transit, exo, RTC, STL, STS, ferries, Quebec, agencies, licence, attribution, bus, timetable data
- Mots-clés
- réseaux de transport en commun disponibles, agences de transport, sociétés de transport, GTFS, horaire statique, STM, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, BC Transit, exo, RTC, STL, STS, traversiers, licence d'utilisation, mention de la source, flux d'horaires d'autobus
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "transit_list_agencies", "arguments": {}}transit_list_national_agencies The transit agencies in Statistics Canada's Canadian Public Transit Network Database (23-26-0003, a compilation of GTFS feeds from over 100 agencies in every province and territory, version 1.0 released 2025-01-31): name, province, the feed's service window, validator error and warning counts, and the licence page and attribution line Statistics Canada recorded for each.
Use for Canadian transit agencies beyond the live feeds (Toronto among them), small-town and regional transit, which agencies a national transit database covers, transit licence and attribution lookup.
- Keywords
- transit, public transit, GTFS, national database, Statistics Canada, 23-26-0003, Canadian Public Transit Network Database, agencies, regional transit, small town bus, Toronto, licence, attribution, 2025 snapshot
- Mots-clés
- transport en commun, GTFS, base de données nationale, Statistique Canada, 23-26-0003, Base de données du réseau de transport en commun canadien, organismes, transport régional, autobus, Toronto, licence, attribution, instantané 2025
| Parameter | Type | Default |
|---|---|---|
query | str | null | null |
province | str | null | null |
status | "available" | "overlaps_live" | "excluded" | null | null |
limit | int | 25 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "transit_list_national_agencies", "arguments": {}}transit_search_routes Routes of an agency whose id, short name (route number), long name or description contain `query` (accent-insensitive); leave `query` empty to list them all.
Use for find a bus route number or name, list the LRT or subway lines, get the route_id for transit_get_route_summary.
- Keywords
- transit, route, bus route, line number, LRT, subway, streetcar, GTFS routes, STM, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, BC Transit
- Mots-clés
- transport en commun, ligne, ligne d'autobus, numéro de ligne, train léger, métro, tramway, lignes GTFS, STM, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, BC Transit
| Parameter | Type | Default |
|---|---|---|
agency | str | required |
query | str | null | null |
route_type | int | null | null |
limit | int | 20 |
lang | "en" | "fr" | "en" |
call_tool {"name": "transit_search_routes", "arguments": {"agency": "…"}}transit_search_stops Stops of an agency by name, public stop code or id (accent- insensitive), and/or within radius_m metres of a latitude/longitude, nearest first; at least one of query or a point is required.
Use for find a transit stop or station, stops near an address, accessible stops, the stop number for a departures lookup.
- Keywords
- transit, stop, bus stop, station, stops near me, nearest stop, coordinates, wheelchair accessible, GTFS stops, STM, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, BC Transit
- Mots-clés
- transport en commun, arrêt, arrêt d'autobus, station, arrêts à proximité, arrêt le plus proche, coordonnées, accessible en fauteuil roulant, arrêts GTFS, STM, OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, BC Transit
| Parameter | Type | Default |
|---|---|---|
agency | str | required |
query | str | null | null |
near_latitude | float | null | null |
near_longitude | float | null | null |
radius_m | float | 500.0 |
limit | int | 20 |
lang | "en" | "fr" | "en" |
call_tool {"name": "transit_search_stops", "arguments": {"agency": "…"}}Municipal · Alberta
Edmonton Police Service
eps_
Edmonton Police Service Community Safety Data Portal: reported occurrences (violent, property, disorder, drugs, weapons, traffic) by date, category, and nearest intersection
Full description
Edmonton Police Service Community Safety Data Portal: reported occurrences (violent, property, disorder, drugs, weapons, traffic) by date, category, and nearest intersection -- a rolling ~12 months plus calendar 2023 -- with filtered listings, grouped counts, and the portal's last refresh date.
eps_get_last_load_date Return the date the Edmonton Police Service last refreshed its Community Safety Data Portal occurrence data (EPS's own load record).
Use for checking how current EPS crime data is before analysing it.
- Keywords
- Edmonton, police, EPS, data freshness, last updated, refresh date, community safety, crime data, load date
- Mots-clés
- Edmonton, Service de police d'Edmonton, police, fraîcheur des données, dernière mise à jour, date de mise à jour, date de chargement, sécurité communautaire, données sur la criminalité
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "eps_get_last_load_date", "arguments": {}}eps_list_occurrences List individual Edmonton Police Service reported occurrences, newest first: reported date, category, group, type, nearest intersection, and WGS84 longitude/latitude.
Use for crime incidents near a street, recent assaults or break-ins in Edmonton, building a crime map.
- Keywords
- Edmonton, police, EPS, crime, occurrences, incidents, assault, theft, break and enter, property crime, community safety, crime map, intersection
- Mots-clés
- Edmonton, Service de police d'Edmonton, police, criminalité, crimes, incidents signalés, infractions, voies de fait, vol, introduction par effraction, crimes contre les biens, sécurité communautaire, carte de la criminalité, intersection
| Parameter | Type | Default |
|---|---|---|
dataset | "current" | "2023" | "current" |
category | str | null | null |
group | str | null | null |
type_group | str | null | null |
start_date | str | null | null |
end_date | str | null | null |
intersection_contains | str | null | null |
limit | int | 50 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "eps_list_occurrences", "arguments": {}}eps_summarize_occurrences Count Edmonton Police Service reported occurrences grouped by "category", "group", "type", "month", or "intersection", with the same filters as eps_list_occurrences. Counts are computed by the server over every matching row, not a sample.
Use for crime trends by month, most common offence types, crime hotspots by intersection, Edmonton crime statistics.
- Keywords
- Edmonton, police, EPS, crime statistics, crime trends, monthly crime, offence types, hotspots, counts, community safety, violent crime, property crime
- Mots-clés
- Edmonton, Service de police d'Edmonton, police, statistiques de criminalité, taux de criminalité, tendances de la criminalité, criminalité mensuelle, types d'infractions, points chauds, nombre d'incidents, sécurité communautaire, crimes violents, crimes contre les biens
| Parameter | Type | Default |
|---|---|---|
dataset | "current" | "2023" | "current" |
group_by | "category" | "group" | "type" | "month" | "intersection" | "category" |
category | str | null | null |
group | str | null | null |
type_group | str | null | null |
start_date | str | null | null |
end_date | str | null | null |
intersection_contains | str | null | null |
top | int | 100 |
lang | "en" | "fr" | "en" |
call_tool {"name": "eps_summarize_occurrences", "arguments": {}}Municipal · Alberta
Edmonton Transit Service
ets_
Edmonton Transit Service real-time GTFS feeds: live bus/LRT vehicle positions, per-stop arrival/departure predictions with delays, and service alerts (detours, stop closures).
Full description
Edmonton Transit Service real-time GTFS feeds: live bus/LRT vehicle positions, per-stop arrival/departure predictions with delays, and service alerts (detours, stop closures). The static schedule is in data.edmonton.ca via socrata_* (portal='edmonton').
ets_get_service_alerts Current Edmonton Transit Service alerts: detours, stop closures, and disruptions, with cause, effect, severity, affected routes and stops, and every active period (a planned detour can cover separate days; active_from/active_until span them). Alert text is English only.
Use for is my route on detour, closed stops, construction impacts on Edmonton transit.
- Keywords
- Edmonton, ETS, service alerts, detours, stop closures, disruptions, construction, transit, bus, LRT, GTFS-RT
- Mots-clés
- Edmonton, ETS, avis de service, alertes de service, détours, déviations, fermetures d'arrêts, perturbations, travaux, transport en commun, autobus, SLR, train léger
| Parameter | Type | Default |
|---|---|---|
route_id | str | null | null |
stop_id | str | null | null |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ets_get_service_alerts", "arguments": {}}ets_get_stop_predictions Real-time predicted arrival/departure times at Edmonton Transit Service stops, with scheduled time and delay in seconds (positive = late), soonest first.
Use for next bus at a stop, how late a route is running, on-time performance snapshots.
- Keywords
- Edmonton, ETS, next bus, arrival times, departures, delays, on-time performance, real-time, GTFS-RT, trip updates, bus stop, transit
- Mots-clés
- Edmonton, ETS, prochain autobus, heures de passage, heures d'arrivée, départs, retards, ponctualité, temps réel, GTFS-RT, arrêt d'autobus, horaires d'autobus, transport en commun
| Parameter | Type | Default |
|---|---|---|
stop_id | str | null | null |
route_id | str | null | null |
include_past | bool | false |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ets_get_stop_predictions", "arguments": {}}ets_get_vehicle_positions Live positions of Edmonton Transit Service buses and LRT trains: latitude/longitude, bearing, speed (km/h), route, trip, and the stop each vehicle is at or approaching.
Use for where is my bus, how many buses are running on a route, live transit maps for Edmonton.
- Keywords
- Edmonton, ETS, transit, bus, LRT, real-time, GTFS-RT, vehicle positions, live location, where is my bus, public transportation
- Mots-clés
- Edmonton, ETS, transport en commun, autobus, train léger, SLR, temps réel, GTFS-RT, position des véhicules, localisation en direct, où est mon autobus, suivi des autobus, transport public
| Parameter | Type | Default |
|---|---|---|
route_id | str | null | null |
limit | int | 50 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ets_get_vehicle_positions", "arguments": {}}Municipal · Alberta
EPCOR water quality, Edmonton
epcor_get_daily_water_quality
EPCOR Edmonton water quality: daily treated-water readings for the E.L.
Full description
EPCOR Edmonton water quality: daily treated-water readings for the E.L. Smith and Rossdale plants (hardness, pH, temperature, chlorine, alkalinity, conductivity, caustic soda, last 7 days). EPCOR's monthly and annual reports are PDF documents and are not covered.
epcor_get_daily_water_quality Daily-average treated drinking-water readings for the last 7 days from one of Edmonton's two EPCOR water treatment plants: total hardness, pH, temperature, total chlorine (chloramine) residual, alkalinity, conductivity, and caustic soda dose.
Use for how hard is Edmonton tap water, chlorine levels, recent water temperature or pH in Edmonton.
- Keywords
- Edmonton, EPCOR, drinking water, water quality, hardness, pH, chlorine, chloramine, conductivity, alkalinity, treatment plant, Rossdale, E.L. Smith
- Mots-clés
- Edmonton, EPCOR, eau potable, eau du robinet, qualité de l'eau, dureté de l'eau, pH, chlore résiduel, chloramine, température de l'eau, conductivité, alcalinité, soude caustique, usine de traitement de l'eau, Rossdale, E.L. Smith
| Parameter | Type | Default |
|---|---|---|
plant | "els" | "rossdale" | "els" |
lang | "en" | "fr" | "en" |
call_tool {"name": "epcor_get_daily_water_quality", "arguments": {}}Open-data catalogues
CKAN catalogues
ckan_
CKAN open-data catalogues: Government of Canada (open.canada.ca), Ontario, British Columbia, Alberta, Québec, Northwest Territories, Yukon, Montréal, Toronto, and Regina.
Full description
CKAN open-data catalogues: Government of Canada (open.canada.ca), Ontario, British Columbia, Alberta, Québec, Northwest Territories, Yukon, Montréal, Toronto, and Regina. Dataset search and detail, organizations, resources, licenses, tags, groups, row-level DataStore queries, and a reader for the Excel (.xlsx, .xls) and CSV files of file-only resources (about half the tabular datasets on the federal, Ontario and BC portals have no DataStore; not Toronto, whose portal does not permit automated file downloads): sheets, guessed header row, filters and paging, with the licence, source and a warning when the licence is not open. Portals are selected with a portal key.
ckan_datastore_search Query rows from a DataStore-backed CKAN resource (tabular data, not just metadata).
Use for reading actual records from a table on any CKAN portal except Yukon and Alberta (neither has DataStore-active resources). Only resources with datastore_active: true work; for a file-only resource use ckan_read_resource. filters is exact-match per column, e.g. {"Year": "2024"}; query is full-text (rejected on federal resources over 100,000 rows — use filters). sort e.g. "Year desc"; fields a comma-separated column list; limit ≤ 1000. Rows are returned as published; lang sets the language of messages.
- Keywords
- CKAN, datastore, rows, records, table, query, filter, data
- Mots-clés
- CKAN, DataStore, magasin de données, lignes, enregistrements, tableau de données, interroger un tableau, requête, filtrer les lignes, recherche plein texte, données tabulaires
| Parameter | Type | Default |
|---|---|---|
portal | "federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina" | required |
resource_id | str | required |
filters | dict[str, str] | null | null |
query | str | null | null |
sort | str | null | null |
fields | str | null | null |
limit | int | 20 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ckan_datastore_search", "arguments": {"portal": "…", "resource_id": "…"}}ckan_describe_resource List the sheets and columns of the Excel or CSV file behind a CKAN resource.
Use for looking inside a file-only dataset before reading it, on federal (open.canada.ca), Ontario, BC, Québec, Montréal, NWT, Yukon, Regina and Alberta portals (not Toronto: the portal does not permit automated file downloads). Most of their tabular datasets have no DataStore (datastore_active false), so the file is the only route to the numbers: ECCC wastewater indicators, CRA tax statistics and benefits by FSA, DFO salmon escapement, ESDC temporary foreign workers, ISED insolvency, Finance budget tables, Ontario tourism, education and agriculture workbooks, BC treasury and local-government finance, NWT traffic counts. resource_id comes from ckan_get_dataset; no URL is accepted, the file link is taken from the portal's own record and only the portal's known data hosts are downloaded. Returns every sheet with declared rows and columns, the guessed header row, other rows that look like headers (header_row_candidates), the column names and a short preview, plus the licence (a plain warning when it is not an open licence), organization, landing page, last-modified date and source URL. Reads .xlsx, legacy .xls and CSV/TSV (UTF-8 or Windows-1252, delimiter detected); the real format is sniffed from the bytes because labels are often wrong. Files over 40 MB are refused. Cached 2 hours; API calls are paced per portal.
- Keywords
- CKAN, resource file, Excel, xlsx, xls, CSV, sheets, columns, header row, file-only dataset, open.canada.ca, Ontario, BC, licence
- Mots-clés
- CKAN, ressource, fichier Excel, classeur, xlsx, xls, CSV, feuilles, onglets, colonnes, ligne d'en-tête, aperçu du fichier, jeu de données sans DataStore, ouvert.canada.ca, Ontario, Colombie-Britannique, licence
| Parameter | Type | Default |
|---|---|---|
portal | "federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina" | required |
resource_id | str | required |
sheet | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "ckan_describe_resource", "arguments": {"portal": "…", "resource_id": "…"}}ckan_get_dataset Get one CKAN dataset's full metadata and every downloadable resource.
Use for resource URLs/formats, license, keywords/tags, publisher, update dates, and portal-specific metadata (in extras) for a dataset found with ckan_search_datasets. dataset_id is the id or name (slug). Check each resource's datastore_active before querying rows with ckan_datastore_search.
- Keywords
- CKAN, dataset detail, package_show, resources, download, metadata, license, open data
- Mots-clés
- CKAN, détail du jeu de données, fiche du jeu de données, ressources, liens de téléchargement, télécharger les données, métadonnées, licence, éditeur, date de mise à jour, données ouvertes
| Parameter | Type | Default |
|---|---|---|
portal | "federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina" | required |
dataset_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ckan_get_dataset", "arguments": {"portal": "…", "dataset_id": "…"}}ckan_get_organization_or_group Get one CKAN publishing organization or thematic group: description and dataset count.
Use for confirming a department's or agency's identity (kind="organization", e.g. "statcan", "nrcan-rncan" on the federal portal) before filtering ckan_search_datasets with fq="organization:<name>", or checking what a group from ckan_list_groups covers (kind="group") before filtering with fq="groups:<name>". collection_id is the id or short name. Groups are not available on federal, Alberta, or Toronto.
- Keywords
- CKAN, organization detail, department, agency, publisher, ministry, group detail, theme, topic, category, open data, catalogue, subject area, dataset count
- Mots-clés
- CKAN, détail de l'organisation, ministère, organisme, éditeur, ministères et organismes, détail du groupe, thème, sujet, catégorie, données ouvertes, catalogue, domaine, nombre de jeux de données
| Parameter | Type | Default |
|---|---|---|
portal | "federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina" | required |
kind | "organization" | "group" | required |
collection_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ckan_get_organization_or_group", "arguments": {"portal": "…", "kind": "…", "collection_id": "…"}}ckan_get_resource Get one CKAN resource (a single file or API endpoint within a dataset).
Use for a resource's download URL, format, size, dates, and whether it has a queryable DataStore table (datastore_active).
- Keywords
- CKAN, resource, file, download URL, format, datastore, data file, CSV
- Mots-clés
- CKAN, ressource, fichier de données, lien de téléchargement, URL du fichier, format du fichier, taille du fichier, CSV, DataStore, magasin de données
| Parameter | Type | Default |
|---|---|---|
portal | "federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina" | required |
resource_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ckan_get_resource", "arguments": {"portal": "…", "resource_id": "…"}}ckan_list_groups List one CKAN portal's curated thematic groups (topics such as health, transport).
Use for browsing a catalogue by theme, then filtering searches with fq="groups:<name>". Not available on federal, Alberta, or Toronto, which do not use CKAN groups.
- Keywords
- CKAN, groups, themes, topics, categories, open data, browse, catalogue
- Mots-clés
- CKAN, groupes, groupes thématiques, thèmes, sujets, catégories, santé, transport, parcourir par thème, données ouvertes, catalogue
| Parameter | Type | Default |
|---|---|---|
portal | "federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina" | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ckan_list_groups", "arguments": {"portal": "…"}}ckan_list_licenses List the licenses one CKAN portal publishes datasets under (e.g. Open Government Licence).
Use for explaining what a dataset's license_id permits.
- Keywords
- CKAN, license, licence, open government licence, terms of use, open data, reuse, copyright
- Mots-clés
- CKAN, licence, licence du gouvernement ouvert, licence ouverte, conditions d'utilisation, droit d'auteur, réutilisation des données, Creative Commons, données ouvertes
| Parameter | Type | Default |
|---|---|---|
portal | "federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina" | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ckan_list_licenses", "arguments": {"portal": "…"}}ckan_list_organizations List the publishing organizations (departments, agencies, ministries) of one CKAN portal.
Use for browsing publishers before filtering ckan_search_datasets with fq="organization:<name>". Federal lists ~350 departments and agencies; Toronto and Regina each have one city organization.
- Keywords
- CKAN, organizations, publishers, departments, agencies, ministries, open data, catalogue
- Mots-clés
- CKAN, organisations, éditeurs, ministères, organismes, organismes publics, ministères fédéraux, producteurs de données, liste des éditeurs, données ouvertes, catalogue
| Parameter | Type | Default |
|---|---|---|
portal | "federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina" | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "ckan_list_organizations", "arguments": {"portal": "…"}}ckan_list_portals List every CKAN open-data catalogue (federal, provincial, territorial, city) and its key.
Use for finding the portal key every other ckan_ tool needs, and which portals support tags, groups, and row-level DataStore queries. Portals: federal (open.canada.ca), on (Ontario), bc (British Columbia), ab (Alberta), qc (Québec, Données Québec), nt (Northwest Territories), yt (Yukon), montreal, toronto, regina.
- Keywords
- CKAN, open data portal, catalogue, federal, provincial, territorial, municipal, city, list portals
- Mots-clés
- CKAN, portail de données ouvertes, catalogue de données, liste des portails, Portail du gouvernement ouvert, ouvert.canada.ca, Catalogue de données de l'Ontario, Données Québec, données ouvertes de Montréal, Colombie-Britannique, Territoires du Nord-Ouest, Yukon, fédéral, provincial, territorial, municipal, ville
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "ckan_list_portals", "arguments": {}}ckan_list_tags List or search one CKAN portal's tag vocabulary.
Use for finding the exact tag to filter searches by (fq="tags:<tag>"). Unfiltered lists are capped at 200; pass query for a substring match. The federal portal has no tags (use its keywords via ckan_get_dataset instead).
- Keywords
- CKAN, tags, keywords, vocabulary, subjects, open data, browse, topics
- Mots-clés
- CKAN, mots-clés, étiquettes, vocabulaire, liste des mots-clés, sujets, thèmes, filtrer par mot-clé, données ouvertes, parcourir
| Parameter | Type | Default |
|---|---|---|
portal | "federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina" | required |
query | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "ckan_list_tags", "arguments": {"portal": "…"}}ckan_read_resource Read rows of the Excel or CSV file behind a CKAN resource, from any CKAN portal.
Use for getting the numbers of a file-only dataset (no DataStore) on federal (open.canada.ca), Ontario, BC, Québec, Montréal, NWT, Yukon, Regina or Alberta (not Toronto, whose portal does not permit automated file downloads): ECCC wastewater indicators, tax filer statistics and child benefits by FSA, DFO salmon escapement, ESDC temporary foreign worker data, ISED insolvency statistics, Finance budget tables, Ontario tourism, education and farm finance workbooks, BC treasury-board and municipal finance, NWT files. resource_id comes from ckan_get_dataset (no URL is accepted). When the DataStore is active the rows come from it (like ckan_datastore_search) and a 404 falls back to the file; otherwise the file is downloaded and read: .xlsx, legacy .xls, CSV/TSV (UTF-8 or Windows-1252, delimiter detected), format sniffed from the bytes. In a multi-sheet workbook name the sheet; without it the sheet list and sizes come back with no rows, unless one sheet holds 80% of the cells (a notes sheet beside the table), which is then read (use ckan_describe_resource first). header_row (1-based) overrides the guessed header and header_rows (1 to 5) joins several rows into the column names. columns selects columns, filters keeps rows whose column equals the value (case-insensitive), contains keeps rows with that text in any cell, limit (up to 1000) and offset page the result; values are text as published. Every result carries the licence, organization, landing page, last-modified date, source URL and a citation line, with a plain warning when the licence is not open (BC Access Only, Ontario terms of use, no licence stated). Files over 40 MB are refused.
- Keywords
- CKAN, read file, Excel, xlsx, xls, CSV, rows, filter, file-only dataset, wastewater, tax statistics, FSA, salmon, insolvency, budget, tourism
- Mots-clés
- CKAN, lire un fichier, fichier Excel, classeur, xlsx, xls, CSV, lignes, filtre, jeu de données sans DataStore, eaux usées, statistiques fiscales, allocation canadienne pour enfants, RTA, saumon, insolvabilité, travailleurs étrangers temporaires, budget, tourisme
| Parameter | Type | Default |
|---|---|---|
portal | "federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina" | required |
resource_id | str | required |
sheet | str | null | null |
header_row | int | null | null |
header_rows | int | 1 |
filters | dict[str, str] | null | null |
contains | str | null | null |
columns | list[str] | null | null |
limit | int | 100 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "ckan_read_resource", "arguments": {"portal": "…", "resource_id": "…"}}ckan_search_datasets Search one Canadian CKAN open-data catalogue for datasets.
Use for finding a dataset by topic on open.canada.ca (portal "federal", ~48,000 datasets incl. CRA, OSFI, Health Canada, ESDC, Elections Canada), Ontario, BC, Alberta, Québec, NWT, Yukon, Montréal, Toronto, or Regina. Empty query matches everything; narrow with Solr fq, e.g. "organization:statcan" or "res_format:CSV". rows ≤ 100; page with start. sort e.g. "metadata_modified desc". lang picks French titles on bilingual portals (federal, on); Québec and Montréal content is French-only.
- Keywords
- CKAN, open data, dataset search, catalogue, government, federal, provincial, municipal, package_search, discover, browse
- Mots-clés
- CKAN, données ouvertes, recherche de jeux de données, trouver un jeu de données, catalogue de données, gouvernement ouvert, ouvert.canada.ca, Données Québec, Ville de Montréal, fédéral, provincial, municipal, découvrir, parcourir, filtre
| Parameter | Type | Default |
|---|---|---|
portal | "federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina" | required |
query | str | "" |
fq | str | null | null |
rows | int | 10 |
start | int | 0 |
sort | str | null | null |
lang | "en" | "fr" | "en" |
call_tool {"name": "ckan_search_datasets", "arguments": {"portal": "…"}}Open-data catalogues
Socrata portals
socrata_
Socrata open-data portals for Nova Scotia, New Brunswick, Calgary, Edmonton, and Winnipeg: dataset search and detail, categories, tags, and direct SoQL row queries.
Full description
Socrata open-data portals for Nova Scotia, New Brunswick, Calgary, Edmonton, and Winnipeg: dataset search and detail, categories, tags, and direct SoQL row queries. Call socrata_list_portals for every portal key.
socrata_get_dataset Get one Socrata dataset's metadata, columns, and download links.
Use for inspecting a dataset found with socrata_search_datasets (same portal) before querying its rows.
- Keywords
- Socrata, dataset detail, columns, metadata, licence, publisher, download, CSV, views, Nova Scotia, New Brunswick, Calgary, Edmonton, Winnipeg
- Mots-clés
- Socrata, détail du jeu de données, colonnes, métadonnées, licence, éditeur, téléchargement, CSV, vues, Nouvelle-Écosse, Nouveau-Brunswick, Calgary, Edmonton, Winnipeg
| Parameter | Type | Default |
|---|---|---|
portal | "ns" | "nb" | "calgary" | "edmonton" | "winnipeg" | required |
dataset_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "socrata_get_dataset", "arguments": {"portal": "…", "dataset_id": "…"}}socrata_list_categories List one Socrata portal's dataset categories and how many datasets each has.
Use for discovering topic categories before filtering search.
- Keywords
- Socrata, categories, domain_category, catalogue, open data, topics, classification, themes
- Mots-clés
- Socrata, catégories, catalogue, données ouvertes, sujets, classification, thèmes, thématiques, catégories de jeux de données
| Parameter | Type | Default |
|---|---|---|
portal | "ns" | "nb" | "calgary" | "edmonton" | "winnipeg" | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "socrata_list_categories", "arguments": {"portal": "…"}}socrata_list_portals List every Socrata open-data portal and its portal key.
Use for finding the portal key other socrata_ tools need — Nova Scotia (ns), New Brunswick (nb), Calgary, Edmonton, Winnipeg.
- Keywords
- Socrata, SODA, open data portal, Nova Scotia, New Brunswick, Calgary, Edmonton, Winnipeg, list portals
- Mots-clés
- Socrata, SODA, portail de données ouvertes, Nouvelle-Écosse, Nouveau-Brunswick, Ville de Calgary, Ville d'Edmonton, Ville de Winnipeg, données municipales, données provinciales, liste des portails
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "socrata_list_portals", "arguments": {}}socrata_list_tags List one Socrata portal's free-text dataset tags and how many datasets each has.
Use for discovering exact tag values for the search tag filter.
- Keywords
- Socrata, tags, domain_tags, keywords, vocabulary, catalogue, search, discover
- Mots-clés
- Socrata, étiquettes, mots-clés, vocabulaire, catalogue, recherche, terminologie, étiquettes de jeux de données, données ouvertes
| Parameter | Type | Default |
|---|---|---|
portal | "ns" | "nb" | "calgary" | "edmonton" | "winnipeg" | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "socrata_list_tags", "arguments": {"portal": "…"}}socrata_query_dataset_rows Query rows from one Socrata dataset with a SoQL clause.
Use for reading actual data values (not just metadata) from a dataset found with socrata_search_datasets, filtering with a SoQL $where clause, sorting, or full-text search within the dataset.
- Keywords
- Socrata, SODA, SoQL, rows, query, filter, data, select, where, order, resource API
- Mots-clés
- Socrata, SODA, SoQL, lignes, requête, filtrer, données, sélection, tri, recherche dans les données
| Parameter | Type | Default |
|---|---|---|
portal | "ns" | "nb" | "calgary" | "edmonton" | "winnipeg" | required |
dataset_id | str | required |
select | str | null | null |
where | str | null | null |
order | str | null | null |
q | str | null | null |
limit | int | 10 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "socrata_query_dataset_rows", "arguments": {"portal": "…", "dataset_id": "…"}}socrata_search_datasets Search a Socrata open-data catalogue (Nova Scotia, New Brunswick, Calgary, Edmonton, Winnipeg).
Use for finding datasets by topic, category, tag, or free-text query.
- Keywords
- Nova Scotia, New Brunswick, Calgary, Edmonton, Winnipeg, open data, Socrata, dataset search, catalogue, government, province, city, category, tags
- Mots-clés
- Nouvelle-Écosse, Nouveau-Brunswick, Calgary, Edmonton, Winnipeg, données ouvertes, Socrata, recherche de jeux de données, catalogue, gouvernement, province, ville, catégorie, étiquettes
| Parameter | Type | Default |
|---|---|---|
portal | "ns" | "nb" | "calgary" | "edmonton" | "winnipeg" | required |
query | str | "" |
category | str | null | null |
tag | str | null | null |
limit | int | 10 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "socrata_search_datasets", "arguments": {"portal": "…"}}Open-data catalogues
ArcGIS Hub portals
arcgis_hub_
Provincial and municipal ArcGIS Hub open-data portals (Manitoba, Saskatchewan, PEI, Ottawa, Halifax, Durham, York, Peel, Metro Vancouver, and 59 more): dataset search and detail, direct FeatureServer/MapServer row queries, and CSV/Shapefile/GeoJSON/KML download links.
Full description
Provincial and municipal ArcGIS Hub open-data portals (Manitoba, Saskatchewan, PEI, Ottawa, Halifax, Durham, York, Peel, Metro Vancouver, and 59 more): dataset search and detail, direct FeatureServer/MapServer row queries, and CSV/Shapefile/GeoJSON/KML download links. Call arcgis_hub_list_portals for every portal key.
arcgis_hub_get_dataset Get one ArcGIS Hub dataset item's metadata, service URL, and download links.
Use for inspecting a dataset found with arcgis_hub_search_datasets (same portal) before querying its rows or downloading it — Ottawa, Halifax, Manitoba, PEI, and every other arcgis_hub portal. Download links depend on the item: export links in the formats the service allows, one stored-file link for a file item, none for an Image Service.
- Keywords
- ArcGIS Hub, dataset detail, FeatureServer, MapServer, metadata, licence, download, CSV, shapefile, GeoJSON, KML
- Mots-clés
- fiche d'un jeu de données, description d'une couche, métadonnées, URL du service FeatureServer, MapServer, licence d'utilisation, liens de téléchargement, exporter en CSV, shapefile, GeoJSON, KML
| Parameter | Type | Default |
|---|---|---|
portal | "mb" | "pe" | "london" | "kitchener" | "windsor" | "saskatoon" | "victoria" | "surrey" | "ottawa" | "halifax" | "mississauga" | "peel" | "durham" | "waterloo_region" | "metro_vancouver" | "york" | "markham" | "newmarket" | "aurora" | "medicine_hat" | "grande_prairie" | "grande_prairie_county" | "st_albert" | "lethbridge" | "airdrie" | "strathcona_county" | "parkland_county" | "sturgeon_county" | "emrb" | "alberta_geological_survey" | "red_deer" | "cochrane" | "okotoks" | "oakville" | "burlington" | "milton" | "brampton" | "kingston" | "kelowna" | "barrie" | "burnaby" | "fredericton" | "greater_sudbury" | "guelph" | "moncton" | "abbotsford" | "whitby" | "oshawa" | "niagara_falls" | "niagara_region" | "st_catharines" | "thunder_bay" | "peterborough" | "coquitlam" | "saanich" | "kamloops" | "prince_george" | "delta" | "yellowknife" | "cambridge" | "maple_ridge" | "pickering" | "sarnia" | "saint_john" | "port_moody" | "white_rock" | "penticton" | "orangeville" | "canmore" | "ntgs" | "ntgs_datahub" | "bc_energy_regulator" | "toronto_police" | "ottawa_police" | "conservation_halton" | "credit_valley" | "npca" | "hamilton_conservation" | "cloca" | "quinte_conservation" | "ontario_geohub" | "parks_canada" | required |
item_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "arcgis_hub_get_dataset", "arguments": {"portal": "…", "item_id": "…"}}arcgis_hub_list_portals List every ArcGIS Hub open-data portal (province, city, region) and its portal key.
Use for finding the portal key the other arcgis_hub_ tools need, and portal-specific caveats. Covers Manitoba (mb), Prince Edward Island (pe), London, Kitchener, Windsor, Saskatoon, Victoria, Surrey, Ottawa, Halifax, Mississauga, Peel, Durham, Waterloo Region, Metro Vancouver, York, Markham, Newmarket, Aurora, Medicine Hat, Grande Prairie, Grande Prairie County, St. Albert, Lethbridge, Airdrie, Strathcona County, Parkland County, Sturgeon County, Edmonton Metropolitan Region Board, Alberta Geological Survey, Red Deer, Cochrane, Okotoks, Oakville, Burlington, Milton, Brampton, Kingston, Kelowna, Barrie, Burnaby, Fredericton, Greater Sudbury, Guelph, Moncton, Abbotsford, Whitby, Oshawa, Niagara Falls, Niagara Region, St. Catharines, Thunder Bay, Peterborough, Coquitlam, Saanich, Kamloops, Prince George, Delta, Yellowknife, Cambridge, Maple Ridge, Pickering, Sarnia, Saint John, Port Moody, White Rock, Penticton, Orangeville, Canmore, BC Energy Regulator, Toronto Police Service, Ottawa Police Service, Conservation Halton, Credit Valley, Niagara Peninsula, Hamilton and Central Lake Ontario conservation authorities, Quinte Conservation, Ontario GeoHub (Land Information Ontario) and Parks Canada.
- Keywords
- ArcGIS Hub, open data portal, municipal, city, region, province, GIS, geospatial, list portals
- Mots-clés
- ArcGIS Hub, portail de données ouvertes, municipal, ville, région, province, SIG, géospatial, liste des portails
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "arcgis_hub_list_portals", "arguments": {}}arcgis_hub_query_feature_layer Query rows from one ArcGIS Hub dataset's FeatureServer/MapServer layer.
Use for reading actual feature attribute values (not just metadata) from a dataset found with arcgis_hub_search_datasets, filtering with an ArcGIS SQL where clause, sorting, or including geometry. Leave layer_index unset to auto-resolve the item's own layer, or the service's first layer or table id (not always 0).
- Keywords
- ArcGIS REST, FeatureServer, MapServer, query, rows, attributes, filter, where clause, municipal, geospatial, GIS
- Mots-clés
- ArcGIS REST, FeatureServer, MapServer, requête, lignes, attributs, filtre, clause where, municipal, géospatial, SIG
| Parameter | Type | Default |
|---|---|---|
portal | "mb" | "pe" | "london" | "kitchener" | "windsor" | "saskatoon" | "victoria" | "surrey" | "ottawa" | "halifax" | "mississauga" | "peel" | "durham" | "waterloo_region" | "metro_vancouver" | "york" | "markham" | "newmarket" | "aurora" | "medicine_hat" | "grande_prairie" | "grande_prairie_county" | "st_albert" | "lethbridge" | "airdrie" | "strathcona_county" | "parkland_county" | "sturgeon_county" | "emrb" | "alberta_geological_survey" | "red_deer" | "cochrane" | "okotoks" | "oakville" | "burlington" | "milton" | "brampton" | "kingston" | "kelowna" | "barrie" | "burnaby" | "fredericton" | "greater_sudbury" | "guelph" | "moncton" | "abbotsford" | "whitby" | "oshawa" | "niagara_falls" | "niagara_region" | "st_catharines" | "thunder_bay" | "peterborough" | "coquitlam" | "saanich" | "kamloops" | "prince_george" | "delta" | "yellowknife" | "cambridge" | "maple_ridge" | "pickering" | "sarnia" | "saint_john" | "port_moody" | "white_rock" | "penticton" | "orangeville" | "canmore" | "ntgs" | "ntgs_datahub" | "bc_energy_regulator" | "toronto_police" | "ottawa_police" | "conservation_halton" | "credit_valley" | "npca" | "hamilton_conservation" | "cloca" | "quinte_conservation" | "ontario_geohub" | "parks_canada" | required |
item_id | str | required |
layer_index | int | null | null |
where | str | null | null |
out_fields | str | "*" |
order_by | str | null | null |
return_geometry | bool | false |
limit | int | 10 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "arcgis_hub_query_feature_layer", "arguments": {"portal": "…", "item_id": "…"}}arcgis_hub_search_datasets Search one Canadian ArcGIS Hub open-data catalogue (city, region, or province).
Use for finding datasets by topic, tag, item type, or free-text query (zoning, trails, parks, police shootings, crime, roads, addresses, boundaries) on a city, region, province, police service, conservation authority or federal agency portal: see arcgis_hub_list_portals for the full list (Ottawa, Toronto Police, Parks Canada, Yellowknife, Manitoba, Halifax, Surrey, Burnaby, Kelowna and more). Offset plus limit stops at 10,000.
- Keywords
- ArcGIS Hub, open data, dataset search, catalogue, municipal, city, region, province, GIS, geospatial, zoning, trails
- Mots-clés
- ArcGIS Hub, données ouvertes, recherche de jeux de données, catalogue, municipal, ville, région, province, SIG, géospatial, zonage, sentiers
| Parameter | Type | Default |
|---|---|---|
portal | "mb" | "pe" | "london" | "kitchener" | "windsor" | "saskatoon" | "victoria" | "surrey" | "ottawa" | "halifax" | "mississauga" | "peel" | "durham" | "waterloo_region" | "metro_vancouver" | "york" | "markham" | "newmarket" | "aurora" | "medicine_hat" | "grande_prairie" | "grande_prairie_county" | "st_albert" | "lethbridge" | "airdrie" | "strathcona_county" | "parkland_county" | "sturgeon_county" | "emrb" | "alberta_geological_survey" | "red_deer" | "cochrane" | "okotoks" | "oakville" | "burlington" | "milton" | "brampton" | "kingston" | "kelowna" | "barrie" | "burnaby" | "fredericton" | "greater_sudbury" | "guelph" | "moncton" | "abbotsford" | "whitby" | "oshawa" | "niagara_falls" | "niagara_region" | "st_catharines" | "thunder_bay" | "peterborough" | "coquitlam" | "saanich" | "kamloops" | "prince_george" | "delta" | "yellowknife" | "cambridge" | "maple_ridge" | "pickering" | "sarnia" | "saint_john" | "port_moody" | "white_rock" | "penticton" | "orangeville" | "canmore" | "ntgs" | "ntgs_datahub" | "bc_energy_regulator" | "toronto_police" | "ottawa_police" | "conservation_halton" | "credit_valley" | "npca" | "hamilton_conservation" | "cloca" | "quinte_conservation" | "ontario_geohub" | "parks_canada" | required |
query | str | "" |
tag | str | null | null |
item_type | str | null | null |
limit | int | 10 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "arcgis_hub_search_datasets", "arguments": {"portal": "…"}}Open-data catalogues · British Columbia
City of Vancouver Open Data
opendatasoft_vancouver_
City of Vancouver Open Data Portal (opendata.vancouver.ca): dataset search and detail, direct record queries with ODSQL filtering/sorting, and CSV/JSON/GeoJSON export download links.
Full description
City of Vancouver Open Data Portal (opendata.vancouver.ca): dataset search and detail, direct record queries with ODSQL filtering/sorting, and CSV/JSON/GeoJSON export download links. The only Opendatasoft-platform source in this codebase.
opendatasoft_vancouver_get_dataset Get one Vancouver dataset's metadata, fields, and download links.
Use for inspecting a dataset found with opendatasoft_vancouver_search_datasets before querying its records or downloading it.
- Keywords
- Vancouver, Opendatasoft, dataset detail, fields, metadata, licence, publisher, download, CSV, JSON, GeoJSON
- Mots-clés
- Ville de Vancouver, fiche du jeu de données, champs, métadonnées, licence, éditeur, liens de téléchargement, CSV, JSON, GeoJSON, Opendatasoft
| Parameter | Type | Default |
|---|---|---|
dataset_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "opendatasoft_vancouver_get_dataset", "arguments": {"dataset_id": "…"}}opendatasoft_vancouver_query_records Query records from one Vancouver dataset with ODSQL filtering/sorting.
Use for reading actual data values (not just metadata) from a dataset found with opendatasoft_vancouver_search_datasets, filtering with a raw ODSQL where clause (e.g. "service_category_1 = 'Housing'"), sorting with order_by, or a full-text query match within the dataset's own fields.
- Keywords
- Vancouver, Opendatasoft, ODSQL, records, query, filter, rows, data, select, where, order, Explore API
- Mots-clés
- Ville de Vancouver, Opendatasoft, ODSQL, enregistrements, requête de données, filtrer les lignes, sélection de colonnes, tri, données municipales, Explore API
| Parameter | Type | Default |
|---|---|---|
dataset_id | str | required |
select | str | null | null |
where | str | null | null |
order_by | str | null | null |
query | str | null | null |
limit | int | 10 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "opendatasoft_vancouver_query_records", "arguments": {"dataset_id": "…"}}opendatasoft_vancouver_search_datasets Search Vancouver's Opendatasoft open-data catalogue.
Use for finding City of Vancouver datasets by topic or free-text query.
- Keywords
- Vancouver, Opendatasoft, open data, dataset search, catalogue, government, municipal, British Columbia, discovery
- Mots-clés
- Ville de Vancouver, données ouvertes de Vancouver, recherche de jeux de données, catalogue de données, données municipales, Colombie-Britannique, Opendatasoft, arbres de rue, permis, découverte
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
limit | int | 10 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "opendatasoft_vancouver_search_datasets", "arguments": {}}Open-data catalogues · Newfoundland and Labrador
Open Data Newfoundland and Labrador
nl_opendata_
Open Data Newfoundland and Labrador (opendata.gov.nl.ca): HTML catalogue search over tabular and spatial datasets, dataset metadata, topic tags, and links to downloadable CSV, XLS, TXT, KMZ, and shapefile files.
Full description
Open Data Newfoundland and Labrador (opendata.gov.nl.ca): HTML catalogue search over tabular and spatial datasets, dataset metadata, topic tags, and links to downloadable CSV, XLS, TXT, KMZ, and shapefile files. The portal is English-only and has no documented JSON catalogue API.
nl_opendata_get_dataset Get full metadata and official file links for one Newfoundland and Labrador dataset.
Use for inspecting a dataset found with nl_opendata_search_datasets, reading its creator, publisher, geography, time coverage, release and modification dates, rights, topics, revisions, formats, file sizes, and binary download URLs.
- Keywords
- Newfoundland, Labrador, open data, dataset details, metadata, creator, publisher, geography, time coverage, rights, licence, topic, revision, format, file, download, CSV, XLS, KMZ
- Mots-clés
- Terre-Neuve-et-Labrador, données ouvertes, fiche du jeu de données, métadonnées, créateur, éditeur, couverture géographique, période couverte, droits, licence, sujet, révision, format, lien de téléchargement, CSV, XLS, KMZ
| Parameter | Type | Default |
|---|---|---|
dataset_id | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "nl_opendata_get_dataset", "arguments": {"dataset_id": "…"}}nl_opendata_list_tags List topic tags exposed by Newfoundland and Labrador's Explore page.
Use for discovering the portal's tag ids before calling nl_opendata_search_datasets with tag_id.
- Keywords
- Newfoundland, Labrador, open data, topic tags, keywords, vocabulary, catalogue, Explore, filter, demographics, health, justice, transportation, environment
- Mots-clés
- Terre-Neuve-et-Labrador, données ouvertes, mots-clés thématiques, sujets, vocabulaire, catalogue, explorer, filtre, démographie, santé, justice, transport, environnement
| Parameter | Type | Default |
|---|---|---|
lang | "en" | "fr" | "en" |
call_tool {"name": "nl_opendata_list_tags", "arguments": {}}nl_opendata_search_datasets Search Newfoundland and Labrador's official open-data catalogue.
Use for finding tabular or spatial datasets by title, publisher, creator, or a known topic-tag id. The upstream catalogue has no JSON search API or server-side pagination, so MapleStats fetches its small HTML listings and applies text filtering and offset/limit pagination locally. query keeps datasets whose title, publisher or creator contains every word (case-insensitive). Use nl_opendata_list_tags first when a topic tag id is needed; an id that is not a portal tag is an error.
- Keywords
- Newfoundland, Labrador, NL, open data, dataset search, catalogue, tabular, spatial, geospatial, government, CSV, XLS, KMZ, shapefile, topic tag
- Mots-clés
- Terre-Neuve-et-Labrador, T.-N.-L., portail de données ouvertes, recherche de jeux de données, catalogue de données, données tabulaires, données géospatiales, gouvernement provincial, CSV, XLS, KMZ, fichier de formes, mot-clé thématique
| Parameter | Type | Default |
|---|---|---|
query | str | "" |
dataset_type | "all" | "tabular" | "spatial" | "all" |
tag_id | str | null | null |
sort | "name" | "released_desc" | "released_asc" | "name" |
limit | int | 10 |
offset | int | 0 |
lang | "en" | "fr" | "en" |
call_tool {"name": "nl_opendata_search_datasets", "arguments": {}}Planning and code
Reproduction code
reproduce_
Reproduction code: for a tool call, returns an R, Python, Stata or Julia snippet or an Excel Power Query that fetches the same data straight from the source, using cansim, canivt, polars, TidierFiles or Stata's import commands, so analysis scripts stay reproducible…
Full description
Reproduction code: for a tool call, returns an R, Python, Stata or Julia snippet or an Excel Power Query that fetches the same data straight from the source, using cansim, canivt, polars, TidierFiles or Stata's import commands, so analysis scripts stay reproducible; reproduce_workbook returns the rows as a formatted Excel workbook.
reproduce_code Get R, Python, Stata, Julia or Excel Power Query code that refetches the same data.
Use for moving any data tool's result into an analysis script reproducibly. Pass the tool name and the arguments you called it with; the server writes the scripts, ready to run. Tools that return documents or text (StatCan articles and Daily releases, Gazette notices) get no script. It rebuilds the exact request: from the arguments (StatCan tables via cansim, Beyond 20/20 via canivt, Valet, Socrata, CKAN), or by recording the upstream request the tool makes (every query parameter, POST body and header). Where the tool filters a downloaded file itself (CER, GC InfoBase, CIHI, IRCC, PHAC Health Infobase, IP Horizons patents) or parses HTML tables (CFIA), the script repeats those steps. Scripts follow a header plus numbered sections (setup, read, check, prepare), save downloads under data/raw/, and clean names, text and numbers; Python uses polars, Julia CSV.jl and TidierData, Stata import delimited (JSON and filtered files go through Stata's built-in Python). language "excel" is a Power Query M query to paste into Excel (Get Data > Blank Query > Advanced Editor): it calls the same URL, filters and cleans the same way, and refreshes inside Excel, with nothing to install. notes say what a script cannot repeat and why a language is missing; language picks one; lang "fr" writes the notes and errors in French.
- Keywords
- reproducible, R code, Python code, Stata do-file, Julia, Excel, Power Query, M query, script, cansim, download data, replication, code generation
- Mots-clés
- reproductible, code R, code Python, Stata, Julia, Excel, Power Query, requête M, script, télécharger les données, réplication, génération de code
| Parameter | Type | Default |
|---|---|---|
tool_name | str | required |
arguments | dict | required |
language | "all" | "r" | "python" | "stata" | "julia" | "excel" | "all" |
lang | "en" | "fr" | "en" |
call_tool {"name": "reproduce_code", "arguments": {"tool_name": "…", "arguments": "…"}}reproduce_workbook Get any data tool's result as a formatted Excel workbook (.xlsx).
Use for handing data to someone who works in Excel. Pass the tool name and its arguments (the tool runs once), or rows you already have. The workbook holds the rows, cleaned as the R scripts clean them, in one Excel table with a frozen header, number formats and fitted column widths; a native, editable line or bar chart when the rows are a time series or a short list; and a Source sheet with the call, the source URL, dates, licence and attribution. lang sets the labels (English or French). A hosted server returns the file as base64 (decode it and save it as file_name), so keep max_rows small (default 2,000, at most 20,000; the file is capped at 2 MB); a local server saves it to your Downloads folder (or MAPLE_EXPORT_DIR) instead. For a refreshable query over the full data, use reproduce_code with language "excel".
- Keywords
- Excel, workbook, spreadsheet, xlsx, export, download table, chart, formatted table, save data, Excel file
- Mots-clés
- Excel, classeur, tableur, chiffrier, xlsx, exporter, télécharger le tableau, graphique, fichier Excel, enregistrer les données
| Parameter | Type | Default |
|---|---|---|
tool_name | str | null | null |
arguments | dict | null | null |
rows | list[dict] | null | null |
title | str | null | null |
max_rows | int | 2000 |
delivery | "auto" | "base64" | "file" | "auto" |
lang | "en" | "fr" | "en" |
call_tool {"name": "reproduce_workbook", "arguments": {}}Planning and code
Query planner
plan_query
Query planner: given a plain-language question, lists the topics it touches, the tools to call across agencies in order, local portals for places named, and caveats on combining the results.
Always visible to the agent, so search_tools does not return it.
plan_query Plan which sources answer a question that may span several agencies.
Use for the first call on a substantive question ("How have rents and interest rates moved in Calgary since 2020?"). Returns the topics it touches, the tools to call for each in order, local portals for any province or city named, and caveats on combining them. Then run the steps with call_tool. Read-only and offline: it matches the question against this server's source map and calls no external API. Use search_tools instead to find a single tool for a narrow, single-source need. lang='fr' gives the labels, purposes, caveats and guidance in French; tool and argument names stay as they are.
- Keywords
- plan, which data source, where to find, combine sources, cross-source, question, research, Canada data
- Mots-clés
- planifier, quelle source de données, où trouver, combiner des sources, question, recherche, données canadiennes, statistiques
| Parameter | Type | Default |
|---|---|---|
question | str | required |
lang | "en" | "fr" | "en" |
call_tool {"name": "plan_query", "arguments": {"question": "…"}}