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

universal_mcp/applications/fireflies/app.py

@@ -2,7 +2,6 @@ from collections.abc import Callable
 from typing import Any
 
 from gql import gql
-
 from universal_mcp.applications.application import (
     GraphQLApplication,
 )
@@ -25,18 +24,18 @@ class FirefliesApp(GraphQLApplication):
     ) -> dict[str, Any]:
         """
         Queries the Fireflies.ai API for team conversation analytics, specifically the average number of filler words. The data retrieval can optionally be filtered by a start and end time. Returns a dictionary containing the fetched analytics.
-        
+
         Args:
             start_time: Optional start time for analytics (ISO 8601 format, e.g., "2024-01-01T00:00:00Z").
             end_time: Optional end time for analytics (ISO 8601 format, e.g., "2024-01-31T23:59:59Z").
-        
+
         Returns:
             A dictionary containing team analytics data.
             Example: {"team": {"conversation": {"average_filler_words": 0.5}}}
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             analytics, team, fireflies, query
         """
@@ -63,17 +62,17 @@ class FirefliesApp(GraphQLApplication):
     def get_transcript_ai_outputs(self, transcript_id: str) -> list[dict[str, Any]]:
         """
         Retrieves all AI-generated application outputs, such as summaries or analyses, associated with a specific transcript ID. It fetches the detailed prompt and response data for each AI app that has processed the transcript, providing a complete record of AI-generated content.
-        
+
         Args:
             transcript_id: The ID of the transcript.
-        
+
         Returns:
             A list of dictionaries, each representing an AI app output.
             Example: [{"transcript_id": "...", "user_id": "...", ...}]
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             ai, apps, transcript, fireflies, query
         """
@@ -99,17 +98,17 @@ class FirefliesApp(GraphQLApplication):
     def get_user_details(self, user_id: str) -> dict[str, Any]:
         """
         Fetches details, such as name and integrations, for a single user identified by their unique ID. This function queries for a specific user, differentiating it from `list_users` which retrieves a list of all users in the workspace.
-        
+
         Args:
             user_id: The ID of the user.
-        
+
         Returns:
             A dictionary containing user details (e.g., name, integrations).
             Example: {"name": "John Doe", "integrations": [...]}
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             user, details, fireflies, query, important
         """
@@ -128,14 +127,14 @@ class FirefliesApp(GraphQLApplication):
     def list_users(self) -> list[dict[str, Any]]:
         """
         Retrieves a list of all users in the workspace, returning each user's name and configured integrations. It provides a complete team roster, differing from `get_user_details`, which fetches information for a single user by their ID.
-        
+
         Returns:
             A list of dictionaries, each representing a user with their name and integrations.
             Example: [{"name": "Justin Fly", "integrations": ["zoom", "slack"]}, ...]
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             user, list, users, fireflies, query
         """
@@ -158,25 +157,133 @@ class FirefliesApp(GraphQLApplication):
     def get_transcript_details(self, transcript_id: str) -> dict[str, Any]:
         """
         Queries the Fireflies API for a single transcript's details, such as title and ID, using its unique identifier. It fetches one specific entry, distinguishing it from `list_transcripts`, which retrieves a collection, and from `get_ai_apps_outputs` which gets AI data from a transcript.
-        
+
         Args:
             transcript_id: The ID of the transcript.
-        
+
         Returns:
             A dictionary containing transcript details (e.g., title, id).
             Example: {"title": "Meeting Notes", "id": "..."}
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             transcript, details, fireflies, query, important
         """
         query_gql = gql("""
         query Transcript($transcriptId: String!) {
           transcript(id: $transcriptId) {
-            title
             id
+            title
+            host_email
+            organizer_email
+            user {
+              user_id
+              email
+              name
+              num_transcripts
+              recent_meeting
+              minutes_consumed
+              is_admin
+              integrations
+            }
+            speakers {
+              id
+              name
+            }
+            transcript_url
+            participants
+            meeting_attendees {
+              displayName
+              email
+              phoneNumber
+              name
+              location
+            }
+            fireflies_users
+            duration
+            dateString
+            date
+            audio_url
+            video_url
+            sentences {
+              index
+              speaker_name
+              speaker_id
+              text
+              raw_text
+              start_time
+              end_time
+              ai_filters {
+                task
+                pricing
+                metric
+                question
+                date_and_time
+                text_cleanup
+                sentiment
+              }
+            }
+            calendar_id
+            summary {
+              action_items
+              keywords
+              outline
+              overview
+              shorthand_bullet
+              gist
+              bullet_gist
+              short_summary
+              short_overview
+              meeting_type
+              topics_discussed
+              transcript_chapters
+            }
+            meeting_info {
+              fred_joined
+              silent_meeting
+              summary_status
+            }
+            cal_id
+            calendar_type
+            apps_preview {
+              outputs {
+                transcript_id
+                user_id
+                app_id
+                created_at
+                title
+                prompt
+                response
+              }
+            }
+            meeting_link
+            analytics {
+              sentiments {
+                negative_pct
+                neutral_pct
+                positive_pct
+              }
+              categories {
+                questions
+                date_times
+                metrics
+                tasks
+              }
+              speakers {
+                speaker_id
+                name
+                duration
+                word_count
+                longest_monologue
+                monologues_count
+                filler_words
+                questions
+                duration_pct
+                words_per_minute
+              }
+            }
           }
         }
         """)
@@ -187,17 +294,17 @@ class FirefliesApp(GraphQLApplication):
     def list_transcripts(self, user_id: str | None = None) -> list[dict[str, Any]]:
         """
         Fetches a list of meeting transcripts, returning the title and ID for each. The list can be filtered to return only transcripts for a specific user. This function complements `get_transcript_details`, which retrieves a single transcript by its unique ID.
-        
+
         Args:
             user_id: Optional ID of the user to filter transcripts for.
-        
+
         Returns:
             A list of dictionaries, each representing a transcript (e.g., title, id).
             Example: [{"title": "Meeting 1", "id": "..."}, {"title": "Meeting 2", "id": "..."}]
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             transcript, list, fireflies, query
         """
@@ -218,17 +325,17 @@ class FirefliesApp(GraphQLApplication):
     def get_bite_details(self, bite_id: str) -> dict[str, Any]:
         """
         Retrieves detailed information for a specific bite (soundbite/clip) using its unique ID. It fetches data including the user ID, name, processing status, and summary. This provides a focused view of a single bite, distinguishing it from `list_bites` which fetches a collection of bites.
-        
+
         Args:
             bite_id: The ID of the bite.
-        
+
         Returns:
             A dictionary containing bite details (e.g., user_id, name, status, summary).
             Example: {"user_id": "...", "name": "Key Moment", "status": "processed", "summary": "..."}
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             bite, details, fireflies, query
         """
@@ -249,17 +356,17 @@ class FirefliesApp(GraphQLApplication):
     def list_bites(self, mine: bool | None = None) -> list[dict[str, Any]]:
         """
         Retrieves a list of soundbites (clips) from the Fireflies API. An optional 'mine' parameter filters for soundbites belonging only to the authenticated user. Differentiates from 'get_bite_details' by fetching multiple items rather than a single one by ID.
-        
+
         Args:
             mine: Optional boolean to filter for the authenticated user's bites (default true if not specified by API).
-        
+
         Returns:
             A list of dictionaries, each representing a bite (e.g., user_id, name, end_time).
             Example: [{"user_id": "...", "name": "Clip 1", "end_time": "..."}]
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             bite, list, fireflies, query
         """
@@ -283,17 +390,17 @@ class FirefliesApp(GraphQLApplication):
     def add_to_live_meeting(self, meeting_link: str) -> dict[str, Any]:
         """
         Executes a GraphQL mutation to make the Fireflies.ai notetaker join a live meeting specified by its URL. This action initiates the bot's recording and transcription process for the ongoing session and returns a success confirmation.
-        
+
         Args:
             meeting_link: The URL of the live meeting (e.g., Google Meet link).
-        
+
         Returns:
             A dictionary indicating the success of the operation.
             Example: {"success": true}
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             meeting, live, fireflies, mutation, important
         """
@@ -313,19 +420,19 @@ class FirefliesApp(GraphQLApplication):
     ) -> dict[str, Any]:
         """
         Creates a soundbite/clip from a specified segment of a transcript using its ID, start, and end times. This function executes a GraphQL mutation, returning details of the newly created bite, such as its ID and processing status.
-        
+
         Args:
             transcript_id: The ID of the transcript.
             start_time: The start time of the bite in seconds (or relevant float unit).
             end_time: The end time of the bite in seconds (or relevant float unit).
-        
+
         Returns:
             A dictionary containing details of the created bite (e.g., summary, status, id).
             Example: {"summary": "...", "status": "processing", "id": "..."}
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             bite, create, transcript, fireflies, mutation
         """
@@ -349,17 +456,17 @@ class FirefliesApp(GraphQLApplication):
     def delete_transcript(self, transcript_id: str) -> dict[str, Any]:
         """
         Permanently deletes a specific transcript from Fireflies.ai using its ID. This destructive operation executes a GraphQL mutation and returns a dictionary containing the details of the transcript (e.g., title, date) as it existed just before being removed, confirming the action.
-        
+
         Args:
             transcript_id: The ID of the transcript to delete.
-        
+
         Returns:
             A dictionary containing details of the deleted transcript.
             Example: {"title": "Old Meeting", "date": "...", "duration": ..., "organizer_email": "..."}
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             transcript, delete, fireflies, mutation, destructive
         """
@@ -380,18 +487,18 @@ class FirefliesApp(GraphQLApplication):
     def set_user_role(self, user_id: str, role: str) -> dict[str, Any]:
         """
         Assigns a new role (e.g., 'admin', 'member') to a user specified by their ID. This function executes a GraphQL mutation to modify user data and returns a dictionary with the user's updated name and admin status to confirm the change.
-        
+
         Args:
             user_id: The ID of the user.
             role: The role to assign (e.g., "admin", "member").
-        
+
         Returns:
             A dictionary containing the updated user details (e.g., name, is_admin).
             Example: {"name": "Jane Doe", "is_admin": true}
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             user, role, admin, fireflies, mutation
         """
@@ -415,20 +522,20 @@ class FirefliesApp(GraphQLApplication):
     ) -> dict[str, Any]:
         """
         Submits an audio file from a URL to the Fireflies.ai API for transcription. It can optionally associate a title and a list of attendees with the audio, returning the upload status and details upon completion.
-        
+
         Args:
             url: The URL of the audio file.
             title: Optional title for the uploaded audio.
             attendees: Optional list of attendees. Each attendee is a dict
                        with "displayName", "email", "phoneNumber".
-        
+
         Returns:
             A dictionary indicating the success and details of the upload.
             Example: {"success": true, "title": "Uploaded Audio", "message": "..."}
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             audio, upload, transcript, fireflies, mutation
         """
@@ -456,18 +563,18 @@ class FirefliesApp(GraphQLApplication):
     ) -> dict[str, Any]:
         """
         Updates the title of a specific transcript, identified by its ID, to a new value. This function executes a GraphQL mutation and returns a dictionary containing the newly assigned title upon successful completion of the request.
-        
+
         Args:
             transcript_id: The ID of the transcript to update.
             new_title: The new title for the meeting.
-        
+
         Returns:
             A dictionary containing the updated title.
             Example: {"title": "New Meeting Title"}
-        
+
         Raises:
             Exception: If the API request fails.
-        
+
         Tags:
             transcript, meeting, title, update, fireflies, mutation
         """

universal_mcp/applications/fpl/README.md

@@ -9,15 +9,15 @@ This is automatically generated from OpenAPI schema for the FplApp API.
 
 | Tool | Description |
 |------|-------------|
-| `get_player_information` | Get detailed information and statistics for a specific player |
-| `search_fpl_players` | Search for FPL players by name with optional filtering |
-| `get_gameweek_status` | Get precise information about current, previous, and next gameweeks. |
-| `analyze_players` | Filter and analyze FPL players based on multiple criteria |
-| `compare_players` | Compare multiple players across various metrics |
-| `analyze_player_fixtures` | Analyze upcoming fixtures for a player and provide a difficulty rating |
-| `analyze_fixtures` | Analyze upcoming fixtures for players, teams, or positions |
-| `get_blank_gameweeks` | Get information about upcoming blank gameweeks where teams don't have fixtures |
-| `get_double_gameweeks` | Get information about upcoming double gameweeks where teams have multiple fixtures |
-| `get_league_standings` | Get standings for a specified FPL league |
-| `get_league_analytics` | Get rich analytics for a Fantasy Premier League mini-league |
-| `team_info` | Get information about a team  |
+| `get_player_information` | 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`. |
+| `find_players` | 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. |
+| `get_gameweek_snapshot` | 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. |
+| `screen_players` | 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. |
+| `compare_players` | 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. |
+| `analyze_player_fixtures` | 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. |
+| `analyze_entity_fixtures` | 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`. |
+| `get_blank_gameweeks` | 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`. |
+| `get_double_gameweeks` | 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. |
+| `get_league_standings` | 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. |
+| `analyze_league` | 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. |
+| `get_manager_team_info` | 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. |