maplestats-mcp

<p align="center">
  <img src="https://raw.githubusercontent.com/dsanchezp18/maplestats-mcp/main/site/assets/logo.svg" width="160" height="160" alt="MapleStats MCP logo: a white pixel maple leaf over the name maplestats-mcp on a red square">
</p>
<p align="center">
  <h1 align="center">MapleStats MCP</h1>
  <p align="center">
    <strong>One MCP server for Canadian open data.</strong>
  </p>
  <p align="center">
    <a href="https://pypi.org/project/maplestats-mcp/"><img src="https://img.shields.io/pypi/v/maplestats-mcp" alt="PyPI version"></a>
    <a href="https://pypi.org/project/maplestats-mcp/"><img src="https://img.shields.io/pypi/pyversions/maplestats-mcp" alt="Supported Python versions"></a>
    <a href="https://github.com/dsanchezp18/maplestats-mcp/blob/main/LICENSE"><img src="https://img.shields.io/github/license/dsanchezp18/maplestats-mcp" alt="License: MIT"></a>
    <a href="https://pypistats.org/packages/maplestats-mcp"><img src="https://img.shields.io/pypi/dm/maplestats-mcp" alt="PyPI downloads per month"></a>
    <a href="https://github.com/dsanchezp18/maplestats-mcp/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/dsanchezp18/maplestats-mcp/ci.yml?branch=main&label=CI" alt="CI status"></a>
    <a href="https://dsanchezp18.github.io/maplestats-mcp/"><img src="https://img.shields.io/github/actions/workflow/status/dsanchezp18/maplestats-mcp/pages.yml?branch=main&label=website" alt="Website build status"></a>
    <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a>
    <a href="https://m8ven.ai/mcp/dsanchezp18/maplestats-mcp"><img src="https://m8ven.ai/badge/mcp/dsanchezp18/maplestats-mcp" alt="M8ven Score"></a>
    <a href="https://glama.ai/mcp/servers/dsanchezp18/maplestats-mcp"><img src="https://glama.ai/mcp/servers/dsanchezp18/maplestats-mcp/badges/score.svg" alt="MapleStats MCP server quality and maintenance score on Glama"></a>
    <a href="https://smithery.ai/servers/dsanchezp998/maplestats-mcp"><img src="https://img.shields.io/badge/Smithery-listed-FF5601" alt="Listed on Smithery"></a>
    <a href="https://registry.modelcontextprotocol.io/?q=io.github.dsanchezp18/maplestats-mcp"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fregistry.modelcontextprotocol.io%2Fv0%2Fservers%2Fio.github.dsanchezp18%252Fmaplestats-mcp%2Fversions%2Flatest&query=%24.server.version&label=MCP%20Registry&prefix=v&color=blue" alt="MCP Registry version"></a>
  </p>
</p>

<!-- mcp-name: io.github.dsanchezp18/maplestats-mcp -->

MapleStats MCP gives AI agents (Claude, Cursor, and any MCP-compatible
client) structured, typed access to Canadian open data through a
single server — covering Statistics Canada (tables, Census and public use
microdata), the Bank of Canada, CMHC, federal agencies, and federal,
provincial, territorial and municipal open-data portals, in English and
French.

*MapleStats MCP donne aux agents IA (Claude, Cursor et tout client
compatible MCP) un accès structuré et typé aux données ouvertes
canadiennes par l'entremise d'un seul serveur — couvrant Statistique
Canada, la Banque du Canada, ainsi que des portails CKAN fédéraux,
provinciaux, territoriaux et municipaux vérifiés.*

See [`PROJECT_GUIDE.md`](https://github.com/dsanchezp18/maplestats-mcp/blob/main/PROJECT_GUIDE.md) for the project vision and
[`ROADMAP.md`](https://github.com/dsanchezp18/maplestats-mcp/blob/main/ROADMAP.md) for source coverage status.

## The easiest way: ask your agent

1. Copy this prompt.
2. Paste it into Claude Code, Codex, Cursor or any agent that can run
   commands on your computer.
3. Restart the agent when it says so, then ask for data.

> Install the MapleStats MCP server and connect it to this agent. Follow the setup steps in https://github.com/dsanchezp18/maplestats-mcp

Prefer to do it by hand? See [Install locally](#install-locally-no-docker-required)
or the [Connect](https://dsanchezp18.github.io/maplestats-mcp/connect.html) page.

### Instructions for the agent doing the setup

1. Make sure [uv](https://docs.astral.sh/uv/) is installed (`uv --version`).
   If it is missing, install it with the official installer from that page.
2. Use this launch command, which fetches the release from PyPI the first
   time and reuses it afterwards: `uvx maplestats-mcp`.
3. Register it with the client you are running in, under the name
   `maplestats`:
   - **Claude Code:** `claude mcp add --scope user maplestats -- uvx maplestats-mcp`
   - **Codex CLI:** `codex mcp add maplestats -- uvx maplestats-mcp`
   - **Cursor, Claude Desktop and other `mcpServers` clients:** add the
     entry below to the client's config file (Cursor: `~/.cursor/mcp.json`;
     Claude Desktop: `~/Library/Application Support/Claude/claude_desktop_config.json`
     on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows),
     keeping any servers already there.
   - **VS Code:** the same entry under a `servers` key (not `mcpServers`)
     in `.vscode/mcp.json`.

   ```json
   {
     "mcpServers": {
       "maplestats": {
         "command": "uvx",
         "args": ["maplestats-mcp"]
       }
     }
   }
   ```
4. The server speaks MCP over stdio and needs no API key, account or open
   port. Tell the user to restart or reload the client, then check that
   the `search_tools` tool is listed.

More clients and hosting options: [Connect](https://dsanchezp18.github.io/maplestats-mcp/connect.html).

## Bilingual by design / Conçu pour être bilingue

Tools accept `lang: "en"|"fr"`, several sources are French-first
or French-only (Quebec's and Montreal's CKAN catalogues, `ckan_*` with `portal="qc"`/`"montreal"`),
and tool discovery works in either language: every tool's docstring
carries both a `Keywords:` line and a `Mots-clés :` line, so calling
`search_tools` with a French-language query (e.g. *"recherche de
jeux de données sur le climat"*) finds the same tools an equivalent
English query would. Read `docs://catalogue` for a bilingual
(EN/FR) one-line description of every module. Not every underlying
government portal is itself bilingual — see each module's own
docstring (or `docs://catalogue`) for where `lang` genuinely changes
the response versus where it is a documented no-op on a monolingual
source.

*Chaque outil accepte `lang : "en"|"fr"`, plusieurs sources sont
francophones ou exclusivement en français (les catalogues CKAN du Québec
et de Montréal, `ckan_*` avec `portal="qc"`/`"montreal"`), et la découverte d'outils
fonctionne dans les deux langues : chaque outil porte à la fois une
ligne `Keywords:` et une ligne `Mots-clés :`, de sorte qu'un appel à
`search_tools` avec une requête en français trouve les mêmes outils
qu'une requête équivalente en anglais. Consultez `docs://catalogue`
pour une description bilingue (EN/FR) de chaque module. Tous les
portails gouvernementaux sous-jacents ne sont pas eux-mêmes
bilingues — consultez la documentation de chaque module (ou
`docs://catalogue`) pour savoir où `lang` change réellement la
réponse et où il s'agit d'un no-op documenté sur une source
unilingue.*

## Status

About 200 tools across these sources (run `docs://catalogue` for a
bilingual one-line description of each module):

| Area | Tool prefixes | Covers |
|---|---|---|
| Reproduction code | `reproduce_code` | R, Python, Stata or Julia code that fetches the same data from the source (cansim, canivt, polars, TidierFiles, import delimited) |
| Query planner | `plan_query` | Always visible: turns a question into an ordered, multi-source plan with caveats on combining sources |
| Statistics Canada | `wds_`, `sdmx_`, `rdaas_`, `statcan_*` | Public use microdata files (find, list downloads, read codebooks and weights without downloading the ZIP, weighted tables with DuckDB), 2006-2016 census data tables (CSV, SDMX, Beyond 20/20 with a canivt route), tables and series, classifications (e.g. NAICS), 2001–2021 Census Profiles, The Daily, indicators, daily bulk-update files, definitions/methods and analysis catalogues, survey directory and IMDB metadata, census geography, SDG hub |
| Bank of Canada | `boc_` | Valet series, groups, observations |
| CMHC | `cmhc_`, `cmhc_dt_` | Housing Market Information Portal tables; Excel data tables |
| ECCC / MSC | `eccc_` | Weather, climate, hydrometric, air quality (OGC API) |
| ISED | `ised_corporations_`, `ised_spectrum_`, `ised_cipo_` | Federal corporations, spectrum licences, trademarks |
| Canada Gazette | `gazette_` | Part I notices and proposed regulations, Part II registered regulations: issues, notice lists, notice text (EN/FR) |
| Vehicle recalls | `tc_recalls_` | Transport Canada motor vehicle safety recalls by make, model and year, with bilingual details |
| Dairy supply management | `cdc_` | Canadian Dairy Commission: special milk class component prices since 2002, butter support price, national total quota, Harmonized Milk Classification System, milk production by province and milk class sales (EN/FR); provincial marketing boards checked and routed to StatCan tables |
| Animal disease | `cfia_` | CFIA federally reportable terrestrial animal diseases: yearly counts 2011 to now, each confirmed detection with date, province and species (chronic wasting disease, scrapie, bovine TB, BSE, cysticercosis), and every avian influenza infected premises since December 2021 with status by province (EN/FR); rabies, aquatic diseases and food testing via `ckan_` |
| Recalls and safety alerts | `recalls_` | Health Canada, CFIA and Transport Canada recalls and alerts (recalls-rappels.canada.ca): search, counts by year or category, affected products and lots (EN/FR) |
| Consumer banking products | `fcac_` | FCAC comparison tools: credit cards (annual fees, purchase, cash advance and balance transfer rates, rewards, insurance) and chequing and savings accounts (monthly fees, transactions, interest tiers, NSF and other fees) by p