universal-mcp-applications 0.1.17__py3-none-any.whl → 0.1.33__py3-none-any.whl

universal_mcp/applications/slack/app.py

@@ -9,6 +9,37 @@ class SlackApp(APIApplication):
         super().__init__(name="slack", integration=integration, **kwargs)
         self.base_url = "https://slack.com/api"
 
+    def _get_headers(self) -> dict[str, str]:
+        """
+        Get headers for Slack API requests.
+        Prioritizes user-scoped access token from raw.authed_user.access_token
+        over the bot token at the root level.
+        """
+        if not self.integration:
+            raise ValueError("Integration not configured for SlackApp")
+        
+        credentials = self.integration.get_credentials()
+        if not credentials:
+            raise ValueError("No credentials found for Slack integration")
+        
+        access_token = None
+        raw = credentials.get('raw', {})
+        if isinstance(raw, dict) and 'authed_user' in raw:
+            authed_user = raw.get('authed_user', {})
+            if isinstance(authed_user, dict):
+                access_token = authed_user.get('access_token')
+        
+        if not access_token:
+            access_token = credentials.get('access_token')
+        
+        if not access_token:
+            raise ValueError("Access token not found in Slack credentials")
+        
+        return {
+            "Authorization": f"Bearer {access_token}",
+            "Content-Type": "application/json",
+        }
+
     def chat_delete(
         self,
         as_user: bool | None = None,
@@ -17,18 +48,18 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Deletes a specific message from a Slack channel. It identifies the message using its channel ID and timestamp (`ts`). This function is distinct from `chat_update` which modifies a message, and `chat_post_message` which sends a new one.
-        
+
         Args:
             as_user (boolean): Pass true to delete the message as the authed user with `chat:write:user` scope. [Bot users](https://slack.dev) in this context are considered authed users. If unused or false, the message will be deleted with `chat:write:bot` scope.
             channel (string): Channel containing the message to be deleted.
             ts (number): Timestamp of the message to be deleted.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chat
         """
@@ -71,7 +102,7 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Posts a new message to a specified Slack channel. It supports rich content formats like text, attachments, and blocks, along with options for threading and authorship. This function creates new messages, unlike `chat_update` which modifies existing ones or `chat_delete` which removes them.
-        
+
         Args:
             as_user (boolean): Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See [authorship](https://slack.dev) below.
             attachments (string): A JSON-based array of structured attachments, presented as a URL-encoded string.
@@ -88,13 +119,13 @@ class SlackApp(APIApplication):
             unfurl_links (boolean): Pass true to enable unfurling of primarily text-based content.
             unfurl_media (boolean): Pass false to disable unfurling of media content.
             username (string): Set your bot's user name. Must be used in conjunction with `as_user` set to false, otherwise ignored. See [authorship](https://slack.dev) below.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chat
         """
@@ -142,7 +173,7 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Updates a specific, existing message in a Slack channel, identified by its timestamp. It modifies content such as text, blocks, or attachments by calling the `chat.update` API endpoint, distinguishing it from functions that create (`chat_post_message`) or delete (`chat_delete`) messages.
-        
+
         Args:
             as_user (string): Pass true to update the message as the authed user. [Bot users](https://slack.dev) in this context are considered authed users.
             attachments (string): A JSON-based array of structured attachments, presented as a URL-encoded string. This field is required when not presenting `text`. If you don't include this field, the message's previous `attachments` will be retained. To remove previous `attachments`, include an empty array for this field.
@@ -152,13 +183,13 @@ class SlackApp(APIApplication):
             parse (string): Change how messages are treated. Defaults to `client`, unlike `chat.postMessage`. Accepts either `none` or `full`. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, `client`.
             text (string): New text for the message, using the [default formatting rules](https://slack.dev). It's not required when presenting `blocks` or `attachments`.
             ts (string): Timestamp of the message to be updated.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             chat, important
         """
@@ -198,7 +229,7 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Fetches the message history for a specific Slack conversation or channel. Supports filtering messages by timestamp and pagination using a cursor. This method retrieves messages *within* a conversation, unlike `conversations_list` which retrieves a list of available conversations.
-        
+
         Args:
             token (string): Authentication token used to access conversation history.
             channel (string): The ID of the channel to retrieve the conversation history from.
@@ -207,13 +238,13 @@ class SlackApp(APIApplication):
             inclusive (boolean): Determines whether to include the messages at the end of the history range in the response.
             limit (integer): Specifies the maximum number of conversation history entries to retrieve in a single API call.
             cursor (string): A string token used for cursor-based pagination to fetch the next set of conversation history results starting from a specific point.
-        
+
         Returns:
             dict[str, Any]: Typical success response containing a channel's messages
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             conversations
         """
@@ -244,20 +275,20 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Fetches a paginated list of channel-like conversations in a workspace. Allows filtering by type and excluding archived channels. This function lists available conversations, unlike `conversations_history` which retrieves the message history from within a specific conversation.
-        
+
         Args:
             token (string): The token parameter in the query string is a string used for authentication to authorize and identify the client making the GET request to the /conversations.list endpoint.
             exclude_archived (boolean): Exclude archived conversations from the list of results.
             types (string): Specifies the types of conversations to include in the list, as a string query parameter.
             limit (integer): Specifies the maximum number of conversations to return in the response, with a default value of 1.
             cursor (string): A cursor string used for pagination to specify the position from which to continue retrieving the next set of conversation results.
-        
+
         Returns:
             dict[str, Any]: Typical success response with only public channels
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             conversations
         """
@@ -279,18 +310,18 @@ class SlackApp(APIApplication):
     def reactions_add(self, channel: str, name: str, timestamp: str) -> dict[str, Any]:
         """
         Adds a specific emoji reaction to a message in a Slack channel, identifying the message by its channel ID and timestamp. This method creates a new reaction, unlike `reactions_get` or `reactions_list` which retrieve existing reaction data for items or users.
-        
+
         Args:
             channel (string): Channel where the message to add reaction to was posted.
             name (string): Reaction (emoji) name.
             timestamp (string): Timestamp of the message to add reaction to.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             reactions
         """
@@ -324,7 +355,7 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves all reactions for a single item, such as a message, file, or file comment. This function targets reactions *on* a specific item, unlike `reactions_list` which gets reactions created *by* a user.
-        
+
         Args:
             token (string): The "token" parameter is a required string that must be provided in the query string for authentication purposes when using the GET operation at "/reactions.get" to authorize access to reaction data.
             channel (string): The channel identifier to filter reactions by, specified as a string.
@@ -332,13 +363,13 @@ class SlackApp(APIApplication):
             file_comment (string): A query parameter to filter reactions by a specific file comment.
             full (boolean): Whether to return full reaction details or only basic reaction information.
             timestamp (string): The timestamp parameter filters results based on a specific date and time value, expected in an ISO 8601 format string.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             reactions
         """
@@ -370,7 +401,7 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves a paginated list of items (e.g., messages, files) that a specific user has reacted to. Unlike `reactions_get`, which fetches all reactions for a single item, this function lists all items a given user has reacted to across Slack.
-        
+
         Args:
             token (string): Required authentication token passed as a query parameter to authenticate the request for listing reactions.
             user (string): Filter reactions by specifying the user, which can be a username or identifier.
@@ -379,13 +410,13 @@ class SlackApp(APIApplication):
             page (integer): The "page" parameter is an integer query parameter used to specify the page number for pagination in the list of reactions.
             cursor (string): A string used to specify the position in the list of reactions for pagination, allowing retrieval of additional items after or before the specified cursor.
             limit (integer): The `limit` parameter specifies the maximum number of reactions to return in the response.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             reactions
         """
@@ -418,7 +449,7 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Searches a Slack workspace for messages matching a specific query. It supports advanced control over results through pagination, sorting by relevance or timestamp, and an option to highlight search terms within the returned message content.
-        
+
         Args:
             token (string): A required string parameter named "token" passed as a query parameter to authenticate the request for retrieving search messages.
             query (string): The search query string to specify the text or keywords to search for in messages.
@@ -427,13 +458,13 @@ class SlackApp(APIApplication):
             page (integer): The page query parameter specifies the page number of search results to retrieve in the GET /search.messages operation.
             sort (string): Sorts the search results by a specified field, allowing clients to customize the order of returned messages.
             sort_dir (string): The "sort_dir" query parameter specifies the direction of sorting for the search results, typically accepting values like "asc" for ascending or "desc" for descending order.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             search, important
         """
@@ -457,17 +488,17 @@ class SlackApp(APIApplication):
     def team_info(self, token: str, team: str | None = None) -> dict[str, Any]:
         """
         Fetches details for a Slack team, such as name and domain, by calling the `team.info` API endpoint. This function requires an authentication token and can optionally target a specific team by its ID, distinguishing it from user or channel-specific functions.
-        
+
         Args:
             token (string): Mandatory authentication token passed as a query parameter to authenticate the request for retrieving team information.
             team (string): The "team" parameter is a query string parameter of type string, used to specify the team for which information is requested in the GET operation at the "/team.info" path.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             team
         """
@@ -486,18 +517,18 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Fetches detailed profile information for a single Slack user, identified by their user ID. Unlike `users_list`, which retrieves all workspace members, this function targets an individual and can optionally include their locale information. It directly calls the `users.info` Slack API endpoint.
-        
+
         Args:
             token (string): The token query parameter is a required string used to authenticate and authorize the API request to access user information in the GET /users.info operation.
             include_locale (boolean): Indicates whether to include locale information in the response, with a value of true or false.
             user (string): A string parameter used to identify or specify a user in the request.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             users, important
         """
@@ -523,19 +554,19 @@ class SlackApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Fetches a paginated list of all users in a Slack workspace, including deactivated members. Unlike `users_info` which retrieves a single user's details, this function returns a collection and supports limiting results or including locale data through optional parameters.
-        
+
         Args:
             token (string): Required authentication token for accessing the list of users.
             limit (integer): Specifies the maximum number of users to return in the response, defaults to 1.
             cursor (string): A unique string identifier used for cursor-based pagination, indicating the starting point for retrieving the next set of users in the list.
             include_locale (boolean): A boolean query parameter to optionally include locale information in the response.
-        
+
         Returns:
             dict[str, Any]: Typical success response
-        
+
         Raises:
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
-        
+
         Tags:
             users
         """

universal_mcp/applications/spotify/README.md

@@ -1,10 +1,10 @@
-# Spotify MCP Server
+# SpotifyApp MCP Server
 
-An MCP Server for the Spotify API.
+An MCP Server for the SpotifyApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Spotify API.
+This is automatically generated from OpenAPI schema for the SpotifyApp API.
 
 
 | Tool | Description |

universal_mcp/applications/supabase/README.md

@@ -1,10 +1,10 @@
-# Supabase MCP Server
+# SupabaseApp MCP Server
 
-An MCP Server for the Supabase API.
+An MCP Server for the SupabaseApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Supabase API.
+This is automatically generated from OpenAPI schema for the SupabaseApp API.
 
 
 | Tool | Description |

universal_mcp/applications/tavily/README.md

@@ -1,12 +1,12 @@
-# Tavily MCP Server
+# TavilyApp MCP Server
 
-An MCP Server for the Tavily API.
+An MCP Server for the TavilyApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Tavily API.
+This is automatically generated from OpenAPI schema for the TavilyApp API.
 
 
 | Tool | Description |
 |------|-------------|
-| `search` | Performs a web search using Tavily's search API and returns either a direct answer or a summary of top results. |
+| `search_and_summarize` | Queries the Tavily API to perform a web search. It returns a direct AI-generated answer if available; otherwise, it provides a formatted summary of the top three search results, including their titles and snippets. |

universal_mcp/applications/tavily/app.py

@@ -11,17 +11,17 @@ class TavilyApp(APIApplication):
     def search_and_summarize(self, query: str) -> str:
         """
         Queries the Tavily API to perform a web search. It returns a direct AI-generated answer if available; otherwise, it provides a formatted summary of the top three search results, including their titles and snippets.
-        
+
         Args:
             query: The search query string to be processed by Tavily's search engine
-        
+
         Returns:
             A string containing either a direct answer from Tavily's AI or a formatted summary of the top 3 search results, with each result containing the title and snippet
-        
+
         Raises:
             ValueError: When authentication credentials are invalid or missing (via validate() method)
             HTTPError: When the API request fails or returns an error response
-        
+
         Tags:
             search, ai, web, query, important, api-client, text-processing
         """

universal_mcp/applications/twilio/README.md

@@ -0,0 +1,15 @@
+# TwilioApp MCP Server
+
+An MCP Server for the TwilioApp API.
+
+## 🛠️ Tool List
+
+This is automatically generated from OpenAPI schema for the TwilioApp API.
+
+
+| Tool | Description |
+|------|-------------|
+| `create_message` | Sends a new SMS or MMS message using Twilio. |
+| `fetch_message` | Fetches the details of a specific message by its SID. |
+| `list_messages` | Lists messages from your Twilio account, optionally filtered by date. |
+| `delete_message` | Deletes a specific message from your Twilio account. |