elections_candidates

The candidates and their parties in one electoral district, by district code or exact name. A miss returns not_found with up to five suggested districts. Use elections_results for votes.

Cost: 2 units of your allowance (see Rate limits).

ParametersCopy Anchor Link

• election_id (string, optional): min length 3, max length 20, default "2024-ge"
• district (string, required): min length 1, max length 80

RESTCopy Anchor Link

curl -X POST https://api.bcmcp.ca/v1/tools/elections_candidates \
  -H "Authorization: Bearer $BCDATA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"district":"..."}'

MCPCopy Anchor Link

Call the tool elections_candidates with these arguments. Over raw JSON-RPC:

curl -X POST https://api.bcmcp.ca/mcp \
  -H "Authorization: Bearer $BCDATA_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"elections_candidates","arguments":{"district":"..."}}}'

What comes backCopy Anchor Link

Every answer is the same envelope, over REST and over MCP: available, data, citations, freshness and notes. See Citations and freshness.