canada-parliament-mcp-server
An MCP server that provides tools to track Canadian federal parliamentary records, including searching and retrieving details on House and Senate bills, MPs, House votes, and Hansard speeches using public sources like LEGISinfo and OpenParliament.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://canada-parliament.caseyjhand.com/mcpWhat you can do with it
- Search for federal bills by title, number, or sponsor
- Retrieve detailed dossiers for specific House or Senate bills
- Find information on current and former Members of Parliament
- Search and read indexed House Hansard speeches
Source and maintenance
Community listingRegistry 0.2.1
- Maintenance checked
Protocol and capabilities
- Server
- canada-parliament-mcp-server 0.2.1
- MCP protocol
- 2025-06-18
- Tools
- 8 advertised
- Resources
- 1 advertised
- Resource templates
- 1 advertised
- Prompts
- 0 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"logging": {},
"prompts": {
"listChanged": true
},
"resources": {
"subscribe": true,
"listChanged": true
},
"extensions": {
"io.modelcontextprotocol/skills": {
"directoryRead": true
}
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
8 advertised
canparl_search_bills — Canparl Search Bills
Advertised read-onlyOpen-world
Find House and Senate bills in one session by title, number, type, chamber, status, or indexed MP sponsor. Sponsor results are the OpenParliament-indexed subset; fetch a bill for its sponsor, stages, divisions, and statute citation. Omitted session means the verified current official session. Follow nextOffset with identical filters.
canparl_search_bills input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 10000,
"minimum": 1,
"description": "Maximum rows, default 10, effective cap 100; values through 10000 are accepted and clamp with a notice. Whole records may end the page early at the 24000-byte response budget; follow nextOffset."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset in the selected ordering."
},
"status": {
"type": "string",
"description": "Official bill status from canparl_list_reference topic bill_statuses."
},
"session": {
"anyOf": [
{
"type": "string",
"pattern": "^\\s*(?:[0-9]+-[0-9]+\\s*)?$",
"description": "Parliament-session token, such as 45-1."
},
{
"type": "object",
"required": [
"parliament",
"session"
],
"properties": {
"session": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive session number.",
"exclusiveMinimum": 0
},
"parliament": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive parliament number.",
"exclusiveMinimum": 0
}
},
"description": "Parliament and session numbers.",
"additionalProperties": false
}
],
"description": "Parliamentary session; omitted means current."
},
"sponsor": {
"type": "string",
"description": "MP OpenParliament slug or politician path/HTTPS URL (member.slug from canparl_get_member, or an includeFormer canparl_search_members row), or a current MP's official personId; Senators are not indexed. A digit-only value equal to a current personId, or its /politicians/<digits>/ path or profile URL, is read as that personId."
},
"billCode": {
"type": "string",
"pattern": "^\\s*(?:(?:[Bb][Ii][Ll][Ll]\\s+)?[CcSs][-\\u0020\\u00A0\\u1680\\u2000-\\u200A\\u202F\\u205F\\u3000\\u2010-\\u2015\\u2212]?[1-9][0-9]*[A-Za-z]?\\s*)?$",
"description": "Exact bill code, including a split-bill suffix letter such as C-15A; accepts bill s321, S321, S 321, or S-321."
},
"billType": {
"type": "string",
"description": "Official bill type from canparl_list_reference topic bill_types."
},
"titleContains": {
"type": "string",
"description": "Literal substring of any English or French long or short title; matching ignores case, accents, dash and quote styles, and repeated whitespace."
},
"originatingChamber": {
"type": "string",
"description": "House, House of Commons, or Senate; case-insensitive."
}
},
"additionalProperties": false
}canparl_search_bills output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"session",
"total",
"bills",
"pagination",
"sponsorCoverage",
"provenance",
"appliedFilters",
"totalCount",
"shown",
"cap",
"truncated"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Effective page limit after the per-call cap.",
"exclusiveMinimum": 0
},
"bills": {
"type": "array",
"items": {
"type": "object",
"required": [
"session",
"billCode",
"longTitle",
"shortTitle",
"billType",
"originatingChamber",
"status",
"latestMajorStage",
"royalAssentDate",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Absolute HTTPS official bill URL."
},
"status": {
"type": [
"string",
"null"
],
"description": "Official status wording, or null."
},
"session": {
"type": "string",
"description": "Verified parliament-session token."
},
"billCode": {
"type": "string",
"description": "Canonical House or Senate bill code."
},
"billType": {
"type": [
"string",
"null"
],
"description": "Official bill type, or null."
},
"longTitle": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Official long titles.",
"additionalProperties": false
},
"shortTitle": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Official short titles.",
"additionalProperties": false
},
"royalAssentDate": {
"type": [
"string",
"null"
],
"description": "Royal assent as a UTC instant ending in Z (YYYY-MM-DDTHH:MM:SS[.fraction]Z), converted from LEGISinfo's Ottawa-time clock, or null; the time of day is LEGISinfo's recorded time, which can differ from when assent was signified. A value in another shape is relayed as published."
},
"latestMajorStage": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"chamber"
],
"properties": {
"name": {
"type": [
"string",
"null"
],
"description": "Latest completed major stage name, or null."
},
"chamber": {
"anyOf": [
{
"enum": [
"House",
"Senate"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Chamber of the latest completed major stage, or null; royal assent is reported as Senate."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Latest completed major stage, or null."
},
"originatingChamber": {
"anyOf": [
{
"enum": [
"House",
"Senate"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Originating chamber, or null."
}
},
"description": "Official bill summary.",
"additionalProperties": false
},
"description": "Matching official bills ordered by chamber prefix, number, then split-bill suffix letter."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"unknown_session",
"invalid_bill_filter",
"sponsor_not_found",
"sponsor_scan_incomplete",
"upstream_blocked"
],
"description": "Machine-readable failure mode. Declared by this tool: `unknown_session`: Session with a zero or out-of-range number, or absent from the official bill session index. `invalid_bill_filter`: Unrecognized chamber, type, or status, or a malformed sponsor slug. `sponsor_not_found`: Sponsor slug has no profile of its own, or a current personId has no unique verified OpenParliament profile. `sponsor_scan_incomplete`: The bounded ten-page sponsor scan still has a continuation. `upstream_blocked`: An official parliamentary source refuses the request with HTTP 403. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of bills in this page."
},
"total": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Exact matching count after all filters and before pagination."
},
"notice": {
"type": "string",
"description": "Limit clamp, coverage, empty-result, past-end, or response-budget guidance."
},
"session": {
"type": "string",
"description": "Verified official parliament-session token."
},
"truncated": {
"type": "boolean",
"description": "Whether more matching bills remain after this page."
},
"pagination": {
"type": "object",
"required": [
"offset",
"limit",
"nextOffset",
"hasMore"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Effective maximum rows after the per-call cap.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Requested zero-based offset."
},
"hasMore": {
"type": "boolean",
"description": "Whether more rows remain."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Next offset, or null when exhausted."
}
},
"description": "Local continuation in the filtered ordering, including a response-budget stop.",
"additionalProperties": false
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"url",
"retrievedAt",
"cached"
],
"properties": {
"url": {
"type": "string",
"pattern": "^https:\\/\\/",
"description": "Absolute HTTPS source request URL."
},
"cached": {
"type": "boolean",
"description": "Whether this response came from the in-memory cache."
},
"source": {
"enum": [
"legisinfo",
"ourcommons",
"openparliament"
],
"type": "string",
"description": "Public source identifier."
},
"retrievedAt": {
"type": "string",
"description": "Original ISO retrieval timestamp."
}
},
"description": "Source retrieval metadata.",
"additionalProperties": false
},
"description": "Original retrieval metadata from all source requests."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Exact matching count before slicing."
},
"appliedFilters": {
"type": "object",
"required": [
"session",
"titleContains",
"billCode",
"originatingChamber",
"billType",
"status",
"sponsor",
"sponsorName"
],
"properties": {
"status": {
"type": [
"string",
"null"
],
"description": "Canonical official status, or null."
},
"session": {
"type": "string",
"description": "Resolved official session."
},
"sponsor": {
"type": [
"string",
"null"
],
"description": "Verified canonical OpenParliament sponsor slug, or null."
},
"billCode": {
"type": [
"string",
"null"
],
"description": "Canonical exact bill code, or null."
},
"billType": {
"type": [
"string",
"null"
],
"description": "Canonical official bill type, or null."
},
"sponsorName": {
"type": [
"string",
"null"
],
"description": "Name on the verified OpenParliament sponsor profile, or null."
},
"titleContains": {
"type": [
"string",
"null"
],
"description": "Trimmed literal title filter, or null."
},
"originatingChamber": {
"anyOf": [
{
"enum": [
"House",
"Senate"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Canonical chamber, or null."
}
},
"description": "Normalized filters applied together with AND.",
"additionalProperties": false
},
"sponsorCoverage": {
"enum": [
"not_applied",
"openparliament_index"
],
"type": "string",
"description": "Whether the result is restricted to the third-party sponsor index."
}
},
"additionalProperties": false
}canparl_search_bills annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}canparl_get_bill — Canparl Get Bill
Advertised read-onlyOpen-world
Read one House or Senate bill's official dossier. Large dossiers return an outline; re-call with one section and follow pagination.nextOffset for collections. Stages preserve nested records whole. Obtain billCode and session from canparl_search_bills; omitted session means the verified current official session.
canparl_get_bill input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"billCode"
],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"description": "Maximum whole records per selected collection page, 1–100 per call; larger values up to 10000 return 100 with a notice, and the byte budget may reduce it."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based whole-record offset within the selected collection."
},
"section": {
"type": "string",
"pattern": "^\\s*(?:(?:sponsor|stages\\.house|stages\\.senate|stages\\.royalAssent|divisions|senateVoteDetails|publications|statute|summary\\.en|summary\\.fr|notes\\.en|notes\\.fr|milestones|webReferences)\\s*)?$",
"description": "One section from the returned outline: sponsor, stages.house, stages.senate, stages.royalAssent, divisions, senateVoteDetails, publications, statute, summary.en, summary.fr, notes.en, notes.fr, milestones, webReferences. Omit for the full dossier or its overflow outline."
},
"session": {
"anyOf": [
{
"type": "string",
"pattern": "^\\s*(?:[0-9]+-[0-9]+\\s*)?$",
"description": "Parliament-session token, such as 45-1."
},
{
"type": "object",
"required": [
"parliament",
"session"
],
"properties": {
"session": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive session number.",
"exclusiveMinimum": 0
},
"parliament": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive parliament number.",
"exclusiveMinimum": 0
}
},
"description": "Parliament and session numbers.",
"additionalProperties": false
}
],
"description": "Parliamentary session; omitted means current."
},
"billCode": {
"type": "string",
"pattern": "^\\s*(?:[Bb][Ii][Ll][Ll]\\s+)?[CcSs][-\\u0020\\u00A0\\u1680\\u2000-\\u200A\\u202F\\u205F\\u3000\\u2010-\\u2015\\u2212]?[1-9][0-9]*[A-Za-z]?\\s*$",
"description": "Bill code from canparl_search_bills, including a split-bill suffix letter such as C-15A; accepts bill s321, S321, S 321, or S-321."
}
},
"additionalProperties": false
}canparl_get_bill output schema
{
"type": "object",
"$defs": {
"BillStage": {
"type": "object",
"required": [
"id",
"name",
"chamber",
"state",
"stateAsOf",
"committee",
"sittings",
"committeeMeetings",
"decisions",
"significantEvents",
"endOfStageEvent"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Bill stage ID."
},
"name": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Stage names.",
"additionalProperties": false
},
"state": {
"type": "object",
"required": [
"id",
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English state wording."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French state wording."
},
"id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Stage state ID."
}
},
"description": "Stage state.",
"additionalProperties": false
},
"chamber": {
"anyOf": [
{
"enum": [
"House",
"Senate"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Containing chamber, or null for royal assent."
},
"sittings": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"number",
"date",
"name",
"published"
],
"properties": {
"date": {
"type": [
"string",
"null"
],
"description": "Sitting date in Ottawa time as published, without an offset."
},
"name": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Sitting names.",
"additionalProperties": false
},
"number": {
"type": [
"string",
"null"
],
"description": "Sitting number."
},
"published": {
"type": [
"boolean",
"null"
],
"description": "Publication flag."
}
},
"description": "Sitting record.",
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Sittings."
},
"committee": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"acronym",
"name"
],
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Committee organization ID."
},
"name": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Committee names.",
"additionalProperties": false
},
"acronym": {
"type": [
"string",
"null"
],
"description": "Committee acronym."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Committee referral."
},
"decisions": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"description": "Official JSON object with all source fields retained.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
}
},
{
"type": "null"
}
],
"description": "Complete variable decision records; their date-times are Ottawa time as published, without an offset."
},
"stateAsOf": {
"type": [
"string",
"null"
],
"description": "State-as-of date-time in Ottawa time as published, without an offset."
},
"endOfStageEvent": {
"anyOf": [
{
"type": "object",
"description": "Official JSON object with all source fields retained.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
},
{
"type": "null"
}
],
"description": "Complete end-of-stage event; its date-times are Ottawa time as published, without an offset."
},
"committeeMeetings": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"number",
"date",
"committeeId",
"acronym",
"name"
],
"properties": {
"date": {
"type": [
"string",
"null"
],
"description": "Committee meeting date in Ottawa time as published, without an offset."
},
"name": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Committee meeting names.",
"additionalProperties": false
},
"number": {
"type": [
"string",
"null"
],
"description": "Committee meeting number."
},
"acronym": {
"type": [
"string",
"null"
],
"description": "Committee acronym."
},
"committeeId": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Committee organization ID."
}
},
"description": "Committee meeting record.",
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Committee meetings."
},
"significantEvents": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"description": "Official JSON object with all source fields retained.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
}
},
{
"type": "null"
}
],
"description": "Complete variable significant-event records; their date-times are Ottawa time as published, without an offset."
}
},
"description": "Complete official stage; null fields are unavailable and empty arrays have no records.",
"additionalProperties": false
},
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/$defs/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
}
],
"description": "Recursively serializable JSON value."
}
},
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"bill",
"provenance",
"appliedFilters"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"bill": {
"type": "object",
"required": [
"session",
"billCode",
"longTitle",
"shortTitle",
"billType",
"originatingChamber",
"status",
"latestMajorStage",
"royalAssentDate",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Absolute HTTPS official bill URL."
},
"status": {
"type": [
"string",
"null"
],
"description": "Official status wording, or null."
},
"session": {
"type": "string",
"description": "Verified parliament-session token."
},
"billCode": {
"type": "string",
"description": "Canonical House or Senate bill code."
},
"billType": {
"type": [
"string",
"null"
],
"description": "Official bill type, or null."
},
"longTitle": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Official long titles.",
"additionalProperties": false
},
"shortTitle": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Official short titles.",
"additionalProperties": false
},
"royalAssentDate": {
"type": [
"string",
"null"
],
"description": "Royal assent as a UTC instant ending in Z (YYYY-MM-DDTHH:MM:SS[.fraction]Z), converted from LEGISinfo's Ottawa-time clock, or null; the time of day is LEGISinfo's recorded time, which can differ from when assent was signified. A value in another shape is relayed as published."
},
"latestMajorStage": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"chamber"
],
"properties": {
"name": {
"type": [
"string",
"null"
],
"description": "Latest completed major stage name, or null."
},
"chamber": {
"anyOf": [
{
"enum": [
"House",
"Senate"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Chamber of the latest completed major stage, or null; royal assent is reported as Senate."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Latest completed major stage, or null."
},
"originatingChamber": {
"anyOf": [
{
"enum": [
"House",
"Senate"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Originating chamber, or null."
}
},
"description": "Official bill summary.",
"additionalProperties": false
},
"kind": {
"enum": [
"outline",
"section"
],
"type": "string",
"description": "Absent for full dossier; outline lists sections; section returns one selection."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"invalid_bill_section",
"unknown_session",
"bill_not_found",
"upstream_blocked"
],
"description": "Machine-readable failure mode. Declared by this tool: `invalid_bill_section`: Pagination supplied without a collection section. `unknown_session`: Session with a zero or out-of-range number, or absent from the official bill session index. `bill_not_found`: Official dossier has no matching record or returns a missing-record response. `upstream_blocked`: An official parliamentary source refuses the request with HTTP 403. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"notes": {
"type": "object",
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English dossier notes as plain text, each link kept as text (href), or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French dossier notes as plain text, each link kept as text (href), or null when unavailable."
}
},
"description": "Official dossier notes; notes.en and notes.fr sections each return one language.",
"additionalProperties": false
},
"notice": {
"type": "string",
"description": "Limit clamp or source coverage guidance when applicable."
},
"stages": {
"type": "object",
"properties": {
"house": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/BillStage"
}
},
{
"type": "null"
}
],
"description": "House stages, or null if unavailable."
},
"senate": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/BillStage"
}
},
{
"type": "null"
}
],
"description": "Senate stages, or null if unavailable."
},
"royalAssent": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/BillStage"
}
},
{
"type": "null"
}
],
"description": "Royal assent stages, or null if unavailable."
}
},
"description": "All official stage containers.",
"additionalProperties": false
},
"sponsor": {
"type": "object",
"required": [
"name",
"personId",
"riding",
"title"
],
"properties": {
"name": {
"type": [
"string",
"null"
],
"description": "Official sponsor name, or null."
},
"title": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Sponsor affiliation title, such as a ministerial office or Senator.",
"additionalProperties": false
},
"riding": {
"type": [
"string",
"null"
],
"description": "Sponsor riding, or null."
},
"personId": {
"type": [
"string",
"null"
],
"description": "Official person ID, distinct from an OpenParliament slug; or null."
}
},
"description": "Official sponsor fields.",
"additionalProperties": false
},
"statute": {
"anyOf": [
{
"type": "object",
"required": [
"year",
"chapter",
"citation"
],
"properties": {
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Statute year."
},
"chapter": {
"type": "string",
"description": "Exact statute chapter designation."
},
"citation": {
"type": "string",
"description": "Statutes of Canada citation."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Enacted statute when both year and chapter exist; otherwise null."
},
"summary": {
"type": "object",
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English legislative summary as plain text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French legislative summary as plain text, or null when unavailable."
}
},
"description": "Library of Parliament legislative summary; summary.en and summary.fr sections each return one language.",
"additionalProperties": false
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"count"
],
"properties": {
"name": {
"type": "string",
"description": "Exact section selector."
},
"count": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Collection record count; null for objects or unavailable data."
}
},
"description": "Retrievable dossier section.",
"additionalProperties": false
},
"description": "Available section selectors."
},
"divisions": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"session",
"number",
"subject",
"dateTime",
"result",
"yeas",
"nays",
"paired",
"total",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Absolute HTTPS House division URL."
},
"nays": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Nay count, or null."
},
"yeas": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Yea count, or null."
},
"total": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Official total, or null."
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "House division number for canparl_get_vote."
},
"paired": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Paired count, or null."
},
"result": {
"type": [
"string",
"null"
],
"description": "Official decision wording, or null."
},
"session": {
"type": "string",
"description": "Verified division session."
},
"subject": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Official division subjects.",
"additionalProperties": false
},
"dateTime": {
"type": [
"string",
"null"
],
"description": "LEGISinfo sitting date-time in Ottawa time as published, without an offset; not the time the division was recorded (canparl_get_vote reports that); or null."
}
},
"description": "Official House division record.",
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "House divisions, or null if unavailable."
},
"disclosure": {
"type": "string",
"description": "Overflow, empty, unavailable, past-end, or response-budget-stop guidance."
},
"milestones": {
"type": "object",
"required": [
"houseFirstReading",
"houseSecondReading",
"houseThirdReading",
"senateFirstReading",
"senateSecondReading",
"senateThirdReading"
],
"properties": {
"houseFirstReading": {
"type": [
"string",
"null"
],
"description": "House first reading date-time, or null."
},
"houseThirdReading": {
"type": [
"string",
"null"
],
"description": "House third reading date-time, or null."
},
"houseSecondReading": {
"type": [
"string",
"null"
],
"description": "House second reading date-time, or null."
},
"senateFirstReading": {
"type": [
"string",
"null"
],
"description": "Senate first reading date-time, or null."
},
"senateThirdReading": {
"type": [
"string",
"null"
],
"description": "Senate third reading date-time, or null."
},
"senateSecondReading": {
"type": [
"string",
"null"
],
"description": "Senate second reading date-time, or null."
}
},
"description": "Reading milestones as UTC instants ending in Z (YYYY-MM-DDTHH:MM:SS[.fraction]Z), converted from LEGISinfo's Ottawa-time clocks; Senate times of day are LEGISinfo's recorded times. A value in another shape is relayed as published. Royal assent is bill.royalAssentDate.",
"additionalProperties": false
},
"pagination": {
"type": "object",
"required": [
"section",
"offset",
"limit",
"total",
"nextOffset"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Effective maximum page size after the per-call cap; the byte budget may return fewer."
},
"total": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Collection total; null for scalar sections or unavailable collections."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Requested zero-based record offset."
},
"section": {
"type": "string",
"description": "Selected section."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Next whole-record offset; null when complete."
}
},
"description": "Whole-record selection continuation.",
"additionalProperties": false
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"url",
"retrievedAt",
"cached"
],
"properties": {
"url": {
"type": "string",
"pattern": "^https:\\/\\/",
"description": "Absolute HTTPS source request URL."
},
"cached": {
"type": "boolean",
"description": "Whether this response came from the in-memory cache."
},
"source": {
"enum": [
"legisinfo",
"ourcommons",
"openparliament"
],
"type": "string",
"description": "Public source identifier."
},
"retrievedAt": {
"type": "string",
"description": "Original ISO retrieval timestamp."
}
},
"description": "Source retrieval metadata.",
"additionalProperties": false
},
"description": "Original retrieval metadata for every source request."
},
"totalCount": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Selected collection total, or null for unavailable or scalar sections."
},
"publications": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"typeId",
"type",
"url"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Official publication ID."
},
"url": {
"type": "string",
"description": "Verified absolute HTTPS document viewer URL."
},
"type": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Publication type wording.",
"additionalProperties": false
},
"typeId": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Publication type ID, or null."
}
},
"description": "Official publication record.",
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Publications, or null if unavailable."
},
"webReferences": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"typeId",
"type",
"url"
],
"properties": {
"url": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Reference URL or citation as published and never fetched; may be http, prose, or null.",
"additionalProperties": false
},
"type": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Reference type, such as Press Release or Legislative Costing Note.",
"additionalProperties": false
},
"title": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Reference titles.",
"additionalProperties": false
},
"typeId": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Reference type ID, or null."
}
},
"description": "Official related web reference.",
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Related documents, press releases, and costing notes, or null if unavailable."
},
"appliedFilters": {
"type": "object",
"required": [
"session",
"billCode"
],
"properties": {
"session": {
"type": "string",
"description": "Resolved official session."
},
"billCode": {
"type": "string",
"description": "Canonical bill code."
}
},
"description": "Normalized requested bill identity.",
"additionalProperties": false
},
"senateVoteDetails": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"description": "Official JSON object with all source fields retained.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
}
},
{
"type": "null"
}
],
"description": "Complete variable Senate vote records; not House divisions."
}
},
"additionalProperties": false
}canparl_get_bill annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}canparl_search_members — Canparl Search Members
Advertised read-onlyOpen-world
Find House MPs by name, riding, province, or caucus in the complete current official roster, or set parliament to search everyone who sat in that Parliament (36th onward) with official personIds and membership dates. Set includeFormer for OpenParliament's historical name index; its rows may contain only a name and slug. Follow nextOffset with identical filters and use detailLookup with canparl_get_member.
canparl_search_members input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Official roster: literal name substring; matching ignores case, accents, dash and quote styles, and repeated whitespace. Historical: OpenParliament's own match, where one token is surname lookup and multiple tokens are full recorded name lookup, not substring search."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 10000,
"minimum": 1,
"description": "Maximum rows, default 25, effective cap 100; values through 10000 are accepted and clamp with a notice. Whole records may end the page early at the 24000-byte response budget; follow nextOffset."
},
"party": {
"type": "string",
"description": "Official caucus name; Bloc and Green aliases accepted; official rosters only, not includeFormer. With parliament, matches the one caucus each member last held in that Parliament, and that roster's own caucus names are accepted."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset in the selected ordering."
},
"riding": {
"type": "string",
"description": "Literal riding substring; matching ignores case, accents, dash and quote styles, and repeated whitespace. Official rosters only, not includeFormer."
},
"province": {
"type": "string",
"description": "Province postal code or full English name; official rosters only, not includeFormer."
},
"parliament": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Parliament number, such as 41, whose official House roster to search instead of the current one: everyone who sat in it, one row each with the caucus and riding last held there. The official roster offers the 36th onward; another number fails listing those offered. Not with includeFormer.",
"exclusiveMinimum": 0
},
"includeFormer": {
"type": "boolean",
"default": false,
"description": "Use the sparse historical name index instead of an official roster; parliament, riding, province, and party are rejected with it."
}
},
"additionalProperties": false
}canparl_search_members output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"total",
"members",
"pagination",
"provenance",
"appliedFilters",
"shown",
"cap",
"truncated"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Effective page limit after the per-call cap."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"unsupported_historical_filter",
"invalid_member_filter",
"upstream_blocked",
"roster_unavailable"
],
"description": "Machine-readable failure mode. Declared by this tool: `unsupported_historical_filter`: Historical mode includes parliament, geographic, or caucus filters. `invalid_member_filter`: Unknown province, a caucus absent from the searched roster and the catalog, or a parliament the official roster does not offer. `upstream_blocked`: An official parliamentary source refuses the request with HTTP 403. `roster_unavailable`: The official roster of an offered Parliament came back empty. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Returned row count."
},
"total": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Exact filtered count of the official roster searched; null for historical index."
},
"notice": {
"type": "string",
"description": "Limit clamp, empty page, historical coverage, or response-budget guidance."
},
"members": {
"type": "array",
"items": {
"type": "object",
"required": [
"personId",
"slug",
"name",
"party",
"riding",
"province",
"current",
"from",
"to",
"url",
"detailLookup"
],
"properties": {
"to": {
"type": [
"string",
"null"
],
"description": "End of that membership, the roster's ToDateTime as published; null while sitting or without an official roster row."
},
"url": {
"type": "string",
"description": "Absolute HTTPS member profile URL."
},
"from": {
"type": [
"string",
"null"
],
"description": "Start of the official roster membership this row describes, the roster's FromDateTime as published; null without an official roster row."
},
"name": {
"type": "string",
"description": "Recorded full name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "Verified OpenParliament slug, or null."
},
"party": {
"type": [
"string",
"null"
],
"description": "Source caucus name, or null. An official roster row carries one caucus per member, the last held in its Parliament: a past Parliament's row, or a former member's row from their latest Parliament."
},
"riding": {
"type": [
"string",
"null"
],
"description": "Source riding name, or null."
},
"current": {
"type": [
"boolean",
"null"
],
"description": "Current official roster membership, or null if unverified."
},
"personId": {
"type": [
"string",
"null"
],
"description": "Official person ID, or null."
},
"province": {
"type": [
"string",
"null"
],
"description": "Province or territory, or null."
},
"detailLookup": {
"anyOf": [
{
"type": "object",
"required": [
"personId"
],
"properties": {
"personId": {
"type": "string",
"description": "Official identifier for canparl_get_member."
}
},
"description": "Official member lookup.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "OpenParliament identifier for canparl_get_member."
}
},
"description": "Historical member lookup.",
"additionalProperties": false
}
],
"description": "Pass exactly this identifier to canparl_get_member."
}
},
"description": "Known public member identity.",
"additionalProperties": false
},
"description": "Returned member identities."
},
"truncated": {
"type": "boolean",
"description": "More queried rows remain."
},
"pagination": {
"type": "object",
"required": [
"offset",
"limit",
"nextOffset",
"hasMore"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Effective maximum rows after the per-call cap.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Requested zero-based offset."
},
"hasMore": {
"type": "boolean",
"description": "Whether more rows remain."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Next offset, or null when exhausted."
}
},
"description": "Continuation in the selected source ordering.",
"additionalProperties": false
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"url",
"retrievedAt",
"cached"
],
"properties": {
"url": {
"type": "string",
"pattern": "^https:\\/\\/",
"description": "Absolute HTTPS source request URL."
},
"cached": {
"type": "boolean",
"description": "Whether this response came from the in-memory cache."
},
"source": {
"enum": [
"legisinfo",
"ourcommons",
"openparliament"
],
"type": "string",
"description": "Public source identifier."
},
"retrievedAt": {
"type": "string",
"description": "Original ISO retrieval timestamp."
}
},
"description": "Source retrieval metadata.",
"additionalProperties": false
},
"description": "Original source retrieval metadata."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Exact filtered count of the official roster searched, current or parliament; absent for historical searches."
},
"appliedFilters": {
"type": "object",
"required": [
"includeFormer",
"parliament",
"name",
"nameMode",
"riding",
"province",
"party"
],
"properties": {
"name": {
"type": [
"string",
"null"
],
"description": "Applied name text."
},
"party": {
"type": [
"string",
"null"
],
"description": "Canonical official caucus."
},
"riding": {
"type": [
"string",
"null"
],
"description": "Applied riding substring."
},
"nameMode": {
"enum": [
"substring",
"surname",
"full_name",
"index"
],
"type": "string",
"description": "Actual source name matching semantics."
},
"province": {
"type": [
"string",
"null"
],
"description": "Canonical province name."
},
"parliament": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Parliament whose official roster was searched, or null."
},
"includeFormer": {
"type": "boolean",
"description": "Selected historical mode."
}
},
"description": "Normalized AND filters and name semantics.",
"additionalProperties": false
}
},
"additionalProperties": false
}canparl_search_members annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}canparl_get_member — Canparl Get Member
Advertised read-onlyOpen-world
Read one House MP by a returned OpenParliament slug or official personId, current or former (36th Parliament onward). Pass exactly one identifier from canparl_search_members detailLookup. Official profiles survive unavailable OpenParliament enrichment. Recent ballots come newest first from the official House member-votes feed when the member has one official personId, filterable by votesSession (default: the member's latest session) and votesBillCode; otherwise from OpenParliament. Sponsored bills and recent ballots are independently pageable; set their limits to zero for profile-only lookup.
canparl_get_member input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"slug": {
"type": "string",
"description": "Returned OpenParliament slug, politician path, or HTTPS OpenParliament profile URL; never a guessed name. A digit-only value equal to a current official personId, or its /politicians/<digits>/ path or profile URL, is read as that personId."
},
"personId": {
"type": "string",
"pattern": "^\\s*(?:[0-9]+\\s*)?$",
"description": "Decimal official person ID, distinct from an OpenParliament slug: a current member's, or a former member's from the 36th Parliament onward, such as a canparl_search_members parliament row or a canparl_get_vote ballot. A former member's profile carries their latest Parliament's caucus and riding."
},
"billsOffset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based sponsored bill page offset."
},
"recentVotes": {
"type": "integer",
"default": 10,
"maximum": 10000,
"minimum": 0,
"description": "Ballot rows to return, 0–10 per call; zero disables, and larger values up to 10000 return 10 with a notice."
},
"votesOffset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based ballot page offset."
},
"votesSession": {
"anyOf": [
{
"type": "string",
"pattern": "^\\s*(?:[0-9]+-[0-9]+\\s*)?$",
"description": "Parliament-session token, such as 45-1."
},
{
"type": "object",
"required": [
"parliament",
"session"
],
"properties": {
"session": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive session number.",
"exclusiveMinimum": 0
},
"parliament": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive parliament number.",
"exclusiveMinimum": 0
}
},
"description": "Parliament and session numbers.",
"additionalProperties": false
}
],
"description": "Official ballot session such as 44-1; omitted means the member's latest session in the feed. Needs one official personId."
},
"votesBillCode": {
"type": "string",
"pattern": "^\\s*(?:(?:[Bb][Ii][Ll][Ll]\\s+)?[CcSs][-\\u0020\\u00A0\\u1680\\u2000-\\u200A\\u202F\\u205F\\u3000\\u2010-\\u2015\\u2212]?[1-9][0-9]*[A-Za-z]?\\s*)?$",
"description": "Keep official ballots on this bill, including a split-bill suffix such as C-15A; accepts c15, C 15, or bill C-15. Needs one official personId."
},
"sponsoredBills": {
"type": "integer",
"default": 5,
"maximum": 10000,
"minimum": 0,
"description": "Sponsored bill rows to hydrate, 0–5 per call; zero disables, and larger values up to 10000 hydrate 5 with a notice."
}
},
"additionalProperties": false
}canparl_get_member output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"member",
"memberships",
"sponsoredBills",
"recentVotes",
"openParliament",
"provenance",
"appliedFilters",
"shown",
"cap",
"truncated",
"unavailable"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "object",
"required": [
"sponsoredBills",
"recentVotes"
],
"properties": {
"recentVotes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Effective ballot workload cap."
},
"sponsoredBills": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Effective bill workload cap."
}
},
"description": "Bounded workloads after the per-call caps.",
"additionalProperties": false
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"invalid_member_identifier",
"member_not_found",
"unsupported_vote_session",
"upstream_blocked",
"roster_unavailable"
],
"description": "Machine-readable failure mode. Declared by this tool: `invalid_member_identifier`: Neither or both identifiers supplied, or a slug that is not an OpenParliament politician reference. `member_not_found`: Slug missing or answered by another profile, or official person ID in neither the current roster nor the all-Parliaments roster. `unsupported_vote_session`: votesSession with a zero or out-of-range number, or absent from the official division picker. `upstream_blocked`: An official parliamentary source refuses the request with HTTP 403. `roster_unavailable`: The official all-Parliaments roster came back empty while resolving a former personId. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "object",
"required": [
"sponsoredBills",
"recentVotes"
],
"properties": {
"recentVotes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Returned ballots."
},
"sponsoredBills": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Hydrated returned bills."
}
},
"description": "Returned activity counts.",
"additionalProperties": false
},
"member": {
"type": "object",
"required": [
"personId",
"slug",
"name",
"party",
"riding",
"province",
"current",
"from",
"to",
"url",
"detailLookup",
"gender",
"imageUrl",
"links"
],
"properties": {
"to": {
"type": [
"string",
"null"
],
"description": "End of that membership, the roster's ToDateTime as published; null while sitting or without an official roster row."
},
"url": {
"type": "string",
"description": "Absolute HTTPS member profile URL."
},
"from": {
"type": [
"string",
"null"
],
"description": "Start of the official roster membership this row describes, the roster's FromDateTime as published; null without an official roster row."
},
"name": {
"type": "string",
"description": "Recorded full name."
},
"slug": {
"type": [
"string",
"null"
],
"description": "Verified OpenParliament slug, or null."
},
"links": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"note"
],
"properties": {
"url": {
"type": "string",
"description": "Absolute http or https URL as published, or a relative value resolved against https://openparliament.ca; never fetched, and only https values render as links."
},
"note": {
"type": [
"string",
"null"
],
"description": "Source link annotation, or null."
}
},
"description": "Public profile link.",
"additionalProperties": false
},
"description": "Source profile links, excluding contact fields."
},
"party": {
"type": [
"string",
"null"
],
"description": "Source caucus name, or null. An official roster row carries one caucus per member, the last held in its Parliament: a past Parliament's row, or a former member's row from their latest Parliament."
},
"gender": {
"type": [
"string",
"null"
],
"description": "Source gender, or null."
},
"riding": {
"type": [
"string",
"null"
],
"description": "Source riding name, or null."
},
"current": {
"type": [
"boolean",
"null"
],
"description": "Current official roster membership, or null if unverified."
},
"imageUrl": {
"type": [
"string",
"null"
],
"description": "HTTPS portrait reference, or null."
},
"personId": {
"type": [
"string",
"null"
],
"description": "Official person ID, or null."
},
"province": {
"type": [
"string",
"null"
],
"description": "Province or territory, or null."
},
"detailLookup": {
"anyOf": [
{
"type": "object",
"required": [
"personId"
],
"properties": {
"personId": {
"type": "string",
"description": "Official identifier for canparl_get_member."
}
},
"description": "Official member lookup.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "OpenParliament identifier for canparl_get_member."
}
},
"description": "Historical member lookup.",
"additionalProperties": false
}
],
"description": "Pass exactly this identifier to canparl_get_member."
}
},
"description": "Public member profile.",
"additionalProperties": false
},
"notice": {
"type": "string",
"description": "Workload clamp, coverage, and recovery guidance."
},
"truncated": {
"type": "object",
"required": [
"sponsoredBills",
"recentVotes"
],
"properties": {
"recentVotes": {
"type": "boolean",
"description": "More ballots remain."
},
"sponsoredBills": {
"type": "boolean",
"description": "More sponsored bills remain."
}
},
"description": "Independent source continuations.",
"additionalProperties": false
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"url",
"retrievedAt",
"cached"
],
"properties": {
"url": {
"type": "string",
"pattern": "^https:\\/\\/",
"description": "Absolute HTTPS source request URL."
},
"cached": {
"type": "boolean",
"description": "Whether this response came from the in-memory cache."
},
"source": {
"enum": [
"legisinfo",
"ourcommons",
"openparliament"
],
"type": "string",
"description": "Public source identifier."
},
"retrievedAt": {
"type": "string",
"description": "Original ISO retrieval timestamp."
}
},
"description": "Source retrieval metadata.",
"additionalProperties": false
},
"description": "All successful source retrieval metadata."
},
"memberships": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"party",
"riding",
"province",
"startDate",
"endDate",
"label"
],
"properties": {
"url": {
"type": "string",
"description": "HTTPS historical membership URL."
},
"label": {
"type": [
"string",
"null"
],
"description": "Source membership label."
},
"party": {
"type": "object",
"required": [
"name",
"shortName"
],
"properties": {
"name": {
"type": [
"string",
"null"
],
"description": "Historical party name."
},
"shortName": {
"type": [
"string",
"null"
],
"description": "Historical party short name."
}
},
"description": "Source-specific historical affiliation.",
"additionalProperties": false
},
"riding": {
"type": [
"string",
"null"
],
"description": "Historical riding."
},
"endDate": {
"type": [
"string",
"null"
],
"description": "Source end date."
},
"province": {
"type": [
"string",
"null"
],
"description": "Historical province."
},
"startDate": {
"type": [
"string",
"null"
],
"description": "Source start date."
}
},
"description": "Dated source membership.",
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Source membership history, or null if unavailable."
},
"recentVotes": {
"type": "object",
"required": [
"status",
"items",
"offset",
"limit",
"total",
"nextOffset",
"hasMore",
"failure"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"session",
"number",
"date",
"subject",
"ballot",
"url",
"source",
"officialBallot",
"billCode",
"result"
],
"properties": {
"url": {
"type": "string",
"description": "Absolute HTTPS division URL: the official division page or the OpenParliament vote."
},
"date": {
"type": [
"string",
"null"
],
"description": "Division date YYYY-MM-DD, or null."
},
"ballot": {
"enum": [
"Yes",
"No",
"Paired",
"Didn't vote"
],
"type": "string",
"description": "Ballot in OpenParliament's vocabulary: official Yea and Nay read Yes and No; Didn't vote occurs only on OpenParliament rows."
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Division number within the session."
},
"result": {
"type": [
"string",
"null"
],
"description": "Division result in source vocabulary (official Agreed To, Negatived, or Tie; OpenParliament Passed, Failed, or Tie), or null."
},
"source": {
"enum": [
"ourcommons",
"openparliament"
],
"type": "string",
"description": "Ballot source: the official member-votes feed, or OpenParliament for a member without one official personId."
},
"session": {
"type": "string",
"description": "Division session."
},
"subject": {
"type": [
"string",
"null"
],
"description": "Source division subject, or null."
},
"billCode": {
"type": [
"string",
"null"
],
"description": "Bill code the official feed links to the division, or null; always null on OpenParliament rows."
},
"officialBallot": {
"anyOf": [
{
"enum": [
"Yea",
"Nay",
"Paired"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Official recorded ballot Yea, Nay, or Paired; null on OpenParliament rows."
}
},
"description": "Member ballot with its division.",
"additionalProperties": false
},
"description": "Complete returned page, or no rows when unavailable."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Effective workload limit after the per-call cap; zero disables activity."
},
"total": {
"type": "null",
"description": "Always null; follow nextOffset."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Requested activity offset."
},
"status": {
"enum": [
"available",
"unavailable",
"not_requested"
],
"type": "string",
"description": "Availability; unavailable never means empty history."
},
"failure": {
"anyOf": [
{
"type": "object",
"required": [
"code",
"reason",
"recovery",
"retryable"
],
"properties": {
"code": {
"type": "string",
"description": "Framework error code name."
},
"reason": {
"type": "string",
"description": "Safe fixed failure classification."
},
"recovery": {
"type": "string",
"description": "Caller recovery guidance."
},
"retryable": {
"type": "boolean",
"description": "Whether retry may succeed."
}
},
"description": "Public optional-section failure metadata.",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Failure metadata only when unavailable."
},
"hasMore": {
"type": "boolean",
"description": "Whether more activity remains."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Next activity offset, or null."
}
},
"description": "Independently pageable activity section.",
"additionalProperties": false
},
"unavailable": {
"type": "array",
"items": {
"type": "object",
"required": [
"section",
"failure"
],
"properties": {
"failure": {
"type": "object",
"required": [
"code",
"reason",
"recovery",
"retryable"
],
"properties": {
"code": {
"type": "string",
"description": "Framework error code name."
},
"reason": {
"type": "string",
"description": "Safe fixed failure classification."
},
"recovery": {
"type": "string",
"description": "Caller recovery guidance."
},
"retryable": {
"type": "boolean",
"description": "Whether retry may succeed."
}
},
"description": "Public optional-section failure metadata.",
"additionalProperties": false
},
"section": {
"type": "string",
"description": "Unavailable profile, history, currentness, or activity section."
}
},
"description": "Optional enrichment failure.",
"additionalProperties": false
},
"description": "Explicit unavailable enrichment outcomes."
},
"appliedFilters": {
"type": "object",
"required": [
"slug",
"personId",
"sponsoredBills",
"billsOffset",
"recentVotes",
"votesOffset",
"votesSession",
"votesBillCode"
],
"properties": {
"slug": {
"type": [
"string",
"null"
],
"description": "Normalized requested OpenParliament slug, or null."
},
"personId": {
"type": [
"string",
"null"
],
"description": "Requested official ID, including a digit-only slug read as a current personId, or null."
},
"billsOffset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Requested bill offset."
},
"recentVotes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Effective ballot workload after the per-call cap."
},
"votesOffset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Requested ballot offset."
},
"votesSession": {
"type": [
"string",
"null"
],
"description": "Requested official ballot session, else the session the official ballots carry, or null."
},
"votesBillCode": {
"type": [
"string",
"null"
],
"description": "Canonical official ballot bill filter, or null."
},
"sponsoredBills": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Effective bill workload after the per-call cap."
}
},
"description": "Normalized lookup and independent activity controls.",
"additionalProperties": false
},
"openParliament": {
"type": "object",
"required": [
"status",
"reason"
],
"properties": {
"reason": {
"type": [
"string",
"null"
],
"description": "Safe unavailability reason, or null."
},
"status": {
"enum": [
"available",
"unavailable"
],
"type": "string",
"description": "Profile enrichment availability."
}
},
"description": "OpenParliament identity outcome.",
"additionalProperties": false
},
"sponsoredBills": {
"type": "object",
"required": [
"status",
"items",
"offset",
"limit",
"total",
"nextOffset",
"hasMore",
"failure"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"session",
"billCode",
"title",
"status",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Absolute HTTPS bill URL."
},
"title": {
"type": "object",
"required": [
"en",
"fr"
],
"properties": {
"en": {
"type": [
"string",
"null"
],
"description": "English text, or null when unavailable."
},
"fr": {
"type": [
"string",
"null"
],
"description": "French text, or null when unavailable."
}
},
"description": "Source bill title translations.",
"additionalProperties": false
},
"status": {
"type": [
"string",
"null"
],
"description": "OpenParliament status wording, or null."
},
"session": {
"type": "string",
"description": "Source bill session."
},
"billCode": {
"type": "string",
"description": "Source bill code."
}
},
"description": "Hydrated sponsored bill.",
"additionalProperties": false
},
"description": "Complete returned page, or no rows when unavailable."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Effective workload limit after the per-call cap; zero disables activity."
},
"total": {
"type": "null",
"description": "Always null; follow nextOffset."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Requested activity offset."
},
"status": {
"enum": [
"available",
"unavailable",
"not_requested"
],
"type": "string",
"description": "Availability; unavailable never means empty history."
},
"failure": {
"anyOf": [
{
"type": "object",
"required": [
"code",
"reason",
"recovery",
"retryable"
],
"properties": {
"code": {
"type": "string",
"description": "Framework error code name."
},
"reason": {
"type": "string",
"description": "Safe fixed failure classification."
},
"recovery": {
"type": "string",
"description": "Caller recovery guidance."
},
"retryable": {
"type": "boolean",
"description": "Whether retry may succeed."
}
},
"description": "Public optional-section failure metadata.",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Failure metadata only when unavailable."
},
"hasMore": {
"type": "boolean",
"description": "Whether more activity remains."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Next activity offset, or null."
}
},
"description": "Independently pageable activity section.",
"additionalProperties": false
}
},
"additionalProperties": false
}canparl_get_member annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}canparl_search_votes — Canparl Search Votes
Advertised read-onlyOpen-world
Find recorded House divisions in one session by bill, result, document type, date, or subject. Return newest first and pass session plus number to canparl_get_vote. Omitted session resolves from the current official bill feed. Follow nextOffset with identical filters.
canparl_search_votes input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 10000,
"minimum": 1,
"description": "Maximum rows, default 25, effective cap 100; values through 10000 are accepted and clamp with a notice. Whole records may end the page early at the 24000-byte response budget; follow nextOffset."
},
"dateTo": {
"type": "string",
"pattern": "^\\s*(?:[0-9]{4}-[0-9]{2}-[0-9]{2}\\s*)?$",
"description": "Inclusive Ottawa civil date YYYY-MM-DD; independently optional."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset in the selected ordering."
},
"result": {
"type": "string",
"description": "Official result from vote_results; Passed and Failed are accepted aliases."
},
"session": {
"anyOf": [
{
"type": "string",
"pattern": "^\\s*(?:[0-9]+-[0-9]+\\s*)?$",
"description": "Parliament-session token, such as 45-1."
},
{
"type": "object",
"required": [
"parliament",
"session"
],
"properties": {
"session": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive session number.",
"exclusiveMinimum": 0
},
"parliament": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive parliament number.",
"exclusiveMinimum": 0
}
},
"description": "Parliament and session numbers.",
"additionalProperties": false
}
],
"description": "Parliamentary session; omitted means current."
},
"billCode": {
"type": "string",
"pattern": "^\\s*(?:(?:[Bb][Ii][Ll][Ll]\\s+)?[CcSs][-\\u0020\\u00A0\\u1680\\u2000-\\u200A\\u202F\\u205F\\u3000\\u2010-\\u2015\\u2212]?[1-9][0-9]*[A-Za-z]?\\s*)?$",
"description": "Exact bill code, including a split-bill suffix letter such as C-15A; accepts bill s321, S321, S 321, or S-321."
},
"dateFrom": {
"type": "string",
"pattern": "^\\s*(?:[0-9]{4}-[0-9]{2}-[0-9]{2}\\s*)?$",
"description": "Inclusive Ottawa civil date YYYY-MM-DD; independently optional."
},
"documentType": {
"type": "string",
"description": "Official category from canparl_list_reference topic vote_document_types."
},
"subjectContains": {
"type": "string",
"description": "Literal subject substring; matching ignores case, accents, dash and quote styles, and repeated whitespace."
}
},
"additionalProperties": false
}canparl_search_votes output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"session",
"total",
"divisions",
"pagination",
"provenance",
"appliedFilters",
"totalCount",
"shown",
"cap",
"truncated"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Effective page limit after the per-call cap.",
"exclusiveMinimum": 0
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"unsupported_vote_session",
"invalid_vote_filter",
"invalid_date_range",
"upstream_blocked"
],
"description": "Machine-readable failure mode. Declared by this tool: `unsupported_vote_session`: Session with a zero or out-of-range number, or absent from the official division picker. `invalid_vote_filter`: Result or document category is unrecognized. `invalid_date_range`: A date names no calendar day, or the bounds are reversed. `upstream_blocked`: An official parliamentary source refuses the request with HTTP 403. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Returned division count."
},
"total": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Exact matching count before pagination."
},
"notice": {
"type": "string",
"description": "Limit clamp, empty-result, past-end, or response-budget guidance."
},
"session": {
"type": "string",
"description": "Resolved official session."
},
"divisions": {
"type": "array",
"items": {
"type": "object",
"required": [
"session",
"number",
"dateTime",
"subject",
"result",
"yeas",
"nays",
"paired",
"documentType",
"billCode",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Official HTTPS division page."
},
"nays": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Official nay tally, or null."
},
"yeas": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Official yea tally, or null."
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Division number within the session.",
"exclusiveMinimum": 0
},
"paired": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Official paired tally, or null."
},
"result": {
"type": [
"string",
"null"
],
"description": "Official result label, or null."
},
"session": {
"type": "string",
"description": "Official parliament-session token."
},
"subject": {
"type": [
"string",
"null"
],
"description": "Official division subject, or null."
},
"billCode": {
"type": [
"string",
"null"
],
"description": "Linked canonical bill code, or null."
},
"dateTime": {
"type": [
"string",
"null"
],
"description": "Source Ottawa date-time, or null."
},
"documentType": {
"type": [
"string",
"null"
],
"description": "Official document category, or null."
}
},
"description": "Official House division metadata.",
"additionalProperties": false
},
"description": "Matching divisions, date-time descending then number descending."
},
"truncated": {
"type": "boolean",
"description": "Whether more matches remain."
},
"pagination": {
"type": "object",
"required": [
"offset",
"limit",
"nextOffset",
"hasMore"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Effective maximum rows after the per-call cap.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Requested zero-based offset."
},
"hasMore": {
"type": "boolean",
"description": "Whether more rows remain."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Next offset, or null when exhausted."
}
},
"description": "Continuation within the filtered ordering.",
"additionalProperties": false
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"url",
"retrievedAt",
"cached"
],
"properties": {
"url": {
"type": "string",
"pattern": "^https:\\/\\/",
"description": "Absolute HTTPS source request URL."
},
"cached": {
"type": "boolean",
"description": "Whether this response came from the in-memory cache."
},
"source": {
"enum": [
"legisinfo",
"ourcommons",
"openparliament"
],
"type": "string",
"description": "Public source identifier."
},
"retrievedAt": {
"type": "string",
"description": "Original ISO retrieval timestamp."
}
},
"description": "Source retrieval metadata.",
"additionalProperties": false
},
"description": "Source retrieval metadata."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Exact matching count."
},
"appliedFilters": {
"type": "object",
"required": [
"session",
"billCode",
"result",
"documentType",
"dateFrom",
"dateTo",
"subjectContains"
],
"properties": {
"dateTo": {
"type": [
"string",
"null"
],
"description": "Inclusive upper date, or null."
},
"result": {
"type": [
"string",
"null"
],
"description": "Canonical result, or null."
},
"session": {
"type": "string",
"description": "Resolved session."
},
"billCode": {
"type": [
"string",
"null"
],
"description": "Canonical bill code, or null."
},
"dateFrom": {
"type": [
"string",
"null"
],
"description": "Inclusive lower date, or null."
},
"documentType": {
"type": [
"string",
"null"
],
"description": "Canonical category, or null."
},
"subjectContains": {
"type": [
"string",
"null"
],
"description": "Trimmed literal substring, or null."
}
},
"description": "Normalized AND filters.",
"additionalProperties": false
}
},
"additionalProperties": false
}canparl_search_votes annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}canparl_get_vote — Canparl Get Vote
Advertised read-onlyOpen-world
Read a recorded House division, its full official tally, party totals, and a page of individual ballots. Ballot, personId, party, and province filters affect the ballot page only; nonvoters are absent. Omitted session means the verified current official session. Follow nextOffset with identical filters.
canparl_get_vote input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"number"
],
"properties": {
"limit": {
"type": "integer",
"default": 30,
"maximum": 10000,
"minimum": 1,
"description": "Maximum returned ballots, 1–400 per call, default 30; larger values up to 10000 clamp to 400 with a notice. A page ends early at the 24000-byte response budget; follow nextOffset."
},
"party": {
"type": "string",
"description": "Canonical official caucus or certain Bloc/Green alias; historical observed caucuses are accepted."
},
"ballot": {
"type": "string",
"description": "Recorded ballot Yea, Nay, or Paired, case-insensitive; Yes and No are accepted as Yea and Nay."
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Division number returned by canparl_search_votes or canparl_get_bill.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset in the selected ordering."
},
"session": {
"anyOf": [
{
"type": "string",
"pattern": "^\\s*(?:[0-9]+-[0-9]+\\s*)?$",
"description": "Parliament-session token, such as 45-1."
},
{
"type": "object",
"required": [
"parliament",
"session"
],
"properties": {
"session": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive session number.",
"exclusiveMinimum": 0
},
"parliament": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive parliament number.",
"exclusiveMinimum": 0
}
},
"description": "Parliament and session numbers.",
"additionalProperties": false
}
],
"description": "Parliamentary session; omitted means current."
},
"personId": {
"type": "string",
"pattern": "^\\s*(?:[0-9]+\\s*)?$",
"description": "Decimal official person ID from canparl_search_members detailLookup or a ballot row; matches this division's recorded participants, including members no longer seated."
},
"province": {
"type": "string",
"description": "English province/territory name or one of the 13 postal codes."
}
},
"additionalProperties": false
}canparl_get_vote output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"division",
"tally",
"byParty",
"ballotsTotal",
"ballotsMatched",
"ballots",
"pagination",
"provenance",
"appliedFilters",
"tallyMatchesBallots",
"totalCount",
"shown",
"cap",
"truncated"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Effective ballot page limit after the per-call cap.",
"exclusiveMinimum": 0
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"unsupported_vote_session",
"vote_not_found",
"invalid_ballot_filter",
"vote_detail_unavailable",
"upstream_blocked"
],
"description": "Machine-readable failure mode. Declared by this tool: `unsupported_vote_session`: Session with a zero or out-of-range number, or absent from the official division picker. `vote_not_found`: Division absent from session feed or explicit detail 404. `invalid_ballot_filter`: Unrecognized caucus, province, or ballot value. `vote_detail_unavailable`: A listed division has empty participant detail. `upstream_blocked`: An official parliamentary source refuses the request with HTTP 403. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Returned ballot count."
},
"tally": {
"type": "object",
"required": [
"yea",
"nay",
"paired"
],
"properties": {
"nay": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Official nay count, or null."
},
"yea": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Official yea count, or null."
},
"paired": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Official paired count, or null."
}
},
"description": "Official counts independent of local filters.",
"additionalProperties": false
},
"notice": {
"type": "string",
"description": "Limit clamp, nonvoter, mismatch, empty, past-end, or response-budget guidance."
},
"ballots": {
"type": "array",
"items": {
"type": "object",
"required": [
"personId",
"name",
"party",
"riding",
"province",
"ballot",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Official HTTPS member profile link."
},
"name": {
"type": "string",
"description": "Official participant name."
},
"party": {
"type": [
"string",
"null"
],
"description": "Source caucus, or null."
},
"ballot": {
"enum": [
"Yea",
"Nay",
"Paired"
],
"type": "string",
"description": "Recorded ballot; no inferred nonvoter rows."
},
"riding": {
"type": [
"string",
"null"
],
"description": "Source constituency, or null."
},
"personId": {
"type": "string",
"description": "Official person identifier."
},
"province": {
"type": [
"string",
"null"
],
"description": "Source province, or null."
}
},
"description": "One recorded official participant ballot.",
"additionalProperties": false
},
"description": "Matching ballots ordered by caucus, surname, given name, then personId."
},
"byParty": {
"type": "array",
"items": {
"type": "object",
"required": [
"party",
"yea",
"nay",
"paired",
"total"
],
"properties": {
"nay": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Recorded Nay ballots."
},
"yea": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Recorded Yea ballots."
},
"party": {
"type": [
"string",
"null"
],
"description": "Source caucus, or null for unknown."
},
"total": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Total recorded ballots for this caucus."
},
"paired": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Recorded Paired ballots; never doubled."
}
},
"description": "Unfiltered recorded ballots for one source caucus.",
"additionalProperties": false
},
"description": "Complete unfiltered participant aggregation by source caucus."
},
"division": {
"type": "object",
"required": [
"session",
"number",
"dateTime",
"subject",
"result",
"yeas",
"nays",
"paired",
"documentType",
"billCode",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Official HTTPS division page."
},
"nays": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Official nay tally, or null."
},
"yeas": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Official yea tally, or null."
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Division number within the session.",
"exclusiveMinimum": 0
},
"paired": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Official paired tally, or null."
},
"result": {
"type": [
"string",
"null"
],
"description": "Official result label, or null."
},
"session": {
"type": "string",
"description": "Official parliament-session token."
},
"subject": {
"type": [
"string",
"null"
],
"description": "Official division subject, or null."
},
"billCode": {
"type": [
"string",
"null"
],
"description": "Linked canonical bill code, or null."
},
"dateTime": {
"type": [
"string",
"null"
],
"description": "Source Ottawa date-time, or null."
},
"documentType": {
"type": [
"string",
"null"
],
"description": "Official document category, or null."
}
},
"description": "Verified full-session division metadata.",
"additionalProperties": false
},
"truncated": {
"type": "boolean",
"description": "Whether more matching ballots remain, including after a response-budget stop."
},
"pagination": {
"type": "object",
"required": [
"offset",
"limit",
"nextOffset",
"hasMore"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Effective maximum rows after the per-call cap.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Requested zero-based offset."
},
"hasMore": {
"type": "boolean",
"description": "Whether more rows remain."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Next offset, or null when exhausted."
}
},
"description": "Continuation within matching ballots; nextOffset is offset plus ballots returned.",
"additionalProperties": false
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"url",
"retrievedAt",
"cached"
],
"properties": {
"url": {
"type": "string",
"pattern": "^https:\\/\\/",
"description": "Absolute HTTPS source request URL."
},
"cached": {
"type": "boolean",
"description": "Whether this response came from the in-memory cache."
},
"source": {
"enum": [
"legisinfo",
"ourcommons",
"openparliament"
],
"type": "string",
"description": "Public source identifier."
},
"retrievedAt": {
"type": "string",
"description": "Original ISO retrieval timestamp."
}
},
"description": "Source retrieval metadata.",
"additionalProperties": false
},
"description": "Retrieval metadata for every source request."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Matching ballot count before pagination."
},
"ballotsTotal": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Complete recorded participant count."
},
"appliedFilters": {
"type": "object",
"required": [
"session",
"number",
"party",
"province",
"ballot",
"personId"
],
"properties": {
"party": {
"type": [
"string",
"null"
],
"description": "Canonical caucus filter, or null."
},
"ballot": {
"type": [
"string",
"null"
],
"description": "Canonical recorded-ballot filter, or null."
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Verified division number.",
"exclusiveMinimum": 0
},
"session": {
"type": "string",
"description": "Resolved session."
},
"personId": {
"type": [
"string",
"null"
],
"description": "Official person ID filter, or null."
},
"province": {
"type": [
"string",
"null"
],
"description": "Canonical province filter, or null."
}
},
"description": "Normalized ballot filters and division identity.",
"additionalProperties": false
},
"ballotsMatched": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Exact matching count before pagination."
},
"tallyMatchesBallots": {
"type": [
"boolean",
"null"
],
"description": "Whether all three official counts match participants; null if any count is absent."
}
},
"additionalProperties": false
}canparl_get_vote annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}canparl_search_speeches — Canparl Search Speeches
Advertised read-onlyOpen-world
Find indexed House Hansard speeches by speaker, bill debated or mentioned, or date. contains scans at most 100 candidate speeches per call; follow nextOffset without changing filters until exhausted before drawing a negative conclusion.
canparl_search_speeches input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 10000,
"minimum": 1,
"description": "Maximum returned matches, 1–10 per call; larger values up to 10000 clamp to 10 with a notice. A page ends early at the 24000-byte response budget, returning at least one match whole. Candidate pages contain 20 rows."
},
"dateTo": {
"type": "string",
"pattern": "^\\s*(?:[0-9]{4}-[0-9]{2}-[0-9]{2}\\s*)?$",
"description": "Inclusive Ottawa civil date upper bound, YYYY-MM-DD; independently optional."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Raw candidate offset; keep every filter identical when continuing."
},
"contains": {
"type": "string",
"description": "Local literal substring of the selected language's plain text; matching ignores case, accents, dash and quote styles, and repeated whitespace. A speech without text in that language never matches. Cannot be the only scope."
},
"dateFrom": {
"type": "string",
"pattern": "^\\s*(?:[0-9]{4}-[0-9]{2}-[0-9]{2}\\s*)?$",
"description": "Inclusive Ottawa civil date lower bound, YYYY-MM-DD; independently optional."
},
"language": {
"enum": [
"en",
"fr"
],
"type": "string",
"default": "en",
"description": "Hansard language of speaker, h1, h2, and content, and of the text contains scans: en (default) or fr. A field without text in that language is null, never filled from the other; older records carry no French. party and riding stay English. Keep identical when continuing."
},
"politician": {
"type": "string",
"description": "Speaker OpenParliament slug or exact politician path/HTTPS URL (member.slug from canparl_get_member, or an includeFormer canparl_search_members row), or a current MP's official personId. A digit-only value equal to a current personId, or its /politicians/<digits>/ path or profile URL, is read as that personId."
},
"billDebated": {
"type": "object",
"required": [
"session",
"code"
],
"properties": {
"code": {
"type": "string",
"pattern": "^\\s*(?:[Bb][Ii][Ll][Ll]\\s+)?[CcSs][-\\u0020\\u00A0\\u1680\\u2000-\\u200A\\u202F\\u205F\\u3000\\u2010-\\u2015\\u2212]?[1-9][0-9]*[A-Za-z]?\\s*$",
"description": "Required bill code, including a split-bill suffix letter such as C-15A; accepts bill s321, S321, S 321, or S-321."
},
"session": {
"anyOf": [
{
"type": "string",
"pattern": "^\\s*[0-9]+-[0-9]+\\s*$",
"description": "Parliament-session token, such as 45-1."
},
{
"type": "object",
"required": [
"parliament",
"session"
],
"properties": {
"session": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive session number.",
"exclusiveMinimum": 0
},
"parliament": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive parliament number.",
"exclusiveMinimum": 0
}
},
"description": "Parliament and session numbers.",
"additionalProperties": false
}
],
"description": "Required explicit parliament-session for this bill."
}
},
"description": "Bill debated; combined with all other scopes using AND.",
"additionalProperties": false
},
"mentionedBill": {
"type": "object",
"required": [
"session",
"code"
],
"properties": {
"code": {
"type": "string",
"pattern": "^\\s*(?:[Bb][Ii][Ll][Ll]\\s+)?[CcSs][-\\u0020\\u00A0\\u1680\\u2000-\\u200A\\u202F\\u205F\\u3000\\u2010-\\u2015\\u2212]?[1-9][0-9]*[A-Za-z]?\\s*$",
"description": "Required bill code, including a split-bill suffix letter such as C-15A; accepts bill s321, S321, S 321, or S-321."
},
"session": {
"anyOf": [
{
"type": "string",
"pattern": "^\\s*[0-9]+-[0-9]+\\s*$",
"description": "Parliament-session token, such as 45-1."
},
{
"type": "object",
"required": [
"parliament",
"session"
],
"properties": {
"session": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive session number.",
"exclusiveMinimum": 0
},
"parliament": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive parliament number.",
"exclusiveMinimum": 0
}
},
"description": "Parliament and session numbers.",
"additionalProperties": false
}
],
"description": "Required explicit parliament-session for this bill."
}
},
"description": "Bill mentioned; combined with all other scopes using AND.",
"additionalProperties": false
},
"substantiveOnly": {
"type": "boolean",
"default": true,
"description": "Exclude procedural remarks when true; false includes substantive and procedural remarks."
}
},
"additionalProperties": false
}canparl_search_speeches output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"speeches",
"scanned",
"exhausted",
"nextOffset",
"provenance",
"appliedFilters",
"shown",
"cap",
"truncated",
"excludedCommittees"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Effective maximum returned matches after the per-call cap.",
"exclusiveMinimum": 0
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"speech_scope_required",
"invalid_speech_filter",
"speech_entity_not_found",
"upstream_filter_not_honored",
"upstream_blocked"
],
"description": "Machine-readable failure mode. Declared by this tool: `speech_scope_required`: No speaker, bill, or date bound is supplied. `invalid_speech_filter`: A malformed slug, a bill session with a zero or out-of-range number, a date naming no calendar day, reversed date bounds, or dateTo 9999-12-31. `speech_entity_not_found`: A supplied speaker or bill is absent from OpenParliament, or a current personId has no unique verified profile. `upstream_filter_not_honored`: A returned candidate violates an applied speaker, time, or procedural filter. `upstream_blocked`: An official parliamentary source refuses the request with HTTP 403. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of returned matching speeches."
},
"notice": {
"type": "string",
"description": "Limit clamp, coverage, continuation, procedural-filter, candidates without selected-language text, unavailable affiliation, and response-budget guidance."
},
"scanned": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Raw candidates visited, including excluded committee records; at most 100. A response-budget stop ends it before the first match not returned."
},
"speeches": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"speaker",
"politician",
"membershipUrl",
"party",
"riding",
"time",
"h1",
"h2",
"content",
"procedural",
"url",
"debateUrl"
],
"properties": {
"h1": {
"type": [
"string",
"null"
],
"description": "Primary heading in the selected language, or null when absent or blank."
},
"h2": {
"type": [
"string",
"null"
],
"description": "Secondary heading in the selected language, or null when absent or blank."
},
"id": {
"type": "string",
"description": "Source speech identifier."
},
"url": {
"type": "string",
"description": "Absolute HTTPS speech link."
},
"time": {
"type": "string",
"description": "Original Ottawa civil date-time; no timezone offset is invented."
},
"party": {
"type": [
"string",
"null"
],
"description": "Party from the speech-date membership, or null when unavailable."
},
"riding": {
"type": [
"string",
"null"
],
"description": "Riding from the speech-date membership, or null when unavailable."
},
"content": {
"type": [
"string",
"null"
],
"description": "Complete plain text in the selected language, or null when that language has none; never filled from the other language."
},
"speaker": {
"type": [
"string",
"null"
],
"description": "Source attribution in the selected language, or null when absent or blank."
},
"debateUrl": {
"type": [
"string",
"null"
],
"description": "Absolute HTTPS House debate document link."
},
"politician": {
"type": [
"string",
"null"
],
"description": "OpenParliament speaker slug, or null for institutional speakers."
},
"procedural": {
"type": [
"boolean",
"null"
],
"description": "Source procedural flag, or null when unavailable."
},
"membershipUrl": {
"type": [
"string",
"null"
],
"description": "Historical membership HTTPS URL, or null."
}
},
"description": "One indexed House speech with complete text and historical affiliation.",
"additionalProperties": false
},
"description": "Matching House speeches in source order with complete prose in the selected language."
},
"exhausted": {
"type": "boolean",
"description": "True only after visiting every row of a source-terminal page."
},
"truncated": {
"type": "boolean",
"description": "Whether raw candidates remain to be scanned; not an exact count of further matches."
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "First unvisited raw candidate offset, or null when exhausted; after a response-budget stop, the first match not returned."
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"url",
"retrievedAt",
"cached"
],
"properties": {
"url": {
"type": "string",
"pattern": "^https:\\/\\/",
"description": "Absolute HTTPS source request URL."
},
"cached": {
"type": "boolean",
"description": "Whether this response came from the in-memory cache."
},
"source": {
"enum": [
"legisinfo",
"ourcommons",
"openparliament"
],
"type": "string",
"description": "Public source identifier."
},
"retrievedAt": {
"type": "string",
"description": "Original ISO retrieval timestamp."
}
},
"description": "Source retrieval metadata.",
"additionalProperties": false
},
"description": "Original retrieval metadata for scope validation, candidate pages fetched before the page ended, and memberships of returned speeches."
},
"appliedFilters": {
"type": "object",
"required": [
"politician",
"politicianName",
"billDebated",
"mentionedBill",
"dateFrom",
"dateTo",
"substantiveOnly",
"contains",
"language",
"offset"
],
"properties": {
"dateTo": {
"type": [
"string",
"null"
],
"description": "Inclusive normalized upper date, or null."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Requested raw candidate offset."
},
"contains": {
"type": [
"string",
"null"
],
"description": "Trimmed local literal text filter applied to the selected language, or null."
},
"dateFrom": {
"type": [
"string",
"null"
],
"description": "Inclusive normalized lower date, or null."
},
"language": {
"enum": [
"en",
"fr"
],
"type": "string",
"description": "Selected Hansard language of the returned text and of the contains scan."
},
"politician": {
"type": [
"string",
"null"
],
"description": "Normalized verified speaker slug, or null."
},
"billDebated": {
"type": [
"string",
"null"
],
"description": "Selected debated-bill path, or null."
},
"mentionedBill": {
"type": [
"string",
"null"
],
"description": "Selected mentioned-bill path, or null."
},
"politicianName": {
"type": [
"string",
"null"
],
"description": "Name on the verified OpenParliament speaker profile, or null."
},
"substantiveOnly": {
"type": "boolean",
"description": "Whether procedural remarks were excluded."
}
},
"description": "All normalized filters applied with AND; bill relationships rely on the source endpoint.",
"additionalProperties": false
},
"excludedCommittees": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Visited candidates excluded because they were not House debate documents."
}
},
"additionalProperties": false
}canparl_search_speeches annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}canparl_list_reference — Canparl List Reference
Advertised read-onlyOpen-world
List canonical session coverage and bill, division, and caucus vocabulary. Use source-specific terms when constructing filters. Omitted session means the verified current session for vocabulary. For topic sessions omit session; the entire global index is returned. Topic parties covers the current session only: its entries come from the current House roster, so a past division's caucuses come from canparl_get_vote byParty.
canparl_list_reference input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"topic"
],
"properties": {
"topic": {
"enum": [
"sessions",
"bill_types",
"bill_statuses",
"vote_results",
"vote_document_types",
"parties"
],
"type": "string",
"description": "Reference topic used to construct source-specific filters."
},
"session": {
"anyOf": [
{
"type": "string",
"pattern": "^\\s*(?:[0-9]+-[0-9]+\\s*)?$",
"description": "Parliament-session token, such as 45-1."
},
{
"type": "object",
"required": [
"parliament",
"session"
],
"properties": {
"session": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive session number.",
"exclusiveMinimum": 0
},
"parliament": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Positive parliament number.",
"exclusiveMinimum": 0
}
},
"description": "Parliament and session numbers.",
"additionalProperties": false
}
],
"description": "Session for session-dependent vocabulary; omitted means current. Omit it for topic sessions; topic parties accepts only the current session."
}
},
"additionalProperties": false
}canparl_list_reference output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"topic",
"session",
"currentSession",
"entries",
"provenance",
"appliedFilters",
"totalCount",
"shown",
"cap",
"truncated"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Complete reference entry count; no display cap is imposed."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"unknown_reference_session",
"incompatible_reference_session",
"upstream_blocked"
],
"description": "Machine-readable failure mode. Declared by this tool: `unknown_reference_session`: Session with a zero or out-of-range number, or absent from the topic-relevant source index. `incompatible_reference_session`: A session is supplied for the global sessions topic, or a session other than the current one for the parties topic, whose entries describe the current House roster. `upstream_blocked`: An official parliamentary source refuses the request with HTTP 403. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "All returned reference entries."
},
"topic": {
"enum": [
"sessions",
"bill_types",
"bill_statuses",
"vote_results",
"vote_document_types",
"parties"
],
"type": "string",
"description": "Reference topic used to construct source-specific filters."
},
"notice": {
"type": "string",
"description": "Catalog-only or historical coverage guidance."
},
"entries": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"label",
"source",
"description",
"observed"
],
"properties": {
"label": {
"type": "string",
"description": "Source-specific display label."
},
"value": {
"type": "string",
"description": "Canonical filter value or actual session token."
},
"source": {
"enum": [
"legisinfo",
"ourcommons",
"openparliament"
],
"type": "string",
"description": "Public source identifier."
},
"coverage": {
"type": "object",
"required": [
"bills",
"houseDivisions",
"openParliament"
],
"properties": {
"bills": {
"enum": [
"basic",
"full",
"not_supported"
],
"type": "string",
"description": "Official advertised bill coverage."
},
"houseDivisions": {
"enum": [
"advertised",
"not_supported"
],
"type": "string",
"description": "Whether the official division picker advertises the session."
},
"openParliament": {
"type": "string",
"description": "Qualitative indexing coverage, without an exhaustive session guarantee."
}
},
"description": "Combined source coverage for a session.",
"additionalProperties": false
},
"observed": {
"type": [
"boolean",
"null"
],
"description": "Whether observed in the selected feed; null when not applicable."
},
"parliament": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Actual parliament number from source index.",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"description": "Applicability and source vocabulary guidance."
},
"sessionNumber": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Actual session number from source index.",
"exclusiveMinimum": 0
}
},
"description": "One source-specific canonical reference entry.",
"additionalProperties": false
},
"description": "Complete bounded reference vocabulary or real session union."
},
"session": {
"type": [
"string",
"null"
],
"description": "Selected session, or null for the global session index."
},
"truncated": {
"type": "boolean",
"description": "Always false: the entire vocabulary is returned."
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"url",
"retrievedAt",
"cached"
],
"properties": {
"url": {
"type": "string",
"pattern": "^https:\\/\\/",
"description": "Absolute HTTPS source request URL."
},
"cached": {
"type": "boolean",
"description": "Whether this response came from the in-memory cache."
},
"source": {
"enum": [
"legisinfo",
"ourcommons",
"openparliament"
],
"type": "string",
"description": "Public source identifier."
},
"retrievedAt": {
"type": "string",
"description": "Original ISO retrieval timestamp."
}
},
"description": "Source retrieval metadata.",
"additionalProperties": false
},
"description": "Source retrieval metadata."
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Exact number of reference entries."
},
"appliedFilters": {
"type": "object",
"required": [
"topic",
"session"
],
"properties": {
"topic": {
"enum": [
"sessions",
"bill_types",
"bill_statuses",
"vote_results",
"vote_document_types",
"parties"
],
"type": "string",
"description": "Reference topic used to construct source-specific filters."
},
"session": {
"type": [
"string",
"null"
],
"description": "Normalized selected session or null."
}
},
"description": "Resolved reference scope.",
"additionalProperties": false
},
"currentSession": {
"type": "string",
"description": "Current session verified from the official default bill feed."
}
},
"additionalProperties": false
}canparl_list_reference annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}Prompts
0 advertised
Resources
1 advertised
canada-parliament-guide
Use canparl_* tools to trace a Canadian federal bill through House divisions, establish an MP's recorded ballot, or research historical Hansard evidence. Guides session identity, division selection, source coverage, and conclusions about missing activity.
canada-parliament-guide URI
skill://canada-parliament-guide/SKILL.mdio.modelcontextprotocol/skills
io.modelcontextprotocol/skills URI template
skill://{+path}30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 617 ms
- 95th percentile latency
- 617 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 617 ms · metadata changed · 8 tool(s), 1 resource(s), 1 resource template(s), 0 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http canada-parliament-mcp-server https://canada-parliament.caseyjhand.com/mcpCodex
Codex configuration
codex mcp add canada-parliament-mcp-server --url https://canada-parliament.caseyjhand.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"canada-parliament-mcp-server": {
"url": "https://canada-parliament.caseyjhand.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"canada-parliament-mcp-server": {
"type": "streamableHttp",
"url": "https://canada-parliament.caseyjhand.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"canada-parliament-mcp-server": {
"type": "http",
"url": "https://canada-parliament.caseyjhand.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http canada-parliament-mcp-server https://canada-parliament.caseyjhand.com/mcpClaude Desktop
Claude Desktop configuration
{
"mcpServers": {
"canada-parliament-mcp-server": {
"url": "https://canada-parliament.caseyjhand.com/mcp"
}
}
}Windsurf
Windsurf configuration
{
"mcpServers": {
"canada-parliament-mcp-server": {
"serverUrl": "https://canada-parliament.caseyjhand.com/mcp"
}
}
}Let your agent find its tools
Find servers like canada-parliament-mcp-server from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.