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

uk_parliament_mcp/tools/committees.py

@@ -0,0 +1,385 @@
+"""Committees API tools for committee info, meetings, and evidence."""
+from urllib.parse import quote
+
+from mcp.server.fastmcp import FastMCP
+
+from uk_parliament_mcp.http_client import build_url, get_result
+
+COMMITTEES_API_BASE = "https://committees-api.parliament.uk/api"
+
+
+def register_tools(mcp: FastMCP) -> None:
+    """Register committees tools with the MCP server."""
+
+    @mcp.tool()
+    async def get_committee_meetings(from_date: str, to_date: str) -> str:
+        """Find committee meetings and hearings by date range | committee meetings, parliamentary hearings, committee schedule, committee calendar, when committees meet | Use for finding committee schedules, planning attendance, or researching past committee activity | Returns meeting details including committees, dates, times, and topics | Covers both Commons and Lords committees
+
+        Args:
+            from_date: Start date. Format: YYYY-MM-DD. Example: 2024-01-15
+            to_date: End date. Format: YYYY-MM-DD. Must be after start date.
+
+        Returns:
+            Meeting details including committees, dates, times, and topics.
+        """
+        url = f"{COMMITTEES_API_BASE}/Broadcast/Meetings?FromDate={quote(from_date)}&ToDate={quote(to_date)}"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def search_committees(search_term: str) -> str:
+        """Search for parliamentary committees by name or subject area. Use when you need to find which committee covers a specific policy area or when researching committee work.
+
+        Args:
+            search_term: Search term for committee names or subject areas (e.g. 'Treasury', 'Health', 'Defence').
+
+        Returns:
+            Matching committees with details.
+        """
+        url = f"{COMMITTEES_API_BASE}/Committees?SearchTerm={quote(search_term)}"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_committee_types() -> str:
+        """Get all types of parliamentary committees (e.g., Select Committee, Public Bill Committee, Delegated Legislation Committee). Use when understanding committee structures or finding the right committee type.
+
+        Returns:
+            All committee types with descriptions.
+        """
+        url = f"{COMMITTEES_API_BASE}/CommitteeType"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_committee_by_id(
+        committee_id: int,
+        include_banners: bool = False,
+        show_on_website_only: bool = True,
+    ) -> str:
+        """Get comprehensive committee profile and membership details | committee information, committee members, committee purpose, parliamentary committee, scrutiny committee | Use for understanding committee roles, finding committee members, or researching committee activities | Returns full committee details including purpose, members, departments scrutinized, and contact information
+
+        Args:
+            committee_id: Committee ID. Required: get from committee search first. Example: 739
+            include_banners: Include banner images. Default: false. May increase response size.
+            show_on_website_only: Show only public committees. Default: true. Recommended for general use.
+
+        Returns:
+            Full committee details including purpose, members, and contact information.
+        """
+        url = build_url(
+            f"{COMMITTEES_API_BASE}/Committees/{committee_id}",
+            {
+                "includeBanners": include_banners,
+                "showOnWebsiteOnly": show_on_website_only,
+            },
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_events(
+        committee_id: int | None = None,
+        committee_business_id: int | None = None,
+        search_term: str | None = None,
+        start_date_from: str | None = None,
+        start_date_to: str | None = None,
+        end_date_from: str | None = None,
+        location_id: int | None = None,
+        exclude_cancelled_events: bool | None = None,
+        sort_ascending: bool | None = None,
+        event_type_id: int | None = None,
+        include_event_attendees: bool = False,
+        show_on_website_only: bool = True,
+        skip: int = 0,
+        take: int = 30,
+    ) -> str:
+        """Search for committee events with flexible filtering options. Use when you need to find meetings, hearings, or other committee activities by date, location, or committee. Supports filtering by start/end dates, house, event type, and location.
+
+        Args:
+            committee_id: Optional: filter by specific committee ID.
+            committee_business_id: Optional: filter by committee business ID.
+            search_term: Optional: search term for event titles or content.
+            start_date_from: Optional: start date from in YYYY-MM-DD format.
+            start_date_to: Optional: start date to in YYYY-MM-DD format.
+            end_date_from: Optional: end date from in YYYY-MM-DD format.
+            location_id: Optional: location ID to filter events.
+            exclude_cancelled_events: Optional: exclude cancelled events.
+            sort_ascending: Optional: sort ascending by date.
+            event_type_id: Optional: filter by event type ID.
+            include_event_attendees: Include event attendees in response.
+            show_on_website_only: Show only events visible on website.
+            skip: Number of records to skip (for pagination).
+            take: Number of records to return (default 30, max 100).
+
+        Returns:
+            Committee events matching the criteria.
+        """
+        url = build_url(
+            f"{COMMITTEES_API_BASE}/Events",
+            {
+                "CommitteeId": committee_id,
+                "CommitteeBusinessId": committee_business_id,
+                "SearchTerm": search_term,
+                "StartDateFrom": start_date_from,
+                "StartDateTo": start_date_to,
+                "EndDateFrom": end_date_from,
+                "LocationId": location_id,
+                "ExcludeCancelledEvents": exclude_cancelled_events,
+                "SortAscending": sort_ascending,
+                "EventTypeId": event_type_id,
+                "IncludeEventAttendees": include_event_attendees,
+                "ShowOnWebsiteOnly": show_on_website_only,
+                "Skip": skip,
+                "Take": take,
+            },
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_event_by_id(
+        event_id: int,
+        show_on_website_only: bool = True,
+    ) -> str:
+        """Get detailed information about a specific committee event by ID. Use when you need complete event details including activities, attendees, committees involved, and related business.
+
+        Args:
+            event_id: Unique event ID number.
+            show_on_website_only: Show only events visible on website.
+
+        Returns:
+            Detailed information about the event.
+        """
+        url = build_url(
+            f"{COMMITTEES_API_BASE}/Events/{event_id}",
+            {"showOnWebsiteOnly": show_on_website_only},
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_committee_events(
+        committee_id: int,
+        committee_business_id: int | None = None,
+        search_term: str | None = None,
+        start_date_from: str | None = None,
+        start_date_to: str | None = None,
+        end_date_from: str | None = None,
+        location_id: int | None = None,
+        exclude_cancelled_events: bool | None = None,
+        sort_ascending: bool | None = None,
+        event_type_id: int | None = None,
+        include_event_attendees: bool = False,
+        show_on_website_only: bool = True,
+        skip: int = 0,
+        take: int = 30,
+    ) -> str:
+        """Get events for a specific committee by committee ID. Use when you want to see all meetings and activities for a particular committee, with options to filter by date range, business, and event type.
+
+        Args:
+            committee_id: Committee ID to get events for.
+            committee_business_id: Optional: filter by committee business ID.
+            search_term: Optional: search term for event titles or content.
+            start_date_from: Optional: start date from in YYYY-MM-DD format.
+            start_date_to: Optional: start date to in YYYY-MM-DD format.
+            end_date_from: Optional: end date from in YYYY-MM-DD format.
+            location_id: Optional: location ID to filter events.
+            exclude_cancelled_events: Optional: exclude cancelled events.
+            sort_ascending: Optional: sort ascending by date.
+            event_type_id: Optional: filter by event type ID.
+            include_event_attendees: Include event attendees in response.
+            show_on_website_only: Show only events visible on website.
+            skip: Number of records to skip (for pagination).
+            take: Number of records to return (default 30, max 100).
+
+        Returns:
+            Events for the specified committee.
+        """
+        url = build_url(
+            f"{COMMITTEES_API_BASE}/Committees/{committee_id}/Events",
+            {
+                "CommitteeBusinessId": committee_business_id,
+                "SearchTerm": search_term,
+                "StartDateFrom": start_date_from,
+                "StartDateTo": start_date_to,
+                "EndDateFrom": end_date_from,
+                "LocationId": location_id,
+                "ExcludeCancelledEvents": exclude_cancelled_events,
+                "SortAscending": sort_ascending,
+                "EventTypeId": event_type_id,
+                "IncludeEventAttendees": include_event_attendees,
+                "ShowOnWebsiteOnly": show_on_website_only,
+                "Skip": skip,
+                "Take": take,
+            },
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_committee_members(
+        committee_id: int,
+        membership_status: str | None = None,
+        show_on_website_only: bool = True,
+        skip: int = 0,
+        take: int = 30,
+    ) -> str:
+        """Get members and staff of a specific committee by committee ID. Use when you need to know who serves on a committee, their roles, and membership status (current/former). Returns both elected members and lay members.
+
+        Args:
+            committee_id: Committee ID to get members for.
+            membership_status: Optional: filter by membership status (e.g. 'Current', 'Former').
+            show_on_website_only: Show only members visible on website.
+            skip: Number of records to skip (for pagination).
+            take: Number of records to return (default 30, max 100).
+
+        Returns:
+            Members and staff of the committee.
+        """
+        url = build_url(
+            f"{COMMITTEES_API_BASE}/Committees/{committee_id}/Members",
+            {
+                "MembershipStatus": membership_status,
+                "ShowOnWebsiteOnly": show_on_website_only,
+                "Skip": skip,
+                "Take": take,
+            },
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_publications(
+        search_term: str | None = None,
+        start_date: str | None = None,
+        end_date: str | None = None,
+        committee_business_id: int | None = None,
+        committee_id: int | None = None,
+        show_on_website_only: bool = True,
+        skip: int = 0,
+        take: int = 30,
+    ) -> str:
+        """Search for committee publications including reports, government responses, and other documents. Use when researching committee outputs, finding reports on specific topics, or tracking publication dates and paper numbers.
+
+        Args:
+            search_term: Optional: search term for publication titles or content.
+            start_date: Optional: start date in YYYY-MM-DD format.
+            end_date: Optional: end date in YYYY-MM-DD format.
+            committee_business_id: Optional: committee business ID to filter by.
+            committee_id: Optional: committee ID to filter by.
+            show_on_website_only: Show only publications visible on website.
+            skip: Number of records to skip (for pagination).
+            take: Number of records to return (default 30, max 100).
+
+        Returns:
+            Committee publications matching the criteria.
+        """
+        url = build_url(
+            f"{COMMITTEES_API_BASE}/Publications",
+            {
+                "SearchTerm": search_term,
+                "StartDate": start_date,
+                "EndDate": end_date,
+                "CommitteeBusinessId": committee_business_id,
+                "CommitteeId": committee_id,
+                "ShowOnWebsiteOnly": show_on_website_only,
+                "Skip": skip,
+                "Take": take,
+            },
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_publication_by_id(
+        publication_id: int,
+        show_on_website_only: bool = True,
+    ) -> str:
+        """Get detailed information about a specific committee publication by ID. Use when you need complete publication details including documents, HC numbers, government responses, and associated committee business.
+
+        Args:
+            publication_id: Unique publication ID number.
+            show_on_website_only: Show only publications visible on website.
+
+        Returns:
+            Detailed information about the publication.
+        """
+        url = build_url(
+            f"{COMMITTEES_API_BASE}/Publications/{publication_id}",
+            {"showOnWebsiteOnly": show_on_website_only},
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_written_evidence(
+        committee_business_id: int | None = None,
+        committee_id: int | None = None,
+        search_term: str | None = None,
+        start_date: str | None = None,
+        end_date: str | None = None,
+        show_on_website_only: bool = True,
+        skip: int = 0,
+        take: int = 30,
+    ) -> str:
+        """Search for written evidence submissions to committees. Use when researching stakeholder submissions, witness statements, or public input to committee inquiries. Can filter by committee, business, witness names, or publication dates.
+
+        Args:
+            committee_business_id: Optional: committee business ID to filter by.
+            committee_id: Optional: committee ID to filter by.
+            search_term: Optional: search term for evidence content or witness names.
+            start_date: Optional: start date in YYYY-MM-DD format.
+            end_date: Optional: end date in YYYY-MM-DD format.
+            show_on_website_only: Show only evidence visible on website.
+            skip: Number of records to skip (for pagination).
+            take: Number of records to return (default 30, max 100).
+
+        Returns:
+            Written evidence submissions matching the criteria.
+        """
+        url = build_url(
+            f"{COMMITTEES_API_BASE}/WrittenEvidence",
+            {
+                "CommitteeBusinessId": committee_business_id,
+                "CommitteeId": committee_id,
+                "SearchTerm": search_term,
+                "StartDate": start_date,
+                "EndDate": end_date,
+                "ShowOnWebsiteOnly": show_on_website_only,
+                "Skip": skip,
+                "Take": take,
+            },
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_oral_evidence(
+        committee_business_id: int | None = None,
+        committee_id: int | None = None,
+        search_term: str | None = None,
+        start_date: str | None = None,
+        end_date: str | None = None,
+        show_on_website_only: bool = True,
+        skip: int = 0,
+        take: int = 30,
+    ) -> str:
+        """Search for oral evidence sessions from committee hearings. Use when researching witness testimonies, committee hearings, or transcripts from evidence sessions. Can filter by committee, business, witness names, or meeting dates.
+
+        Args:
+            committee_business_id: Optional: committee business ID to filter by.
+            committee_id: Optional: committee ID to filter by.
+            search_term: Optional: search term for evidence content or witness names.
+            start_date: Optional: start date in YYYY-MM-DD format.
+            end_date: Optional: end date in YYYY-MM-DD format.
+            show_on_website_only: Show only evidence visible on website.
+            skip: Number of records to skip (for pagination).
+            take: Number of records to return (default 30, max 100).
+
+        Returns:
+            Oral evidence sessions matching the criteria.
+        """
+        url = build_url(
+            f"{COMMITTEES_API_BASE}/OralEvidence",
+            {
+                "CommitteeBusinessId": committee_business_id,
+                "CommitteeId": committee_id,
+                "SearchTerm": search_term,
+                "StartDate": start_date,
+                "EndDate": end_date,
+                "ShowOnWebsiteOnly": show_on_website_only,
+                "Skip": skip,
+                "Take": take,
+            },
+        )
+        return await get_result(url)

uk_parliament_mcp/tools/commons_votes.py

@@ -0,0 +1,138 @@
+"""Commons Votes API tools for House of Commons divisions and voting records."""
+from mcp.server.fastmcp import FastMCP
+
+from uk_parliament_mcp.http_client import build_url, get_result
+
+COMMONS_VOTES_API_BASE = "http://commonsvotes-api.parliament.uk/data"
+
+
+def register_tools(mcp: FastMCP) -> None:
+    """Register Commons votes tools with the MCP server."""
+
+    @mcp.tool()
+    async def search_commons_divisions(
+        search_term: str,
+        member_id: int | None = None,
+        start_date: str | None = None,
+        end_date: str | None = None,
+        division_number: int | None = None,
+    ) -> str:
+        """Search House of Commons voting records (divisions). Use when you want to find how MPs voted on specific issues, bills, or amendments. Can filter by member, date range, or division number.
+
+        Args:
+            search_term: Search term for division topics (e.g. 'brexit', 'climate', 'NHS').
+            member_id: Optional: specific member ID to filter votes.
+            start_date: Optional: start date in YYYY-MM-DD format.
+            end_date: Optional: end date in YYYY-MM-DD format.
+            division_number: Optional: specific division number.
+
+        Returns:
+            Commons divisions matching the search criteria.
+        """
+        url = build_url(
+            f"{COMMONS_VOTES_API_BASE}/divisions.json/search",
+            {
+                "queryParameters.searchTerm": search_term,
+                "memberId": member_id,
+                "queryParameters.startDate": start_date,
+                "queryParameters.endDate": end_date,
+                "queryParameters.divisionNumber": division_number,
+            },
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_commons_voting_record_for_member(member_id: int) -> str:
+        """Get complete voting record of an MP in House of Commons divisions. Use when analyzing how a specific MP votes, their voting patterns, or their stance on particular issues through their voting history.
+
+        Args:
+            member_id: Parliament member ID to get Commons voting record for.
+
+        Returns:
+            Complete Commons voting record for the member.
+        """
+        url = f"{COMMONS_VOTES_API_BASE}/divisions.json/membervoting?queryParameters.memberId={member_id}"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_commons_division_by_id(division_id: int) -> str:
+        """Get detailed information about a specific House of Commons division by ID. Use when you need complete details about a particular vote including who voted for/against, tellers, and voting totals.
+
+        Args:
+            division_id: Unique Commons division ID number.
+
+        Returns:
+            Detailed information about the Commons division.
+        """
+        url = f"{COMMONS_VOTES_API_BASE}/division/{division_id}.json"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_commons_divisions_grouped_by_party(
+        search_term: str | None = None,
+        member_id: int | None = None,
+        start_date: str | None = None,
+        end_date: str | None = None,
+        division_number: int | None = None,
+        include_when_member_was_teller: bool | None = None,
+    ) -> str:
+        """Get House of Commons divisions grouped by party voting patterns. Use when analyzing how different parties voted on issues or understanding party-line voting behavior. Shows vote counts by party rather than individual MPs.
+
+        Args:
+            search_term: Optional: search term to filter divisions.
+            member_id: Optional: member ID to filter divisions.
+            start_date: Optional: start date in YYYY-MM-DD format.
+            end_date: Optional: end date in YYYY-MM-DD format.
+            division_number: Optional: specific division number.
+            include_when_member_was_teller: Optional: include when member was a teller.
+
+        Returns:
+            Commons divisions grouped by party.
+        """
+        url = build_url(
+            f"{COMMONS_VOTES_API_BASE}/divisions.json/groupedbyparty",
+            {
+                "queryParameters.searchTerm": search_term,
+                "queryParameters.memberId": member_id,
+                "queryParameters.startDate": start_date,
+                "queryParameters.endDate": end_date,
+                "queryParameters.divisionNumber": division_number,
+                "queryParameters.includeWhenMemberWasTeller": include_when_member_was_teller,
+            },
+        )
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_commons_divisions_search_count(
+        search_term: str | None = None,
+        member_id: int | None = None,
+        start_date: str | None = None,
+        end_date: str | None = None,
+        division_number: int | None = None,
+        include_when_member_was_teller: bool | None = None,
+    ) -> str:
+        """Get total count of House of Commons divisions matching search criteria. Use when you need to know how many divisions match your search parameters before retrieving the actual results.
+
+        Args:
+            search_term: Optional: search term to filter divisions.
+            member_id: Optional: member ID to filter divisions.
+            start_date: Optional: start date in YYYY-MM-DD format.
+            end_date: Optional: end date in YYYY-MM-DD format.
+            division_number: Optional: specific division number.
+            include_when_member_was_teller: Optional: include when member was a teller.
+
+        Returns:
+            Total count of matching Commons divisions.
+        """
+        url = build_url(
+            f"{COMMONS_VOTES_API_BASE}/divisions.json/searchTotalResults",
+            {
+                "queryParameters.searchTerm": search_term,
+                "queryParameters.memberId": member_id,
+                "queryParameters.startDate": start_date,
+                "queryParameters.endDate": end_date,
+                "queryParameters.divisionNumber": division_number,
+                "queryParameters.includeWhenMemberWasTeller": include_when_member_was_teller,
+            },
+        )
+        return await get_result(url)

uk_parliament_mcp/tools/core.py

@@ -0,0 +1,28 @@
+"""Core tools for Parliament data assistant session management."""
+from mcp.server.fastmcp import FastMCP
+
+SYSTEM_PROMPT = """You are a helpful assistant that answers questions using only data from UK Parliament MCP servers.
+When the session begins, introduce yourself with a brief message such as:
+"Hello! I'm a parliamentary data assistant. I can help answer questions using official data from the UK Parliament MCP APIs. Just ask me something, and I'll fetch what I can - and I'll always show you which sources I used."
+When responding to user queries, you must:
+Only retrieve and use data from the MCP API endpoints this server provides.
+Avoid using any external sources or inferred knowledge.
+After every response, append a list of all MCP API URLs used to generate the answer.
+If no relevant data is available via the MCP API, state that clearly and do not attempt to fabricate a response.
+Convert raw data into human-readable summaries while preserving accuracy, but always list the raw URLs used."""
+
+GOODBYE_PROMPT = """You are now interacting as a normal assistant. There are no special restrictions or requirements for using UK Parliament MCP data. You may answer questions using any available data or knowledge, and you do not need to append MCP API URLs or limit yourself to MCP sources. Resume normal assistant behavior."""
+
+
+def register_tools(mcp: FastMCP) -> None:
+    """Register core tools with the MCP server."""
+
+    @mcp.tool()
+    async def hello_parliament() -> str:
+        """Initialize Parliament data assistant with system prompt | setup, configuration, start session, getting started, how to use, instructions | Use FIRST when beginning parliamentary research to get proper assistant behavior and data handling guidelines | Returns system prompt for optimal parliamentary data interaction"""
+        return SYSTEM_PROMPT
+
+    @mcp.tool()
+    async def goodbye_parliament() -> str:
+        """End Parliament session and restore normal assistant behavior | exit, quit, finish session, reset, normal mode, end parliamentary mode | Use when finished with parliamentary research to return to standard assistant behavior | Removes parliamentary data restrictions and requirements"""
+        return GOODBYE_PROMPT

uk_parliament_mcp/tools/erskine_may.py

@@ -0,0 +1,25 @@
+"""Erskine May API tools for parliamentary procedure."""
+from urllib.parse import quote
+
+from mcp.server.fastmcp import FastMCP
+
+from uk_parliament_mcp.http_client import get_result
+
+ERSKINE_MAY_API_BASE = "https://erskinemay-api.parliament.uk/api"
+
+
+def register_tools(mcp: FastMCP) -> None:
+    """Register Erskine May tools with the MCP server."""
+
+    @mcp.tool()
+    async def search_erskine_may(search_term: str) -> str:
+        """Search Erskine May parliamentary procedure manual. Use when you need to understand parliamentary rules, procedures, or precedents. Erskine May is the authoritative guide to parliamentary procedure.
+
+        Args:
+            search_term: Search term for parliamentary procedure rules (e.g. 'Speaker', 'amendment', 'division').
+
+        Returns:
+            Erskine May paragraphs matching the search term.
+        """
+        url = f"{ERSKINE_MAY_API_BASE}/Search/ParagraphSearchResults/{quote(search_term)}"
+        return await get_result(url)

uk_parliament_mcp/tools/hansard.py

@@ -0,0 +1,39 @@
+"""Hansard API tools for searching the official parliamentary record."""
+from mcp.server.fastmcp import FastMCP
+
+from uk_parliament_mcp.http_client import build_url, get_result
+
+HANSARD_API_BASE = "https://hansard-api.parliament.uk"
+
+
+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,
+    ) -> 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').
+
+        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,
+            },
+        )
+        return await get_result(url)

uk_parliament_mcp/tools/interests.py

@@ -0,0 +1,43 @@
+"""Interests API tools for Register of Interests."""
+from mcp.server.fastmcp import FastMCP
+
+from uk_parliament_mcp.http_client import get_result
+
+INTERESTS_API_BASE = "https://interests-api.parliament.uk/api/v1"
+
+
+def register_tools(mcp: FastMCP) -> None:
+    """Register interests tools with the MCP server."""
+
+    @mcp.tool()
+    async def search_roi(member_id: int) -> str:
+        """Search member's Register of Interests for financial and business declarations | register of interests, ROI, financial interests, conflicts of interest, directorships, consultancies, gifts, external roles, transparency | Use for investigating potential conflicts, researching member finances, or checking declared interests | Returns declared interests including directorships, consultancies, gifts, and other financial interests
+
+        Args:
+            member_id: Parliament member ID. Required: get from member search first. Returns all declared interests.
+
+        Returns:
+            Declared interests including directorships, consultancies, gifts, and other financial interests.
+        """
+        url = f"{INTERESTS_API_BASE}/Interests/?MemberId={member_id}"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def interests_categories() -> str:
+        """Get categories of interests that MPs and Lords must declare in the Register of Interests. Use when you need to understand what types of financial or other interests parliamentarians must declare.
+
+        Returns:
+            Categories of interests that must be declared.
+        """
+        url = f"{INTERESTS_API_BASE}/Categories"
+        return await get_result(url)
+
+    @mcp.tool()
+    async def get_registers_of_interests() -> str:
+        """Get list of published Registers of Interests. Use when you need to see all available interest registers or understand the transparency framework for parliamentary interests.
+
+        Returns:
+            List of published Registers of Interests.
+        """
+        url = f"{INTERESTS_API_BASE}/Registers"
+        return await get_result(url)