uk-parliament-mcp 1.1.0__py3-none-any.whl

uk_parliament_mcp/tools/members.py

@@ -0,0 +1,439 @@
+"""Members API tools for MPs, Lords, constituencies, and parties."""
+
+from urllib.parse import quote
+
+from mcp.server.fastmcp import FastMCP
+
+from uk_parliament_mcp.config import MEMBERS_API_BASE
+from uk_parliament_mcp.http_client import build_url, get_result
+
+
+def register_tools(mcp: FastMCP) -> None:
+    """Register member tools with the MCP server."""
+
+    @mcp.tool()
+    async def get_member_by_name(name: str) -> str:
+        """Search for MPs and Lords by name with comprehensive member details | find MP, search politician, lookup member, who is, member search, parliamentary representative | Use for identifying members, checking spellings, finding member IDs, or getting basic member information | Returns member profiles with names, parties, constituencies, and current status
+
+        Args:
+            name: Full or partial name to search for. Examples: 'Boris Johnson', 'Keir Starmer', 'Smith'. Searches current and former members.
+
+        Returns:
+            Member profiles with names, parties, constituencies, and current status.
+        """
+        url = f"{MEMBERS_API_BASE}/Members/Search?Name={quote(name)}"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_answering_bodies() -> str:
+        """Get government departments and their parliamentary responsibilities | government departments, ministries, answering bodies, policy areas, department structure, who answers questions | Use for understanding government structure, finding responsible departments, or determining who answers questions on specific topics | Returns department names, abbreviations, and policy responsibilities
+
+        Returns:
+            Department names, abbreviations, and policy responsibilities.
+        """
+        url = f"{MEMBERS_API_BASE}/Reference/AnsweringBodies"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_member_by_id(member_id: int) -> str:
+        """Get comprehensive member profile by ID with full parliamentary details | member details, MP profile, member information, parliamentary roles, constituency data | Use when you have a member ID and need complete biographical, political, and contact information | Returns detailed member data including roles, constituency, party, and career information
+
+        Args:
+            member_id: Parliament member ID. Required: get from member search first. Example: 1423
+
+        Returns:
+            Detailed member data including roles, constituency, party, and career information.
+        """
+        url = f"{MEMBERS_API_BASE}/Members/{member_id}"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def edms_for_member_id(member_id: int) -> str:
+        """Get all Early Day Motions signed by a specific MP. Use when you want to see what issues a particular member has supported or their political priorities through EDM signatures.
+
+        Args:
+            member_id: Parliament member ID to get EDMs for.
+
+        Returns:
+            List of Early Day Motions signed by the member.
+        """
+        url = f"{MEMBERS_API_BASE}/Members/{member_id}/Edms"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def parties_list_by_house(house: int) -> str:
+        """Get list of active political parties in either House of Commons (1) or House of Lords (2). Use when you need to know current party representation or party structures in Parliament.
+
+        Args:
+            house: House number: 1 for Commons, 2 for Lords.
+
+        Returns:
+            List of active political parties in the specified house.
+        """
+        url = f"{MEMBERS_API_BASE}/Parties/GetActive/{house}"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_departments() -> str:
+        """Get list of all government departments. Use when you need to know the structure of government or which department handles specific policy areas.
+
+        Returns:
+            List of all government departments.
+        """
+        url = f"{MEMBERS_API_BASE}/Reference/Departments"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_contributions(member_id: int) -> str:
+        """Get summary of parliamentary contributions (speeches, questions, interventions) made by a specific member. Use when analyzing an MP or Lord's parliamentary activity and participation levels.
+
+        Args:
+            member_id: Parliament member ID to get contribution summary for.
+
+        Returns:
+            Summary of parliamentary contributions for the member.
+        """
+        url = f"{MEMBERS_API_BASE}/Members/{member_id}/ContributionSummary?page=1"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_constituencies(
+        skip: int | None = None,
+        take: int | None = None,
+    ) -> str:
+        """Get list of UK parliamentary constituencies with pagination support. Use when you need constituency information, want to browse all constituencies, or need constituency data for analysis.
+
+        Args:
+            skip: Number of constituencies to skip (for pagination).
+            take: Number of constituencies to return (default 20, max 100).
+
+        Returns:
+            List of UK parliamentary constituencies.
+        """
+        url = build_url(
+            f"{MEMBERS_API_BASE}/Location/Constituency/Search",
+            {"skip": skip, "take": take},
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_election_results_for_constituency(constituency_id: int) -> str:
+        """Get historical election results for a specific constituency. Use when researching constituency voting patterns, election history, or past electoral outcomes for a particular area.
+
+        Args:
+            constituency_id: Unique constituency ID number.
+
+        Returns:
+            Historical election results for the constituency.
+        """
+        url = f"{MEMBERS_API_BASE}/Location/Constituency/{constituency_id}/ElectionResults"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_lords_interests_staff(search_term: str = "richard") -> str:
+        """Search for staff interests declared by Lords. Use when investigating potential conflicts of interest related to Lords' staff or understanding transparency requirements for parliamentary staff.
+
+        Args:
+            search_term: Search term for staff names or interests (default 'richard').
+
+        Returns:
+            Staff interests declared by Lords matching the search term.
+        """
+        url = f"{MEMBERS_API_BASE}/LordsInterests/Staff?searchTerm={quote(search_term)}"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_members_biography(member_id: int) -> str:
+        """Get comprehensive member biography and personal history | MP background, life story, career details, education, personal info, political experience | Use for researching member backgrounds, writing profiles, understanding political journey | Returns detailed biographical data including education, career timeline, and political milestones
+
+        Args:
+            member_id: Parliament member ID. Required: get from member search first. Returns comprehensive biographical information.
+
+        Returns:
+            Detailed biographical data including education, career timeline, and political milestones.
+        """
+        url = f"{MEMBERS_API_BASE}/Members/{member_id}/Biography"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_members_contact(member_id: int) -> str:
+        """Get member contact details and office information | MP contact, phone number, email, office address, constituency office | Use for contacting members, finding office locations, or getting official contact details | Returns phone numbers, addresses, and official contact information
+
+        Args:
+            member_id: Parliament member ID. Required: get from member search first. Returns official contact details.
+
+        Returns:
+            Phone numbers, addresses, and official contact information.
+        """
+        url = f"{MEMBERS_API_BASE}/Members/{member_id}/Contact"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def search_members(
+        name: str | None = None,
+        location: str | None = None,
+        post_title: str | None = None,
+        party_id: int | None = None,
+        house: int | None = None,
+        constituency_id: int | None = None,
+        name_starts_with: str | None = None,
+        gender: str | None = None,
+        membership_started_since: str | None = None,
+        membership_ended_since: str | None = None,
+        was_member_on_or_after: str | None = None,
+        was_member_on_or_before: str | None = None,
+        was_member_of_house: int | None = None,
+        is_eligible: bool | None = None,
+        is_current_member: bool | None = None,
+        policy_interest_id: int | None = None,
+        experience: str | None = None,
+        skip: int = 0,
+        take: int = 20,
+    ) -> str:
+        """Search for current MPs and Lords with comprehensive filtering options. Use when you need to find members by name, location, party, constituency, gender, posts held, or policy interests. Supports advanced search criteria including membership dates and eligibility status.
+
+        Args:
+            name: Optional: full or partial name to search for.
+            location: Optional: location or constituency name.
+            post_title: Optional: post title (e.g. 'Minister', 'Secretary of State').
+            party_id: Optional: party ID to filter by.
+            house: Optional: house number (1=Commons, 2=Lords).
+            constituency_id: Optional: constituency ID to filter by.
+            name_starts_with: Optional: filter names starting with specific letter(s).
+            gender: Optional: gender filter ('M' or 'F').
+            membership_started_since: Optional: membership started since date in YYYY-MM-DD format.
+            membership_ended_since: Optional: membership ended since date in YYYY-MM-DD format.
+            was_member_on_or_after: Optional: was member on or after date in YYYY-MM-DD format.
+            was_member_on_or_before: Optional: was member on or before date in YYYY-MM-DD format.
+            was_member_of_house: Optional: was member of house (1=Commons, 2=Lords).
+            is_eligible: Optional: filter by eligibility status.
+            is_current_member: Optional: filter by current membership status.
+            policy_interest_id: Optional: policy interest ID to filter by.
+            experience: Optional: search term for professional experience.
+            skip: Number of records to skip (for pagination).
+            take: Number of records to return (default 20, max 100).
+
+        Returns:
+            Matching member profiles with comprehensive details.
+        """
+        url = build_url(
+            f"{MEMBERS_API_BASE}/Members/Search",
+            {
+                "Name": name,
+                "Location": location,
+                "PostTitle": post_title,
+                "PartyId": party_id,
+                "House": house,
+                "ConstituencyId": constituency_id,
+                "NameStartsWith": name_starts_with,
+                "Gender": gender,
+                "MembershipStartedSince": membership_started_since,
+                "MembershipEnded.MembershipEndedSince": membership_ended_since,
+                "MembershipInDateRange.WasMemberOnOrAfter": was_member_on_or_after,
+                "MembershipInDateRange.WasMemberOnOrBefore": was_member_on_or_before,
+                "MembershipInDateRange.WasMemberOfHouse": was_member_of_house,
+                "IsEligible": is_eligible,
+                "IsCurrentMember": is_current_member,
+                "PolicyInterestId": policy_interest_id,
+                "Experience": experience,
+                "skip": skip,
+                "take": take,
+            },
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def search_members_historical(
+        name: str | None = None,
+        date_to_search_for: str | None = None,
+        skip: int = 0,
+        take: int = 20,
+    ) -> str:
+        """Search for historical members who were active on a specific date. Use when you need to find MPs or Lords who served during a particular period in parliamentary history.
+
+        Args:
+            name: Optional: full or partial name to search for.
+            date_to_search_for: Optional: specific date to search for members active on that date (YYYY-MM-DD format).
+            skip: Number of records to skip (for pagination).
+            take: Number of records to return (default 20, max 100).
+
+        Returns:
+            Historical members matching the search criteria.
+        """
+        url = build_url(
+            f"{MEMBERS_API_BASE}/Members/SearchHistorical",
+            {
+                "name": name,
+                "dateToSearchFor": date_to_search_for,
+                "skip": skip,
+                "take": take,
+            },
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_member_experience(member_id: int) -> str:
+        """Get professional experience and career background of a member by ID. Use when researching a member's qualifications, previous employment, education, or professional history before entering Parliament.
+
+        Args:
+            member_id: Parliament member ID to get professional experience for.
+
+        Returns:
+            Professional experience and career background of the member.
+        """
+        url = f"{MEMBERS_API_BASE}/Members/{member_id}/Experience"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_member_focus(member_id: int) -> str:
+        """Get areas of focus and policy interests of a member by ID. Use when understanding what issues and policy areas a member prioritizes or specializes in.
+
+        Args:
+            member_id: Parliament member ID to get policy focus areas for.
+
+        Returns:
+            Areas of focus and policy interests of the member.
+        """
+        url = f"{MEMBERS_API_BASE}/Members/{member_id}/Focus"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_member_registered_interests(
+        member_id: int,
+        house: int | None = None,
+    ) -> str:
+        """Get registered interests of a member by ID and house. Use when investigating potential conflicts of interest, financial interests, or external roles. Shows declared interests like directorships, consultancies, and gifts.
+
+        Args:
+            member_id: Parliament member ID to get registered interests for.
+            house: Optional: house number (1=Commons, 2=Lords).
+
+        Returns:
+            Registered interests of the member.
+        """
+        url = build_url(
+            f"{MEMBERS_API_BASE}/Members/{member_id}/RegisteredInterests",
+            {"house": house},
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_member_staff(member_id: int) -> str:
+        """Get staff members working for a specific MP or Lord by member ID. Use when researching parliamentary office staff, researchers, or support personnel.
+
+        Args:
+            member_id: Parliament member ID to get staff details for.
+
+        Returns:
+            Staff members working for the member.
+        """
+        url = f"{MEMBERS_API_BASE}/Members/{member_id}/Staff"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_member_synopsis(member_id: int) -> str:
+        """Get a brief synopsis or summary about a member by ID. Use when you need a concise overview of a member's background, role, or key information.
+
+        Args:
+            member_id: Parliament member ID to get synopsis for.
+
+        Returns:
+            Brief synopsis or summary about the member.
+        """
+        url = f"{MEMBERS_API_BASE}/Members/{member_id}/Synopsis"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_member_voting(
+        member_id: int,
+        house: int,
+        page: int | None = None,
+    ) -> str:
+        """Get voting records of a member by ID for a specific house. Use when analyzing how a member votes, their voting patterns, or their stance on particular issues through their voting history.
+
+        Args:
+            member_id: Parliament member ID to get voting record for.
+            house: House number (1=Commons, 2=Lords).
+            page: Optional: page number for pagination.
+
+        Returns:
+            Voting records of the member.
+        """
+        url = build_url(
+            f"{MEMBERS_API_BASE}/Members/{member_id}/Voting",
+            {"house": house, "page": page},
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_member_written_questions(
+        member_id: int,
+        page: int | None = None,
+    ) -> str:
+        """Get written questions submitted by a member by ID. Use when researching what questions a member has asked of government departments or their areas of parliamentary inquiry.
+
+        Args:
+            member_id: Parliament member ID to get written questions for.
+            page: Optional: page number for pagination.
+
+        Returns:
+            Written questions submitted by the member.
+        """
+        url = build_url(
+            f"{MEMBERS_API_BASE}/Members/{member_id}/WrittenQuestions",
+            {"page": page},
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_members_history(member_ids: list[int]) -> str:
+        """Get historical information for multiple members by their IDs. Returns name history, party affiliations, and membership details over time. Use when researching how members' details have changed throughout their careers.
+
+        Args:
+            member_ids: List of Parliament member IDs to get history for.
+
+        Returns:
+            Historical information for the specified members.
+        """
+        ids_str = ",".join(str(id) for id in member_ids)
+        url = build_url(f"{MEMBERS_API_BASE}/Members/History", {"ids": ids_str})
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_member_latest_election_result(member_id: int) -> str:
+        """Get the latest election result for a member by ID. Use when researching how a member was elected, their constituency performance, vote share, or election margin.
+
+        Args:
+            member_id: Parliament member ID to get latest election result for.
+
+        Returns:
+            Latest election result for the member.
+        """
+        url = f"{MEMBERS_API_BASE}/Members/{member_id}/LatestElectionResult"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_member_portrait_url(member_id: int) -> str:
+        """Get the portrait image URL for a member by ID. Use when you need a link to a member's official parliamentary portrait photograph.
+
+        Args:
+            member_id: Parliament member ID to get portrait URL for.
+
+        Returns:
+            Portrait image URL for the member.
+        """
+        url = f"{MEMBERS_API_BASE}/Members/{member_id}/PortraitUrl"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_member_thumbnail_url(member_id: int) -> str:
+        """Get the thumbnail image URL for a member by ID. Use when you need a link to a smaller version of a member's parliamentary photograph for lists or compact displays.
+
+        Args:
+            member_id: Parliament member ID to get thumbnail URL for.
+
+        Returns:
+            Thumbnail image URL for the member.
+        """
+        url = f"{MEMBERS_API_BASE}/Members/{member_id}/ThumbnailUrl"
+        return await get_result(url)

uk_parliament_mcp/tools/now.py

@@ -0,0 +1,30 @@
+"""Now API tools for live chamber activity."""
+
+from mcp.server.fastmcp import FastMCP
+
+from uk_parliament_mcp.config import NOW_API_BASE
+from uk_parliament_mcp.http_client import get_result
+
+
+def register_tools(mcp: FastMCP) -> None:
+    """Register now tools with the MCP server."""
+
+    @mcp.tool()
+    async def happening_now_in_commons() -> str:
+        """Get live information about what's currently happening in the House of Commons chamber. Use when you want real-time updates on parliamentary business, current debates, or voting activity.
+
+        Returns:
+            Live information about current Commons chamber activity.
+        """
+        url = f"{NOW_API_BASE}/Message/message/CommonsMain/current"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def happening_now_in_lords() -> str:
+        """Get live information about what's currently happening in the House of Lords chamber. Use when you want real-time updates on Lords business, current debates, or voting activity.
+
+        Returns:
+            Live information about current Lords chamber activity.
+        """
+        url = f"{NOW_API_BASE}/Message/message/LordsMain/current"
+        return await get_result(url)

uk_parliament_mcp/tools/oral_questions.py

@@ -0,0 +1,55 @@
+"""Oral Questions API tools for EDMs and question times."""
+
+from urllib.parse import quote
+
+from mcp.server.fastmcp import FastMCP
+
+from uk_parliament_mcp.config import ORAL_QUESTIONS_API_BASE
+from uk_parliament_mcp.http_client import get_result
+
+
+def register_tools(mcp: FastMCP) -> None:
+    """Register oral questions tools with the MCP server."""
+
+    @mcp.tool()
+    async def get_recently_tabled_edms(take: int = 10) -> str:
+        """Get recently tabled Early Day Motions - formal political statements | EDMs, political motions, backbench initiatives, MP opinions, parliamentary statements, political positions, cross-party support | Use for tracking political sentiment, finding MP stances on issues, monitoring backbench activity, or researching political movements | Returns recent EDMs with titles, sponsors, supporters, and tabling dates | Data freshness: updated daily
+
+        Args:
+            take: Number of EDMs to return. Default: 10, recommended max: 50. Recent motions returned first.
+
+        Returns:
+            Recent EDMs with titles, sponsors, supporters, and tabling dates.
+        """
+        url = f"{ORAL_QUESTIONS_API_BASE}/EarlyDayMotions/list?parameters.orderBy=DateTabledDesc&skip=0&take={take}"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def search_early_day_motions(search_term: str) -> str:
+        """Search Early Day Motions by topic or keyword. Use when researching MP opinions on specific issues or finding motions related to particular subjects. EDMs often reflect backbench MP concerns.
+
+        Args:
+            search_term: Search term for EDM topics or content (e.g. 'climate change', 'NHS funding').
+
+        Returns:
+            EDMs matching the search term.
+        """
+        url = f"{ORAL_QUESTIONS_API_BASE}/EarlyDayMotions/list?parameters.searchTerm={quote(search_term)}"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def search_oral_question_times(
+        answering_date_start: str,
+        answering_date_end: str,
+    ) -> str:
+        """Get scheduled oral question times for ministers in Parliament. Use when you want to know when specific departments will answer questions or when particular topics will be discussed.
+
+        Args:
+            answering_date_start: Start date for question times in YYYY-MM-DD format.
+            answering_date_end: End date for question times in YYYY-MM-DD format.
+
+        Returns:
+            Scheduled oral question times in the date range.
+        """
+        url = f"{ORAL_QUESTIONS_API_BASE}/oralquestiontimes/list?parameters.answeringDateStart={quote(answering_date_start)}&parameters.answeringDateEnd={quote(answering_date_end)}"
+        return await get_result(url)

uk_parliament_mcp/tools/statutory_instruments.py

@@ -0,0 +1,38 @@
+"""Statutory Instruments API tools for secondary legislation."""
+
+from urllib.parse import quote
+
+from mcp.server.fastmcp import FastMCP
+
+from uk_parliament_mcp.config import STATUTORY_INSTRUMENTS_API_BASE
+from uk_parliament_mcp.http_client import get_result
+
+
+def register_tools(mcp: FastMCP) -> None:
+    """Register statutory instruments tools with the MCP server."""
+
+    @mcp.tool()
+    async def search_statutory_instruments(name: str) -> str:
+        """Search for Statutory Instruments (secondary legislation) by name. Use when researching government regulations, rules, or orders made under primary legislation. SIs are used to implement or modify laws.
+
+        Args:
+            name: Name or title of the statutory instrument to search for.
+
+        Returns:
+            Statutory Instruments matching the search term.
+        """
+        url = f"{STATUTORY_INSTRUMENTS_API_BASE}/StatutoryInstrument?Name={quote(name)}"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def search_acts_of_parliament(name: str) -> str:
+        """Search for Acts of Parliament (primary legislation) by name or topic. Use when researching existing laws, finding legislation on specific subjects, or understanding the legal framework on particular issues.
+
+        Args:
+            name: Name or title of the Act to search for (e.g. 'Climate Change Act', 'Human Rights Act').
+
+        Returns:
+            Acts of Parliament matching the search term.
+        """
+        url = f"{STATUTORY_INSTRUMENTS_API_BASE}/ActOfParliament?Name={quote(name)}"
+        return await get_result(url)

uk_parliament_mcp/tools/treaties.py

@@ -0,0 +1,25 @@
+"""Treaties API tools for international agreements."""
+
+from urllib.parse import quote
+
+from mcp.server.fastmcp import FastMCP
+
+from uk_parliament_mcp.config import TREATIES_API_BASE
+from uk_parliament_mcp.http_client import get_result
+
+
+def register_tools(mcp: FastMCP) -> None:
+    """Register treaties tools with the MCP server."""
+
+    @mcp.tool()
+    async def search_treaties(search_text: str) -> str:
+        """Search UK international treaties and agreements under parliamentary scrutiny | treaties, international agreements, trade deals, diplomatic treaties, international law, bilateral agreements | Use for researching international relations, trade agreements, or diplomatic commitments | Returns treaty details including titles, countries involved, and parliamentary scrutiny status
+
+        Args:
+            search_text: Search term for treaties. Examples: 'trade', 'EU', 'climate', 'Brexit'. Searches titles and content.
+
+        Returns:
+            Treaty details including titles, countries involved, and parliamentary scrutiny status.
+        """
+        url = f"{TREATIES_API_BASE}/Treaty?SearchText={quote(search_text)}"
+        return await get_result(url)

uk_parliament_mcp/tools/whatson.py

@@ -0,0 +1,72 @@
+"""WhatsOn API tools for parliamentary calendar and sessions."""
+
+from mcp.server.fastmcp import FastMCP
+
+from uk_parliament_mcp.config import WHATSON_API_BASE
+from uk_parliament_mcp.http_client import build_url, get_result
+
+
+def register_tools(mcp: FastMCP) -> None:
+    """Register whatson tools with the MCP server."""
+
+    @mcp.tool()
+    async def search_calendar(
+        house: str,
+        start_date: str,
+        end_date: str,
+    ) -> str:
+        """Search parliamentary calendar for upcoming events and business in either chamber. Use when you want to know what's scheduled in Parliament, upcoming debates, or future parliamentary business. House: Commons/Lords.
+
+        Args:
+            house: House name: 'Commons' or 'Lords'.
+            start_date: Start date in YYYY-MM-DD format.
+            end_date: End date in YYYY-MM-DD format.
+
+        Returns:
+            Parliamentary calendar events in the date range.
+        """
+        url = build_url(
+            f"{WHATSON_API_BASE}/events/list.json",
+            {
+                "queryParameters.house": house,
+                "queryParameters.startDate": start_date,
+                "queryParameters.endDate": end_date,
+            },
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_sessions() -> str:
+        """Get list of parliamentary sessions. Use when you need to understand parliamentary terms, session dates, or the parliamentary calendar structure.
+
+        Returns:
+            List of parliamentary sessions.
+        """
+        url = f"{WHATSON_API_BASE}/sessions/list.json"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_non_sitting_days(
+        house: str,
+        start_date: str,
+        end_date: str,
+    ) -> str:
+        """Get periods when Parliament is not sitting (recesses, holidays). Use when you need to know when Parliament is on break, recess periods, or when no parliamentary business is scheduled.
+
+        Args:
+            house: House name: 'Commons' or 'Lords'.
+            start_date: Start date in YYYY-MM-DD format.
+            end_date: End date in YYYY-MM-DD format.
+
+        Returns:
+            Non-sitting days in the date range.
+        """
+        url = build_url(
+            f"{WHATSON_API_BASE}/events/nonsitting.json",
+            {
+                "queryParameters.house": house,
+                "queryParameters.startDate": start_date,
+                "queryParameters.endDate": end_date,
+            },
+        )
+        return await get_result(url)