universal-mcp-applications 0.1.20__py3-none-any.whl → 0.1.22__py3-none-any.whl

universal_mcp/applications/fpl/app.py

@@ -3,7 +3,6 @@ from datetime import datetime
 from typing import Any
 
 import requests
-
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
@@ -49,9 +48,9 @@ class FplApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Performs advanced analysis on an FPL league for a given gameweek range. It routes requests based on the analysis type ('overview', 'historical', 'team_composition') to provide deeper insights beyond the basic rankings from `get_league_standings`, such as historical performance or team composition.
-        
+
         Returns visualization-optimized data for various types of league analysis.
-        
+
         Args:
             league_id: ID of the league to analyze
             analysis_type: Type of analysis to perform:
@@ -61,14 +60,14 @@ class FplApp(APIApplication):
             start_gw: Starting gameweek (defaults to 1)
             end_gw: Ending gameweek (defaults to current)
             api: FPL API instance (import from your api.py)
-        
+
         Returns:
             Rich analytics data structured for visualization
-        
+
         Raises:
             ValueError: Raised when analysis_type is invalid.
             RuntimeError: Raised when API request fails.
-        
+
         Tags:
             leagues, analytics, important
         """
@@ -168,17 +167,17 @@ class FplApp(APIApplication):
     def get_league_standings(self, league_id: int) -> dict[str, Any]:
         """
         Retrieves current standings for a specified FPL classic mini-league by its ID. It fetches and parses raw API data to provide a direct snapshot of the league table, distinguishing it from `get_league_analytics` which performs deeper, historical analysis.
-        
+
         Args:
             league_id: ID of the league to fetch
-        
+
         Returns:
             League information with standings and team details
-        
+
         Raises:
             ValueError: Raised when league_id is invalid.
             RuntimeError: Raised when API request fails.
-        
+
         Tags:
             leagues, standings, important
         """
@@ -217,7 +216,7 @@ class FplApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Fetches a detailed profile for a specific FPL player, identified by ID or name. It can include gameweek performance history, filterable by range, and future fixtures. This provides an in-depth look at one player, differing from broader search or analysis functions like `search_fpl_players`.
-        
+
         Args:
             player_id: FPL player ID (if provided, takes precedence over player_name)
             player_name: Player name to search for (used if player_id not provided)
@@ -225,14 +224,14 @@ class FplApp(APIApplication):
             end_gameweek: Ending gameweek for filtering player history
             include_history: Whether to include gameweek-by-gameweek history
             include_fixtures: Whether to include upcoming fixtures
-        
+
         Returns:
             Comprehensive player information including stats and history
-        
+
         Raises:
             ValueError: Raised when both player_id and player_name are missing.
             KeyError: Raised when player is not found in the database.
-        
+
         Tags:
             players, important
         """
@@ -254,20 +253,20 @@ class FplApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Searches for FPL players by full or partial name with optional filtering by team and position. This is a discovery tool, differentiating it from `get_player_information` which fetches a specific known player. It serves as a public interface to the internal `search_players` utility.
-        
+
         Args:
             query: Player name or partial name to search for
             position: Optional position filter (GKP, DEF, MID, FWD)
             team: Optional team name filter
             limit: Maximum number of results to return
-        
+
         Returns:
             List of matching players with details
-        
+
         Raises:
             ValueError: Raised when query parameter is empty or invalid.
             TypeError: Raised when position or team filters are invalid.
-        
+
         Tags:
             players, search, important
         """
@@ -276,14 +275,14 @@ class FplApp(APIApplication):
     def get_gameweek_snapshot(self) -> dict[str, Any]:
         """
         Provides a detailed snapshot of the FPL schedule by identifying the current, previous, and next gameweeks. It calculates the precise real-time status of the current gameweek (e.g., 'Imminent', 'In Progress') and returns key deadline times and overall season progress.
-        
+
         Returns:
             Detailed information about gameweek timing, including exact status.
-        
+
         Raises:
             RuntimeError: If gameweek data cannot be retrieved.
             ValueError: If gameweek data is malformed or incomplete.
-        
+
         Tags:
             gameweek, status, timing, important
         """
@@ -345,7 +344,7 @@ class FplApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Filters the FPL player database using multiple criteria like position, price, points, and form. Returns a sorted list of matching players, summary statistics for the filtered group, and optional recent gameweek performance data to aid in player discovery and analysis.
-        
+
         Args:
             position: Player position (e.g., "midfielders", "defenders")
             team: Team name filter
@@ -360,14 +359,14 @@ class FplApp(APIApplication):
             sort_by: Metric to sort results by (default: total_points)
             sort_order: Sort direction ("asc" or "desc")
             limit: Maximum number of players to return
-        
+
         Returns:
             Filtered player data with summary statistics
-        
+
         Raises:
             ValueError: Raised when query parameter is empty or invalid.
             TypeError: Raised when position or team filters are invalid.
-        
+
         Tags:
             players, analyze, important
         """
@@ -610,21 +609,21 @@ class FplApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Performs a detailed comparison of multiple players based on specified metrics, recent gameweek history, and upcoming fixture analysis. It provides a side-by-side breakdown, identifies the best performer per metric, and determines an overall winner, considering fixture difficulty, blanks, and doubles for a comprehensive overview.
-        
+
         Args:
             player_names: List of player names to compare (2-5 players recommended)
             metrics: List of metrics to compare
             include_gameweeks: Whether to include gameweek-by-gameweek comparison
             num_gameweeks: Number of recent gameweeks to include in comparison
             include_fixture_analysis: Whether to include fixture analysis including blanks and doubles
-        
+
         Returns:
             Detailed comparison of players across the specified metrics
-        
+
         Raises:
             ValueError: Raised when player_names parameter is empty or invalid.
             TypeError: Raised when metrics parameter is invalid.
-        
+
         Tags:
             players, compare, important
         """
@@ -943,18 +942,18 @@ class FplApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Analyzes a player's upcoming fixture difficulty. Given a player's name, it retrieves their schedule for a set number of matches, returning a detailed list and a calculated difficulty rating. This method is a focused alternative to the more comprehensive `analyze_fixtures` function.
-        
+
         Args:
             player_name: Player name to search for
             num_fixtures: Number of upcoming fixtures to analyze (default: 5)
-        
+
         Returns:
             Analysis of player's upcoming fixtures with difficulty ratings
-        
+
         Raises:
             ValueError: Raised when player_name parameter is empty or invalid.
             TypeError: Raised when num_fixtures parameter is invalid.
-        
+
         Tags:
             players, fixtures, important
         """
@@ -979,21 +978,21 @@ class FplApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Provides a detailed fixture difficulty analysis for a specific player, team, or an entire position over a set number of gameweeks. It calculates a difficulty score and can include blank/double gameweek data, offering broader analysis than the player-only `analyze_player_fixtures`.
-        
+
         Args:
             entity_type: Type of entity to analyze ("player", "team", or "position")
             entity_name: Name of the specific entity
             num_gameweeks: Number of gameweeks to look ahead
             include_blanks: Whether to include blank gameweek info
             include_doubles: Whether to include double gameweek info
-        
+
         Returns:
             Fixture analysis with difficulty ratings and summary
-        
+
         Raises:
             ValueError: Raised when entity_type parameter is invalid.
             TypeError: Raised when num_gameweeks parameter is invalid.
-        
+
         Tags:
             players, fixtures, important
         """
@@ -1261,17 +1260,17 @@ class FplApp(APIApplication):
     def get_blank_gameweeks(self, num_weeks: int = 5) -> list[dict[str, Any]]:
         """
         Identifies upcoming 'blank' gameweeks where teams lack a scheduled fixture. The function returns a list detailing each blank gameweek and the affected teams within a specified number of weeks, which is essential for strategic planning. It is distinct from `get_double_gameweeks`.
-        
+
         Args:
             num_weeks: Number of upcoming gameweeks to check (default: 5)
-        
+
         Returns:
             Information about blank gameweeks and affected teams
-        
+
         Raises:
             ValueError: Raised when num_weeks parameter is invalid.
             TypeError: Raised when num_weeks parameter has incorrect type.
-        
+
         Tags:
             gameweeks, blanks, important
         """
@@ -1280,17 +1279,17 @@ class FplApp(APIApplication):
     def get_double_gameweeks(self, num_weeks: int = 5) -> list[dict[str, Any]]:
         """
         Identifies upcoming double gameweeks where teams have multiple fixtures within a specified number of weeks. It returns a list detailing each double gameweek and the teams involved. This function specifically finds gameweeks with extra matches, unlike `get_blank_gameweeks` which finds those with none.
-        
+
         Args:
             num_weeks: Number of upcoming gameweeks to check (default: 5)
-        
+
         Returns:
             Information about double gameweeks and affected teams
-        
+
         Raises:
             ValueError: Raised when num_weeks parameter is invalid.
             TypeError: Raised when num_weeks parameter has incorrect type.
-        
+
         Tags:
             gameweeks, doubles, important
         """
@@ -1299,17 +1298,17 @@ class FplApp(APIApplication):
     def get_manager_team_info(self, team_id: str) -> dict[str, Any]:
         """
         Retrieves detailed information for a specific FPL manager's team (an "entry") using its unique ID. This is distinct from functions analyzing Premier League clubs, as it targets an individual user's fantasy squad and its performance details within the game.
-        
+
         Args:
             team_id: The ID of the team to get information about
-        
+
         Returns:
             Information about the team
-        
+
         Raises:
             ValueError: Raised when team_id parameter is invalid.
-        
-        
+
+
         Tags:
             teams, important
         """

universal_mcp/applications/ghost_content/app.py

@@ -2,7 +2,6 @@ from collections.abc import Callable
 from typing import Any
 
 from loguru import logger
-
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 

universal_mcp/applications/github/app.py

@@ -1,7 +1,6 @@
 from typing import Any
 
 from loguru import logger
-
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
@@ -26,17 +25,17 @@ class GithubApp(APIApplication):
     def star_repository(self, repo_full_name: str) -> str:
         """
         Stars a GitHub repository for the authenticated user. This user-centric action takes the full repository name ('owner/repo') and returns a simple string message confirming the outcome, unlike other functions that list or create repository content like issues or pull requests.
-        
+
         Args:
             repo_full_name: The full name of the repository in 'owner/repo' format (e.g., 'octocat/Hello-World')
-        
+
         Returns:
             A string message indicating whether the starring operation was successful, the repository was not found, or an error occurred
-        
+
         Raises:
             RequestException: If there are network connectivity issues or API request failures
             ValueError: If the repository name format is invalid
-        
+
         Tags:
             star, github, api, action, social, repository, important
         """
@@ -53,17 +52,17 @@ class GithubApp(APIApplication):
     def list_recent_commits(self, repo_full_name: str) -> str:
         """
         Fetches and formats the 12 most recent commits from a repository. It returns a human-readable string summarizing each commit's hash, author, and message, providing a focused overview of recent code changes, unlike functions that list branches, issues, or pull requests.
-        
+
         Args:
             repo_full_name: The full name of the repository in 'owner/repo' format
-        
+
         Returns:
             A formatted string containing the most recent 12 commits, including commit hash, message, and author
-        
+
         Raises:
             requests.exceptions.HTTPError: When the GitHub API request fails (e.g., repository not found, rate limit exceeded)
             requests.exceptions.RequestException: When network issues or other request-related problems occur
-        
+
         Tags:
             list, read, commits, github, history, api, important
         """
@@ -86,17 +85,17 @@ class GithubApp(APIApplication):
     def list_branches(self, repo_full_name: str) -> str:
         """
         Fetches all branches for a specified GitHub repository and formats them into a human-readable string. This method is distinct from others like `search_issues`, as it returns a formatted list for display rather than raw JSON data for programmatic use.
-        
+
         Args:
             repo_full_name: The full name of the repository in 'owner/repo' format (e.g., 'octocat/Hello-World')
-        
+
         Returns:
             A formatted string containing the list of branches, or a message indicating no branches were found
-        
+
         Raises:
             HTTPError: When the GitHub API request fails (e.g., repository not found, authentication error)
             RequestException: When there are network connectivity issues or API communication problems
-        
+
         Tags:
             list, branches, github, read, api, repository, important
         """
@@ -116,17 +115,17 @@ class GithubApp(APIApplication):
     def list_pull_requests(self, repo_full_name: str, state: str = "open") -> str:
         """
         Fetches pull requests for a repository, filtered by state (e.g., 'open'). It returns a formatted string summarizing each PR's details, distinguishing it from `get_pull_request` (single PR) and `search_issues` (raw issue data).
-        
+
         Args:
             repo_full_name: The full name of the repository in the format 'owner/repo' (e.g., 'tensorflow/tensorflow')
             state: Filter for pull request state. Can be 'open', 'closed', or 'all'. Defaults to 'open'
-        
+
         Returns:
             A formatted string containing the list of pull requests, including PR number, title, author, and status. Returns a message if no pull requests are found.
-        
+
         Raises:
             HTTPError: Raised when the GitHub API request fails (e.g., invalid repository name, rate limiting, or authentication issues)
-        
+
         Tags:
             list, pull-request, github, api, read, important, fetch, query
         """
@@ -161,7 +160,7 @@ class GithubApp(APIApplication):
     ) -> list[dict[str, Any]]:
         """
         Fetches issues from a GitHub repository using specified filters (state, assignee, labels) and pagination. It returns the raw API response as a list of dictionaries, providing detailed issue data for programmatic processing, distinct from other methods that return formatted strings.
-        
+
         Args:
             repo_full_name: The full name of the repository in 'owner/repo' format
             state: Filter issues by state ('open', 'closed', 'all'). Defaults to 'open'
@@ -169,14 +168,14 @@ class GithubApp(APIApplication):
             labels: Comma-separated string of label names to filter by (e.g., 'bug,ui,@high')
             per_page: Number of results per page (max 100). Defaults to 30
             page: Page number for pagination. Defaults to 1
-        
+
         Returns:
             List of dictionaries containing issue data from the GitHub API response
-        
+
         Raises:
             HTTPError: When the GitHub API request fails (e.g., invalid repository name, authentication failure)
             RequestException: When there are network connectivity issues or other request-related problems
-        
+
         Tags:
             list, issues, github, api, read, filter, pagination, important, project-management
         """
@@ -194,18 +193,18 @@ class GithubApp(APIApplication):
     def get_pull_request(self, repo_full_name: str, pull_number: int) -> str:
         """
         Fetches a specific pull request from a repository using its unique number. It returns a human-readable string summarizing the PR's title, creator, status, and description, unlike `list_pull_requests` which retrieves a list of multiple PRs.
-        
+
         Args:
             repo_full_name: The full repository name in 'owner/repo' format (e.g., 'octocat/Hello-World')
             pull_number: The numeric identifier of the pull request to retrieve
-        
+
         Returns:
             A formatted string containing pull request details including title, creator, status, and description
-        
+
         Raises:
             HTTPError: Raised when the GitHub API request fails (e.g., invalid repository name, non-existent PR number, or authentication issues)
             RequestException: Raised when there are network connectivity issues or other request-related problems
-        
+
         Tags:
             get, read, github, pull-request, api, fetch, format, important
         """
@@ -240,7 +239,7 @@ class GithubApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Creates a pull request between specified `head` and `base` branches, or converts an issue into a PR. Unlike read functions that return formatted strings, this write operation returns the raw API response as a dictionary, providing comprehensive data on the newly created pull request.
-        
+
         Args:
             repo_full_name: The full name of the repository (e.g. 'owner/repo')
             head: The name of the branch where your changes are implemented
@@ -250,14 +249,14 @@ class GithubApp(APIApplication):
             issue: An issue number to convert to a pull request. If specified, the issue's title, body, and comments will be used
             maintainer_can_modify: Indicates whether maintainers can modify the pull request
             draft: Indicates whether the pull request is a draft
-        
+
         Returns:
             A dictionary containing the complete GitHub API response
-        
+
         Raises:
             ValueError: Raised when neither 'title' nor 'issue' parameter is specified
             HTTPError: Raised when the GitHub API request fails
-        
+
         Tags:
             create, pull-request, github, api, write, important
         """
@@ -286,19 +285,19 @@ class GithubApp(APIApplication):
     ) -> str:
         """
         Creates a new issue in a GitHub repository using a title, body, and optional labels. It returns a formatted confirmation string with the new issue's number and URL, differing from `update_issue` which modifies existing issues and `search_issues` which returns raw API data.
-        
+
         Args:
             repo_full_name: The full name of the repository in 'owner/repo' format
             title: The title of the issue
             body: The contents/description of the issue (defaults to empty string)
             labels: Labels to associate with the issue, as a comma-separated string or list. Only users with push access can set labels
-        
+
         Returns:
             A string containing a confirmation message with the issue number, title, and URL
-        
+
         Raises:
             HTTPError: When the GitHub API request fails (e.g., invalid repository name, authentication issues, or insufficient permissions)
-        
+
         Tags:
             create, issues, github, api, project-management, write, important
         """
@@ -329,19 +328,19 @@ class GithubApp(APIApplication):
     ) -> str:
         """
         Fetches recent events for a GitHub repository and formats them into a human-readable string. It summarizes activities with actors and timestamps, providing a general event feed, unlike other `list_*` functions which retrieve specific resources like commits or issues.
-        
+
         Args:
             repo_full_name: The full name of the repository in 'owner/repo' format
             direction: The sort direction for results ('asc' or 'desc'). Defaults to 'desc'
             per_page: Number of activities to return per page (1-100). Defaults to 30
-        
+
         Returns:
             A formatted string containing a list of repository activities, including timestamps and actor names. Returns a 'No activities' message if no activities are found.
-        
+
         Raises:
             HTTPError: Raised when the GitHub API request fails
             ValueError: May be raised if repo_full_name is invalid or empty after stripping
-        
+
         Tags:
             list, activity, github, read, events, api, query, format
         """
@@ -377,7 +376,7 @@ class GithubApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Modifies an existing GitHub issue, identified by its number within a repository. It can update optional fields like title, body, or state and returns the raw API response as a dictionary, differentiating it from `create_issue` which makes new issues and returns a formatted string.
-        
+
         Args:
             repo_full_name: The full name of the repository in 'owner/repo' format
             issue_number: The unique identifier number of the issue to update
@@ -386,14 +385,14 @@ class GithubApp(APIApplication):
             assignee: GitHub username to assign to the issue (optional)
             state: The desired state of the issue ('open' or 'closed') (optional)
             state_reason: The reason for state change ('completed', 'not_planned', 'reopened', or null) (optional)
-        
+
         Returns:
             A dictionary containing the complete GitHub API response with updated issue details
-        
+
         Raises:
             HTTPError: Raised when the GitHub API request fails (e.g., invalid repository, non-existent issue, insufficient permissions)
             RequestException: Raised when there's a network error or API connectivity issue
-        
+
         Tags:
             github, issues, update, api, project-management, write, important
         """
@@ -413,7 +412,6 @@ class GithubApp(APIApplication):
         response.raise_for_status()
         return response.json()
 
-
     def list_tools(self):
         return [
             self.star_repository,
@@ -426,4 +424,4 @@ class GithubApp(APIApplication):
             self.create_issue,
             self.update_issue,
             self.list_repo_activities,
-        ]
+        ]