uk-parliament-mcp 1.1.0__tar.gz → 1.2.0__tar.gz

{uk_parliament_mcp-1.1.0 → uk_parliament_mcp-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uk-parliament-mcp
-Version: 1.1.0
+Version: 1.2.0
 Summary: UK Parliament MCP Server - bridges AI assistants with UK Parliament APIs
 Author: Chris Brooksbank
 License: MIT
@@ -51,7 +51,7 @@ Access official UK Parliament data through AI assistants. Query MPs, Lords, bill
 - Use the `/parliament` slash command (in Claude Desktop or compatible MCP clients)
 - Or say "Hello Parliament" to initialize the session
 
-This gives your AI assistant the context it needs to effectively use the 92 available tools.
+This gives your AI assistant the context it needs to effectively use the 105 available tools.
 
 ## Claude Desktop Setup
 
@@ -201,26 +201,26 @@ Show me the JSON returned from the last MCP call.
 <summary><strong>Members of Parliament</strong> (14 examples)</summary>
 
 - Show me the interests of Sir Keir Starmer
-- Who is Boris Johnson?
-- Who is the member with ID 1471?
-- Get the biography of member 172
+- Tell me about Boris Johnson's parliamentary career
+- Look up the MP with ID 1471
+- Show me the biography for member 172
 - Show me contact details for member 4129
 - What are the registered interests of member 3743?
-- Show recent contributions from member 172
-- What is the Commons voting record for member 4129?
-- What is the Lords voting record for member 3743?
-- Show the professional experience of member 1471
+- What speeches has member 172 made recently?
+- Show me how member 4129 has voted in the Commons
+- Show me how member 3743 has voted in the Lords
+- What was member 1471's career before Parliament?
 - What policy areas does member 172 focus on?
-- Show early day motions submitted by member 1471
+- What early day motions has member 1471 signed?
 - Get the constituency election results for member 4129
-- Show me the portrait and thumbnail images for member 172
+- Show me photos of member 172
 
 </details>
 
 <details>
 <summary><strong>Bills and Legislation</strong> (14 examples)</summary>
 
-- What recent bills are about fishing?
+- What bills about fishing are currently before Parliament?
 - What bills were updated recently?
 - Show me details of bill 425
 - What stages has bill 425 been through?
@@ -230,9 +230,9 @@ Show me the JSON returned from the last MCP call.
 - What news articles are there about bill 425?
 - Show me all bill types available
 - What are the different stages a bill can go through?
-- Search for bills containing the word "environment"
-- Get the RSS feed for all bills
-- Get the RSS feed for public bills only
+- Find bills related to the environment
+- Get the RSS feed to track all bills
+- Get the RSS feed for public bills
 - Get the RSS feed for bill 425
 
 </details>
@@ -240,12 +240,26 @@ Show me the JSON returned from the last MCP call.
 <details>
 <summary><strong>Voting and Divisions</strong> (6 examples)</summary>
 
-- Search Commons Divisions for the keyword "refugee"
+- How have MPs voted on refugee-related issues?
 - Show details of Commons division 1234
 - Show details of Lords division 5678
-- Get Commons divisions grouped by party for keyword "climate"
-- Get Lords divisions grouped by party for member 3743
-- How many divisions match the search term "brexit"?
+- Show how parties voted on climate issues in the Commons
+- How did Lords vote by party on issues involving member 3743?
+- How many votes have there been on Brexit?
+
+</details>
+
+<details>
+<summary><strong>Written Questions & Statements</strong> (8 examples)</summary>
+
+- What written questions have MPs asked about climate change?
+- Show me unanswered written questions to the Home Office
+- Find written questions about the NHS from the last month
+- Get details of written question 12345
+- What written ministerial statements were made about the budget?
+- Search for written statements about housing policy
+- Show me the daily report of written questions for this week
+- Has any MP asked written questions about artificial intelligence?
 
 </details>
 
@@ -253,29 +267,43 @@ Show me the JSON returned from the last MCP call.
 <summary><strong>Committees and Inquiries</strong> (9 examples)</summary>
 
 - Which committees are focused on women's issues?
-- List committee meetings scheduled for November 2024
+- What committee meetings are scheduled this month?
 - Show me details of committee 789
-- What events has committee 789 held?
+- What hearings has committee 789 held?
 - Who are the members of committee 789?
-- Search for committee publications about healthcare
-- Show me written evidence submitted to committee 789
-- Show me oral evidence from committee 789 hearings
+- Find committee reports on healthcare
+- What written evidence was submitted to committee 789?
+- What oral evidence was given to committee 789?
 - What are all the committee types?
 
 </details>
 
+<details>
+<summary><strong>Hansard (Official Record)</strong> (8 examples)</summary>
+
+- Search Hansard for recent debates on Brexit
+- What was said about immigration in the Commons last month?
+- Show me the full transcript of debate abc123-def456
+- What did Keir Starmer say during the debate on the economy?
+- Were there any votes during the NHS funding debate?
+- What debates happened in the Commons on March 15th 2024?
+- Which days in January 2024 had Commons sittings?
+- Show me all speeches by member 4514 in debate xyz789
+
+</details>
+
 <details>
 <summary><strong>Parliamentary Procedures</strong> (9 examples)</summary>
 
 - Search Erskine May for references to the Mace
-- Show oral question times for questions tabled in November 2024
-- Search Hansard for contributions on Brexit from November 2024
+- What oral question times are coming up?
 - What government departments exist?
 - What are the answering bodies in Parliament?
 - What parties are represented in the House of Commons?
 - What parties are represented in the House of Lords?
-- Show parliamentary calendar events for Commons in December 2024
-- When is Parliament not sitting in January 2025?
+- What's on the Commons calendar this month?
+- When are the upcoming parliamentary recesses?
+- What are the procedural rules for bill amendments?
 
 </details>
 
@@ -293,7 +321,7 @@ Show me the JSON returned from the last MCP call.
 
 - List all categories of members' interests
 - Get published registers of interests
-- Show staff interests for Lords members
+- Show staff interests declared by Lords members
 - Search the register of interests for member 1471
 
 </details>
@@ -316,7 +344,7 @@ Show me the JSON returned from the last MCP call.
 - Show me the JSON returned from the last MCP call
 - Show me the API URL you just used
 - Search for bills sponsored by member 172 from the Environment department
-- Find all committee meetings about climate change between November and December 2024
+- Find committee meetings about climate change in the last few months
 
 </details>
 

{uk_parliament_mcp-1.1.0 → uk_parliament_mcp-1.2.0}/README.md

@@ -27,7 +27,7 @@ Access official UK Parliament data through AI assistants. Query MPs, Lords, bill
 - Use the `/parliament` slash command (in Claude Desktop or compatible MCP clients)
 - Or say "Hello Parliament" to initialize the session
 
-This gives your AI assistant the context it needs to effectively use the 92 available tools.
+This gives your AI assistant the context it needs to effectively use the 105 available tools.
 
 ## Claude Desktop Setup
 
@@ -177,26 +177,26 @@ Show me the JSON returned from the last MCP call.
 <summary><strong>Members of Parliament</strong> (14 examples)</summary>
 
 - Show me the interests of Sir Keir Starmer
-- Who is Boris Johnson?
-- Who is the member with ID 1471?
-- Get the biography of member 172
+- Tell me about Boris Johnson's parliamentary career
+- Look up the MP with ID 1471
+- Show me the biography for member 172
 - Show me contact details for member 4129
 - What are the registered interests of member 3743?
-- Show recent contributions from member 172
-- What is the Commons voting record for member 4129?
-- What is the Lords voting record for member 3743?
-- Show the professional experience of member 1471
+- What speeches has member 172 made recently?
+- Show me how member 4129 has voted in the Commons
+- Show me how member 3743 has voted in the Lords
+- What was member 1471's career before Parliament?
 - What policy areas does member 172 focus on?
-- Show early day motions submitted by member 1471
+- What early day motions has member 1471 signed?
 - Get the constituency election results for member 4129
-- Show me the portrait and thumbnail images for member 172
+- Show me photos of member 172
 
 </details>
 
 <details>
 <summary><strong>Bills and Legislation</strong> (14 examples)</summary>
 
-- What recent bills are about fishing?
+- What bills about fishing are currently before Parliament?
 - What bills were updated recently?
 - Show me details of bill 425
 - What stages has bill 425 been through?
@@ -206,9 +206,9 @@ Show me the JSON returned from the last MCP call.
 - What news articles are there about bill 425?
 - Show me all bill types available
 - What are the different stages a bill can go through?
-- Search for bills containing the word "environment"
-- Get the RSS feed for all bills
-- Get the RSS feed for public bills only
+- Find bills related to the environment
+- Get the RSS feed to track all bills
+- Get the RSS feed for public bills
 - Get the RSS feed for bill 425
 
 </details>
@@ -216,12 +216,26 @@ Show me the JSON returned from the last MCP call.
 <details>
 <summary><strong>Voting and Divisions</strong> (6 examples)</summary>
 
-- Search Commons Divisions for the keyword "refugee"
+- How have MPs voted on refugee-related issues?
 - Show details of Commons division 1234
 - Show details of Lords division 5678
-- Get Commons divisions grouped by party for keyword "climate"
-- Get Lords divisions grouped by party for member 3743
-- How many divisions match the search term "brexit"?
+- Show how parties voted on climate issues in the Commons
+- How did Lords vote by party on issues involving member 3743?
+- How many votes have there been on Brexit?
+
+</details>
+
+<details>
+<summary><strong>Written Questions & Statements</strong> (8 examples)</summary>
+
+- What written questions have MPs asked about climate change?
+- Show me unanswered written questions to the Home Office
+- Find written questions about the NHS from the last month
+- Get details of written question 12345
+- What written ministerial statements were made about the budget?
+- Search for written statements about housing policy
+- Show me the daily report of written questions for this week
+- Has any MP asked written questions about artificial intelligence?
 
 </details>
 
@@ -229,29 +243,43 @@ Show me the JSON returned from the last MCP call.
 <summary><strong>Committees and Inquiries</strong> (9 examples)</summary>
 
 - Which committees are focused on women's issues?
-- List committee meetings scheduled for November 2024
+- What committee meetings are scheduled this month?
 - Show me details of committee 789
-- What events has committee 789 held?
+- What hearings has committee 789 held?
 - Who are the members of committee 789?
-- Search for committee publications about healthcare
-- Show me written evidence submitted to committee 789
-- Show me oral evidence from committee 789 hearings
+- Find committee reports on healthcare
+- What written evidence was submitted to committee 789?
+- What oral evidence was given to committee 789?
 - What are all the committee types?
 
 </details>
 
+<details>
+<summary><strong>Hansard (Official Record)</strong> (8 examples)</summary>
+
+- Search Hansard for recent debates on Brexit
+- What was said about immigration in the Commons last month?
+- Show me the full transcript of debate abc123-def456
+- What did Keir Starmer say during the debate on the economy?
+- Were there any votes during the NHS funding debate?
+- What debates happened in the Commons on March 15th 2024?
+- Which days in January 2024 had Commons sittings?
+- Show me all speeches by member 4514 in debate xyz789
+
+</details>
+
 <details>
 <summary><strong>Parliamentary Procedures</strong> (9 examples)</summary>
 
 - Search Erskine May for references to the Mace
-- Show oral question times for questions tabled in November 2024
-- Search Hansard for contributions on Brexit from November 2024
+- What oral question times are coming up?
 - What government departments exist?
 - What are the answering bodies in Parliament?
 - What parties are represented in the House of Commons?
 - What parties are represented in the House of Lords?
-- Show parliamentary calendar events for Commons in December 2024
-- When is Parliament not sitting in January 2025?
+- What's on the Commons calendar this month?
+- When are the upcoming parliamentary recesses?
+- What are the procedural rules for bill amendments?
 
 </details>
 
@@ -269,7 +297,7 @@ Show me the JSON returned from the last MCP call.
 
 - List all categories of members' interests
 - Get published registers of interests
-- Show staff interests for Lords members
+- Show staff interests declared by Lords members
 - Search the register of interests for member 1471
 
 </details>
@@ -292,7 +320,7 @@ Show me the JSON returned from the last MCP call.
 - Show me the JSON returned from the last MCP call
 - Show me the API URL you just used
 - Search for bills sponsored by member 172 from the Environment department
-- Find all committee meetings about climate change between November and December 2024
+- Find committee meetings about climate change in the last few months
 
 </details>
 

{uk_parliament_mcp-1.1.0 → uk_parliament_mcp-1.2.0}/src/uk_parliament_mcp/__init__.py

@@ -1,3 +1,3 @@
 """UK Parliament MCP Server - bridges AI assistants with UK Parliament APIs."""
 
-__version__ = "1.1.0"
+__version__ = "1.2.0"

{uk_parliament_mcp-1.1.0 → uk_parliament_mcp-1.2.0}/src/uk_parliament_mcp/config.py

@@ -14,6 +14,7 @@ STATUTORY_INSTRUMENTS_API_BASE = "https://statutoryinstruments-api.parliament.uk
 TREATIES_API_BASE = "https://treaties-api.parliament.uk/api"
 ERSKINE_MAY_API_BASE = "https://erskinemay-api.parliament.uk/api"
 ORAL_QUESTIONS_API_BASE = "https://oralquestionsandmotions-api.parliament.uk"
+WRITTEN_QUESTIONS_API_BASE = "https://writtenquestions-api.parliament.uk/api"
 
 # Common constants
 HOUSE_COMMONS = 1

{uk_parliament_mcp-1.1.0 → uk_parliament_mcp-1.2.0}/src/uk_parliament_mcp/server.py

@@ -18,6 +18,7 @@ from uk_parliament_mcp.tools import (
     statutory_instruments,
     treaties,
     whatson,
+    written_questions,
 )
 from uk_parliament_mcp.tools.core import SYSTEM_PROMPT
 
@@ -42,6 +43,7 @@ def create_server() -> FastMCP:
     statutory_instruments.register_tools(mcp)
     treaties.register_tools(mcp)
     erskine_may.register_tools(mcp)
+    written_questions.register_tools(mcp)
 
     # Register prompts (agent skills)
     core.register_prompts(mcp)

uk_parliament_mcp-1.2.0/src/uk_parliament_mcp/tools/hansard.py

@@ -0,0 +1,172 @@
+"""Hansard API tools for searching the official parliamentary record."""
+
+from mcp.server.fastmcp import FastMCP
+
+from uk_parliament_mcp.config import HANSARD_API_BASE
+from uk_parliament_mcp.http_client import build_url, get_result
+
+
+def register_tools(mcp: FastMCP) -> None:
+    """Register Hansard tools with the MCP server."""
+
+    @mcp.tool()
+    async def search_hansard(
+        house: int,
+        start_date: str,
+        end_date: str,
+        search_term: str,
+        member_id: int | None = None,
+        skip: int = 0,
+        take: int = 20,
+    ) -> str:
+        """Search Hansard (official parliamentary record) for speeches and debates. Use when researching what was said in Parliament on specific topics, by specific members, or in specific time periods. House: 1=Commons, 2=Lords.
+
+        Args:
+            house: House number: 1 for Commons, 2 for Lords.
+            start_date: Start date in YYYY-MM-DD format.
+            end_date: End date in YYYY-MM-DD format.
+            search_term: Search term for speeches or debates (e.g. 'climate change', 'NHS').
+            member_id: Optional member ID to filter results to a specific MP/Lord.
+            skip: Number of results to skip for pagination (default 0).
+            take: Number of results to return (default 20, max varies by endpoint).
+
+        Returns:
+            Hansard records matching the search criteria.
+        """
+        url = build_url(
+            f"{HANSARD_API_BASE}/search.json",
+            {
+                "queryParameters.house": house,
+                "queryParameters.startDate": start_date,
+                "queryParameters.endDate": end_date,
+                "queryParameters.searchTerm": search_term,
+                "queryParameters.memberId": member_id,
+                "queryParameters.skip": skip,
+                "queryParameters.take": take,
+            },
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_debate_by_id(debate_section_id: str) -> str:
+        """Get full debate transcript | Hansard, speeches, contributions |
+        Use after search_hansard to get complete debate with all member speeches.
+        Returns debate title, date, house, and all contributions.
+
+        Args:
+            debate_section_id: External ID from search_hansard results.
+
+        Returns:
+            Full debate with all member contributions.
+        """
+        url = f"{HANSARD_API_BASE}/debates/debate/{debate_section_id}.json"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_member_hansard_contributions(
+        member_id: int,
+        debate_section_id: str,
+    ) -> str:
+        """Get all speeches by a specific MP/Lord in a debate | Hansard, member speeches |
+        Use to extract just one member's contributions from a debate.
+        Returns all contributions by that member in the specified debate.
+
+        Args:
+            member_id: Parliament member ID (from members API).
+            debate_section_id: External ID of debate section (from search_hansard).
+
+        Returns:
+            All contributions by that member in the debate.
+        """
+        url = f"{HANSARD_API_BASE}/debates/memberdebatecontributions/{member_id}.json?debateSectionExtId={debate_section_id}"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_debate_divisions(debate_section_id: str) -> str:
+        """Get votes that occurred during a debate | Hansard, divisions, voting |
+        Use to find divisions (votes) that took place in a specific debate.
+        Returns list of divisions with aye/noe counts.
+
+        Args:
+            debate_section_id: External ID of debate section (from search_hansard).
+
+        Returns:
+            List of divisions with vote counts.
+        """
+        url = f"{HANSARD_API_BASE}/debates/divisions/{debate_section_id}.json"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_division_details(
+        division_id: str,
+        is_evel: bool = False,
+    ) -> str:
+        """Get full division details including how each member voted | Hansard, division, voting records |
+        Use to see individual voting records for a specific division.
+        Returns division with debate title, counts, and member voting records.
+
+        Args:
+            division_id: External ID of division (from get_debate_divisions).
+            is_evel: Filter to EVEL (English Votes for English Laws) voters only.
+
+        Returns:
+            Division details with member voting records.
+        """
+        url = build_url(
+            f"{HANSARD_API_BASE}/debates/division/{division_id}.json",
+            {"isEvel": is_evel if is_evel else None},
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_hansard_sitting_day(
+        sitting_date: str,
+        house: int,
+    ) -> str:
+        """Get full agenda/sections for a sitting day | Hansard, daily business, agenda |
+        Use to see all debates and business for a specific day.
+        Returns all debate sections for that day.
+
+        Args:
+            sitting_date: Date in YYYY-MM-DD format.
+            house: House number: 1 for Commons, 2 for Lords.
+
+        Returns:
+            All debate sections for that day.
+        """
+        url = build_url(
+            f"{HANSARD_API_BASE}/overview/sectionsforday.json",
+            {
+                "date": sitting_date,
+                "house": house,
+            },
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_hansard_calendar(
+        year: int,
+        month: int,
+        house: int,
+    ) -> str:
+        """Get all sitting dates for a month | Hansard, calendar, sitting days |
+        Use to discover which days have Hansard records available.
+        Returns list of sitting dates with Hansard available.
+
+        Args:
+            year: Year (e.g. 2024).
+            month: Month number (1-12).
+            house: House number: 1 for Commons, 2 for Lords.
+
+        Returns:
+            List of sitting dates for the month.
+        """
+        url = build_url(
+            f"{HANSARD_API_BASE}/overview/calendar.json",
+            {
+                "year": year,
+                "month": month,
+                "house": house,
+            },
+        )
+        return await get_result(url)