FAQ and licences
Questions people ask
Short answers about your queries, the data and what you may do with it. Last updated 8 October 2026.
Privacy and hosting
Does MapleStats save my queries?
No. The code stores no queries, has no accounts and sends nothing to any analytics service.
The one thing it keeps is a count of how many times each tool has run, by the tool's name, the day and whether the call worked; the counts sit in memory and are public at /stats on the hosted server. The server does see the tool calls your AI agent makes, such as a search phrase or a table number, because it has to run them, but never your conversation, and it writes none of them down: its console log shows start-up messages and, over HTTP, the method, path and status of each request, never what is in them. This is about the code; if you use the hosted server, read the answer on it below.
Two things are kept to save time: an in-memory copy of recent responses, gone when the server stops, and the microdata files, patent tables and StatCan open-database files that some tools download, kept in cache folders you choose. Neither holds your questions. On your own machine, reproduce_workbook also saves the Excel workbooks you ask for, in your Downloads folder unless you choose another.
Who sees my questions, then?
Your AI assistant handles your conversation under its own privacy policy. When a tool runs, the publisher's service, such as Statistics Canada, the Bank of Canada or a city's portal, sees that request and the address it comes from, as with any web page. If you use the hosted endpoint, the server and its host, Render, are on that path too. MapleStats itself stores nothing.
Is there a hosted MapleStats I can connect to?
Yes. A public endpoint runs at https://maplestats-mcp.onrender.com/mcp, with no account or API key. It is a free instance: a ping every 10 minutes keeps it awake, so cold starts are rare, but the first request after an idle spell can take up to a minute. Each client is limited to 60 requests a minute, and the public use microdata tabulation tool (statcan_pumf_tabulate) is switched off there because it downloads whole files. For those, or for anything you would rather keep on your own machine, run MapleStats locally.
On the hosted endpoint your tool calls do reach the server, since it has to run them. The server code does not store or log them: its access log records the method, path and status of each request, not what is in it, the usage counts hold tool names only (never arguments or client addresses), and the rate limiter keeps a client's address in memory for a minute to count requests. Render, the host, keeps its own request logs under its own terms, so read Render's terms and privacy policy before you rely on it. If you want full privacy, run MapleStats locally: then nothing leaves your computer except the requests to the publishers.
The data
How fresh is the data?
It comes live from the publisher, kept for a short time in memory. Each result says where it came from, when it was queried and any limits, in its provenance block.
Does MapleStats respect publishers' terms?
Yes. Before a source is added, its terms of use are read, and a source whose terms ban automated use is left out.
Some useful portals are therefore not covered. Examples are Canada's Business Registries, SEDAR+, Payments Canada and CAPP's Statistics Handbook, whose terms forbid automated tools, scraping or bulk use. Petrinex's public oil and gas data is not built either, because the host that serves its downloads does not permit automated access. Some sources were removed after a later review of their terms: CanadaBuys procurement data, OpenParliament.ca and the Toronto Transit Commission's own schedule download; the Saskatchewan GeoHub portal was also removed. Justice Laws (federal statutes and regulations) is out of scope, because legislation text is not data this server carries. The Saskatchewan Bureau of Statistics' Provincial Economic Accounts are not built: the tables could be fetched, but they are under Crown copyright for non-commercial reuse only and the site's terms bar automated access, which a public server cannot keep to. The Toronto Transit Commission's schedule is still available from Statistics Canada's national transit database. Sites that block automated requests are also left alone. Each skipped source and the reason are recorded in the roadmap. Where a source asks for credit or a notice, the result's provenance block names the publisher so you can give it.
Can I check a number without trusting the agent?
Yes, for most data calls. Ask for the script: reproduce_code writes R, Python, Stata or Julia code, or an Excel Power Query, that fetches the same data straight from the source, and every result names its source with a link. reproduce_workbook returns the data as a formatted Excel workbook.
Using it
Which AI tools work with it?
Any client that speaks MCP, including Claude, Codex, Cursor, VS Code and ChatGPT in developer mode. The Connect page has the steps.
Something is wrong or missing. What do I do?
Open an issue on GitHub with the question and the source URL from the result. The Contribute page explains what helps most.
Licences and reuse
MapleStats MCP is independent. It is not affiliated with or endorsed by Statistics Canada, the Bank of Canada, CMHC or any government.
The code
The server, the scripts and the source of this website are under the MIT licence. You may use, copy, change and share them, including commercially, if you keep the licence notice. The notices of the two projects whose layout and middleware informed this one are in THIRD_PARTY_NOTICES.md.
The data
The MIT licence covers the code, not the data. The data belongs to the agencies and portals that publish it, and their terms apply to it. Many publish under an open government licence, such as the Open Government Licence – Canada or the Statistics Canada Open Licence, but the terms differ by publisher and dataset, and a few sources carry their own conditions: Hydro-Québec's electricity data is CC BY-NC 4.0 (credit Hydro-Québec, non-commercial use only), IESO requires its copyright notice, Elections Quebec, Elections Alberta and the Parliamentary Budget Officer allow non-profit or non-commercial reuse only, and some Government of Canada pages fall under the Canada.ca terms, which allow non-commercial reproduction with the title, author and source URL. The World Bank's indicators are CC BY 4.0. The Canadian Real Estate Association's terms allow private, non-commercial analysis only and require its written consent to publish its figures, so its MLS® Home Price Index comes back as links, not values. The STL's Laval bus schedule bars commercial use without its written permission, and Open North's Represent data on elected officials has no verified licence. Each result's provenance block names the publisher and links to the source, so you can read the terms that apply before you reuse a number. Where the licence is known, the block also carries it in a licence field: every Statistics Canada result, for instance, carries the attribution the Statistics Canada Open Licence asks for.
Crediting
When you publish a number, credit the publisher named in the result, not MapleStats. A mention of MapleStats as the route you took is welcome.
Questions
If something here is unclear or you want to do something it does not cover, open an issue on GitHub.