trackmcp
Back to directory
ThreeFortyThree-Canada

elections-canada-mcp-server

View on GitHub

This Model Context Protocol (MCP) server provides access to Canadian federal election data. The server exposes resources and tools to query and analyze election results by riding, province, and party.

2 stars PythonSearch & Data Retrieval Updated Aug 25, 2025

Documentation

Elections Canada MCP Server

This is a Model Context Protocol (MCP) server that provides access to Canadian federal election data. It currently supports results from the 2021 and 2025 elections. Future updates will include past elections, census demographics, and ThreeFortyThree real-time projections.

Brought to you by ThreeFortyThree, this server powers ThreeFortyThree Chat and is available for use with MCP clients such as Claude Desktop.


🛠 Setup

Installation (via PyPI)

bash
uv pip install elections-canada-mcp-server

Usage with Claude Desktop

1. Make sure the server is installed:

bash
uv pip install elections-canada-mcp-server

2. Open your `claude_desktop_config.json` and add the following block:

uv

json
{
  "mcpServers": {
    "elections_canada_data_and_predictions": {
      "command": "{PATH_TO_UVX}",  // Replace with output of: which uvx
      "args": ["elections-canada-mcp"]
    }
  }
}

3. Restart Claude Desktop.

4. Now you can ask Claude questions such as:


    Local Development

    To test the server using MCP Inspector:

    1. Clone this repository:

    bash
    git clone https://github.com/ThreeFortyThree-Canada/elections-canada-mcp-server.git
       cd elections-canada-mcp-server

    2. Install MCP CLI:

    bash
    uv pip install mcp

    3. Test the server:

    bash
    mcp dev elections_canada_mcp/server.py

    This opens a web UI to test the server locally.


    🧰 Tools

    ToolDescriptionInputReturns
    `search_ridings`Search ridings by name (accent-insensitive)`search_term: str`List of matching ridings
    `get_party_votes`Get vote share in a riding (optionally by party)`riding_code: str, party_code: str (optional)`Votes and percentage
    `get_winning_party`Get the winning party in a riding`riding_code: str`Winning party
    `summarize_province_results`Province-wide summary of votes/seats`province_name_or_code: str`Party results
    `summarize_national_results`Canada-wide election summaryNational party results
    `find_closest_ridings`Find most competitive ridings`num_results: int, party: str (optional)`Closest margins
    `best_and_worst_results`Best/worst ridings for a party`party: str, num_entries: int`4-category performance summary

    📚 Resources

    ResourceURI
    All ridings`elections-canada://ridings`
    Single riding`elections-canada://riding/{riding_code}`
    Province`elections-canada://province/{province_code}`

    📌 Province Codes

    AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT

    📌 Party Codes

    LPC, CPC, NDP, BQ, GPC, PPC


    📄 License

    This project is licensed under the MIT License.

    © ThreeFortyThree Canada – threefortythree.ca

    Frequently asked questions

    What is elections-canada-mcp-server?

    elections-canada-mcp-server is This Model Context Protocol (MCP) server provides access to Canadian federal election data. The server exposes resources and tools to query and analyze election results by riding, province, and party.

    How do I install elections-canada-mcp-server?

    Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

    Is elections-canada-mcp-server open source?

    Yes — it is hosted on GitHub at https://github.com/ThreeFortyThree-Canada/elections-canada-mcp-server and has 2 stars.

    Related MCP tools

    Run your own MCP server? See who uses it and what to fix.

    Measure it with TrackMCP