{en}Connect{fr}Connexion{/}

{en}Connect MapleStats to your agent{fr}Connecter MapleStats à votre agent{/}

{en}The easiest way is to let your agent do it: paste one prompt and it installs the server and connects it. If you would rather do it yourself, it takes two steps by hand. Either way there is no account and no API key.{fr}Le plus simple est de laisser votre agent s'en charger : collez une requête, il installe le serveur et le connecte. Si vous préférez le faire vous-même, il suffit de deux étapes. Dans les deux cas, ni compte ni clé d'API.{/}

{en}The easiest way: ask your agent{fr}Le plus simple : demandez à votre agent{/} {en}The agent reads the setup steps from the repository, installs uv if it is missing, adds MapleStats to its own settings and tells you when to restart.{fr}L'agent lit les étapes d'installation dans le dépôt, installe uv s'il manque, ajoute MapleStats à ses propres réglages et vous dit quand redémarrer.{/}

{{agent_prompt}}

{en}Copy the prompt.{fr}Copiez la requête.{/}
{en}Paste it into Claude Code, Codex, Cursor or any agent that can run commands on your computer.{fr}Collez-la dans Claude Code, Codex, Cursor ou tout agent qui peut exécuter des commandes sur votre ordinateur.{/}
{en}Restart the agent when it says so, then ask for data.{fr}Redémarrez l'agent quand il vous le dit, puis demandez des données.{/}

{en}Or set it up by hand{fr}Ou installez-le vous-même{/}

{en}Install uv{fr}Installer uv{/}

{en}uv runs Python tools without a separate install step. Skip this if uv --version already works.{fr}uv exécute des outils Python sans étape d'installation distincte. Passez cette étape si uv --version fonctionne déjà.{/}

macOS, Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows PowerShell

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

{en}Add the server to your client{fr}Ajouter le serveur à votre client{/}

{en}Pick your client. Each entry runs uvx maplestats-mcp, which fetches the latest release the first time and reuses it afterwards.{fr}Choisissez votre client. Chaque entrée exécute uvx maplestats-mcp, qui télécharge la dernière version la première fois, puis la réutilise.{/}

{en}Before the first PyPI release, the package is only on GitHub. Replace uvx maplestats-mcp with uvx --from git+{{repo}} maplestats-mcp (in JSON, "args": ["--from", "git+{{repo}}", "maplestats-mcp"]).{fr}Avant la première version sur PyPI, le paquet n'est offert que sur GitHub. Remplacez uvx maplestats-mcp par uvx --from git+{{repo}} maplestats-mcp (en JSON : "args": ["--from", "git+{{repo}}", "maplestats-mcp"]).{/}

{en}Ask a question{fr}Poser une question{/}

{en}Restart the client if it was open, then ask for data. Naming the source is optional; asking for citations makes the agent quote each provenance block. For eight worked examples, from census microdata to credit-card pricing, see the case studies.{fr}Redémarrez le client s'il était ouvert, puis demandez des données. Nommer la source est facultatif; demander des citations amène l'agent à citer chaque bloc de provenance. Pour huit exemples complets, des microdonnées du recensement au prix des cartes de crédit, consultez les études de cas.{/}

{en}What was the year-over-year change in Canada's consumer price index last month? Cite the table.{fr}Quelle a été la variation sur 12 mois de l'indice des prix à la consommation le mois dernier? Citez le tableau.{/}
{en}Compare the average rent of a two-bedroom apartment in Calgary and Edmonton since 2020, using CMHC data.{fr}Comparez le loyer moyen d'un appartement de deux chambres à Calgary et à Edmonton depuis 2020, avec les données de la SCHL.{/}
{en}Using the Labour Force Survey public use microdata, estimate the employment rate by province, with its survey weights.{fr}Avec les microdonnées à grande diffusion de l'Enquête sur la population active, estimez le taux d'emploi par province, avec les poids d'enquête.{/}
{en}Quel est le taux directeur de la Banque du Canada, et depuis quand est-il à ce niveau?{fr}What is the Bank of Canada's policy rate, and how long has it been at that level?{/}

{en}Other ways to install{fr}Autres façons d'installer{/}

{en}Install the command once{fr}Installer la commande une fois{/}

{en}If you prefer a fixed install to uvx, install the command and point your client at maplestats-mcp directly.{fr}Si vous préférez une installation fixe à uvx, installez la commande et indiquez directement maplestats-mcp à votre client.{/}

{en}Terminal{fr}Terminal{/}

# {en}with uv (upgrade later with: uv tool upgrade maplestats-mcp){fr}avec uv (mise à jour : uv tool upgrade maplestats-mcp){/}
uv tool install maplestats-mcp

# {en}or with pip{fr}ou avec pip{/}
pip install maplestats-mcp

# {en}or the development version, from GitHub{fr}ou la version de développement, depuis GitHub{/}
uv tool install git+{{repo}}.git

{en}Hosting{fr}Hébergement{/}

{en}Run it as an HTTP server{fr}L'exécuter comme serveur HTTP{/}

{en}For a shared deployment, set the transport to HTTP. If the server is reachable beyond your machine, set a bearer token and require it. GET /health reports uptime and version and skips authentication.{fr}Pour un déploiement partagé, passez le transport en HTTP. Si le serveur est accessible au-delà de votre machine, définissez un jeton porteur et exigez-le. GET /health indique la durée de fonctionnement et la version, sans authentification.{/}

{en}Terminal{fr}Terminal{/}

MAPLE_TRANSPORT=http MAPLE_HOST=0.0.0.0 MAPLE_PORT=8000 \
MAPLE_AUTH_TOKEN="$(openssl rand -hex 32)" MAPLE_REQUIRE_AUTH=1 \
uvx maplestats-mcp

{en}Variable{fr}Variable{/}	{en}Default{fr}Défaut{/}	{en}Purpose{fr}Rôle{/}
`MAPLE_TRANSPORT`	`stdio`	{en}`stdio` for local clients, `http` for hosting{fr}`stdio` pour les clients locaux, `http` pour l'hébergement{/}
`MAPLE_HOST`, `MAPLE_PORT`	`127.0.0.1`, `8000`	{en}HTTP bind address{fr}Adresse d'écoute HTTP{/}
`MAPLE_AUTH_TOKEN`	{en}unset{fr}non défini{/}	{en}Bearer token required on `/mcp` when set{fr}Jeton porteur exigé sur `/mcp` s'il est défini{/}
`MAPLE_REQUIRE_AUTH`	`0`	{en}Refuse to start without a token when `1`{fr}Refuse de démarrer sans jeton si `1`{/}
`MAPLE_RATE_LIMIT_REQUESTS`, `MAPLE_RATE_LIMIT_WINDOW_SECONDS`	`120`, `60`	{en}Per-client sliding-window rate limit{fr}Limite de débit par client, sur fenêtre glissante{/}
`MAPLE_MAX_CONCURRENT_REQUESTS`	`8`	{en}In-flight MCP requests; extra requests wait up to 5 s, then get HTTP 503{fr}Requêtes MCP simultanées; les suivantes attendent jusqu'à 5 s, puis reçoivent HTTP 503{/}
`MAPLE_TOOL_TIMEOUT_SECONDS`	`120`	{en}Longest a tool call may run before it fails with a named error{fr}Durée maximale d'un appel d'outil avant une erreur nommée{/}
`MAPLE_CACHE_MAX_ENTRIES`	`2000`	{en}Entries per cache bucket in memory{fr}Entrées par compartiment du cache en mémoire{/}
`MAPLE_PUMF_CACHE_DIR`, `MAPLE_PUMF_CACHE_MAX_GB`	{en}system temp, `5`{fr}dossier temporaire, `5`{/}	{en}Where downloaded microdata is kept, and its size cap{fr}Emplacement des microdonnées téléchargées et taille maximale{/}
`MAPLE_IP_HORIZONS_CACHE_DIR`, `MAPLE_IP_HORIZONS_CACHE_MAX_GB`	{en}system temp, `3`{fr}dossier temporaire, `3`{/}	{en}Where CIPO patent tables are kept as Parquet, and the size cap{fr}Emplacement des tableaux de brevets de l'OPIC en Parquet et taille maximale{/}
`MAPLE_SSL_CERTFILE`, `MAPLE_SSL_KEYFILE`	{en}unset{fr}non défini{/}	{en}Terminate TLS in the server process{fr}Terminaison TLS dans le processus du serveur{/}
`MAPLE_TRUST_PROXY_HEADERS`	`0`	{en}Key rate limits on `X-Forwarded-For`; enable only behind a proxy that sets it{fr}Limites de débit selon `X-Forwarded-For`; à activer seulement derrière un mandataire qui le définit{/}

{en}Troubleshooting{fr}Dépannage{/}

{en}When something does not connect{fr}Quand la connexion échoue{/}

{en}The client cannot find uvx{fr}Le client ne trouve pas uvx{/}: {en}Desktop apps do not always read your shell's PATH. Use the full path from which uvx (macOS, Linux) or where uvx (Windows) as the command, then restart the client.{fr}Les applications de bureau ne lisent pas toujours le PATH de votre terminal. Utilisez le chemin complet donné par which uvx (macOS, Linux) ou where uvx (Windows) comme commande, puis redémarrez le client.{/}
{en}A microdata or patent call times out{fr}Un appel de microdonnées ou de brevets expire{/}: {en}The first statcan_pumf_tabulate call on a file downloads it, which can take a minute or two; later calls use the cache. Raise MAPLE_TOOL_TIMEOUT_SECONDS if your connection is slow.{fr}Le premier appel de statcan_pumf_tabulate sur un fichier le télécharge, ce qui peut prendre une minute ou deux; les appels suivants utilisent le cache. Augmentez MAPLE_TOOL_TIMEOUT_SECONDS si votre connexion est lente.{/}
{en}The agent does not use the tools{fr}L'agent n'utilise pas les outils{/}: {en}Check that the client lists three MapleStats tools: plan_query, search_tools and call_tool. The rest are found through search, so they do not appear in the client's tool list.{fr}Vérifiez que le client affiche trois outils MapleStats : plan_query, search_tools et call_tool. Les autres sont trouvés par la recherche; ils n'apparaissent donc pas dans la liste d'outils du client.{/}