Skip to main content
Your AI assistant can use the NorthAxium Data MCP server to query Canadian government data in natural language — contracts, tenders, awards, lobbying, grants, contributions, parliamentary activity, building permits, and zoning — without writing a single API call.

Overview

The MCP (Model Context Protocol) server exposes 19 tools across 7 domains. Once connected, your AI assistant handles the reasoning while NorthAxium Data supplies the ground truth from primary government sources. There is currently one way to connect:
  • Claude Desktop (stdio) — runs locally using your Developer or Pro API key; available on Developer and Pro plans
Hosted SSE transport (for Claude.ai web and always-on agent frameworks) is coming for Pro tier. The stdio setup below works today with Claude Desktop.

Getting Started

MCP access requires a Developer or Pro plan. Sign up at northaxiumdata.ca to get your API key.

Prerequisites

  • Claude Desktop installed (Mac or Windows)
  • A Developer or Pro API key
  • Python 3.11+ installed locally

1. Get the server package

cd /path/to/NorthAxiumData/api
pip install -r requirements.txt
Contact support@northaxiumdata.ca if you need the NorthAxium Data MCP package or install instructions.

2. Add to Claude Desktop config

Open your Claude Desktop configuration file:
  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the NorthAxium Data server entry:
{
  "mcpServers": {
    "northaxium-data": {
      "command": "python3",
      "args": ["-m", "mcp_server.server"],
      "cwd": "/absolute/path/to/NorthAxiumData/api",
      "env": {
        "NORTHAXIUM_API_KEY": "your_api_key_here"
      }
    }
  }
}
Replace /absolute/path/to/NorthAxiumData/api with the full path to the api directory on your machine.
NORTHAXIUM_API_BASE_URL is optional. Leave it unset unless NorthAxium provides you a non-default API base URL.

3. Restart Claude Desktop

Quit Claude Desktop completely — do not just close the window — and relaunch it. The northaxium-data server should appear in the tools panel.

Troubleshooting

Tools not appearing — make sure you fully quit and relaunched Claude Desktop. A window close is not a restart.NORTHAXIUM_API_KEY not set — verify the env block is present in your Claude Desktop config and that the key is valid for a Developer or Pro plan.Authentication error — the MCP server authenticates against the live NorthAxium Data REST API over HTTPS. It does not connect directly to a hosted Postgres database.Import errors — run pip install -r requirements.txt again from inside the repo directory.

MCP Tools

Once connected, your AI assistant has access to 19 tools across 7 domains. Procurement
  • search_contracts — Search federal contracts by vendor, department, value range, and date. Returns paginated contract records from CanadaBuys and TBS.
  • search_vendors — Browse distinct vendor name strings to resolve ambiguous vendor names before profiling. Use before get_vendor_profile.
  • get_vendor_profile — Aggregated procurement profile for a named vendor: total contract value, top departments, contract count, and recent awards.
  • get_department_profile — Aggregated procurement profile for a federal department: total spend, top vendors, and event type breakdown.
  • search_tenders — Search federal tender notices — open and historical solicitations published on CanadaBuys. Use to find active procurement opportunities or to retrieve a solicitation_number for lifecycle tracing.
  • search_awards — Search federal award notices — announcements of intent to award a contract. Useful for early signal on who won a competition before the final contract is signed.
  • get_procurement_lifecycle — Return the full procurement lifecycle for a solicitation number: the tender, award notices, and awarded contracts all linked together. Use when you have a solicitation_number and want to trace the complete chain.
Grants
  • search_grants — Search across three grant datasets. Specify dataset: federal_grants (TBS), research_grants (NSERC/SSHRC), or infrastructure_projects (Infrastructure Canada).
  • search_grant_recipients — Browse distinct recipient name strings to resolve ambiguous institution names before profiling. Use before get_grant_recipient_profile.
  • get_grant_recipient_profile — Aggregated grants profile for a recipient: total value received, top funding departments, and recent grants.
Lobbying
  • search_lobbying — Search lobbying registrations — what organizations are registered to lobby, on what subjects, and targeting which institutions.
  • get_lobbying_communications — Search actual communication records: who lobbyists met with, when, and on what subject.
  • get_client_profile — Aggregated lobbying profile for a client organization: total communication count, top institutions lobbied, and top subject areas.
Contributions
  • search_contributions — Search Elections Canada reviewed political contributions by contributor name, party, year, province, and monetary amount.
Parliamentary
  • search_bills — Search parliamentary bills by keyword, session, status, sponsor, and sector tag.
  • search_politicians — Search current and historical MPs. Use to resolve a name to its slug before calling get_politician_profile.
  • get_politician_profile — Full politician profile: election history, committee memberships, lobbying interactions as a designated public office holder (DPOH), and bill sponsorships.
Permits
  • search_permits — Search building permits across 17 Canadian municipalities. Supports proximity search by latitude, longitude, and radius in kilometres.
Zoning
  • lookup_zone — Look up the zoning classification at a lat/lng coordinate. Returns zone code, zone description, zone category, municipality, and province. Available for: toronto, calgary, edmonton, vancouver, winnipeg, ottawa, mississauga, kitchener, hamilton, quebec_city.

Authentication

The MCP server authenticates using your NorthAxium Data API key. The server reads NORTHAXIUM_API_KEY from the local environment and uses it to call the live NorthAxium Data REST API over HTTPS. It does not connect directly to NorthAxium Postgres. MCP access is gated by plan:
TierMCP Access
Free
Developer ($29 CAD / mo)✅ stdio — Claude Desktop and compatible clients
Pro ($99 CAD / mo)✅ stdio + Hosted SSE (coming soon)
Enterprise✅ Hosted SSE + priority rate limits
If you don’t have an account, sign up at northaxiumdata.ca.

Example Usage

After connecting, try asking Claude questions like:
  • “What has Palantir lobbied for in Canada?”
  • “Who are the top vendors for the Department of National Defence by contract value?”
  • “What federal contracts has Shopify won?”
  • “Find all new construction permits in Calgary over $1M issued in the last year”
  • “What zone is 123 King Street West in Toronto?”
  • “Which companies are lobbying most actively on mining and natural resources?”
  • “Show me Mark Carney’s lobbying interactions as a DPOH before he entered politics”
  • “How much has the University of Toronto received in NSERC grants over the last 10 years?”
  • “Compare lobbying activity for the top three defence contractors”