MapleStatsMCP

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.

84 tools · Resources: docs://statcan/addressing, docs://statcan/fr/adressage, docs://statcan/gotchas, docs://statcan/fr/pieges · Prompts: build_sdmx_or_key, find_and_fetch_series, look_up_classification

2021 Census Profile 3

statcan_census_profile_get_dataGet 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
Parameters of statcan_census_profile_get_data
ParameterTypeDefault
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_codeslist[str]required
characteristic_codeslist[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_characteristicSearch 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
Parameters of statcan_census_profile_search_characteristic
ParameterTypeDefault
querystr""
limitint20
lang"en" | "fr""en"
call_tool {"name": "statcan_census_profile_search_characteristic", "arguments": {}}
statcan_census_profile_search_geographySearch 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
Parameters of statcan_census_profile_search_geography
ParameterTypeDefault
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
querystr""
limitint20
lang"en" | "fr""en"
call_tool {"name": "statcan_census_profile_search_geography", "arguments": {"level": "…"}}

2016 Census Profile 2

statcan_census_profile_2016_get_dataGet 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
Parameters of statcan_census_profile_2016_get_data
ParameterTypeDefault
dguidstrrequired
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_notesboolfalse
lang"en" | "fr""en"
call_tool {"name": "statcan_census_profile_2016_get_data", "arguments": {"dguid": "…"}}
statcan_census_profile_2016_list_geographiesList 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
Parameters of statcan_census_profile_2016_list_geographies
ParameterTypeDefault
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_list_geography_levelsList 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
Parameters of statcan_census_profile_archive_list_geography_levels
ParameterTypeDefault
year2001 | 2006 | 2011 | 2016required
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_downloadsGet 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
Parameters of statcan_census_tables_get_downloads
ParameterTypeDefault
pidstrrequired
release"2016" | "2011" | "2011_nhs" | "2006""2016"
lang"en" | "fr""en"
call_tool {"name": "statcan_census_tables_get_downloads", "arguments": {"pid": "…"}}

Merchandise trade by commodity 8

cimt_get_periodsGet 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
Parameters of cimt_get_periods
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "cimt_get_periods", "arguments": {}}
cimt_get_province_breakdownSplit 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
Parameters of cimt_get_province_breakdown
ParameterTypeDefault
direction"exports" | "imports"required
periodstr""
hs_chapterstr""
partnerstr""
us_statestr""
lang"en" | "fr""en"
call_tool {"name": "cimt_get_province_breakdown", "arguments": {"direction": "…"}}
cimt_get_seriesGet 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
Parameters of cimt_get_series
ParameterTypeDefault
direction"exports" | "imports"required
hs_codestrrequired
periodstr""
partnerstr""
us_statestr""
provincestr""
lang"en" | "fr""en"
call_tool {"name": "cimt_get_series", "arguments": {"direction": "…", "hs_code": "…"}}
cimt_get_top_commoditiesRank 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
Parameters of cimt_get_top_commodities
ParameterTypeDefault
direction"exports" | "imports"required
periodstr""
hs_chapterstr""
provincestr""
partnerstr""
us_statestr""
hs_level"hs6" | "national""hs6"
lang"en" | "fr""en"
call_tool {"name": "cimt_get_top_commodities", "arguments": {"direction": "…"}}
cimt_get_top_partnersRank 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
Parameters of cimt_get_top_partners
ParameterTypeDefault
direction"exports" | "imports"required
periodstr""
hs_chapterstr""
provincestr""
view"country" | "us_state""country"
lang"en" | "fr""en"
call_tool {"name": "cimt_get_top_partners", "arguments": {"direction": "…"}}
cimt_get_tradeGet 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
Parameters of cimt_get_trade
ParameterTypeDefault
direction"exports" | "imports"required
from_periodstrrequired
to_periodstrrequired
hs_codestr""
partnerstr""
us_statestr""
provinceslist[str] | nullnull
hs_level"hs6" | "national""hs6"
annualizeboolfalse
limitint500
lang"en" | "fr""en"
call_tool {"name": "cimt_get_trade", "arguments": {"direction": "…", "from_period": "…", "to_period": "…"}}
cimt_search_commoditiesSearch 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
Parameters of cimt_search_commodities
ParameterTypeDefault
querystr""
direction"exports" | "imports""exports"
level"chapter" | "heading" | "hs6" | "national""hs6"
lang"en" | "fr""en"
limitint20
call_tool {"name": "cimt_search_commodities", "arguments": {}}
cimt_search_partnersSearch 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
Parameters of cimt_search_partners
ParameterTypeDefault
querystr""
kind"country" | "us_state" | "province""country"
lang"en" | "fr""en"
limitint20
call_tool {"name": "cimt_search_partners", "arguments": {}}

The Daily and the release calendar 3

statcan_daily_get_release_calendarFind 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
Parameters of statcan_daily_get_release_calendar
ParameterTypeDefault
querystr""
lang"en" | "fr""en"
kind"key_indicators" | "products" | "all""key_indicators"
upcoming_onlybooltrue
start_datestr | nullnull
end_datestr | nullnull
limitint20
call_tool {"name": "statcan_daily_get_release_calendar", "arguments": {}}
statcan_daily_get_releasesGet 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
Parameters of statcan_daily_get_releases
ParameterTypeDefault
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"
limitint20
call_tool {"name": "statcan_daily_get_releases", "arguments": {}}
statcan_daily_search_archiveSearch 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
Parameters of statcan_daily_search_archive
ParameterTypeDefault
querystr""
lang"en" | "fr""en"
start_datestr | nullnull
end_datestr | nullnull
limitint20
call_tool {"name": "statcan_daily_search_archive", "arguments": {}}

Delta files: daily bulk updates 5

statcan_delta_list_filesList 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
Parameters of statcan_delta_list_files
ParameterTypeDefault
datestr | nullnull
include_sizesboolfalse
lang"en" | "fr""en"
call_tool {"name": "statcan_delta_list_files", "arguments": {}}
statcan_delta_list_real_time_tablesList 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
Parameters of statcan_delta_list_real_time_tables
ParameterTypeDefault
querystr | nullnull
lang"en" | "fr""en"
call_tool {"name": "statcan_delta_list_real_time_tables", "arguments": {}}
statcan_delta_list_tablesList 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
Parameters of statcan_delta_list_tables
ParameterTypeDefault
datestrrequired
product_idint | nullnull
querystr | nullnull
detailboolfalse
max_tablesint200
lang"en" | "fr""en"
call_tool {"name": "statcan_delta_list_tables", "arguments": {"date": "…"}}
statcan_delta_read_tableRead 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
Parameters of statcan_delta_read_table
ParameterTypeDefault
datestrrequired
product_idintrequired
vector_idslist[int] | nullnull
max_rowsint1000
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_detailGet 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
Parameters of statcan_geo_get_layer_detail
ParameterTypeDefault
yearstrrequired
servicestrrequired
layer_idintrequired
lang"en" | "fr""en"
call_tool {"name": "statcan_geo_get_layer_detail", "arguments": {"year": "…", "service": "…", "layer_id": "…"}}
statcan_geo_get_spatial_layer_detailGet 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
Parameters of statcan_geo_get_spatial_layer_detail
ParameterTypeDefault
dataset"infc" | "hna" | "qol" | "nrn"required
layer_idintrequired
lang"en" | "fr""en"
call_tool {"name": "statcan_geo_get_spatial_layer_detail", "arguments": {"dataset": "…", "layer_id": "…"}}
statcan_geo_list_servicesList 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
Parameters of statcan_geo_list_services
ParameterTypeDefault
yearstrrequired
lang"en" | "fr""en"
call_tool {"name": "statcan_geo_list_services", "arguments": {"year": "…"}}
statcan_geo_list_spatial_layersList 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
Parameters of statcan_geo_list_spatial_layers
ParameterTypeDefault
dataset"infc" | "hna" | "qol" | "nrn"required
provincestr | nullnull
road_classstr | nullnull
lang"en" | "fr""en"
call_tool {"name": "statcan_geo_list_spatial_layers", "arguments": {"dataset": "…"}}
statcan_geo_query_layerQuery 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
Parameters of statcan_geo_query_layer
ParameterTypeDefault
yearstrrequired
servicestrrequired
layer_idintrequired
wherestr"1=1"
out_fieldsstr"*"
return_geometryboolfalse
out_srint4326
result_offsetint0
result_record_countint100
latfloat | nullnull
lonfloat | nullnull
bboxstr | nullnull
distance_mfloat | nullnull
lang"en" | "fr""en"
call_tool {"name": "statcan_geo_query_layer", "arguments": {"year": "…", "service": "…", "layer_id": "…"}}
statcan_geo_query_spatial_layerQuery 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
Parameters of statcan_geo_query_spatial_layer
ParameterTypeDefault
dataset"infc" | "hna" | "qol" | "nrn"required
layer_idint | nullnull
provincestr | nullnull
road_classstr | nullnull
wherestr"1=1"
out_fieldsstr"*"
return_geometryboolfalse
out_srint4326
result_offsetint0
result_record_countint100
latfloat | nullnull
lonfloat | nullnull
bboxstr | nullnull
distance_mfloat | nullnull
lang"en" | "fr""en"
call_tool {"name": "statcan_geo_query_spatial_layer", "arguments": {"dataset": "…"}}

Indicators 1

statcan_indicators_get_indicatorsGet 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
Parameters of statcan_indicators_get_indicators
ParameterTypeDefault
dataset"all" | "economic" | "homepage""all"
querystr""
geo_codeint | nullnull
lang"en" | "fr""en"
limitint20
call_tool {"name": "statcan_indicators_get_indicators", "arguments": {}}

Open databases (LODE): facilities, buildings, addresses 6

statcan_lode_describeShow 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
Parameters of statcan_lode_describe
ParameterTypeDefault
databasestrrequired
filestr | nullnull
lang"en" | "fr""en"
call_tool {"name": "statcan_lode_describe", "arguments": {"database": "…"}}
statcan_lode_list_databasesList 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é
Parameters of statcan_lode_list_databases
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "statcan_lode_list_databases", "arguments": {}}
statcan_lode_list_filesList 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
Parameters of statcan_lode_list_files
ParameterTypeDefault
databasestrrequired
sizesbooltrue
lang"en" | "fr""en"
call_tool {"name": "statcan_lode_list_files", "arguments": {"database": "…"}}
statcan_lode_list_zipList 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
Parameters of statcan_lode_list_zip
ParameterTypeDefault
urlstrrequired
lang"en" | "fr""en"
call_tool {"name": "statcan_lode_list_zip", "arguments": {"url": "…"}}
statcan_lode_preview_memberRead 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
Parameters of statcan_lode_preview_member
ParameterTypeDefault
urlstrrequired
memberstrrequired
matchdict[str, str] | nullnull
rowsint10
scan_mbfloat8
lang"en" | "fr""en"
call_tool {"name": "statcan_lode_preview_member", "arguments": {"url": "…", "member": "…"}}
statcan_lode_queryQuery 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
Parameters of statcan_lode_query
ParameterTypeDefault
databasestrrequired
provincestr | nullnull
csdstr | nullnull
typestr | nullnull
namestr | nullnull
bboxlist[float] | nullnull
filtersdict[str, str] | nullnull
filestr | nullnull
memberstr | nullnull
layerstr | nullnull
limitint25
lang"en" | "fr""en"
call_tool {"name": "statcan_lode_query", "arguments": {"database": "…"}}

Public use microdata files (PUMF) 5

statcan_pumf_get_codebookRead 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
Parameters of statcan_pumf_get_codebook
ParameterTypeDefault
urlstrrequired
querystr | nullnull
limitint50
lang"en" | "fr""en"
call_tool {"name": "statcan_pumf_get_codebook", "arguments": {"url": "…"}}
statcan_pumf_list_filesList 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
Parameters of statcan_pumf_list_files
ParameterTypeDefault
catalogue_numberstrrequired
lang"en" | "fr""en"
call_tool {"name": "statcan_pumf_list_files", "arguments": {"catalogue_number": "…"}}
statcan_pumf_list_zipList 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
Parameters of statcan_pumf_list_zip
ParameterTypeDefault
urlstrrequired
lang"en" | "fr""en"
call_tool {"name": "statcan_pumf_list_zip", "arguments": {"url": "…"}}
statcan_pumf_tabulateCompute 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
Parameters of statcan_pumf_tabulate
ParameterTypeDefault
urlstrrequired
rowslist[str]required
statistic"total" | "share" | "mean""total"
value_variablestr | nullnull
filtersdict[str, list[str]] | nullnull
weightstr | nullnull
data_filestr | nullnull
min_countint30
lang"en" | "fr""en"
call_tool {"name": "statcan_pumf_tabulate", "arguments": {"url": "…", "rows": "…"}}

Classifications and concordances 11

rdaas_get_classificationGet 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
Parameters of rdaas_get_classification
ParameterTypeDefault
classification_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "rdaas_get_classification", "arguments": {"classification_id": "…"}}
rdaas_get_classification_categories_detailedGet 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
Parameters of rdaas_get_classification_categories_detailed
ParameterTypeDefault
classification_idstrrequired
querystr""
limitint100
offsetint0
lang"en" | "fr""en"
call_tool {"name": "rdaas_get_classification_categories_detailed", "arguments": {"classification_id": "…"}}
rdaas_get_classification_exclusionsGet 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
Parameters of rdaas_get_classification_exclusions
ParameterTypeDefault
classification_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "rdaas_get_classification_exclusions", "arguments": {"classification_id": "…"}}
rdaas_get_classification_index_entryGet 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
Parameters of rdaas_get_classification_index_entry
ParameterTypeDefault
classification_idstrrequired
index_idintrequired
lang"en" | "fr""en"
call_tool {"name": "rdaas_get_classification_index_entry", "arguments": {"classification_id": "…", "index_id": "…"}}
rdaas_get_classification_indexesList 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
Parameters of rdaas_get_classification_indexes
ParameterTypeDefault
classification_idstrrequired
querystr""
limitint100
offsetint0
lang"en" | "fr""en"
call_tool {"name": "rdaas_get_classification_indexes", "arguments": {"classification_id": "…"}}
rdaas_get_concordanceGet 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
Parameters of rdaas_get_concordance
ParameterTypeDefault
concordance_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "rdaas_get_concordance", "arguments": {"concordance_id": "…"}}
rdaas_get_concordance_mapsGet 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
Parameters of rdaas_get_concordance_maps
ParameterTypeDefault
concordance_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "rdaas_get_concordance_maps", "arguments": {"concordance_id": "…"}}
rdaas_get_search_filtersGet 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
Parameters of rdaas_get_search_filters
ParameterTypeDefault
kind"classification" | "concordance"required
lang"en" | "fr""en"
call_tool {"name": "rdaas_get_search_filters", "arguments": {"kind": "…"}}
rdaas_get_term_exclusionGet 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
Parameters of rdaas_get_term_exclusion
ParameterTypeDefault
term_exclusion_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "rdaas_get_term_exclusion", "arguments": {"term_exclusion_id": "…"}}
rdaas_search_classificationsSearch 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
Parameters of rdaas_search_classifications
ParameterTypeDefault
querystr""
startint0
limitint10
audiencelist[str] | nullnull
statuslist[str] | nullnull
lang"en" | "fr""en"
call_tool {"name": "rdaas_search_classifications", "arguments": {}}
rdaas_search_concordancesSearch 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
Parameters of rdaas_search_concordances
ParameterTypeDefault
querystr""
startint0
limitint10
audiencelist[str] | nullnull
statuslist[str] | nullnull
lang"en" | "fr""en"
call_tool {"name": "rdaas_search_concordances", "arguments": {}}

Definitions, methods and analysis 3

statcan_reference_search_analysisSearch 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
Parameters of statcan_reference_search_analysis
ParameterTypeDefault
querystr""
lang"en" | "fr""en"
countint10
pageint0
call_tool {"name": "statcan_reference_search_analysis", "arguments": {}}
statcan_reference_search_dataSearch 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
Parameters of statcan_reference_search_data
ParameterTypeDefault
querystr""
lang"en" | "fr""en"
countint10
pageint0
call_tool {"name": "statcan_reference_search_data", "arguments": {}}
statcan_reference_search_documentsSearch 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
Parameters of statcan_reference_search_documents
ParameterTypeDefault
querystr""
lang"en" | "fr""en"
countint10
pageint0
call_tool {"name": "statcan_reference_search_documents", "arguments": {}}

Sustainable Development Goals 3

statcan_sdg_get_indicator_dataGet 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
Parameters of statcan_sdg_get_indicator_data
ParameterTypeDefault
framework"canada" | "global"required
codestrrequired
lang"en" | "fr""en"
limitint200
offsetint0
start_yearint | nullnull
end_yearint | nullnull
filtersdict[str, str] | nullnull
call_tool {"name": "statcan_sdg_get_indicator_data", "arguments": {"framework": "…", "code": "…"}}
statcan_sdg_get_indicator_metadataGet 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
Parameters of statcan_sdg_get_indicator_metadata
ParameterTypeDefault
framework"canada" | "global"required
codestrrequired
lang"en" | "fr""en"
call_tool {"name": "statcan_sdg_get_indicator_metadata", "arguments": {"framework": "…", "code": "…"}}
statcan_sdg_search_indicatorsSearch 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
Parameters of statcan_sdg_search_indicators
ParameterTypeDefault
framework"canada" | "global"required
querystr""
lang"en" | "fr""en"
limitint10
call_tool {"name": "statcan_sdg_search_indicators", "arguments": {"framework": "…"}}

SDMX API: filtered series 4

sdmx_get_dataGet 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
Parameters of sdmx_get_data
ParameterTypeDefault
product_idintrequired
keystrrequired
start_periodstr | nullnull
end_periodstr | nullnull
last_n_observationsint | nullnull
lang"en" | "fr""en"
call_tool {"name": "sdmx_get_data", "arguments": {"product_id": "…", "key": "…"}}
sdmx_get_key_for_dimensionBuild 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
Parameters of sdmx_get_key_for_dimension
ParameterTypeDefault
product_idintrequired
dimension_positionintrequired
lang"en" | "fr""en"
call_tool {"name": "sdmx_get_key_for_dimension", "arguments": {"product_id": "…", "dimension_position": "…"}}
sdmx_get_structureGet 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
Parameters of sdmx_get_structure
ParameterTypeDefault
product_idintrequired
dimension_positionint | nullnull
code_querystr""
limitint100
offsetint0
lang"en" | "fr""en"
call_tool {"name": "sdmx_get_structure", "arguments": {"product_id": "…"}}
sdmx_get_vector_dataGet 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
Parameters of sdmx_get_vector_data
ParameterTypeDefault
vector_idintrequired
start_periodstr | nullnull
end_periodstr | nullnull
last_n_observationsint | nullnull
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_dataGet 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
Parameters of sdmx_space_get_data
ParameterTypeDefault
flowstrrequired
keystrrequired
space"ccei" | "stcshared""ccei"
start_periodstr | nullnull
end_periodstr | nullnull
last_n_observationsint | nullnull
max_rowsint1000
lang"en" | "fr""en"
call_tool {"name": "sdmx_space_get_data", "arguments": {"flow": "…", "key": "…"}}
sdmx_space_get_structureBrowse 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é
Parameters of sdmx_space_get_structure
ParameterTypeDefault
flowstrrequired
space"ccei" | "stcshared""ccei"
dimensionstr""
code_querystr""
limitint100
offsetint0
lang"en" | "fr""en"
call_tool {"name": "sdmx_space_get_structure", "arguments": {"flow": "…"}}
sdmx_space_list_flowsList 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
Parameters of sdmx_space_list_flows
ParameterTypeDefault
space"ccei" | "stcshared""ccei"
querystr""
agencystr""
limitint50
offsetint0
lang"en" | "fr""en"
call_tool {"name": "sdmx_space_list_flows", "arguments": {}}

Surveys, metadata and microdata holdings (RDC, RTRA) 4

statcan_surveys_get_survey_metadataGet 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
Parameters of statcan_surveys_get_survey_metadata
ParameterTypeDefault
survey_idintrequired
lang"en" | "fr""en"
call_tool {"name": "statcan_surveys_get_survey_metadata", "arguments": {"survey_id": "…"}}
statcan_surveys_search_rdc_holdingsSearch 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
Parameters of statcan_surveys_search_rdc_holdings
ParameterTypeDefault
querystr""
lang"en" | "fr""en"
limitint20
call_tool {"name": "statcan_surveys_search_rdc_holdings", "arguments": {}}
statcan_surveys_search_rtra_datasetsSearch 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
Parameters of statcan_surveys_search_rtra_datasets
ParameterTypeDefault
querystr""
lang"en" | "fr""en"
deleted_variablestr | nullnull
limitint20
call_tool {"name": "statcan_surveys_search_rtra_datasets", "arguments": {}}
statcan_surveys_search_surveysSearch 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
Parameters of statcan_surveys_search_surveys
ParameterTypeDefault
querystr""
lang"en" | "fr""en"
limitint20
call_tool {"name": "statcan_surveys_search_surveys", "arguments": {}}

Web Data Service: tables and vectors 12

wds_get_bulk_vector_data_by_rangeGet 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
Parameters of wds_get_bulk_vector_data_by_range
ParameterTypeDefault
vector_idslist[int]required
start_release_datetimestrrequired
end_release_datetimestrrequired
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_listList 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
Parameters of wds_get_changed_cube_list
ParameterTypeDefault
datestr | nullnull
lang"en" | "fr""en"
call_tool {"name": "wds_get_changed_cube_list", "arguments": {}}
wds_get_changed_series_dataGet 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
Parameters of wds_get_changed_series_data
ParameterTypeDefault
vector_idint | nullnull
product_idint | str | nullnull
coordinatestr | nullnull
lang"en" | "fr""en"
call_tool {"name": "wds_get_changed_series_data", "arguments": {}}
wds_get_changed_series_listList 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
Parameters of wds_get_changed_series_list
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "wds_get_changed_series_list", "arguments": {}}
wds_get_code_setsGet 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
Parameters of wds_get_code_sets
ParameterTypeDefault
category"scalar" | "frequency" | "symbol" | "status" | "uom" | "survey" | "subject" | "classification_type" | "security_level" | "terminated" | nullnull
querystr | nullnull
limitint100
lang"en" | "fr""en"
call_tool {"name": "wds_get_code_sets", "arguments": {}}
wds_get_cube_metadataGet 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
Parameters of wds_get_cube_metadata
ParameterTypeDefault
product_idint | strrequired
dimensionint | nullnull
member_querystr | nullnull
member_limitint100
member_offsetint0
footnote_limitint25
lang"en" | "fr""en"
call_tool {"name": "wds_get_cube_metadata", "arguments": {"product_id": "…"}}
wds_get_data_by_reference_period_rangeGet 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
Parameters of wds_get_data_by_reference_period_range
ParameterTypeDefault
vector_idslist[int]required
start_ref_periodstrrequired
end_ref_periodstrrequired
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_coordGet 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
Parameters of wds_get_data_from_cube_coord
ParameterTypeDefault
product_idint | strrequired
coordinatestrrequired
latest_nint12
lang"en" | "fr""en"
call_tool {"name": "wds_get_data_from_cube_coord", "arguments": {"product_id": "…", "coordinate": "…"}}
wds_get_data_from_vectorsGet 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
Parameters of wds_get_data_from_vectors
ParameterTypeDefault
vector_idslist[int]required
latest_nint12
lang"en" | "fr""en"
call_tool {"name": "wds_get_data_from_vectors", "arguments": {"vector_ids": "…"}}
wds_get_full_table_downloadGet 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
Parameters of wds_get_full_table_download
ParameterTypeDefault
product_idint | strrequired
format"csv" | "sdmx""csv"
lang"en" | "fr""en"
call_tool {"name": "wds_get_full_table_download", "arguments": {"product_id": "…"}}
wds_get_series_infoResolve 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
Parameters of wds_get_series_info
ParameterTypeDefault
vector_idint | nullnull
product_idint | str | nullnull
coordinatestr | nullnull
lang"en" | "fr""en"
call_tool {"name": "wds_get_series_info", "arguments": {}}
wds_search_cubesSearch 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é
Parameters of wds_search_cubes
ParameterTypeDefault
querystr | nullnull
limitint25
offsetint0
litebooltrue
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.

11 tools

Drug Product Database 3

hc_drug_get_productFull 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
Parameters of hc_drug_get_product
ParameterTypeDefault
dinstr""
drug_codeint | nullnull
lang"en" | "fr""en"
call_tool {"name": "hc_drug_get_product", "arguments": {}}
hc_drug_search_ingredientsActive 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
Parameters of hc_drug_search_ingredients
ParameterTypeDefault
namestrrequired
limitint50
lang"en" | "fr""en"
call_tool {"name": "hc_drug_search_ingredients", "arguments": {"name": "…"}}
hc_drug_search_productsSearch 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
Parameters of hc_drug_search_products
ParameterTypeDefault
dinstr""
brandstr""
ingredientstr""
companystr""
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" | nullnull
schedulestr""
atcstr""
product_class"human" | "veterinary" | "disinfectant" | "radiopharmaceutical" | nullnull
limitint50
lang"en" | "fr""en"
call_tool {"name": "hc_drug_search_products", "arguments": {}}

Licensed natural health products 2

hc_nhp_get_productLicence 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
Parameters of hc_nhp_get_product
ParameterTypeDefault
npnstrrequired
lang"en" | "fr""en"
call_tool {"name": "hc_nhp_get_product", "arguments": {"npn": "…"}}
hc_nhp_search_productsSearch 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
Parameters of hc_nhp_search_products
ParameterTypeDefault
querystr""
companystr""
active_onlybooltrue
limitint50
lang"en" | "fr""en"
call_tool {"name": "hc_nhp_search_products", "arguments": {}}

Medical device licences 3

hc_device_get_licenceOne 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
Parameters of hc_device_get_licence
ParameterTypeDefault
licence_numberintrequired
lang"en" | "fr""en"
call_tool {"name": "hc_device_get_licence", "arguments": {"licence_number": "…"}}
hc_device_search_devicesSearch 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
Parameters of hc_device_search_devices
ParameterTypeDefault
namestr""
identifierstr""
active_onlybooltrue
limitint50
lang"en" | "fr""en"
call_tool {"name": "hc_device_search_devices", "arguments": {}}
hc_device_search_licencesSearch 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
Parameters of hc_device_search_licences
ParameterTypeDefault
namestr""
companystr""
active_onlybooltrue
risk_class2 | 3 | 4 | nullnull
limitint50
lang"en" | "fr""en"
call_tool {"name": "hc_device_search_licences", "arguments": {}}

Canada Vigilance adverse reaction reports 3

hc_vigilance_get_reportOne 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
Parameters of hc_vigilance_get_report
ParameterTypeDefault
report_idintrequired
lang"en" | "fr""en"
call_tool {"name": "hc_vigilance_get_report", "arguments": {"report_id": "…"}}
hc_vigilance_list_codesCode 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
Parameters of hc_vigilance_list_codes
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "hc_vigilance_list_codes", "arguments": {}}
hc_vigilance_search_reactionsFind 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
Parameters of hc_vigilance_search_reactions
ParameterTypeDefault
reactionstr""
system_organ_classstr""
min_report_idint0
limitint50
max_scan_mbint120
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.

8 tools

Trademarks (CIPO) 1

ised_cipo_search_trademarksSearch 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
Parameters of ised_cipo_search_trademarks
ParameterTypeDefault
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
criteriastr""
max_returnint20
lang"en" | "fr""en"
call_tool {"name": "ised_cipo_search_trademarks", "arguments": {"search_field": "…"}}

Clean technology investment 1

ised_clean_growth_get_federal_investmentGet 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
Parameters of ised_clean_growth_get_federal_investment
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "ised_clean_growth_get_federal_investment", "arguments": {}}

Federal corporations 1

ised_corporations_get_corporationLook 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é
Parameters of ised_corporations_get_corporation
ParameterTypeDefault
id_or_business_numberstrrequired
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_dictionaryGet 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
Parameters of ised_ip_horizons_get_dictionary
ParameterTypeDefault
ip_type"patent" | "industrial_design"required
tablestr | nullnull
lang"en" | "fr""en"
call_tool {"name": "ised_ip_horizons_get_dictionary", "arguments": {"ip_type": "…"}}
ised_ip_horizons_get_patentLook 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
Parameters of ised_ip_horizons_get_patent
ParameterTypeDefault
patent_numberintrequired
include_classificationsboolfalse
lang"en" | "fr""en"
call_tool {"name": "ised_ip_horizons_get_patent", "arguments": {"patent_number": "…"}}
ised_ip_horizons_list_filesList 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
Parameters of ised_ip_horizons_list_files
ParameterTypeDefault
ip_type"patent" | "industrial_design" | "trademark"required
tablestr | nullnull
latest_onlybooltrue
lang"en" | "fr""en"
call_tool {"name": "ised_ip_horizons_list_files", "arguments": {"ip_type": "…"}}
ised_ip_horizons_search_patentsSearch 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
Parameters of ised_ip_horizons_search_patents
ParameterTypeDefault
party_namestr | nullnull
party_type"owner" | "inventor" | "applicant" | "agent" | nullnull
ipcstr | nullnull
titlestr | nullnull
filed_fromstr | nullnull
filed_tostr | nullnull
limitint25
lang"en" | "fr""en"
call_tool {"name": "ised_ip_horizons_search_patents", "arguments": {}}

Spectrum licences 1

ised_spectrum_query_licencesQuery 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
Parameters of ised_spectrum_query_licences
ParameterTypeDefault
wherestr | nullnull
out_fieldsstr"*"
order_bystr | nullnull
limitint10
offsetint0
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).

8 tools

cwfis_get_fire_dangerFire 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
Parameters of cwfis_get_fire_danger
ParameterTypeDefault
latitudefloatrequired
longitudefloatrequired
lang"en" | "fr""en"
call_tool {"name": "cwfis_get_fire_danger", "arguments": {"latitude": "…", "longitude": "…"}}
cwfis_get_fire_perimetersCurrent-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
Parameters of cwfis_get_fire_perimeters
ParameterTypeDefault
bboxlist[float] | nullnull
min_area_hafloat | nullnull
include_geometryboolfalse
limitint20
offsetint0
lang"en" | "fr""en"
call_tool {"name": "cwfis_get_fire_perimeters", "arguments": {}}
cwfis_get_fire_weather_forecastModelled 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
Parameters of cwfis_get_fire_weather_forecast
ParameterTypeDefault
station_namestrrequired
limitint100
lang"en" | "fr""en"
call_tool {"name": "cwfis_get_fire_weather_forecast", "arguments": {"station_name": "…"}}
cwfis_get_hotspotsSatellite 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
Parameters of cwfis_get_hotspots
ParameterTypeDefault
agencystr | nullnull
bboxlist[float] | nullnull
min_frpfloat | nullnull
start_datestr | nullnull
end_datestr | nullnull
canada_onlybooltrue
sort_by"latest" | "frp""latest"
limitint20
offsetint0
lang"en" | "fr""en"
call_tool {"name": "cwfis_get_hotspots", "arguments": {}}
cwfis_get_situation_reportOne 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
Parameters of cwfis_get_situation_report
ParameterTypeDefault
report_type"in_season" | "end_of_season""in_season"
date_on_or_beforestr | nullnull
lang"en" | "fr""en"
call_tool {"name": "cwfis_get_situation_report", "arguments": {}}
cwfis_get_weather_stationsFire 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
Parameters of cwfis_get_weather_stations
ParameterTypeDefault
provincestr | nullnull
namestr | nullnull
latitudefloat | nullnull
longitudefloat | nullnull
radius_kmfloat50.0
limitint20
lang"en" | "fr""en"
call_tool {"name": "cwfis_get_weather_stations", "arguments": {}}
cwfis_list_situation_reportsList 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
Parameters of cwfis_list_situation_reports
ParameterTypeDefault
report_type"all" | "end_of_season""all"
start_datestr | nullnull
end_datestr | nullnull
limitint20
offsetint0
lang"en" | "fr""en"
call_tool {"name": "cwfis_list_situation_reports", "arguments": {}}
cwfis_search_large_firesNational 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
Parameters of cwfis_search_large_fires
ParameterTypeDefault
year_fromint | nullnull
year_toint | nullnull
agencystr | nullnull
min_size_hafloat | nullnull
cause"N" | "H" | "U" | "H-PB" | nullnull
namestr | nullnull
sort_by"size" | "date""size"
limitint20
offsetint0
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).

7 tools · Resources: docs://cmhc/gotchas, docs://cmhc/fr/pieges, docs://cmhc/well-known-categories, docs://cmhc/fr/categories-courantes · Prompts: find_and_query_cmhc_table

Data tables (Excel) 3

cmhc_dt_get_download_urlResolve 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
Parameters of cmhc_dt_get_download_url
ParameterTypeDefault
categorystrrequired
slugstrrequired
geography_idstr | nullnull
edition_idstr | nullnull
lang"en" | "fr""en"
call_tool {"name": "cmhc_dt_get_download_url", "arguments": {"category": "…", "slug": "…"}}
cmhc_dt_get_tableGet 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
Parameters of cmhc_dt_get_table
ParameterTypeDefault
categorystrrequired
slugstrrequired
lang"en" | "fr""en"
call_tool {"name": "cmhc_dt_get_table", "arguments": {"category": "…", "slug": "…"}}
cmhc_dt_list_tablesList 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
Parameters of cmhc_dt_list_tables
ParameterTypeDefault
categorystrrequired
lang"en" | "fr""en"
call_tool {"name": "cmhc_dt_list_tables", "arguments": {"category": "…"}}

Housing Market Information Portal 4

cmhc_get_table_dataGet 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
Parameters of cmhc_get_table_data
ParameterTypeDefault
category_level_1strrequired
category_level_2strrequired
column_fieldstrrequired
row_fieldstrrequired
geography_typestr"Country"
geography_idstr"1"
filtersdict[str, str] | nullnull
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_optionsGet 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
Parameters of cmhc_get_table_options
ParameterTypeDefault
category_level_1strrequired
category_level_2strrequired
geography_typestr"Country"
geography_idstr"1"
lang"en" | "fr""en"
call_tool {"name": "cmhc_get_table_options", "arguments": {"category_level_1": "…", "category_level_2": "…"}}
cmhc_list_categoriesList 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
Parameters of cmhc_list_categories
ParameterTypeDefault
geography_typestr"Country"
geography_idstr"1"
lang"en" | "fr""en"
call_tool {"name": "cmhc_list_categories", "arguments": {}}
cmhc_list_provincesList 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
Parameters of cmhc_list_provinces
ParameterTypeDefault
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.

7 tools · Resources: docs://eccc/gotchas, docs://eccc/fr/pieges, docs://eccc/well-known-collections, docs://eccc/fr/collections-courantes · Prompts: eccc_severe_weather_check, find_and_query_eccc_collection

Climate projections (gridded) 3

eccc_coverages_describeDescribe 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
Parameters of eccc_coverages_describe
ParameterTypeDefault
collection_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "eccc_coverages_describe", "arguments": {"collection_id": "…"}}
eccc_coverages_get_dataGet 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
Parameters of eccc_coverages_get_data
ParameterTypeDefault
collection_idstrrequired
latfloat | nullnull
lonfloat | nullnull
bboxlist[float] | nullnull
variableslist[str] | nullnull
scenarioslist[str] | nullnull
percentileslist[float] | nullnull
seasonslist[str] | nullnull
averaging_periodslist[str] | nullnull
startstr | nullnull
endstr | nullnull
max_rowsint1000
lang"en" | "fr""en"
call_tool {"name": "eccc_coverages_get_data", "arguments": {"collection_id": "…"}}

Weather, water and climate observations 4

eccc_get_collectionGet 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
Parameters of eccc_get_collection
ParameterTypeDefault
collection_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "eccc_get_collection", "arguments": {"collection_id": "…"}}
eccc_list_collectionsList 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
Parameters of eccc_list_collections
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "eccc_list_collections", "arguments": {}}
eccc_query_itemsQuery 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
Parameters of eccc_query_items
ParameterTypeDefault
collection_idstrrequired
bboxlist[float] | nullnull
datetime_filterstr | nullnull
filtersdict[str, str] | nullnull
fieldslist[str] | nullnull
sortbystr | nullnull
limitint10
offsetint0
lang"en" | "fr""en"
call_tool {"name": "eccc_query_items", "arguments": {"collection_id": "…"}}
eccc_search_collectionsSearch 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
Parameters of eccc_search_collections
ParameterTypeDefault
querystrrequired
limitint25
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.

6 tools · Resources: docs://boc/gotchas, docs://boc/fr/pieges, docs://boc/well-known-series, docs://boc/fr/series-courantes · Prompts: compare_boc_series, find_and_fetch_boc_series

boc_get_groupGet 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
Parameters of boc_get_group
ParameterTypeDefault
namestrrequired
lang"en" | "fr""en"
call_tool {"name": "boc_get_group", "arguments": {"name": "…"}}
boc_get_group_observationsGet 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
Parameters of boc_get_group_observations
ParameterTypeDefault
group_namestrrequired
start_datestr | nullnull
end_datestr | nullnull
recentint | nullnull
recent_weeksint | nullnull
recent_monthsint | nullnull
recent_yearsint | nullnull
lang"en" | "fr""en"
call_tool {"name": "boc_get_group_observations", "arguments": {"group_name": "…"}}
boc_get_observationsGet 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
Parameters of boc_get_observations
ParameterTypeDefault
series_nameslist[str]required
start_datestr | nullnull
end_datestr | nullnull
recentint | nullnull
recent_weeksint | nullnull
recent_monthsint | nullnull
recent_yearsint | nullnull
lang"en" | "fr""en"
call_tool {"name": "boc_get_observations", "arguments": {"series_names": "…"}}
boc_get_seriesGet 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
Parameters of boc_get_series
ParameterTypeDefault
namestrrequired
lang"en" | "fr""en"
call_tool {"name": "boc_get_series", "arguments": {"name": "…"}}
boc_search_groupsSearch 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
Parameters of boc_search_groups
ParameterTypeDefault
querystr | nullnull
limitint | nullnull
lang"en" | "fr""en"
call_tool {"name": "boc_search_groups", "arguments": {}}
boc_search_seriesSearch 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
Parameters of boc_search_series
ParameterTypeDefault
querystr | nullnull
limitint | nullnull
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.

6 tools

cdc_get_butter_support_pricesGet 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
Parameters of cdc_get_butter_support_prices
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "cdc_get_butter_support_prices", "arguments": {}}
cdc_get_component_pricesGet 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
Parameters of cdc_get_component_prices
ParameterTypeDefault
year_fromint | nullnull
year_toint | nullnull
milk_classstr | nullnull
lang"en" | "fr""en"
call_tool {"name": "cdc_get_component_prices", "arguments": {}}
cdc_get_milk_classesGet 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
Parameters of cdc_get_milk_classes
ParameterTypeDefault
milk_classstr | nullnull
lang"en" | "fr""en"
call_tool {"name": "cdc_get_milk_classes", "arguments": {}}
cdc_get_national_quotaGet 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
Parameters of cdc_get_national_quota
ParameterTypeDefault
year_fromint | nullnull
year_toint | nullnull
lang"en" | "fr""en"
call_tool {"name": "cdc_get_national_quota", "arguments": {}}
cdc_list_datasetsList 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
Parameters of cdc_list_datasets
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "cdc_list_datasets", "arguments": {}}
cdc_query_market_dataQuery 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
Parameters of cdc_query_market_data
ParameterTypeDefault
dataset"production" | "sales_p10" | "sales_by_region" | "farms"required
provincestr | nullnull
regionstr | nullnull
milk_classstr | nullnull
segment"volume" | "butterfat_sales" | "butterfat_revenue" | "protein_sales" | "protein_revenue" | "other_solids_sales" | "other_solids_revenue" | "farm_count" | nullnull
date_fromstr | nullnull
date_tostr | nullnull
limitint500
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_.

6 tools

eccc_datamart_browseList 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
Parameters of eccc_datamart_browse
ParameterTypeDefault
pathstr"/"
limitint200
offsetint0
lang"en" | "fr""en"
call_tool {"name": "eccc_datamart_browse", "arguments": {}}
eccc_datamart_describe_fileDescribe 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
Parameters of eccc_datamart_describe_file
ParameterTypeDefault
pathstrrequired
sheetstr | nullnull
lang"en" | "fr""en"
call_tool {"name": "eccc_datamart_describe_file", "arguments": {"path": "…"}}
eccc_datamart_ghgrp_facilitiesLook 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)
Parameters of eccc_datamart_ghgrp_facilities
ParameterTypeDefault
yearint | nullnull
year_toint | nullnull
facilitystr | nullnull
companystr | nullnull
provincestr | nullnull
naicsstr | nullnull
ghgrp_idstr | nullnull
npri_idstr | nullnull
order"file" | "largest""file"
limitint50
offsetint0
lang"en" | "fr""en"
call_tool {"name": "eccc_datamart_ghgrp_facilities", "arguments": {}}
eccc_datamart_npri_facilitiesLook 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)
Parameters of eccc_datamart_npri_facilities
ParameterTypeDefault
yearint | nullnull
facilitystr | nullnull
companystr | nullnull
provincestr | nullnull
substancestr | nullnull
naicsstr | nullnull
npri_idstr | nullnull
order"file" | "largest""file"
limitint50
offsetint0
lang"en" | "fr""en"
call_tool {"name": "eccc_datamart_npri_facilities", "arguments": {}}
eccc_datamart_read_fileRead 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
Parameters of eccc_datamart_read_file
ParameterTypeDefault
pathstrrequired
sheetstr | nullnull
columnslist[str] | nullnull
filtersdict[str, str] | nullnull
containsstr | nullnull
header_rowint | nullnull
header_rowsint1
limitint50
offsetint0
lang"en" | "fr""en"
call_tool {"name": "eccc_datamart_read_file", "arguments": {"path": "…"}}

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.

6 tools

Monthly IRCC Updates 3

ircc_monthly_describe_tableDescribe 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)
Parameters of ircc_monthly_describe_table
ParameterTypeDefault
table_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "ircc_monthly_describe_table", "arguments": {"table_id": "…"}}
ircc_monthly_list_tablesList 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)
Parameters of ircc_monthly_list_tables
ParameterTypeDefault
querystr""
include_archivedboolfalse
lang"en" | "fr""en"
call_tool {"name": "ircc_monthly_list_tables", "arguments": {}}
ircc_monthly_queryQuery 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
Parameters of ircc_monthly_query
ParameterTypeDefault
table_idstrrequired
filtersdict[str, str] | nullnull
year_fromint | nullnull
year_toint | nullnull
period"month" | "quarter" | "year" | nullnull
group_bylist[str] | nullnull
sort"period" | "value_desc""period"
limitint100
lang"en" | "fr""en"
call_tool {"name": "ircc_monthly_query", "arguments": {"table_id": "…"}}

Express Entry rounds 3

ircc_get_express_entry_roundGet 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)
Parameters of ircc_get_express_entry_round
ParameterTypeDefault
draw_numberstrrequired
lang"en" | "fr""en"
call_tool {"name": "ircc_get_express_entry_round", "arguments": {"draw_number": "…"}}
ircc_get_latest_express_entry_roundGet 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)
Parameters of ircc_get_latest_express_entry_round
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "ircc_get_latest_express_entry_round", "arguments": {}}
ircc_list_express_entry_roundsList 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)
Parameters of ircc_list_express_entry_rounds
ParameterTypeDefault
programstr | nullnull
sincestr | nullnull
limitint20
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.

5 tools

represent_list_boundary_setsList 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
Parameters of represent_list_boundary_sets
ParameterTypeDefault
domainstr | nullnull
namestr | nullnull
with_detailsbooltrue
limitint20
offsetint0
lang"en" | "fr""en"
call_tool {"name": "represent_list_boundary_sets", "arguments": {}}
represent_list_representative_setsList 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
Parameters of represent_list_representative_sets
ParameterTypeDefault
level"federal" | "provincial" | "municipal" | nullnull
lang"en" | "fr""en"
call_tool {"name": "represent_list_representative_sets", "arguments": {}}
represent_lookup_pointFind 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
Parameters of represent_lookup_point
ParameterTypeDefault
latitudefloatrequired
longitudefloatrequired
include_set_detailsbooltrue
lang"en" | "fr""en"
call_tool {"name": "represent_lookup_point", "arguments": {"latitude": "…", "longitude": "…"}}
represent_lookup_postcodeFind 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é
Parameters of represent_lookup_postcode
ParameterTypeDefault
postcodestrrequired
setsstr | nullnull
include_set_detailsbooltrue
lang"en" | "fr""en"
call_tool {"name": "represent_lookup_postcode", "arguments": {"postcode": "…"}}
represent_search_representativesSearch 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
Parameters of represent_search_representatives
ParameterTypeDefault
namestr | nullnull
officestr | nullnull
districtstr | nullnull
partystr | nullnull
level"federal" | "provincial" | "municipal" | nullnull
representative_setstr | nullnull
limitint20
offsetint0
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.

4 tools

borealis_odesi_get_datasetGet 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
Parameters of borealis_odesi_get_dataset
ParameterTypeDefault
persistent_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "borealis_odesi_get_dataset", "arguments": {"persistent_id": "…"}}
borealis_odesi_search_datasetsSearch 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
Parameters of borealis_odesi_search_datasets
ParameterTypeDefault
querystr""
collection"all_public" | "pumfs" | "polls" | "aggregate" | "census" | "other" | "international""all_public"
limitint20
startint0
lang"en" | "fr""en"
call_tool {"name": "borealis_odesi_search_datasets", "arguments": {}}
borealis_odesi_search_variablesList 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
Parameters of borealis_odesi_search_variables
ParameterTypeDefault
persistent_idstrrequired
querystr""
limitint30
lang"en" | "fr""en"
call_tool {"name": "borealis_odesi_search_variables", "arguments": {"persistent_id": "…"}}
borealis_search_ivtFind 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
Parameters of borealis_search_ivt
ParameterTypeDefault
querystr""
limitint20
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.

4 tools

cgc_exports_describeList 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
Parameters of cgc_exports_describe
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "cgc_exports_describe", "arguments": {}}
cgc_exports_queryGet 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
Parameters of cgc_exports_query
ParameterTypeDefault
grainstr | list[str] | nullnull
destinationstr | list[str] | nullnull
regionstr | list[str] | nullnull
elevatorstr | list[str] | nullnull
global_regionstr | list[str] | nullnull
gradestr | list[str] | nullnull
year_fromint | nullnull
year_toint | nullnull
frequency"month" | "year" | "crop_year""month"
group_bylist["grain" | "grade" | "elevator" | "region" | "global_region" | "destination"] | nullnull
limitint200
lang"en" | "fr""en"
call_tool {"name": "cgc_exports_query", "arguments": {}}
cgc_weekly_describeList 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é
Parameters of cgc_weekly_describe
ParameterTypeDefault
crop_yearstr | nullnull
lang"en" | "fr""en"
call_tool {"name": "cgc_weekly_describe", "arguments": {}}
cgc_weekly_queryGet 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
Parameters of cgc_weekly_query
ParameterTypeDefault
worksheetstrrequired
crop_yearstr | nullnull
metricstr | list[str] | nullnull
periodstr | list[str] | nullnull
grainstr | list[str] | nullnull
gradestr | list[str] | nullnull
regionstr | list[str] | nullnull
week_fromint | nullnull
week_toint | nullnull
latest_week_onlyboolfalse
group_bylist["worksheet" | "metric" | "period" | "grain" | "grade" | "region"] | nullnull
limitint200
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.

4 tools

finance_fiscal_monitor_get_tablesRead 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
Parameters of finance_fiscal_monitor_get_tables
ParameterTypeDefault
periodstr""
tablestr""
lang"en" | "fr""en"
call_tool {"name": "finance_fiscal_monitor_get_tables", "arguments": {}}
finance_fiscal_monitor_list_issuesList 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
Parameters of finance_fiscal_monitor_list_issues
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "finance_fiscal_monitor_list_issues", "arguments": {}}
finance_frt_get_tableRead 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
Parameters of finance_frt_get_table
ParameterTypeDefault
tableintrequired
editionint | nullnull
lastint | nullnull
lang"en" | "fr""en"
call_tool {"name": "finance_frt_get_table", "arguments": {"table": "…"}}
finance_frt_list_tablesList 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
Parameters of finance_frt_list_tables
ParameterTypeDefault
editionint | nullnull
querystr""
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_.

4 tools

elections_results_get_historicalGet 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
Parameters of elections_results_get_historical
ParameterTypeDefault
electionint | nullnull
provincestr | nullnull
constituencystr | nullnull
partystr | nullnull
limitint50
offsetint0
lang"en" | "fr""en"
call_tool {"name": "elections_results_get_historical", "arguments": {}}
elections_results_get_historical_candidatesGet 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
Parameters of elections_results_get_historical_candidates
ParameterTypeDefault
electionint | nullnull
yearint | nullnull
provincestr | nullnull
ridingstr | nullnull
candidatestr | nullnull
partystr | nullnull
winners_onlyboolfalse
election_type"general" | "by-election" | "all""general"
limitint50
offsetint0
lang"en" | "fr""en"
call_tool {"name": "elections_results_get_historical_candidates", "arguments": {}}
elections_results_get_tableGet 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
Parameters of elections_results_get_table
ParameterTypeDefault
electionintrequired
table"turnout" | "seats" | "votes_by_party" | "vote_share_by_party" | "district_results" | "candidates" | "returning_officers"required
provincestr | nullnull
districtstr | nullnull
partystr | nullnull
winners_onlyboolfalse
limitint50
offsetint0
lang"en" | "fr""en"
call_tool {"name": "elections_results_get_table", "arguments": {"election": "…", "table": "…"}}
elections_results_list_electionsList 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
Parameters of elections_results_list_elections
ParameterTypeDefault
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.

4 tools

fcac_get_bank_accountEvery 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
Parameters of fcac_get_bank_account
ParameterTypeDefault
product_idstrrequired
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"
groupslist["senior" | "gis_recipient" | "rdsp_beneficiary" | "youth" | "student" | "newcomer" | "indigenous" | "social_assistance" | "disability_tax_credit"] | nullnull
lang"en" | "fr""en"
call_tool {"name": "fcac_get_bank_account", "arguments": {"product_id": "…", "province": "…"}}
fcac_get_credit_cardFull 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
Parameters of fcac_get_credit_card
ParameterTypeDefault
product_idstrrequired
province"AB" | "BC" | "MB" | "NB" | "NL" | "NS" | "NT" | "NU" | "ON" | "PE" | "QC" | "SK" | "YT"required
currency"CAD" | "USD" | "other""CAD"
studentboolfalse
securedboolfalse
lang"en" | "fr""en"
call_tool {"name": "fcac_get_credit_card", "arguments": {"product_id": "…", "province": "…"}}
fcac_search_bank_accountsCompare 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
Parameters of fcac_search_bank_accounts
ParameterTypeDefault
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"
groupslist["senior" | "gis_recipient" | "rdsp_beneficiary" | "youth" | "student" | "newcomer" | "indigenous" | "social_assistance" | "disability_tax_credit"] | nullnull
querystr""
institutionstr""
max_monthly_feefloat | nullnull
low_cost_onlyboolfalse
sort"monthly_fee" | "institution" | "name" | nullnull
limitint25
lang"en" | "fr""en"
call_tool {"name": "fcac_search_bank_accounts", "arguments": {"province": "…"}}
fcac_search_credit_cardsCompare 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
Parameters of fcac_search_credit_cards
ParameterTypeDefault
province"AB" | "BC" | "MB" | "NB" | "NL" | "NS" | "NT" | "NU" | "ON" | "PE" | "QC" | "SK" | "YT"required
currency"CAD" | "USD" | "other""CAD"
studentboolfalse
securedboolfalse
querystr""
institutionstr""
max_annual_feefloat | nullnull
max_purchase_ratefloat | nullnull
rewardslist["cash_back" | "travel" | "groceries" | "gas" | "general_merchandise"] | nullnull
sort"annual_fee" | "purchase_rate" | "institution" | "name" | nullnull
limitint25
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.

4 tools

ourcommons_get_member_rolesGet 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
Parameters of ourcommons_get_member_roles
ParameterTypeDefault
person_idintrequired
lang"en" | "fr""en"
call_tool {"name": "ourcommons_get_member_roles", "arguments": {"person_id": "…"}}
ourcommons_get_ministryGet 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
Parameters of ourcommons_get_ministry
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "ourcommons_get_ministry", "arguments": {}}
ourcommons_get_party_standingsGet 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
Parameters of ourcommons_get_party_standings
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "ourcommons_get_party_standings", "arguments": {}}
ourcommons_list_membersList 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
Parameters of ourcommons_list_members
ParameterTypeDefault
provincestr | nullnull
partystr | nullnull
constituencystr | nullnull
namestr | nullnull
limitint50
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.

4 tools

nfd_describe_tableDescribe 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
Parameters of nfd_describe_table
ParameterTypeDefault
table_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "nfd_describe_table", "arguments": {"table_id": "…"}}
nfd_list_tablesList 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
Parameters of nfd_list_tables
ParameterTypeDefault
sectionstr | nullnull
lang"en" | "fr""en"
call_tool {"name": "nfd_list_tables", "arguments": {}}
nfd_query_tableGet 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
Parameters of nfd_query_table
ParameterTypeDefault
table_idstrrequired
provincestr | list[str] | nullnull
year_fromint | nullnull
year_toint | nullnull
filtersdict[str, str | list[str] | null] | nullnull
group_bylist[str] | nullnull
drop_missingboolfalse
limitint200
lang"en" | "fr""en"
call_tool {"name": "nfd_query_table", "arguments": {"table_id": "…"}}
nfd_table_commentsRead 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
Parameters of nfd_table_comments
ParameterTypeDefault
table_idstrrequired
provincestr | list[str] | nullnull
year_fromint | nullnull
year_toint | nullnull
limitint50
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.

4 tools

pbo_get_information_requestRead 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
Parameters of pbo_get_information_request
ParameterTypeDefault
request_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "pbo_get_information_request", "arguments": {"request_id": "…"}}
pbo_get_publicationRead 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
Parameters of pbo_get_publication
ParameterTypeDefault
publication_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "pbo_get_publication", "arguments": {"publication_id": "…"}}
pbo_search_information_requestsSearch 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
Parameters of pbo_search_information_requests
ParameterTypeDefault
querystr""
departmentstr""
status"completed" | "pending" | "pending_correspondence" | "pending_data" | "canceled" | str | nullnull
disposition"all_disclosed" | "disclosed_in_part" | "nothing_disclosed" | "does_not_exist" | nullnull
sincestr""
untilstr""
pageint1
lang"en" | "fr""en"
call_tool {"name": "pbo_search_information_requests", "arguments": {}}
pbo_search_publicationsSearch 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
Parameters of pbo_search_publications
ParameterTypeDefault
querystr""
typeslist["RP" | "NT" | "LEG" | "ES" | "OA" | "LIBARC"] | nullnull
pageint1
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.

4 tools

worldbank_get_canada_seriesGet 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
Parameters of worldbank_get_canada_series
ParameterTypeDefault
indicatorstrrequired
compare_withlist[str] | nullnull
start_yearint | nullnull
end_yearint | nullnull
most_recentint | nullnull
lang"en" | "fr""en"
call_tool {"name": "worldbank_get_canada_series", "arguments": {"indicator": "…"}}
worldbank_get_indicatorGet 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
Parameters of worldbank_get_indicator
ParameterTypeDefault
indicatorstrrequired
lang"en" | "fr""en"
call_tool {"name": "worldbank_get_indicator", "arguments": {"indicator": "…"}}
worldbank_list_topicsList 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
Parameters of worldbank_list_topics
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "worldbank_list_topics", "arguments": {}}
worldbank_search_indicatorsFind 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
Parameters of worldbank_search_indicators
ParameterTypeDefault
querystr | nullnull
topicstr | nullnull
limitint25
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.

3 tools

gazette_get_issueList 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
Parameters of gazette_get_issue
ParameterTypeDefault
part1 | 21
issue_datestr | nullnull
lang"en" | "fr""en"
call_tool {"name": "gazette_get_issue", "arguments": {}}
gazette_get_noticeRead 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
Parameters of gazette_get_notice
ParameterTypeDefault
urlstrrequired
lang"en" | "fr""en"
call_tool {"name": "gazette_get_notice", "arguments": {"url": "…"}}
gazette_list_issuesList 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
Parameters of gazette_list_issues
ParameterTypeDefault
part1 | 21
limitint10
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).

3 tools

cfia_avian_influenzaGet 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
Parameters of cfia_avian_influenza
ParameterTypeDefault
status"current" | "released" | "all""all"
provincestr | nullnull
date_fromstr | nullnull
date_tostr | nullnull
premises_type"commercial" | "non_commercial" | "captive_wild" | nullnull
counts_by"province" | "month" | "year" | "premises_type""province"
limitint25
lang"en" | "fr""en"
call_tool {"name": "cfia_avian_influenza", "arguments": {}}
cfia_disease_detectionsList 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
Parameters of cfia_disease_detections
ParameterTypeDefault
diseasestr | nullnull
year_fromint | nullnull
year_toint | nullnull
provincestr | nullnull
animal_typestr | nullnull
counts_by"year" | "month" | "province" | "animal_type" | nullnull
lang"en" | "fr""en"
call_tool {"name": "cfia_disease_detections", "arguments": {}}
cfia_reportable_diseasesGet 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
Parameters of cfia_reportable_diseases
ParameterTypeDefault
year_fromint | nullnull
year_toint | nullnull
diseasestr | nullnull
totals_by"year" | "disease" | nullnull
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).

3 tools

cihi_get_indicatorGet 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
Parameters of cihi_get_indicator
ParameterTypeDefault
indicatorstrrequired
lang"en" | "fr""en"
call_tool {"name": "cihi_get_indicator", "arguments": {"indicator": "…"}}
cihi_get_indicator_dataRead 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é
Parameters of cihi_get_indicator_data
ParameterTypeDefault
indicatorstrrequired
placestr | nullnull
filtersdict[str, str] | nullnull
tablestr | nullnull
columnslist[str] | nullnull
limitint40
lang"en" | "fr""en"
call_tool {"name": "cihi_get_indicator_data", "arguments": {"indicator": "…"}}
cihi_search_indicatorsSearch 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é
Parameters of cihi_search_indicators
ParameterTypeDefault
querystr""
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").

3 tools

elections_financial_returns_get_financial_return_partRetrieve 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
Parameters of elections_financial_returns_get_financial_return_part
ParameterTypeDefault
candidate_client_idstrrequired
partstrrequired
election_idstrrequired
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_electionsList 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
Parameters of elections_financial_returns_list_elections
ParameterTypeDefault
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_candidatesSearch 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
Parameters of elections_financial_returns_search_candidates
ParameterTypeDefault
election_idstrrequired
act"after_2019" | "2015_2019" | "2007_2014" | "2004_2006""after_2019"
last_namestr""
first_namestr""
party_idstr"-1"
province_idstr"-1"
district_idstr"-1"
return_status"submitted" | "amended""submitted"
offsetint0
limitint300
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.

3 tools

dfo_iwls_get_stationGet 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
Parameters of dfo_iwls_get_station
ParameterTypeDefault
station_codestrrequired
lang"en" | "fr""en"
call_tool {"name": "dfo_iwls_get_station", "arguments": {"station_code": "…"}}
dfo_iwls_get_water_levelsGet 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
Parameters of dfo_iwls_get_water_levels
ParameterTypeDefault
station_codestrrequired
series_codestr"wlp-hilo"
startstr | nullnull
endstr | nullnull
resolution"ONE_MINUTE" | "FIVE_MINUTES" | "FIFTEEN_MINUTES" | "SIXTY_MINUTES" | nullnull
lang"en" | "fr""en"
call_tool {"name": "dfo_iwls_get_water_levels", "arguments": {"station_code": "…"}}
dfo_iwls_search_stationsSearch 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
Parameters of dfo_iwls_search_stations
ParameterTypeDefault
querystr""
operating_onlybooltrue
series_codestr | nullnull
limitint20
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.

3 tools

pmra_get_productOne 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
Parameters of pmra_get_product
ParameterTypeDefault
registration_numberstrrequired
lang"en" | "fr""en"
call_tool {"name": "pmra_get_product", "arguments": {"registration_number": "…"}}
pmra_get_residue_limitsCanada'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
Parameters of pmra_get_residue_limits
ParameterTypeDefault
chemicalstr""
commoditystr""
limitint200
lang"en" | "fr""en"
call_tool {"name": "pmra_get_residue_limits", "arguments": {}}
pmra_search_productsSearch 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
Parameters of pmra_search_products
ParameterTypeDefault
querystr""
registration_numberstr""
active_ingredientstr""
registrantstr""
product_typestr""
status"current" | "historical" | "all""current"
limitint50
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.

3 tools

nrcan_energy_use_get_tableRead 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é
Parameters of nrcan_energy_use_get_table
ParameterTypeDefault
table_keystrrequired
lang"en" | "fr""en"
call_tool {"name": "nrcan_energy_use_get_table", "arguments": {"table_key": "…"}}
nrcan_energy_use_list_productsList 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
Parameters of nrcan_energy_use_list_products
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "nrcan_energy_use_list_products", "arguments": {}}
nrcan_energy_use_list_tablesList 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
Parameters of nrcan_energy_use_list_tables
ParameterTypeDefault
productstrrequired
sectorstr | nullnull
jurisdictionstr | nullnull
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_).

3 tools

pmprb_get_report_tableRead 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
Parameters of pmprb_get_report_table
ParameterTypeDefault
yearintrequired
tablestrrequired
lang"en" | "fr""en"
call_tool {"name": "pmprb_get_report_table", "arguments": {"year": "…", "table": "…"}}
pmprb_list_report_tablesList 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
Parameters of pmprb_list_report_tables
ParameterTypeDefault
yearint | nullnull
querystr""
lang"en" | "fr""en"
call_tool {"name": "pmprb_list_report_tables", "arguments": {}}
pmprb_search_patented_medicinesSearch 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
Parameters of pmprb_search_patented_medicines
ParameterTypeDefault
querystr""
companystr""
atcstr""
status"within_guidelines" | "does_not_trigger" | "under_investigation" | "under_review" | "voluntary_compliance_undertaking" | "notice_of_hearing" | "stay_order" | nullnull
year2020 | 20212021
limitint25
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.

3 tools

phac_infobase_describe_datasetDescribe 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
Parameters of phac_infobase_describe_dataset
ParameterTypeDefault
dataset_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "phac_infobase_describe_dataset", "arguments": {"dataset_id": "…"}}
phac_infobase_list_datasetsList 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
Parameters of phac_infobase_list_datasets
ParameterTypeDefault
topicstr | nullnull
querystr | nullnull
lang"en" | "fr""en"
call_tool {"name": "phac_infobase_list_datasets", "arguments": {}}
phac_infobase_queryQuery 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
Parameters of phac_infobase_query
ParameterTypeDefault
dataset_idstrrequired
filtersdict[str, str] | nullnull
geographystr | nullnull
startstr | nullnull
endstr | nullnull
columnslist[str] | nullnull
limitint100
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.

3 tools

recalls_getGet 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é
Parameters of recalls_get
ParameterTypeDefault
recall_idintrequired
lang"en" | "fr""en"
call_tool {"name": "recalls_get", "arguments": {"recall_id": "…"}}
recalls_summarizeCount 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
Parameters of recalls_summarize
ParameterTypeDefault
group_by"year" | "agency" | "product_type" | "organization" | "category" | "issue" | "recall_class"required
querystr | nullnull
agency"health_canada" | "cfia" | "transport_canada" | nullnull
product_type"food" | "health_product" | "consumer_product" | "vehicle" | nullnull
categorystr | nullnull
recall_classstr | nullnull
updated_fromstr | nullnull
updated_tostr | nullnull
include_archivedbooltrue
topint50
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…

2 tools

cer_list_datasetsFind 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
Parameters of cer_list_datasets
ParameterTypeDefault
querystr""
limitint10
lang"en" | "fr""en"
call_tool {"name": "cer_list_datasets", "arguments": {}}
cer_query_fileRead 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
Parameters of cer_query_file
ParameterTypeDefault
urlstrrequired
filtersdict[str, str] | nullnull
columnslist[str] | nullnull
startstr | nullnull
endstr | nullnull
limitint100
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.

2 tools

gc_infobase_list_filesList 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
Parameters of gc_infobase_list_files
ParameterTypeDefault
querystr | nullnull
lang"en" | "fr""en"
call_tool {"name": "gc_infobase_list_files", "arguments": {}}
gc_infobase_queryQuery 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
Parameters of gc_infobase_query
ParameterTypeDefault
resource_idstrrequired
organizationstr | nullnull
fiscal_yearstr | nullnull
filtersdict[str, str] | nullnull
columnslist[str] | nullnull
limitint100
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.

2 tools

nrcan_geo_locateGeocode 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
Parameters of nrcan_geo_locate
ParameterTypeDefault
querystrrequired
limitint10
lang"en" | "fr""en"
call_tool {"name": "nrcan_geo_locate", "arguments": {"query": "…"}}
nrcan_geo_search_namesSearch 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
Parameters of nrcan_geo_search_names
ParameterTypeDefault
querystr | nullnull
provincestr | nullnull
feature_typestr | nullnull
latitudefloat | nullnull
longitudefloat | nullnull
radius_kmfloat | nullnull
bboxlist[float] | nullnull
limitint10
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_).

2 tools

nrcan_minerals_get_productionCanada'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
Parameters of nrcan_minerals_get_production
ParameterTypeDefault
yearint | nullnull
commoditystr""
provincestr""
category"all" | "value" | "quantity""all"
limitint500
lang"en" | "fr""en"
call_tool {"name": "nrcan_minerals_get_production", "arguments": {}}
nrcan_minerals_get_seriesOne 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
Parameters of nrcan_minerals_get_series
ParameterTypeDefault
commoditystrrequired
provincestr"Canada"
category"value" | "quantity_shipped" | "quantity_produced""value"
from_yearint | nullnull
to_yearint | nullnull
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.

2 tools

senate_get_voteGet 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
Parameters of senate_get_vote
ParameterTypeDefault
vote_idintrequired
sessionstrrequired
lang"en" | "fr""en"
call_tool {"name": "senate_get_vote", "arguments": {"vote_id": "…", "session": "…"}}
senate_list_votesList 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é
Parameters of senate_list_votes
ParameterTypeDefault
sessionstr | nullnull
keywordstr | nullnull
billstr | nullnull
limitint50
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.

2 tools

tc_recalls_getGet 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
Parameters of tc_recalls_get
ParameterTypeDefault
recall_numberstrrequired
lang"en" | "fr""en"
call_tool {"name": "tc_recalls_get", "arguments": {"recall_number": "…"}}

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.

1 tool

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').

1 tool

cbsa_border_wait_timesCurrent 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
Parameters of cbsa_border_wait_times
ParameterTypeDefault
provincestr""
crossingstr""
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.

1 tool

competition_bureau_search_mergersSearch 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
Parameters of competition_bureau_search_mergers
ParameterTypeDefault
partystr""
naicsstr | nullnull
outcome"ARC" | "NAL" | "CA" | "JD" | "TA" | "Other" | "Ongoing" | nullnull
concluded_fromstr | nullnull
concluded_tostr | nullnull
include_ongoingbooltrue
limitint25
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.

1 tool

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.

1 tool

nrcan_nbac_query_firesQuery 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é
Parameters of nrcan_nbac_query_fires
ParameterTypeDefault
cql_filterstr | nullnull
include_geometryboolfalse
sort_bystr | nullnull
limitint20
offsetint0
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_).

1 tool

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.

12 tools

bc_env_get_air_parameter_dataOne 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
Parameters of bc_env_get_air_parameter_data
ParameterTypeDefault
parameterstrrequired
stationstr | nullnull
startstr | nullnull
endstr | nullnull
latest_onlyboolfalse
limitint200
lang"en" | "fr""en"
call_tool {"name": "bc_env_get_air_parameter_data", "arguments": {"parameter": "…"}}
bc_env_get_air_station_dataHourly 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
Parameters of bc_env_get_air_station_data
ParameterTypeDefault
stationstrrequired
parameterslist[str] | nullnull
startstr | nullnull
endstr | nullnull
limitint200
lang"en" | "fr""en"
call_tool {"name": "bc_env_get_air_station_data", "arguments": {"station": "…"}}
bc_env_get_aqhiCurrent 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
Parameters of bc_env_get_aqhi
ParameterTypeDefault
areastr | nullnull
history_hoursint0
lang"en" | "fr""en"
call_tool {"name": "bc_env_get_aqhi", "arguments": {}}
bc_env_get_snow_readingsBC 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
Parameters of bc_env_get_snow_readings
ParameterTypeDefault
variablestrrequired
stationslist[str] | nullnull
startstr | nullnull
endstr | nullnull
limitint200
lang"en" | "fr""en"
call_tool {"name": "bc_env_get_snow_readings", "arguments": {"variable": "…"}}
bc_env_get_snow_station_dataCurrent-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
Parameters of bc_env_get_snow_station_data
ParameterTypeDefault
stationstrrequired
variableslist[str] | nullnull
startstr | nullnull
endstr | nullnull
limitint200
lang"en" | "fr""en"
call_tool {"name": "bc_env_get_snow_station_data", "arguments": {"station": "…"}}
bc_env_get_snow_surveysManual 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
Parameters of bc_env_get_snow_surveys
ParameterTypeDefault
querystr | nullnull
season"current" | "archive""current"
startstr | nullnull
endstr | nullnull
limitint200
lang"en" | "fr""en"
call_tool {"name": "bc_env_get_snow_surveys", "arguments": {}}
bc_env_get_streamflowDischarge (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
Parameters of bc_env_get_streamflow
ParameterTypeDefault
stationstrrequired
parameter"discharge" | "stage""discharge"
startstr | nullnull
endstr | nullnull
limitint200
lang"en" | "fr""en"
call_tool {"name": "bc_env_get_streamflow", "arguments": {"station": "…"}}
bc_env_get_well_levelsGroundwater 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
Parameters of bc_env_get_well_levels
ParameterTypeDefault
wellstrrequired
series"daily" | "hourly" | "all""daily"
startstr | nullnull
endstr | nullnull
limitint200
lang"en" | "fr""en"
call_tool {"name": "bc_env_get_well_levels", "arguments": {"well": "…"}}
bc_env_list_air_stationsList 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
Parameters of bc_env_list_air_stations
ParameterTypeDefault
querystr | nullnull
parameterstr | nullnull
ownerstr | nullnull
limitint100
lang"en" | "fr""en"
call_tool {"name": "bc_env_list_air_stations", "arguments": {}}
bc_env_list_snow_stationsList 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
Parameters of bc_env_list_snow_stations
ParameterTypeDefault
querystr | nullnull
statusstr | nullnull
operatorstr | nullnull
limitint100
lang"en" | "fr""en"
call_tool {"name": "bc_env_list_snow_stations", "arguments": {}}
bc_env_list_streamflow_gaugesList 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
Parameters of bc_env_list_streamflow_gauges
ParameterTypeDefault
querystr | nullnull
limitint100
lang"en" | "fr""en"
call_tool {"name": "bc_env_list_streamflow_gauges", "arguments": {}}
bc_env_list_wellsList 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
Parameters of bc_env_list_wells
ParameterTypeDefault
querystr | nullnull
statusstr | nullnull
regionstr | nullnull
with_data_onlybooltrue
limitint100
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.

12 tools

electricity_ontario_get_adequacy_outlookOntario'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é
Parameters of electricity_ontario_get_adequacy_outlook
ParameterTypeDefault
datestr | nullnull
lang"en" | "fr""en"
call_tool {"name": "electricity_ontario_get_adequacy_outlook", "arguments": {}}
electricity_ontario_get_hoep_historyMonthly 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é
Parameters of electricity_ontario_get_hoep_history
ParameterTypeDefault
yearint | nullnull
lang"en" | "fr""en"
call_tool {"name": "electricity_ontario_get_hoep_history", "arguments": {}}
electricity_ontario_get_hourly_demandOntario 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
Parameters of electricity_ontario_get_hourly_demand
ParameterTypeDefault
yearint | nullnull
start_datestr | nullnull
end_datestr | nullnull
limitint48
lang"en" | "fr""en"
call_tool {"name": "electricity_ontario_get_hourly_demand", "arguments": {}}
electricity_ontario_get_intertie_flowsOntario 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
Parameters of electricity_ontario_get_intertie_flows
ParameterTypeDefault
datestr | nullnull
lang"en" | "fr""en"
call_tool {"name": "electricity_ontario_get_intertie_flows", "arguments": {}}
electricity_ontario_get_pricesOntario 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
Parameters of electricity_ontario_get_prices
ParameterTypeDefault
market"day_ahead" | "real_time""day_ahead"
datestr | nullnull
hourint | nullnull
lang"en" | "fr""en"
call_tool {"name": "electricity_ontario_get_prices", "arguments": {}}
electricity_ontario_get_realtime_demandOntario 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
Parameters of electricity_ontario_get_realtime_demand
ParameterTypeDefault
datestr | nullnull
hourint | nullnull
lang"en" | "fr""en"
call_tool {"name": "electricity_ontario_get_realtime_demand", "arguments": {}}
electricity_ontario_get_supply_by_fuelOntario 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
Parameters of electricity_ontario_get_supply_by_fuel
ParameterTypeDefault
yearint | nullnull
start_datestr | nullnull
end_datestr | nullnull
limitint48
lang"en" | "fr""en"
call_tool {"name": "electricity_ontario_get_supply_by_fuel", "arguments": {}}
electricity_quebec_get_demandQuebec 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
Parameters of electricity_quebec_get_demand
ParameterTypeDefault
dataset"recent" | "history""recent"
start_datestr | nullnull
end_datestr | nullnull
limitint48
lang"en" | "fr""en"
call_tool {"name": "electricity_quebec_get_demand", "arguments": {}}
electricity_quebec_get_facility_flowsHourly 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
Parameters of electricity_quebec_get_facility_flows
ParameterTypeDefault
facilitystrrequired
kind"total" | "turbined" | "spilled" | "inflow" | nullnull
startstr | nullnull
endstr | nullnull
lang"en" | "fr""en"
call_tool {"name": "electricity_quebec_get_facility_flows", "arguments": {"facility": "…"}}
electricity_quebec_get_generationQuebec 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é
Parameters of electricity_quebec_get_generation
ParameterTypeDefault
dataset"recent" | "history""recent"
start_datestr | nullnull
end_datestr | nullnull
limitint48
lang"en" | "fr""en"
call_tool {"name": "electricity_quebec_get_generation", "arguments": {}}
electricity_quebec_get_tradeQuebec 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
Parameters of electricity_quebec_get_trade
ParameterTypeDefault
start_datestr | nullnull
end_datestr | nullnull
limitint48
lang"en" | "fr""en"
call_tool {"name": "electricity_quebec_get_trade", "arguments": {}}
electricity_quebec_list_facilitiesHydro-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
Parameters of electricity_quebec_list_facilities
ParameterTypeDefault
querystr | nullnull
regionstr | nullnull
kind"total" | "turbined" | "spilled" | "inflow" | nullnull
limitint100
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.

7 tools

ab_wildfire_get_fire_dangerAlberta'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
Parameters of ab_wildfire_get_fire_danger
ParameterTypeDefault
latitudefloatrequired
longitudefloatrequired
lang"en" | "fr""en"
call_tool {"name": "ab_wildfire_get_fire_danger", "arguments": {"latitude": "…", "longitude": "…"}}
ab_wildfire_get_fire_perimetersList 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
Parameters of ab_wildfire_get_fire_perimeters
ParameterTypeDefault
state"active" | "extinguished""active"
fire_numberstr | nullnull
causestr | nullnull
size_classstr | nullnull
forest_areastr | nullnull
min_area_hafloat | nullnull
include_geometryboolfalse
limitint20
offsetint0
lang"en" | "fr""en"
call_tool {"name": "ab_wildfire_get_fire_perimeters", "arguments": {}}
ab_wildfire_get_fire_restrictionsList 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
Parameters of ab_wildfire_get_fire_restrictions
ParameterTypeDefault
latitudefloat | nullnull
longitudefloat | nullnull
alert_typestr | nullnull
name_containsstr | nullnull
limitint100
lang"en" | "fr""en"
call_tool {"name": "ab_wildfire_get_fire_restrictions", "arguments": {}}
ab_wildfire_get_firesList 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
Parameters of ab_wildfire_get_fires
ParameterTypeDefault
dataset"current" | "previous_5_years""current"
statusstr | nullnull
active_onlyboolfalse
fire_typestr | nullnull
causestr | nullnull
size_classstr | nullnull
forest_areastr | nullnull
fire_yearint | nullnull
carryoverbool | nullnull
start_datestr | nullnull
end_datestr | nullnull
date_basis"assessed" | "status_changed""assessed"
min_area_hafloat | nullnull
bboxlist[float] | nullnull
latitudefloat | nullnull
longitudefloat | nullnull
radius_kmfloat | nullnull
sort_by"latest" | "largest""latest"
limitint20
offsetint0
lang"en" | "fr""en"
call_tool {"name": "ab_wildfire_get_fires", "arguments": {}}
ab_wildfire_get_season_statisticsAlberta 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
Parameters of ab_wildfire_get_season_statistics
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "ab_wildfire_get_season_statistics", "arguments": {}}
ab_wildfire_summarize_fire_dangerCount 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
Parameters of ab_wildfire_summarize_fire_danger
ParameterTypeDefault
bboxlist[float] | nullnull
lang"en" | "fr""en"
call_tool {"name": "ab_wildfire_summarize_fire_danger", "arguments": {}}
ab_wildfire_summarize_firesCount 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
Parameters of ab_wildfire_summarize_fires
ParameterTypeDefault
dataset"current" | "previous_5_years""current"
group_by"status" | "cause" | "size_class" | "forest_area" | "fire_type" | "fire_year""status"
statusstr | nullnull
active_onlyboolfalse
fire_typestr | nullnull
causestr | nullnull
size_classstr | nullnull
forest_areastr | nullnull
fire_yearint | nullnull
carryoverbool | nullnull
start_datestr | nullnull
end_datestr | nullnull
date_basis"assessed" | "status_changed""assessed"
min_area_hafloat | nullnull
bboxlist[float] | nullnull
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.

5 tools

ab_economic_get_dataGet 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
Parameters of ab_economic_get_data
ParameterTypeDefault
tablestrrequired
filtersdict[str, str] | nullnull
start_datestr | nullnull
end_datestr | nullnull
limitint120
lang"en" | "fr""en"
call_tool {"name": "ab_economic_get_data", "arguments": {"table": "…"}}
ab_economic_get_indicator_seriesGet 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
Parameters of ab_economic_get_indicator_series
ParameterTypeDefault
indicatorstrrequired
lang"en" | "fr""en"
call_tool {"name": "ab_economic_get_indicator_series", "arguments": {"indicator": "…"}}
ab_economic_get_table_fieldsGet 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
Parameters of ab_economic_get_table_fields
ParameterTypeDefault
tablestrrequired
lang"en" | "fr""en"
call_tool {"name": "ab_economic_get_table_fields", "arguments": {"table": "…"}}
ab_economic_list_indicatorsList 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
Parameters of ab_economic_list_indicators
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "ab_economic_list_indicators", "arguments": {}}
ab_economic_list_tablesList 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
Parameters of ab_economic_list_tables
ParameterTypeDefault
querystr | nullnull
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).

5 tools

bc_lobbyists_get_registrationRead 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
Parameters of bc_lobbyists_get_registration
ParameterTypeDefault
registrationstrrequired
lang"en" | "fr""en"
call_tool {"name": "bc_lobbyists_get_registration", "arguments": {"registration": "…"}}
bc_lobbyists_list_codesList 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
Parameters of bc_lobbyists_list_codes
ParameterTypeDefault
kind"subject_matters" | "intended_outcomes" | "ministries"required
querystr""
lang"en" | "fr""en"
call_tool {"name": "bc_lobbyists_list_codes", "arguments": {"kind": "…"}}
bc_lobbyists_search_activity_reportsSearch 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
Parameters of bc_lobbyists_search_activity_reports
ParameterTypeDefault
querystr""
client_namestr""
lobbyiststr""
office_holderstr""
agencystr""
subject_matterstr""
kind"consultant" | "in_house" | nullnull
date_fromstr | nullnull
date_tostr | nullnull
arranged_onlybool | nullnull
limitint25
lang"en" | "fr""en"
call_tool {"name": "bc_lobbyists_search_activity_reports", "arguments": {}}
bc_lobbyists_search_registrationsSearch 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
Parameters of bc_lobbyists_search_registrations
ParameterTypeDefault
querystr""
client_namestr""
lobbyiststr""
firmstr""
subject_matterstr""
agencystr""
kind"consultant" | "in_house" | nullnull
status"active" | "ended" | nullnull
date_fromstr | nullnull
date_tostr | nullnull
limitint25
lang"en" | "fr""en"
call_tool {"name": "bc_lobbyists_search_registrations", "arguments": {}}
bc_lobbyists_summarize_activityCount 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
Parameters of bc_lobbyists_summarize_activity
ParameterTypeDefault
group_by"client" | "ministry" | "office_holder" | "subject_matter" | "lobbyist" | "month" | "year"required
querystr""
client_namestr""
lobbyiststr""
office_holderstr""
agencystr""
subject_matterstr""
kind"consultant" | "in_house" | nullnull
date_fromstr | nullnull
date_tostr | nullnull
arranged_onlybool | nullnull
topint20
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).

5 tools

ab_opendata_describe_resourceList 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
Parameters of ab_opendata_describe_resource
ParameterTypeDefault
urlstrrequired
sheetstr | nullnull
lang"en" | "fr""en"
call_tool {"name": "ab_opendata_describe_resource", "arguments": {"url": "…"}}
ab_opendata_get_datasetGet 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
Parameters of ab_opendata_get_dataset
ParameterTypeDefault
datasetstrrequired
lang"en" | "fr""en"
call_tool {"name": "ab_opendata_get_dataset", "arguments": {"dataset": "…"}}
ab_opendata_list_organizationsList 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
Parameters of ab_opendata_list_organizations
ParameterTypeDefault
format"xlsx" | "xls" | "csv" | nullnull
lang"en" | "fr""en"
call_tool {"name": "ab_opendata_list_organizations", "arguments": {}}
ab_opendata_read_resourceRead 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
Parameters of ab_opendata_read_resource
ParameterTypeDefault
urlstrrequired
sheetstr | nullnull
columnslist[str] | nullnull
filtersdict[str, str] | nullnull
containsstr | nullnull
header_rowint | nullnull
header_rowsint1
limitint50
offsetint0
lang"en" | "fr""en"
call_tool {"name": "ab_opendata_read_resource", "arguments": {"url": "…"}}
ab_opendata_search_datasetsSearch 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
Parameters of ab_opendata_search_datasets
ParameterTypeDefault
querystr | nullnull
organizationstr | nullnull
format"xlsx" | "xls" | "csv" | nullnull
ogl_alberta_onlyboolfalse
sort"relevance" | "modified" | "title""relevance"
limitint20
offsetint0
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.

4 tools

drivebc_get_eventOne 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
Parameters of drivebc_get_event
ParameterTypeDefault
event_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "drivebc_get_event", "arguments": {"event_id": "…"}}
drivebc_list_areasThe 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
Parameters of drivebc_list_areas
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "drivebc_list_areas", "arguments": {}}
drivebc_search_eventsActive 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
Parameters of drivebc_search_events
ParameterTypeDefault
event_type"CONSTRUCTION" | "INCIDENT" | "ROAD_CONDITION" | "WEATHER_CONDITION" | "SPECIAL_EVENT" | nullnull
severity"MINOR" | "MODERATE" | "MAJOR" | "UNKNOWN" | nullnull
subtypestr | nullnull
areastr | nullnull
roadstr | nullnull
bboxlist[float] | nullnull
querystr | nullnull
limitint25
lang"en" | "fr""en"
call_tool {"name": "drivebc_search_events", "arguments": {}}
drivebc_summarize_eventsCounts 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
Parameters of drivebc_summarize_events
ParameterTypeDefault
group_by"event_type" | "severity" | "area" | "road" | "subtype""area"
event_type"CONSTRUCTION" | "INCIDENT" | "ROAD_CONDITION" | "WEATHER_CONDITION" | "SPECIAL_EVENT" | nullnull
severity"MINOR" | "MODERATE" | "MAJOR" | "UNKNOWN" | nullnull
areastr | nullnull
roadstr | nullnull
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.

4 tools

oeb_describe_datasetDescribe 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
Parameters of oeb_describe_dataset
ParameterTypeDefault
datasetstrrequired
filestr | nullnull
releasestr | nullnull
sheetstr | nullnull
lang"en" | "fr""en"
call_tool {"name": "oeb_describe_dataset", "arguments": {"dataset": "…"}}
oeb_list_datasetsList 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
Parameters of oeb_list_datasets
ParameterTypeDefault
querystr | nullnull
lang"en" | "fr""en"
call_tool {"name": "oeb_list_datasets", "arguments": {}}
oeb_query_datasetRead 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
Parameters of oeb_query_dataset
ParameterTypeDefault
datasetstrrequired
distributorstr | nullnull
yearint | nullnull
fieldslist[str] | nullnull
wheredict[str, str] | nullnull
filestr | nullnull
releasestr | nullnull
sheetstr | nullnull
max_rowsint100
lang"en" | "fr""en"
call_tool {"name": "oeb_query_dataset", "arguments": {"dataset": "…"}}
oeb_ratesOntario 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
Parameters of oeb_rates
ParameterTypeDefault
table"electricity_residential" | "electricity_general_service" | "natural_gas_residential" | "rpp_time_of_use" | "rpp_tiered" | "rpp_ultra_low_overnight"required
distributorstr | nullnull
max_rowsint200
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_.

4 tools

elections_provincial_get_resultsGet 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
Parameters of elections_provincial_get_results
ParameterTypeDefault
provincestrrequired
electionstr | nullnull
districtstr | nullnull
partystr | nullnull
candidatestr | nullnull
winners_onlyboolfalse
limitint50
offsetint0
lang"en" | "fr""en"
call_tool {"name": "elections_provincial_get_results", "arguments": {"province": "…"}}
elections_provincial_get_seatsGet 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
Parameters of elections_provincial_get_seats
ParameterTypeDefault
provincestrrequired
electionstr | nullnull
lang"en" | "fr""en"
call_tool {"name": "elections_provincial_get_seats", "arguments": {"province": "…"}}
elections_provincial_get_voting_areasGet 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é
Parameters of elections_provincial_get_voting_areas
ParameterTypeDefault
districtstrrequired
provincestr"mb"
electionstr | nullnull
voting_areastr | nullnull
partystr | nullnull
candidatestr | nullnull
limitint50
offsetint0
lang"en" | "fr""en"
call_tool {"name": "elections_provincial_get_voting_areas", "arguments": {"district": "…"}}
elections_provincial_list_electionsList 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
Parameters of elections_provincial_list_elections
ParameterTypeDefault
provincestr | nullnull
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").

3 tools

aer_get_well_licences_dailyFetch 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
Parameters of aer_get_well_licences_daily
ParameterTypeDefault
daystr | nullnull
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").

3 tools

bcgw_get_active_wildfiresQuery 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é
Parameters of bcgw_get_active_wildfires
ParameterTypeDefault
statusstr | nullnull
fire_yearint | nullnull
min_size_hectaresfloat | nullnull
include_outboolfalse
include_geometryboolfalse
limitint20
offsetint0
lang"en" | "fr""en"
call_tool {"name": "bcgw_get_active_wildfires", "arguments": {}}
bcgw_get_mining_tenureQuery 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
Parameters of bcgw_get_mining_tenure
ParameterTypeDefault
tenure_typestr | nullnull
owner_namestr | nullnull
min_area_hectaresfloat | nullnull
include_geometryboolfalse
limitint20
offsetint0
lang"en" | "fr""en"
call_tool {"name": "bcgw_get_mining_tenure", "arguments": {}}
bcgw_query_layerQuery 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
Parameters of bcgw_query_layer
ParameterTypeDefault
type_namestrrequired
cql_filterstr | nullnull
property_namesstr | nullnull
include_geometryboolfalse
sort_bystr | nullnull
limitint20
offsetint0
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.

3 tools

nwt_stats_list_filesList 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
Parameters of nwt_stats_list_files
ParameterTypeDefault
topicstr | nullnull
limitint100
offsetint0
lang"en" | "fr""en"
call_tool {"name": "nwt_stats_list_files", "arguments": {}}
nwt_stats_read_fileRead 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
Parameters of nwt_stats_read_file
ParameterTypeDefault
urlstrrequired
sheetstr | nullnull
header_rowint | nullnull
header_rowsint1
filtersdict[str, str] | nullnull
containsstr | nullnull
columnslist[str] | nullnull
limitint50
offsetint0
lang"en" | "fr""en"
call_tool {"name": "nwt_stats_read_file", "arguments": {"url": "…"}}
nwt_stats_search_filesSearch 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
Parameters of nwt_stats_search_files
ParameterTypeDefault
querystrrequired
topicstr | nullnull
limitint100
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.

2 tools

bc_stats_list_filesList 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
Parameters of bc_stats_list_files
ParameterTypeDefault
querystr | nullnull
datasetstr | nullnull
limitint100
offsetint0
lang"en" | "fr""en"
call_tool {"name": "bc_stats_list_files", "arguments": {}}
bc_stats_read_fileRead 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
Parameters of bc_stats_read_file
ParameterTypeDefault
urlstrrequired
sheetstr | nullnull
containsstr | nullnull
header_rowint | nullnull
limitint50
offsetint0
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).

2 tools

isq_get_tableRead 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
Parameters of isq_get_table
ParameterTypeDefault
tablestrrequired
offsetint0
max_rowsint200
lang"en" | "fr""fr"
call_tool {"name": "isq_get_table", "arguments": {"table": "…"}}
isq_search_tablesSearch 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
Parameters of isq_search_tables
ParameterTypeDefault
querystrrequired
lang"en" | "fr" | "all""all"
limitint25
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.

2 tools

nl_stats_list_filesList 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
Parameters of nl_stats_list_files
ParameterTypeDefault
topicstr | nullnull
querystr | nullnull
limitint40
offsetint0
lang"en" | "fr""en"
call_tool {"name": "nl_stats_list_files", "arguments": {}}
nl_stats_read_fileRead 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
Parameters of nl_stats_read_file
ParameterTypeDefault
urlstrrequired
sheetstr | nullnull
containsstr | nullnull
header_rowint | nullnull
header_rowsint1
limitint50
offsetint0
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.

2 tools

yukon_stats_list_tablesList 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
Parameters of yukon_stats_list_tables
ParameterTypeDefault
querystr | nullnull
datasetstr | nullnull
limitint50
lang"en" | "fr""en"
call_tool {"name": "yukon_stats_list_tables", "arguments": {}}
yukon_stats_query_tableRead 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
Parameters of yukon_stats_query_table
ParameterTypeDefault
urlstrrequired
filtersdict[str, str] | nullnull
columnslist[str] | nullnull
limitint50
offsetint0
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.

7 tools

transit_get_feed_infoOne 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
Parameters of transit_get_feed_info
ParameterTypeDefault
agencystrrequired
lang"en" | "fr""en"
call_tool {"name": "transit_get_feed_info", "arguments": {"agency": "…"}}
transit_get_route_summaryA 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
Parameters of transit_get_route_summary
ParameterTypeDefault
agencystrrequired
routestrrequired
service_datestr | nullnull
lang"en" | "fr""en"
call_tool {"name": "transit_get_route_summary", "arguments": {"agency": "…", "route": "…"}}
transit_get_stop_departuresScheduled (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
Parameters of transit_get_stop_departures
ParameterTypeDefault
agencystrrequired
stopstrrequired
service_datestr | nullnull
start_timestr | nullnull
routestr | nullnull
limitint20
lang"en" | "fr""en"
call_tool {"name": "transit_get_stop_departures", "arguments": {"agency": "…", "stop": "…"}}
transit_list_agenciesThe 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
Parameters of transit_list_agencies
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "transit_list_agencies", "arguments": {}}
transit_list_national_agenciesThe 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
Parameters of transit_list_national_agencies
ParameterTypeDefault
querystr | nullnull
provincestr | nullnull
status"available" | "overlaps_live" | "excluded" | nullnull
limitint25
offsetint0
lang"en" | "fr""en"
call_tool {"name": "transit_list_national_agencies", "arguments": {}}
transit_search_routesRoutes 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
Parameters of transit_search_routes
ParameterTypeDefault
agencystrrequired
querystr | nullnull
route_typeint | nullnull
limitint20
lang"en" | "fr""en"
call_tool {"name": "transit_search_routes", "arguments": {"agency": "…"}}
transit_search_stopsStops 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
Parameters of transit_search_stops
ParameterTypeDefault
agencystrrequired
querystr | nullnull
near_latitudefloat | nullnull
near_longitudefloat | nullnull
radius_mfloat500.0
limitint20
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.

3 tools

eps_get_last_load_dateReturn 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é
Parameters of eps_get_last_load_date
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "eps_get_last_load_date", "arguments": {}}
eps_list_occurrencesList 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
Parameters of eps_list_occurrences
ParameterTypeDefault
dataset"current" | "2023""current"
categorystr | nullnull
groupstr | nullnull
type_groupstr | nullnull
start_datestr | nullnull
end_datestr | nullnull
intersection_containsstr | nullnull
limitint50
offsetint0
lang"en" | "fr""en"
call_tool {"name": "eps_list_occurrences", "arguments": {}}
eps_summarize_occurrencesCount 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
Parameters of eps_summarize_occurrences
ParameterTypeDefault
dataset"current" | "2023""current"
group_by"category" | "group" | "type" | "month" | "intersection""category"
categorystr | nullnull
groupstr | nullnull
type_groupstr | nullnull
start_datestr | nullnull
end_datestr | nullnull
intersection_containsstr | nullnull
topint100
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').

3 tools

ets_get_service_alertsCurrent 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
Parameters of ets_get_service_alerts
ParameterTypeDefault
route_idstr | nullnull
stop_idstr | nullnull
limitint50
lang"en" | "fr""en"
call_tool {"name": "ets_get_service_alerts", "arguments": {}}
ets_get_stop_predictionsReal-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
Parameters of ets_get_stop_predictions
ParameterTypeDefault
stop_idstr | nullnull
route_idstr | nullnull
include_pastboolfalse
limitint50
lang"en" | "fr""en"
call_tool {"name": "ets_get_stop_predictions", "arguments": {}}
ets_get_vehicle_positionsLive 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
Parameters of ets_get_vehicle_positions
ParameterTypeDefault
route_idstr | nullnull
limitint50
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.

1 tool

epcor_get_daily_water_qualityDaily-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
Parameters of epcor_get_daily_water_quality
ParameterTypeDefault
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.

12 tools

ckan_describe_resourceList 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
Parameters of ckan_describe_resource
ParameterTypeDefault
portal"federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina"required
resource_idstrrequired
sheetstr | nullnull
lang"en" | "fr""en"
call_tool {"name": "ckan_describe_resource", "arguments": {"portal": "…", "resource_id": "…"}}
ckan_get_datasetGet 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
Parameters of ckan_get_dataset
ParameterTypeDefault
portal"federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina"required
dataset_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "ckan_get_dataset", "arguments": {"portal": "…", "dataset_id": "…"}}
ckan_get_organization_or_groupGet 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
Parameters of ckan_get_organization_or_group
ParameterTypeDefault
portal"federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina"required
kind"organization" | "group"required
collection_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "ckan_get_organization_or_group", "arguments": {"portal": "…", "kind": "…", "collection_id": "…"}}
ckan_get_resourceGet 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
Parameters of ckan_get_resource
ParameterTypeDefault
portal"federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina"required
resource_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "ckan_get_resource", "arguments": {"portal": "…", "resource_id": "…"}}
ckan_list_groupsList 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
Parameters of ckan_list_groups
ParameterTypeDefault
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_licensesList 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
Parameters of ckan_list_licenses
ParameterTypeDefault
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_organizationsList 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
Parameters of ckan_list_organizations
ParameterTypeDefault
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_portalsList 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
Parameters of ckan_list_portals
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "ckan_list_portals", "arguments": {}}
ckan_list_tagsList 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
Parameters of ckan_list_tags
ParameterTypeDefault
portal"federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina"required
querystr | nullnull
lang"en" | "fr""en"
call_tool {"name": "ckan_list_tags", "arguments": {"portal": "…"}}
ckan_read_resourceRead 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
Parameters of ckan_read_resource
ParameterTypeDefault
portal"federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina"required
resource_idstrrequired
sheetstr | nullnull
header_rowint | nullnull
header_rowsint1
filtersdict[str, str] | nullnull
containsstr | nullnull
columnslist[str] | nullnull
limitint100
offsetint0
lang"en" | "fr""en"
call_tool {"name": "ckan_read_resource", "arguments": {"portal": "…", "resource_id": "…"}}
ckan_search_datasetsSearch 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
Parameters of ckan_search_datasets
ParameterTypeDefault
portal"federal" | "on" | "bc" | "ab" | "qc" | "nt" | "yt" | "montreal" | "toronto" | "regina"required
querystr""
fqstr | nullnull
rowsint10
startint0
sortstr | nullnull
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.

6 tools

socrata_get_datasetGet 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
Parameters of socrata_get_dataset
ParameterTypeDefault
portal"ns" | "nb" | "calgary" | "edmonton" | "winnipeg"required
dataset_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "socrata_get_dataset", "arguments": {"portal": "…", "dataset_id": "…"}}
socrata_list_categoriesList 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
Parameters of socrata_list_categories
ParameterTypeDefault
portal"ns" | "nb" | "calgary" | "edmonton" | "winnipeg"required
lang"en" | "fr""en"
call_tool {"name": "socrata_list_categories", "arguments": {"portal": "…"}}
socrata_list_portalsList 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
Parameters of socrata_list_portals
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "socrata_list_portals", "arguments": {}}
socrata_list_tagsList 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
Parameters of socrata_list_tags
ParameterTypeDefault
portal"ns" | "nb" | "calgary" | "edmonton" | "winnipeg"required
lang"en" | "fr""en"
call_tool {"name": "socrata_list_tags", "arguments": {"portal": "…"}}
socrata_query_dataset_rowsQuery 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
Parameters of socrata_query_dataset_rows
ParameterTypeDefault
portal"ns" | "nb" | "calgary" | "edmonton" | "winnipeg"required
dataset_idstrrequired
selectstr | nullnull
wherestr | nullnull
orderstr | nullnull
qstr | nullnull
limitint10
offsetint0
lang"en" | "fr""en"
call_tool {"name": "socrata_query_dataset_rows", "arguments": {"portal": "…", "dataset_id": "…"}}
socrata_search_datasetsSearch 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
Parameters of socrata_search_datasets
ParameterTypeDefault
portal"ns" | "nb" | "calgary" | "edmonton" | "winnipeg"required
querystr""
categorystr | nullnull
tagstr | nullnull
limitint10
offsetint0
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.

4 tools

arcgis_hub_get_datasetGet 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
Parameters of arcgis_hub_get_dataset
ParameterTypeDefault
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_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "arcgis_hub_get_dataset", "arguments": {"portal": "…", "item_id": "…"}}
arcgis_hub_list_portalsList 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
Parameters of arcgis_hub_list_portals
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "arcgis_hub_list_portals", "arguments": {}}
arcgis_hub_query_feature_layerQuery 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
Parameters of arcgis_hub_query_feature_layer
ParameterTypeDefault
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_idstrrequired
layer_indexint | nullnull
wherestr | nullnull
out_fieldsstr"*"
order_bystr | nullnull
return_geometryboolfalse
limitint10
offsetint0
lang"en" | "fr""en"
call_tool {"name": "arcgis_hub_query_feature_layer", "arguments": {"portal": "…", "item_id": "…"}}
arcgis_hub_search_datasetsSearch 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
Parameters of arcgis_hub_search_datasets
ParameterTypeDefault
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
querystr""
tagstr | nullnull
item_typestr | nullnull
limitint10
offsetint0
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.

3 tools

opendatasoft_vancouver_get_datasetGet 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
Parameters of opendatasoft_vancouver_get_dataset
ParameterTypeDefault
dataset_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "opendatasoft_vancouver_get_dataset", "arguments": {"dataset_id": "…"}}
opendatasoft_vancouver_query_recordsQuery 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
Parameters of opendatasoft_vancouver_query_records
ParameterTypeDefault
dataset_idstrrequired
selectstr | nullnull
wherestr | nullnull
order_bystr | nullnull
querystr | nullnull
limitint10
offsetint0
lang"en" | "fr""en"
call_tool {"name": "opendatasoft_vancouver_query_records", "arguments": {"dataset_id": "…"}}
opendatasoft_vancouver_search_datasetsSearch 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
Parameters of opendatasoft_vancouver_search_datasets
ParameterTypeDefault
querystr""
limitint10
offsetint0
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.

3 tools

nl_opendata_get_datasetGet 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
Parameters of nl_opendata_get_dataset
ParameterTypeDefault
dataset_idstrrequired
lang"en" | "fr""en"
call_tool {"name": "nl_opendata_get_dataset", "arguments": {"dataset_id": "…"}}
nl_opendata_list_tagsList 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
Parameters of nl_opendata_list_tags
ParameterTypeDefault
lang"en" | "fr""en"
call_tool {"name": "nl_opendata_list_tags", "arguments": {}}
nl_opendata_search_datasetsSearch 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
Parameters of nl_opendata_search_datasets
ParameterTypeDefault
querystr""
dataset_type"all" | "tabular" | "spatial""all"
tag_idstr | nullnull
sort"name" | "released_desc" | "released_asc""name"
limitint10
offsetint0
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.

2 tools

reproduce_codeGet 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
Parameters of reproduce_code
ParameterTypeDefault
tool_namestrrequired
argumentsdictrequired
language"all" | "r" | "python" | "stata" | "julia" | "excel""all"
lang"en" | "fr""en"
call_tool {"name": "reproduce_code", "arguments": {"tool_name": "…", "arguments": "…"}}
reproduce_workbookGet 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
Parameters of reproduce_workbook
ParameterTypeDefault
tool_namestr | nullnull
argumentsdict | nullnull
rowslist[dict] | nullnull
titlestr | nullnull
max_rowsint2000
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.

1 tool

Always visible to the agent, so search_tools does not return it.

plan_queryPlan 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
Parameters of plan_query
ParameterTypeDefault
questionstrrequired
lang"en" | "fr""en"
call_tool {"name": "plan_query", "arguments": {"question": "…"}}