unique-sdk 2026.44.0.dev1__tar.gz → 2026.44.0.dev2__tar.gz

{unique_sdk-2026.44.0.dev1 → unique_sdk-2026.44.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-sdk
-Version: 2026.44.0.dev1
+Version: 2026.44.0.dev2
 Summary: 
 Author: Martin Fadler, Konstantin Krauss, Andreas Hauri
 Author-email: Martin Fadler <martin.fadler@unique.ch>, Konstantin Krauss <konstantin@unique.ch>, Andreas Hauri <andreas@unique.ch>

{unique_sdk-2026.44.0.dev1 → unique_sdk-2026.44.0.dev2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique_sdk"
-version = "2026.44.0.dev1"
+version = "2026.44.0.dev2"
 description = ""
 readme = "README.md"
 license = { text = "MIT" }

{unique_sdk-2026.44.0.dev1 → unique_sdk-2026.44.0.dev2}/unique_sdk/api_resources/_mcp.py

@@ -46,6 +46,29 @@ class CallToolContentDto(TypedDict):
     ]  # For type: "resource"
 
 
+class McpServerToolDto(TypedDict):
+    """A tool of an MCP server that the company has enabled."""
+
+    name: str
+    description: str | None
+
+
+class McpServerDto(TypedDict):
+    """An MCP server (connector) of the company that can be attached to a space."""
+
+    id: str
+    name: str
+    description: str | None
+    requiresOAuth: bool
+    isSpaceRestricted: bool
+    allowedSpaceIds: list[str]
+    tools: list[McpServerToolDto]
+
+
+class McpServersResponse(TypedDict):
+    mcpServers: list[McpServerDto]
+
+
 class MCP(APIResource["MCP"]):
     @classproperty
     def OBJECT_NAME(cls) -> Literal["mcp.call_tool"]:
@@ -128,3 +151,57 @@ class MCP(APIResource["MCP"]):
                 params=params,
             ),
         )
+
+    @classmethod
+    def list_servers(
+        cls,
+        user_id: str,
+        company_id: str,
+    ) -> McpServersResponse:
+        """
+        List the company's MCP servers that can be attached to a space, with their
+        tools. Never returns server URLs or credentials.
+
+        Args:
+            user_id: The ID of the user making the request
+            company_id: The ID of the company
+
+        Returns:
+            McpServersResponse: The servers, sorted by name
+        """
+        return cast(
+            McpServersResponse,
+            cls._static_request(
+                "get",
+                "/mcp/servers",
+                user_id,
+                company_id,
+            ),
+        )
+
+    @classmethod
+    async def list_servers_async(
+        cls,
+        user_id: str,
+        company_id: str,
+    ) -> McpServersResponse:
+        """
+        Asynchronously list the company's MCP servers that can be attached to a space,
+        with their tools. Never returns server URLs or credentials.
+
+        Args:
+            user_id: The ID of the user making the request
+            company_id: The ID of the company
+
+        Returns:
+            McpServersResponse: The servers, sorted by name
+        """
+        return cast(
+            McpServersResponse,
+            await cls._static_request_async(
+                "get",
+                "/mcp/servers",
+                user_id,
+                company_id,
+            ),
+        )

{unique_sdk-2026.44.0.dev1 → unique_sdk-2026.44.0.dev2}/unique_sdk/api_resources/_space.py

@@ -19,7 +19,11 @@ class Space(APIResource["Space"]):
         return "space"
 
     UiType: TypeAlias = Literal[
-        "MAGIC_TABLE", "UNIQUE_CUSTOM", "TRANSLATION", "UNIQUE_AI"
+        "MAGIC_TABLE",
+        "UNIQUE_CUSTOM",
+        "TRANSLATION",
+        "UNIQUE_AI",
+        "SWAPPABLE_INTELLIGENCE",
     ]
 
     class ModuleParams(TypedDict):
@@ -57,6 +61,24 @@ class Space(APIResource["Space"]):
         isExclusive: bool
         configuration: dict[str, Any]
 
+    class McpServerToolParams(TypedDict):
+        name: str
+        isEnabled: bool
+
+    class McpServerParams(TypedDict):
+        """
+        An MCP server (connector) to attach to a space.
+
+        Only listed servers change. ``tools`` is the complete selection for the server:
+        listed tools take ``isEnabled``, unlisted tools are disabled, and an empty list
+        disables the server for the space. Omit ``tools`` to enable every callable tool.
+        Applied after MCP tool entries in module configurations, so it wins for a server
+        that appears in both. Use ``MCP.list_servers`` for the ids and tool names.
+        """
+
+        mcpServerId: str
+        tools: NotRequired[list["Space.McpServerToolParams"] | None]
+
     class CreateSpaceParams(RequestOptions):
         name: str
         fallbackModule: str
@@ -77,6 +99,7 @@ class Space(APIResource["Space"]):
         isSubAgent: NotRequired[bool | None]
         subAgentSettings: NotRequired["Space.SubAgentSettings | None"]
         subAgentIds: NotRequired[list[str] | None]
+        mcpServers: NotRequired[list["Space.McpServerParams"] | None]
 
     class UpdateParams(RequestOptions):
         name: NotRequired[str | None]
@@ -98,6 +121,7 @@ class Space(APIResource["Space"]):
         isSubAgent: NotRequired[bool | None]
         subAgentSettings: NotRequired["Space.SubAgentSettings | None"]
         subAgentIds: NotRequired[list[str] | None]
+        mcpServers: NotRequired[list["Space.McpServerParams"] | None]
 
     class AccessEntry(TypedDict):
         entityId: str
@@ -261,6 +285,10 @@ class Space(APIResource["Space"]):
         messages: list["Space.Message"]
         totalCount: int
 
+    class McpServerTool(TypedDict):
+        name: str
+        isEnabled: bool
+
     class McpServer(TypedDict):
         """
         Represents an MCP server associated with a space.
@@ -271,9 +299,27 @@ class Space(APIResource["Space"]):
         assistantId: str
         mcpServerId: str
         isEnabled: bool
+        tools: NotRequired[list["Space.McpServerTool"]]
         createdAt: str
         updatedAt: str
 
+    class McpServerStatus(TypedDict):
+        """
+        The calling user's own state for an MCP server enabled on a space.
+        """
+
+        mcpServerId: str
+        name: str
+        isEnabled: bool
+        requiresOAuth: bool
+        isOAuth2Connected: bool
+        oauth2Url: str | None
+        enabledToolNames: list[str]
+
+    class McpServerStatusResponse(TypedDict):
+        spaceId: str
+        mcpServers: list["Space.McpServerStatus"]
+
     class Module(TypedDict):
         """
         Represents a module configured for a space.
@@ -911,3 +957,45 @@ class Space(APIResource["Space"]):
                 params=params,
             ),
         )
+
+    @classmethod
+    def get_mcp_server_status(
+        cls,
+        user_id: str,
+        company_id: str,
+        space_id: str,
+    ) -> "Space.McpServerStatusResponse":
+        """
+        Get the MCP servers enabled on a space with the calling user's own OAuth
+        connection state (``isOAuth2Connected``, ``oauth2Url``).
+        """
+        return cast(
+            "Space.McpServerStatusResponse",
+            cls._static_request(
+                "get",
+                f"/space/{space_id}/mcp-servers/status",
+                user_id,
+                company_id,
+            ),
+        )
+
+    @classmethod
+    async def get_mcp_server_status_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        space_id: str,
+    ) -> "Space.McpServerStatusResponse":
+        """
+        Async get the MCP servers enabled on a space with the calling user's own OAuth
+        connection state (``isOAuth2Connected``, ``oauth2Url``).
+        """
+        return cast(
+            "Space.McpServerStatusResponse",
+            await cls._static_request_async(
+                "get",
+                f"/space/{space_id}/mcp-servers/status",
+                user_id,
+                company_id,
+            ),
+        )