MapleStats MCP
MapleStats MCP lets an AI agent plan, discover, and retrieve citable Canadian open data from many official sources.
Use
plan_queryto turn a Canada-related question into an ordered multi-source data plan, including local portals and caveats.Use
search_toolsto find the right data tool from 462 tools across 90 modules, in English or French.Use
call_toolto run tools against Statistics Canada, Bank of Canada, CMHC, federal/provincial/territorial/municipal open data, international sources, transit, wildfire, electricity, housing, health, labour, and more.Get official values with citations, provenance, quality flags, licence/commercial-use terms, caveats, freshness, and gap handling.
Check cited figures with
check_answerand generate reproducible R, Python, Stata, Julia, or Excel Power Query code/workbooks withreproduce_codeandreproduce_workbook.Perform cross-series calculations such as ratios, rankings, CAGR, and count changes with
calc_*tools.Use a read-only server locally over stdio or hosted over HTTP, with bilingual English/French support.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MapleStats MCP Get Canada's inflation rate from StatCan and generate Python code to plot it"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MapleStats MCP gives AI agents (Claude, Cursor and any MCP client) typed access to Canadian open data through one server: Statistics Canada (tables, Census, public use microdata), the Bank of Canada, CMHC, federal agencies, and federal, provincial, territorial and municipal open-data portals, in English and French. Every figure comes back with its citation, its quality flags and its licence, so an answer built on it can be traced to the publisher and checked.
MapleStats MCP donne aux agents IA un accès structuré aux données ouvertes canadiennes par un seul serveur, en français et en anglais. Chaque chiffre revient avec sa citation, ses indicateurs de qualité et sa licence.
Provenance and accountability
Every figure comes with its citation. A Statistics Canada value carries its table and vector, reference period, release date, unit and scale, geography and a link to the table's page; a Bank of Canada value, its series id and the Valet URL. Every result's
provenanceblock names the source, the exact URL and the time of the query. Results are brief by default (the values, citation, flags, caveats and limits, long row lists as CSV text);detail="full"oncall_toolreturns the completeprovenanceblock and every field.Quality flags are kept. StatCan's "use with caution" and "too unreliable to be published", preliminary and revised stay on each value; public microdata tabulations give a CV and a quality grade per cell where the survey's user guide sets one; staff forecasts are marked as forecasts.
Gaps are named, not filled. When a figure is not published or a period is not released yet, the server says so and points to the closest published figure. A date range that stops before the newest data gets a note that newer data exist.
Answers can be checked.
check_answerre-reads the StatCan and Bank of Canada figures an answer cites and reports only the problems.reproduce_codewrites the R, Python, Stata or Julia script (or Excel Power Query) that pulls the same data straight from the publisher, andreproduce_workbookgives the rows.Licences travel with the data. Each result carries the publisher's licence, where it has one, and whether it allows commercial use (
provenance.commercial_use; the AESO's market data, for one, arenot_allowed).StatCan's data and its documentation. Besides tables and vectors, the server reaches definitions, methods and analysis (
statcan_reference_*), the survey directory and IMDB metadata (statcan_surveys_*), PUMF codebooks and user guides (statcan_pumf_*), The Daily's articles and release tables (statcan_daily_*) and classifications (rdaas_*).Measured. On the 53 questions of the Maple Test, MapleStats answered 91.8% correctly over three runs (November 3, 2026), with no false claims and no invented StatCan table or vector ids. Fifty-three questions are few, part of them were chosen from what MapleStats covers, and later MapleStats runs are in-sample (details).
Related MCP server: mcp-statscan
Why MapleStats
Built by a statistician, for anyone who works with the numbers: economists, demographers, policy analysts, researchers, journalists, students, anyone who needs a Canadian figure they can trust and cite. MapleStats is designed around the mistakes people actually make with official data, and we test it against other tools on public benchmarks: see how it does.
It knows the traps. Constant vs current dollars, family vs individual income, annual average vs December over December, survey rent vs listing rent: it warns in plain language, and each fitness-for-use caution rests on the publisher's own documentation.
It says when data do not exist. A series that is not published, a period not released yet or a date with no data gets a plain no, and the nearest figure that does exist.
The answer can be checked. Before replying, the assistant can send the StatCan and Bank of Canada figures it cites to
check_answer, which re-reads them from the source.Your work stays reproducible. It writes the R, Python, Stata or Julia script, or the Excel query, that pulls the same data from the source.
Quality flags and revisions, shown: "use with caution", "too unreliable to be published", preliminary and revised are spelled out on every StatCan value.
It only reads, in English and French. The server only reads from public sources. The scripts it writes run only if you run them (the full-table ones then save the download under
data/raw/), and saving a workbook to disk is opt-in (MAPLE_EXPORT_DIR, on a local server).
Project vision: docs/PROJECT_GUIDE.md.
Source coverage: docs/ROADMAP.md.
Website: https://maplestats.danielstats.io/.
The easiest way: ask your agent
Copy this prompt.
Paste it into Claude Code, Codex, Cursor or any agent that can run commands on your computer.
Restart the agent when it says so, then ask for data.
Connect the MapleStats MCP server to this agent. Follow the setup steps in https://github.com/dsanchezp18/maplestats-mcp
Instructions for the agent doing the setup
The default is the hosted server: nothing to install, no account, no key.
Register this remote (HTTP) MCP server under the name
maplestats:Claude Code:
claude mcp add --transport http --scope user maplestats https://mcp.maplestats.danielstats.io/mcpCodex CLI:
codex mcp add maplestats --url https://mcp.maplestats.danielstats.io/mcpCursor, Claude Desktop and other
mcpServersclients: add the entry below to the client's config file (Cursor:~/.cursor/mcp.json; Claude Desktop:~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS,%APPDATA%\Claude\claude_desktop_config.jsonon Windows), keeping any servers already there.claude.ai and the Claude phone app: on the web, open Settings → Connectors → Add custom connector, name it
MapleStats, and enterhttps://mcp.maplestats.danielstats.io/mcp. Then switch it on from the tools menu in a chat, on the web or in the phone app. Claude asks for approval before each call by default; every tool is read-only, so set them to always allow in the connector's tool permissions.ChatGPT (web): turn on Settings → Security and login → Developer mode, then create a developer-mode app for a remote MCP server with the same address and No Authentication. Every tool is read-only, so ChatGPT should not ask to confirm calls. OpenAI documents this feature for the web.
A whole organization: on Claude Team or Enterprise, an Owner adds it once under Organization settings → Connectors → Add custom connector, and each member then connects it. On ChatGPT Business, Enterprise or Edu, an admin turns on Developer mode (Workspace Settings → Permissions & Roles → Connected Data), creates the app, and publishes it (Workspace settings → Apps → Drafts → Publish). The hosted server is shared and limits each client to 60 requests a minute, so a large organization should run its own copy.
VS Code: the same entry under a
serverskey, with"type": "http", in.vscode/mcp.json.
{ "mcpServers": { "maplestats": { "url": "https://mcp.maplestats.danielstats.io/mcp" } } }Tell the user to restart or reload the client, then check that the
search_toolstool is listed.Only if the client cannot use remote servers, or the user wants everything kept on their own machine, run it locally instead:
claude mcp add --scope user maplestats -- uvx maplestats-mcp(needs uv), or the equivalentuvx maplestats-mcpentry for other clients (see Install).
Each client gets 60 requests a minute. Your agent's tool calls (a search phrase, a table number) reach the server and its host, Microsoft Azure (Canada Central). The code keeps no log of them, but its in-memory cache can hold a search phrase or filter in a key or a response until the entry expires or the server restarts. Check Microsoft's terms and privacy statement; for full privacy, run it locally. What it logs: FAQ. Other clients: the Connect page.
Teach your agent to use it well
skills/maplestats/SKILL.md is a portable
instruction file (Agent Skills format) for Claude Code, Codex, Cursor and
similar agents: start with plan_query, ask for the latest periods, read
the caveats, cite table, vector and release date, and run check_answer
before answering. Copy it into your agent's skills folder or project
instructions. It works with the hosted server and with a local one.
Clients for R, Python and Julia
To call the hosted server from a script, with no agent in between, use the
small clients in clients/r,
clients/python and
clients/julia. Each returns a data frame with
its citation. They are not on CRAN, PyPI or the Julia registry yet; each
README gives the command to install from GitHub.
docs/clients.md explains the design.
Install locally (optional)
Prefer to run it on your machine? It works over stdio with no account or key.
uvx maplestats-mcp # run without installing
uv tool install maplestats-mcp # or install the command once (pip works too)
uv tool upgrade maplestats-mcp # updateFor the development version: uv tool install git+https://github.com/dsanchezp18/maplestats-mcp.git.
If you installed the command, use "command": "maplestats-mcp" with no
args in the JSON above. On Windows, make sure the directory where uv
installs tools is on PATH, and restart the client afterwards.
Using it
Tools are found through search rather than listed flat: call
search_tools with a plain-language query (English or French), then
call_tool with the name it returns.
{"name": "search_tools", "arguments": {"query": "consumer price index"}}
{"name": "call_tool", "arguments": {"name": "wds_search_cubes", "arguments": {"query": "consumer price index"}}}plan_query turns a question into an ordered, multi-source plan, and
reproduce_code writes the R, Python, Stata or Julia script (or an Excel
Power Query) that fetches the same data straight from the source;
reproduce_workbook returns the rows as a formatted Excel workbook.
Before replying with figures, the assistant can call check_answer with the
StatCan and Bank of Canada figures it cites: it re-reads them from the source
and returns only the problems (a different value, a missed scale factor, a
newer period, another geography, an unadjusted series), each with a fix.
The calc_ tools do the arithmetic across series that assistants get wrong,
from StatCan and Bank of Canada series, and return the formula and every
input's citation with the result: calc_ratio (one series over another,
aligned by period, scale factors applied), calc_rank (places ranked for one
period, ties shared), calc_cagr (compound annual growth between two periods)
and calc_count_changes (how many times a series moved, such as policy rate
decisions). Mismatched frequencies or units are refused, not guessed.
Every tool accepts lang: "en"|"fr";
some sources only publish English content (for example Yukon's CKAN portal,
the World Bank's indicator definitions and the PMPRB), so there lang
changes the labels MapleStats adds, not the source's own text. Every response
has a provenance block: source, URL, query time, freshness and limits.
Through call_tool results are brief by default: values, periods, unit and
scale, the citation, status flags, caveats, limits, licence and URL, with a
list of six or more rows sent as one CSV text block ({"format": "csv", "csv": ...}) and the boilerplate (query time, cache flag, schema name,
freshness, the reproduce hint) left out. Pass detail="full" for every field
and the whole provenance block, rows as JSON objects. reproduce_code and
reproduce_workbook always read the full result.
docs://catalogue describes every module in both languages. The guided
prompts take lang too, and each docs://<module>/... resource has a French
twin at docs://<module>/fr/... (for example docs://statcan/fr/pieges).
To call the sources from Python without MCP, see docs/library.md.
What to watch for
MapleStats retrieves data directly from the original sources and returns
values as published. When a result is trimmed, scaled, cleaned or computed,
it says so in its provenance block or its notes; series values come
unscaled, with the scale factor beside them. When a source is down or blocks
the request, the tool returns an error, not a silent gap or a substitute
value.
The risk is in the use. An AI assistant can pick the wrong table, geography
or reference period, and the answers, summaries and analysis it writes are
AI-generated and can contain errors. For anything you would publish,
spot-check a few figures against the source's own site and use
reproduce_code to fetch them again outside the assistant. Publishers revise
their figures, so a value retrieved today can differ from an earlier one.
Each dataset keeps its own licence and attribution terms, shown in the
result's provenance; credit the publisher, not MapleStats. MapleStats is an
independent project, not affiliated with or endorsed by Statistics Canada,
the Bank of Canada, CMHC or any other data provider. It is provided as is,
depends on upstream services that can change or go offline, and is not
professional, legal or financial advice. Parts of the code and tests were
written with AI assistance; the discovery benchmark's questions were
written by one AI session and reviewed by a second, independent one, not yet
by a person
(tests/discovery_benchmark/REVIEW.md).
What it covers
463 tools in 90 modules. Read docs://catalogue (or docs_read_resource through call_tool) for the full, bilingual list.
Area | Tool prefixes | Covers |
Statistics Canada |
| Tables and series, the extra SDMX spaces (energy information, shared data), classifications, Census Profiles 2001–2021, public use microdata (codebooks, weighted tables, standard errors where the survey's guide gives a method, the LFS included; SAS, SPSS and Stata files read), merchandise trade by commodity (CIMT), open databases (LODE), The Daily and the tables inside each release as first published, delta files, indicators, surveys, census geography |
Bank of Canada |
| Valet series, groups, observations |
CMHC |
| Housing Market Information Portal and Excel data tables |
Federal agencies |
| Weather, climate and gridded climate projections, pollutant releases and emissions (NPRI, GHGRP, NAPS), corporations and IP, regulations, recalls, dairy, animal disease, consumer banking, federal and provincial fiscal tables, health, drugs, natural health products, medical devices, adverse reactions, pesticides, spending, federal contracts, grants and travel and hospitality disclosures, energy, energy use by sector (NRCan, to 2023), mineral production, oceans, commercial fisheries landings, grain, forestry, immigration and application processing times, Job Bank wages and outlooks by occupation, registered charities, mobile and Internet plan prices, border wait times, customs tariff rates, budgets, mergers, elections, earthquakes, university-library data tables, First Nation profiles, registered population and drinking water advisories |
Wildland fire |
| NRCan's Canadian Wildland Fire Information System (satellite hotspots, fire danger, weather stations), burned areas, and Alberta Wildfire's live fire status |
Electricity |
| IESO (Ontario) demand, generation and prices; Hydro-Québec demand, generation and trade (CC BY-NC 4.0: credit Hydro-Québec, non-commercial use only); AESO (Alberta) hourly, daily and monthly pool prices, load and current generation by fuel (AESO terms: non-commercial use only); Ontario Energy Board datasets |
Parliament and elected officials |
| MPs and their roles, party standings, Cabinet, Senate votes; elected officials and districts for a postal code via Open North's Represent (unofficial) |
Provincial agencies |
| Alberta Energy Regulator (well licences, production, ST98 energy outlook), BC Geographic Warehouse, BC Stats Excel tables, BC environmental monitoring (air quality, snow, groundwater, streamflow), BC lobbyists registry, DriveBC road events, Alberta Economic Dashboard, Open Alberta files, Institut de la statistique du Québec, the Newfoundland and Labrador, Yukon and Northwest Territories statistics bureaus, provincial general election results (Quebec, Alberta, British Columbia, Saskatchewan, Manitoba), Ontario's municipal Financial Information Return (every schedule of every municipality, 2000 on) |
Housing (links only) |
| Links, release timing and terms for CREA's MLS® Home Price Index; no values, because CREA's terms allow private, non-commercial analysis only |
International |
| World Bank World Development Indicators for Canada and peer countries (CC BY 4.0); Bank for International Settlements statistics: policy rates, debt service ratios, credit, house prices, banking and payment statistics (free reuse with citation); OECD Data Explorer for Canada and its peers: Economic Outlook projections, productivity, unit labour costs, PPPs, tax revenue, house prices, leading indicators (any use with credit, third-party data excepted); Eurostat for the EU, the euro area and member states (CC BY 4.0, not commercially for non-EU countries' data); ILOSTAT, the International Labour Organization's internationally comparable labour statistics for Canada and its peers: unemployment, participation, hours, earnings, minimum wages and ILO modelled estimates (CC BY 4.0); the Australian Bureau of Statistics' headline inflation, labour force, GDP, wage and population series, each with the Canadian table to pair with, and any ABS dataset by SDMX key (CC BY 4.0); the UK Office for National Statistics' headline inflation, GDP and labour market series, each with the Canadian table to pair with (Open Government Licence v3.0); US Federal Reserve Board releases: the federal funds rate, Treasury yields, the Canadian dollar per US dollar, industrial production and capacity utilization, money and credit (public domain, Board cited); European Central Bank Data Portal: key interest rates, €STR, euro reference rates (EUR/CAD), euro area HICP, money and credit (free reuse with 'Source: ECB statistics', third-party data excepted) |
Open-data portals |
| Federal, provincial, territorial and municipal catalogues ( |
Other municipal |
| Vancouver, Newfoundland and Labrador, Edmonton police, transit and water quality, BC Transit real-time vehicle positions, arrival predictions and service alerts, City of Toronto neighbourhood profiles, RentSafeTO building scores, short-term rental registrations and DineSafe inspections |
Transit schedules |
| Static GTFS timetables of the STM (buses), OC Transpo, Calgary Transit, VIA Rail, GO Transit, UP Express, the BC Transit systems and the Quebec networks listed on Données Québec (exo, RTC, STL, STS and others), plus further agencies from Statistics Canada's 2025 Canadian Public Transit Network Database: stops, routes, scheduled departures, frequency by hour |
Other federal series (CRA, OSFI, ISED insolvency) are ordinary
open.canada.ca datasets, reachable with
ckan_search_datasets(portal="federal", fq="organization:<org>").
Not covered: CAPP's Statistics Handbook, Petrinex and Payments Canada were
not built, because their terms or download hosts do not permit automated
access. CanadaBuys, OpenParliament.ca and the Toronto Transit Commission's
own schedule download were removed for the same reason (the TTC schedule is
still served from Statistics Canada's national transit database). The City
of Whitehorse's open data files are not built: its terms bar commercial
reproduction without the City's written consent. The City of Toronto's
files (as opposed to its DataStore tables) are not read: its portal's robots.txt
disallows automated file downloads. The
City of Hamilton's portal is left out because it answers automated requests
with a Cloudflare challenge (Niagara Open Data did too until 2026-11-08, and is
now covered). The 2006-2016 census data tables and the 2016 Census Profile service were removed because Statistics Canada's www12 host answers automated clients with a bot challenge, 503 errors or timeouts (the 2021 profile and the WDS tables remain, and statcan_census_profile_archive_* still lists the links to the 2001-2016 Census Profile bulk files without opening them). Justice Laws (federal statutes and
regulations) is out of scope, because legislation text is not data this
server carries, and the Saskatchewan Bureau of Statistics' Provincial
Economic Accounts were not built: they are under Crown copyright, for
non-commercial reuse only, and the site's terms bar automated access. The
roadmap
records each decision.
Development
uv sync # install
uv run ruff check src tests scripts # lint
uv run ruff format src tests scripts # format
uv run pyright # type check
uv run pytest # unit tests (mocked, no network).\scripts\verify.ps1 runs that gate plus every scripts/smoke_test*.py
against the live APIs. The website is generated from the tool registry:
uv run python scripts/build_site.py writes build/site/. See
AGENTS.md
for the contributor guide and how to add a source module.
Hosting
MAPLE_TRANSPORT=http MAPLE_HOST=0.0.0.0 MAPLE_PORT=8000 uv run maplestats-mcp
serves HTTP instead of stdio. Docker Compose does the same in Docker, but the
image and docker-compose.yml set MAPLE_REQUIRE_AUTH=1, so the server refuses to
start until MAPLE_AUTH_TOKEN is set:
MAPLE_AUTH_TOKEN=<a long random string> docker compose up --build. Clients
then send that token as a bearer token. Docker is optional and unnecessary on
a personal computer. If the server is exposed beyond your machine, set
MAPLE_AUTH_TOKEN and keep MAPLE_REQUIRE_AUTH=1. GET /health reports uptime and version. GET /stats
is public, needs no token and reports calls per tool name and day, each tool's
p50 and p95 duration, and each upstream host's error counts and circuit-breaker
state (see MAPLE_USAGE_STATS and MAPLE_BREAKER below). After repeated
failures (timeouts, connection errors, 5xx answers, Cloudflare challenges) a
host is paused for a cooldown: its tools fail at once with an "unavailable"
error that says when to retry, instead of waiting for another timeout. The
docs://status resource lists the paused hosts.
Env var | Default | Purpose |
|
|
|
|
| HTTP bind address |
| unset, | Bearer token required on |
|
| Per-client rate limit |
|
| In-flight request cap; the excess waits 5 s, then gets 503 |
|
| In-flight requests one client (IPv6: one /64) may hold; past it, 429. Leave off where many people share an address |
| unset | TLS in-process |
|
| Rate-limit on |
|
| Proxies that append to |
| project website, localhost | Browser origins allowed on |
|
| Response cache size per TTL bucket |
|
| Estimated memory cap for the response cache, all buckets together |
|
| Threads for parsing Excel and CSV files, and the time one parse may take |
|
| Longest a tool call may run |
|
| Pause requests to an upstream host after repeated failures; |
|
| Failures in a row, within the window, that pause a host, and how long before one probe request is sent |
|
|
|
|
|
|
|
|
|
| system temp, | Downloaded microdata cache; use a persistent volume when hosted |
| unset | Header the outermost proxy sets to the caller's own address (Cloudflare's |
| unset | Memory limit for DuckDB queries over downloaded files (patents, open databases, microdata), such as |
| system temp ( | Where DuckDB spills past its memory limit (each query in its own subfolder, removed when it ends), and the most one query may spill |
|
|
|
| system temp, | Where StatCan open-database (LODE) archives are unpacked, and the size cap (least recently used files go first); use a persistent volume when hosted |
|
| Largest open-database archive one call may download; |
| system temp, | CIPO patent table cache |
| system temp | Customs Tariff editions as Parquet (under 1 MB each, newest 12 kept) |
| system temp, | Ontario FIR years kept as Parquet (about 3 MB each); use a persistent volume when hosted |
| unset (no files saved) | Folder where |
|
|
|
|
| Byte budget for one tool result (minimum 10,000); a larger result has its biggest lists trimmed, and |
| unset | With both set (an https GoatCounter site and an API token allowed to record pageviews), each counted tool call is also sent there as the event |
|
| The |
| unset | Token served as plain text at |
|
| Counts calls and durations per tool name and UTC day, each failure's error code ( |
| unset | A JSON file the |
|
| How much of a Delta File one |
| system temp | Saved Delta File resume points (a few MB per day); |
License
MIT. Third-party notices are in THIRD_PARTY_NOTICES.md.
Security and conduct
Report a vulnerability privately through GitHub's
private vulnerability reporting;
see SECURITY.md. Changes are recorded in
CHANGELOG.md, and community expectations in
CODE_OF_CONDUCT.md.
Acknowledgments
MapleStats owes its architecture to EcuDataMCP, the MCP server for Ecuador's open data that I help maintain with DweskZ and its other contributors. Its approach to Canadian data owes much to the R developers who got there first: Jens von Bergmann (mountainMath) and his co-authors, including Dmitry Shkolnik (dshkol), Thierry Warin (statcanR), Valentin Lucet (rgovcan), and others. Thanks to them, and to everyone who publishes Canadian data in the open.
For other ways to get Canadian data, see the alternatives.
Available Tools
3 toolscall_toolRun a Canadian data toolARead-onlyIdempotentInspect
Run one Canadian data tool (Statistics Canada, Bank of Canada, CMHC, provincial and city sources) found through search_tools or plan_query.
Use for: executing a tool by exact name with arguments that match the
arguments search_tools returned for it. Data tools read public sources
(StatCan, Bank of Canada, open-data portals). reproduce_workbook can save
an Excel file on a local stdio server; hosted exports return base64. Returns that
tool's result. detail is "brief" by default: values, periods, units and
scale, members, the citation, status flags, caveats and limits, with a
list of six or more rows written as CSV text ({"format": "csv", "csv": ...}),
and provenance cut to source, URL, licence and caveats. Pass
detail="full" for every field and the full provenance block (query time,
freshness, schema), with rows as JSON objects.
Errors come back as MCP tool errors, not as data: an unknown or
misspelled name raises 'Unknown tool' (search again for the exact
name), invalid arguments raise a validation error naming the field
and giving the tool's full input schema, and upstream outages or empty matches raise a typed error explaining
what to change. search_tools, call_tool and plan_query cannot be called
through it; call them directly. Tool calls are subject to the server's
timeout (MAPLE_TOOL_TIMEOUT_SECONDS, default 120).
Inputs: name (required), detail, arguments.
plan_queryPlan queryARead-onlyIdempotentInspect
Plan how to answer a question about Canadian data from official sources.
Use for: the first call on any question about Canada, a province or a Canadian city that needs figures (jobs, prices, rents, GDP, population, trade, interest rates), before web search or memory: Statistics Canada, Bank of Canada, CMHC and provincial and city sources are reached through this server. For example: "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 (a question written in French gets them in French too); 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.
Inputs: question (required), lang. Returns: places, topics, guidance, question, +3 more
search_toolsSearch Canadian data toolsARead-onlyIdempotentInspect
Search Canadian official data: Statistics Canada, Bank of Canada, CMHC, provincial statistics agencies, federal departments and city portals.
Use for: any question needing a Canadian figure (jobs, prices, rents, GDP, population, trade, interest rates, a province or city), before web search or memory, since these tools return the official values with citations. Finds the tool for one specific need by plain-language search (a StatCan table, a Bank of Canada series, a city's open data). Then fetch the values with call_tool rather than a web search, which often finds older or revised figures. Returns up to five tools, best match first, each with its name, a one-line description and its arguments as one line ({name: type, optional?: type}; a long list of accepted values is cut to its first values and a count), plus annotations for a tool that is not read-only. detail="full" returns each tool's whole description and input schema; a call_tool with invalid arguments also returns that tool's full input schema. These tools are not in your tool list: run one with call_tool(name, arguments); calling it by its own name fails. Read-only; it searches this server's catalogue only and calls no external API. Use plan_query instead when a question may span several sources or you do not know where to start; use call_tool to run a tool once you have its name. Queries in English or French both work. An empty result means no tool matched: rephrase with topic words (e.g. 'housing starts' rather than 'CMHC table').
Inputs: query (required), detail. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools form a clear loop: search_tools finds one tool, plan_query maps a multi-source question, call_tool executes. search_tools and plan_query do overlap conceptually, but the descriptions draw an explicit boundary ('narrow, single-source need' vs 'may span several sources'). The main residual risk is an agent picking search_tools when plan_query would serve better, though the guidance mitigates it.
All three names follow the same verb_noun snake_case convention: search_tools, plan_query, call_tool. No casing or style drift, and the verbs accurately signal the action.
Three tools is minimal but exactly right for a gateway/meta-server whose real surface lives in a hidden catalogue. Each tool earns its place (discover, plan, execute) with no filler. It sits at the low end, so slightly thin rather than a perfect score.
The discover-plan-execute loop covers the Canadian-data domain end to end, and errors, detail levels, and provenance are handled. The notable gap is that plan_query emits ordered multi-tool steps but there is no batch executor, so agents must chain call_tool manually; there is also no way to browse the catalogue without a query.
Maintenance
Related MCP Connectors
Curated gateway to snapshot-versioned Canadian public data services with source provenance.
Access Statistics Canada data via the Web Data Services API
StatCan MCP — Statistics Canada (StatCan) via the Web Data Service (WDS). Free, no auth. Fills the…
Statistics Canada (StatCan) WDS MCP — Canadian official statistics (no auth)
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to search, explore, and analyze Québec open data (Données Québec, Ville de Montréal, IGO) via natural language, including SQL queries, geocoding, and spatial operations.1MIT
- AlicenseNot gradedqualityFmaintenanceProvides access to Statistics Canada official statistics without authentication, enabling AI agents to query Canadian economic and demographic data.4 npmMIT
- AlicenseAqualityDmaintenanceProvides LLM agents with live access to Canadian economic and financial data (exchange rates, interest rates, inflation, etc.) through the Bank of Canada Valet API, with no API key required.105MIT
- AlicenseAqualityDmaintenanceMCP server serving official statistics from major data agencies (Statistics Canada, FRED, BLS, World Bank, etc.) as tools with provenance and verification, enabling search, retrieval, analysis, and monitoring via natural language.1157 npmMIT