canada MCP server
Commit Oct 22, 2026Provides AI agents with structured access to Canadian federal, provincial, and municipal government data through 295 bilingual tools.
Also known as ReyemTech/mcp-canada
- Stars
- 62
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 22, 2026
- License
- MIT
What is canada MCP?
canada provides AI agents with structured access to Canadian federal, provincial, and municipal government data through 295 bilingual tools.
Summary generated from the project's README
About canada MCP server
Providing AI agents with structured access to Canadian federal, provincial, and municipal government data is what mcp-canada enables through 295 bilingual tools. Developers can integrate this server into various platforms including Claude Desktop, Cursor, VS Code, and Windsurf to retrieve information ranging from Bank of Canada exchange rates to Toronto municipal transit data. The server connects to 9 federal APIs, 9 provincial APIs, 2 municipal APIs, and a local SQLite datastore for persistent storage.
Users can manage large toolsets using BM25 search via the discover_tools command, which prevents context window exhaustion. The system supports complex workflows through orchestration tools like plan_query and execute_batch, allowing for parallel execution and multi-step reasoning. It provides access to over 80,000 open datasets, including weather conditions, immigration statistics, parliamentary debates, and food nutrition information. The implementation includes specialized modules for provinces like Alberta, British Columbia, and Quebec, utilizing technologies such as CKAN, ArcGIS Hub, and OGC WFS.
What you can do with it
- 1Analyze economic trendsAn agent can retrieve current exchange rates and inflation data from the Bank of Canada.
- 2Monitor public safetyA developer can build a tool to track food, vehicle, or health product recalls across Canada.
- 3Perform geospatial researchAn AI can query provincial geospatial data using WFS or ArcGIS Hub modules.
- 4Conduct legislative researchUsers can request summaries of parliamentary bills, MP votes, or Hansard debates.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablereyemtech/mcp-canada is public and reachablegithub.com/reyemtech/mcp-canada ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-22github.com/reyemtech/mcp-canada ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub295 tools, ~107 prompts, and ~141 resources across 9 federal APIs + 9 provincial APIs + 2 municipal APIs + 1 local SQLite datastore — exchange rates, parliamentary data, product recalls, drug information, 80K+ open datasets, food nutrition data, real-time weather, immigration statistics, Ontario provincial data, Toronto municipal data, York Region ArcGIS Hub data, British Columbia CKAN + WFS geospatial data, Quebec Données Québec CKAN + ArcGIS IQA data, Alberta open data + AER energy + WMBappServices wildfire + AHSGIS health + 511 Alberta transport, Manitoba geoportal (ArcGIS Hub) + 511 Manitoba transport, Saskatchewan geoportal (ArcGIS Hub) + WSA water infrastructure + SPSA fire bans, Nova Scotia Socrata SODA portal (data.novascotia.ca), New Brunswick federal-CKAN discovery + GeoNB bare ArcGIS Server geospatial data + gnb.socrata.com Socrata portal + key-gated 511 NB transport, and persistent local storage. All bilingual (English/French).
First ArcGIS Hub module — shared infrastructure in
shared/arcgis_hub.pyis reusable for future Canadian municipal modules (BC, Calgary, Edmonton, and other cities publishing via ArcGIS Hub). First OGC WFS module — BC introduces WFS 2.0 (OGC) support viashared/ogc.py, making WFS the third portal technology alongside CKAN and ArcGIS Hub. Seedocs://bc/wfs-query-guidefor the CKAN→WFS two-step workflow.
Quick Start
# Auto-configure your platform (interactive)
uvx mcp-canada install
# Or name platforms directly
uvx mcp-canada install claude-desktop cursor vscode
Supports 14 platforms: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Zed, Codex CLI, Gemini CLI, Amazon Q, OpenCode, Cline, Roo Code, Goose CLI, Junie CLI.
Manual Setup
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"mcp-canada": {
"command": "uvx",
"args": ["mcp-canada"]
}
}
}
claude mcp add mcp-canada -- uvx mcp-canada
git clone https://github.com/reyemtech/mcp-canada.git
cd mcp-canada
uv run mcp-canada
Options
| Flag | Description | Example |
|---|---|---|
--transport |
Transport protocol | --transport sse |
--port |
Port for SSE/HTTP | --port 8000 |
--modules |
Load only specific modules | --modules bank_of_canada,recalls |
--verbose |
INFO-level logging | --verbose |
--debug |
DEBUG-level logging | --debug |
Environment variable: MCP_CANADA_MODULES=bank_of_canada,recalls
Examples
See the documentation site for cross-API intelligence scenarios — from tracing prairie drought to the Canadian dollar, to building pharmaceutical safety audits, to assembling MP accountability briefs, to joining data from multiple APIs in a single SQL query. Each example includes the exact prompt and tool chain you can run today. The source remains in EXAMPLES.md.
How Discovery Works
With 250 tools, listing all of them would consume half an agent's context window. Instead, BM25 search lets agents find exactly what they need:
Agent: "What tools do you have for exchange rates?"
→ discover_tools("exchange rate CAD")
→ Returns: boc_get_exchange_rates, boc_get_observations
→ call_tool("boc_get_exchange_rates", {"currency": "USD", "recent": 3})
→ Returns: {"_meta": {...}, "data": [{"date": "2026-04-02", "value": 1.3918, ...}]}
Agents see 5 always-visible tools:
| Tool | Purpose |
|---|---|
discover_tools |
BM25 natural language search across all tools |
call_tool |
Execute any discovered tool by name |
list_modules |
List available API modules with tool counts |
plan_query |
Plan a multi-step query across Canadian government data APIs |
execute_batch |
Run multiple tool calls in parallel with per-step error isolation |
Modules
All tools accept lang: "en" | "fr" for bilingual support. Responses include a _meta envelope with source attribution and cache status. Browse the complete, searchable tool reference for current tool parameters and source APIs.
| Module | Level | Tools | Prompts | Resources | Description |
|---|---|---|---|---|---|
| Meta / Discovery | — | 5 | — | — | Always-visible orchestration tools (discover_tools, call_tool, list_modules, plan_query, execute_batch) |
| Bank of Canada | Federal | 8 | 5 | 7 | Exchange rates, interest rates, commodity prices, inflation — Valet API |
| CKAN Open Data | Federal | 7 | 5 | 7 | 80,000+ federal datasets — open.canada.ca |
| Drug Database | Federal | 8 | 5 | 7 | Drug products, ingredients, schedules — Health Canada DPD |
| IRCC Immigration | Federal | 10 | 5 | 7 | PR, study/work permits, Express Entry, asylum — IRCC Open Data |
| Nutrient File | Federal | 8 | 5 | 7 | Food nutrition data — Canadian Nutrient File |
| Open Parliament | Federal | 10 | 5 | 7 | Bills, MPs, votes, ballots, Hansard debates — Open Parliament API |
| Recalls & Safety | Federal | 6 | 4 | 6 | Food, vehicle, and health product recalls — Healthy Canadians |
| Statistics Canada | Federal | 15 | 6 | 8 | Time series, cube metadata, SDMX filtering — StatCan WDS |
| Weather | Federal | 34 | 6 | 8 | Conditions, climate, air quality, hydrology, marine, radar — MSC GeoMet |
| Alberta | Provincial | 24 | 6 | 7 | CKAN + AER energy + WMBappServices wildfire + AHSGIS health + 511 Alberta — open.alberta.ca |
| British Columbia | Provincial | 20 | 6 | 7 | CKAN + WFS geospatial — BC Data Catalogue |
| Manitoba | Provincial | 20 | 6 | 7 | ArcGIS Hub + 511 Manitoba — geoportal.gov.mb.ca |
| Saskatchewan | Provincial | 13 | 6 | 7 | ArcGIS Hub + WSA water + SPSA fire bans — geohub.saskatchewan.ca |
New Brunswick (new_brunswick/) |
Provincial | 22 | 6 | 7 | Federal CKAN + GeoNB bare ArcGIS Server + gnb.socrata.com Socrata + key-gated 511 NB transport — geonb.snb.ca |
| Nova Scotia | Provincial | 16 | 6 | 7 | Socrata SODA portal (aquaculture, environment, health) — data.novascotia.ca |
| Ontario | Provincial | 6 | 4 | 6 | 3,000+ provincial datasets — Ontario Open Data |
| Quebec | Provincial | 18 | 6 | 7 | Federated CKAN (139 orgs) — Données Québec |
| Toronto | Municipal | 12 | 6 | 8 | TTC, neighbourhoods, 311, RentSafe — Toronto Open Data |
| York Region | Municipal | 27 | 5 | 8 | 4 ArcGIS Hub portals (York Region, Markham, Newmarket, Aurora) |
| Local Datastore | Local | 6 | 4 | 6 | SQLite persistence for cross-API SQL JOINs — ~/.mcp-canada/datastore.db |
| Total | 295 | ~107 | ~141 |
Response Format
All tools return a consistent envelope:
{
"_meta": {
"source": {"api": "bank-of-canada-valet", "url": "https://..."},
"cached": true,
"lang": "en",
"timestamp": "2026-04-04T12:00:00Z"
},
"data": [ ... ]
}
Errors return:
{
"error": {
"code": "INVALID_SERIES",
"message": "Series 'FXXYZCAD' not found.",
"suggestions": ["FXUSDCAD", "FXEURCAD"]
}
}
Architecture
src/mcp_canada/
├── server.py # FastMCP entry point, transport, module loading
├── shared/ # Cross-module utilities
│ ├── cache.py # TTL-based in-memory cache (aiocache)
│ ├── envelope.py # Response/error envelope (make_response/make_error)
│ ├── http.py # Shared HTTP client with retry (tenacity)
│ ├── rate_limiter.py # Per-source token bucket
│ └── i18n.py # Bilingual error messages
├── meta/
│ └── list_modules.py # list_modules meta-tool
└── modules/
├── bank_of_canada/ # 8 tools — Valet API
├── open_parliament/ # 10 tools — Parliament API
├── recalls/ # 6 tools — Healthy Canadians API
├── drug_database/ # 8 tools — Health Canada DPD
├── ckan/ # 7 tools — Open Data Portal
├── nutrient_file/ # 8 tools — Canadian Nutrient File
├── datastore/ # 6 tools — local SQLite persistence
├── ircc/ # 10 tools — IRCC Immigration Open Data
├── ontario/ # 6 tools — Ontario Open Data Catalogue
├── toronto/ # 12 tools — City of Toronto Open Data Portal
├── york_region/ # 27 tools — York Region ArcGIS Hub (4 portals)
├── british_columbia/ # 20 tools — BC Data Catalogue + WFS
├── manitoba/ # 20 tools — geoportal.gov.mb.ca ArcGIS Hub + 511 Manitoba
├── saskatchewan/ # 13 tools — geohub.saskatchewan.ca ArcGIS Hub + WSA water + SPSA fire bans
├── quebec/ # 18 tools — Données Québec CKAN
├── alberta/ # 24 tools — open.alberta.ca CKAN + AER + WMB + AHSGIS + 511
├── nova_scotia/ # 16 tools — data.novascotia.ca Socrata SODA
├── statcan/ # 15 tools — Statistics Canada WDS + SDMX
└── weather/ # 34 tools — MSC GeoMet OGC API
├── current/ # 5 tools — realtime conditions, forecast, alerts
├── climate/ # 7 tools — daily/monthly/normals/trends
├── aqhi/ # 3 tools — air quality health index
├── hydro/ # 5 tools — water levels, flow, flood risk
├── marine/ # 3 tools — marine forecasts, hurricane tracks
├── severe/ # 3 tools — radar, lightning, UV index
├── snow/ # 2 tools — snow depth, snow water equivalent
├── collections/ # 2 tools — collection browser and direct query
└── summary/ # 4 tools — composite summary, extremes, growing season, degree days
Each module follows a 7-file pattern:
| File | Purpose |
|---|---|
__init__.py |
Module name and description |
constants.py |
Base URL, rate limits, cache TTLs, API mappings |
schemas.py |
Pydantic v2 response models (always flat) |
client.py |
Async HTTP functions with caching and rate limiting |
tools.py |
@tool decorated MCP tool functions |
prompts.py |
@prompt functions — guided workflows + quick lookups |
resources.py |
@resource functions — catalogs, docs, templates |
New modules are auto-discovered — drop a folder in modules/ and it registers via FileSystemProvider.
Development
# Install dependencies
uv sync
# Run tests (~2000 unit tests, ~15s)
uv run pytest
# Run integration tests against live APIs (~2min)
uv run pytest tests/integration/ -v -m integration --timeout=120
# Type check and lint
uv run pyright
uv run ruff check src/ tests/
# Coverage (must be ≥95%)
uv run pytest --cov=src/mcp_canada --cov-fail-under=95
Contributing
See CONTRIBUTING.md for setup, required checks, the module pattern, MCP integration tests, pagination and parameter contracts, and generated catalog updates. Every PR includes a checklist and receives check results and advisory review feedback; the maintainer decides what to merge.
Before submitting, run lint, type checks, unit tests with at least 95% coverage,
and uv run python scripts/generate_catalog.py --check. See
PR automation for maintainer setup.
Changelog
See CHANGELOG.md for version-by-version changes, or browse GitHub Releases.
Security
Found a vulnerability? Please do not open a public issue. Email contact@reyem.tech with details and reproduction steps. We support the latest minor version on PyPI.
Community
- Questions & ideas: GitHub Discussions
- Bugs & feature requests: GitHub Issues
- Contact: contact@reyem.tech
License
Data Attributions
Data from the following government sources is accessed by this library subject to their respective licences:
- Nova Scotia Open Data — Licensed under the Open Government Licence – Nova Scotia v1.1. Contains public sector information provided by the Province of Nova Scotia.
Star History
canada MCP questions
How do I find specific tools without listing all 295 of them?
The server uses BM25 natural language search via the discover_tools tool, allowing agents to find specific capabilities using keywords.
Does the server support multiple languages?
Yes, all tools are bilingual and support both English and French.