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

universal_mcp/applications/firecrawl/app.py

@@ -167,18 +167,18 @@ class FirecrawlApp(APIApplication):
     def scrape_url(self, url: str) -> Any:
         """
         Synchronously scrapes a single URL, immediately returning its content. This provides a direct method for single-page scraping, contrasting with asynchronous, job-based functions like `start_crawl` (for entire sites) and `start_batch_scrape` (for multiple URLs).
-        
+
         Args:
             url: The URL of the web page to scrape.
-        
+
         Returns:
             A dictionary containing the scraped data on success,
             or a string containing an error message on failure.
-        
+
         Raises:
             NotAuthorizedError: If API key is missing or invalid.
             ToolError: If the Firecrawl SDK is not installed.
-        
+
         Tags:
             scrape, important
         """
@@ -199,18 +199,18 @@ class FirecrawlApp(APIApplication):
     def search(self, query: str) -> dict[str, Any] | str:
         """
         Executes a synchronous web search using the Firecrawl service for a given query. Unlike scrape_url which fetches a single page, this function discovers web content. It returns a dictionary of results on success or an error string on failure, raising exceptions for authorization or SDK issues.
-        
+
         Args:
             query: The search query string.
-        
+
         Returns:
             A dictionary containing the search results on success,
             or a string containing an error message on failure.
-        
+
         Raises:
             NotAuthorizedError: If API key is missing or invalid.
             ToolError: If the Firecrawl SDK is not installed.
-        
+
         Tags:
             search, important
         """
@@ -233,18 +233,18 @@ class FirecrawlApp(APIApplication):
     ) -> dict[str, Any] | str:
         """
         Starts an asynchronous Firecrawl job to crawl a website from a given URL, returning a job ID. Unlike the synchronous `scrape_url` for single pages, this function initiates a comprehensive, link-following crawl. Progress can be monitored using the `check_crawl_status` function with the returned ID.
-        
+
         Args:
             url: The starting URL for the crawl.
-        
+
         Returns:
             A dictionary containing the job initiation response on success,
             or a string containing an error message on failure.
-        
+
         Raises:
             NotAuthorizedError: If API key is missing or invalid.
             ToolError: If the Firecrawl SDK is not installed.
-        
+
         Tags:
             crawl, async_job, start
         """
@@ -269,18 +269,18 @@ class FirecrawlApp(APIApplication):
     def check_crawl_status(self, job_id: str) -> dict[str, Any] | str:
         """
         Retrieves the status of an asynchronous Firecrawl job using its unique ID. As the counterpart to `start_crawl`, this function exclusively monitors website crawl progress, distinct from status checkers for batch scraping or data extraction jobs. Returns job details on success or an error message on failure.
-        
+
         Args:
             job_id: The ID of the crawl job to check.
-        
+
         Returns:
             A dictionary containing the job status details on success,
             or a string containing an error message on failure.
-        
+
         Raises:
             NotAuthorizedError: If API key is missing or invalid.
             ToolError: If the Firecrawl SDK is not installed.
-        
+
         Tags:
             crawl, async_job, status
         """
@@ -304,19 +304,19 @@ class FirecrawlApp(APIApplication):
     def cancel_crawl(self, job_id: str) -> dict[str, Any] | str:
         """
         Cancels a running asynchronous Firecrawl crawl job using its unique ID. As a lifecycle management tool for jobs initiated by `start_crawl`, it returns a confirmation status upon success or an error message on failure, distinguishing it from controls for other job types.
-        
+
         Args:
             job_id: The ID of the crawl job to cancel.
-        
+
         Returns:
             A dictionary confirming the cancellation status on success,
             or a string containing an error message on failure.
             (Note: This functionality might depend on Firecrawl API capabilities)
-        
+
         Raises:
             NotAuthorizedError: If API key is missing or invalid.
             ToolError: If the Firecrawl SDK is not installed or operation not supported.
-        
+
         Tags:
             crawl, async_job, management, cancel
         """
@@ -343,18 +343,18 @@ class FirecrawlApp(APIApplication):
     ) -> dict[str, Any] | str:
         """
         Initiates an asynchronous Firecrawl job to scrape a list of URLs. It returns a job ID for tracking with `check_batch_scrape_status`. Unlike the synchronous `scrape_url` which processes a single URL, this function handles bulk scraping and doesn't wait for completion.
-        
+
         Args:
             urls: A list of URLs to scrape.
-        
+
         Returns:
             A dictionary containing the job initiation response (e.g., a batch job ID or list of results/job IDs) on success,
             or a string containing an error message on failure.
-        
+
         Raises:
             NotAuthorizedError: If API key is missing or invalid.
             ToolError: If the Firecrawl SDK is not installed.
-        
+
         Tags:
             scrape, batch, async_job, start
         """
@@ -378,18 +378,18 @@ class FirecrawlApp(APIApplication):
     def check_batch_scrape_status(self, job_id: str) -> dict[str, Any] | str:
         """
         Checks the status of an asynchronous batch scrape job using its job ID. As the counterpart to `start_batch_scrape`, it specifically monitors multi-URL scraping tasks, distinct from checkers for site-wide crawls (`check_crawl_status`) or AI-driven extractions (`check_extract_status`). Returns detailed progress or an error message.
-        
+
         Args:
             job_id: The ID of the batch scrape job to check.
-        
+
         Returns:
             A dictionary containing the job status details on success,
             or a string containing an error message on failure.
-        
+
         Raises:
             NotAuthorizedError: If API key is missing or invalid.
             ToolError: If the Firecrawl SDK is not installed or operation not supported.
-        
+
         Tags:
             scrape, batch, async_job, status
         """
@@ -422,21 +422,21 @@ class FirecrawlApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Performs synchronous, AI-driven data extraction from URLs using an optional prompt or schema. Unlike asynchronous jobs like `start_crawl`, it returns structured data directly. This function raises an exception on failure, contrasting with other methods in the class that return an error string upon failure.
-        
+
         Args:
             urls: A list of URLs to extract data from.
             prompt: Optional custom extraction prompt describing what data to extract.
             schema: Optional JSON schema or Pydantic model for the desired output structure.
             system_prompt: Optional system context for the extraction.
             allow_external_links: Optional boolean to allow following external links.
-        
+
         Returns:
             A dictionary containing the extracted data on success.
-        
+
         Raises:
             NotAuthorizedError: If API key is missing or invalid.
             ToolError: If the Firecrawl SDK is not installed or extraction fails.
-        
+
         Tags:
             extract, ai, sync, quick, important
         """
@@ -477,18 +477,18 @@ class FirecrawlApp(APIApplication):
     def check_extract_status(self, job_id: str) -> dict[str, Any] | str:
         """
         Checks the status of an asynchronous, AI-powered Firecrawl data extraction job using its ID. Unlike `check_crawl_status` or `check_batch_scrape_status`, this function specifically monitors structured data extraction tasks, returning the job's progress or an error message on failure.
-        
+
         Args:
             job_id: The ID of the extraction job to check.
-        
+
         Returns:
             A dictionary containing the job status details on success,
             or a string containing an error message on failure.
-        
+
         Raises:
             NotAuthorizedError: If API key is missing or invalid.
             ToolError: If the Firecrawl SDK is not installed or operation not supported.
-        
+
         Tags:
             extract, ai, async_job, status
         """

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,17 +157,17 @@ 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
         """
@@ -295,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
         """
@@ -326,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
         """
@@ -357,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
         """
@@ -391,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
         """
@@ -421,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
         """
@@ -457,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
         """
@@ -488,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
         """
@@ -523,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
         """
@@ -564,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
         """