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

universal_mcp/applications/domain_checker/README.md

@@ -9,5 +9,5 @@ This is automatically generated from OpenAPI schema for the DomainCheckerApp API
 
 | Tool | Description |
 |------|-------------|
-| `check_domain_tool` | Checks if a domain is available for registration by querying DNS records and RDAP data. |
-| `check_tlds_tool` | Checks a keyword across multiple top-level domains (TLDs) to find available domain names. |
+| `check_domain_registration` | Determines a domain's availability by querying DNS and RDAP servers. For registered domains, it returns details like registrar and key dates. This function provides a comprehensive analysis for a single, fully qualified domain name, unlike `check_keyword_across_tlds_tool` which checks a keyword across multiple domains. |
+| `find_available_domains_for_keyword` | Checks a keyword's availability across a predefined list of popular TLDs. Using DNS and RDAP lookups, it generates a summary report of available and taken domains. This bulk-check differs from `check_domain_registration`, which deeply analyzes a single, fully-qualified domain. |

universal_mcp/applications/domain_checker/app.py

@@ -4,7 +4,6 @@ from typing import Any
 
 import dns.resolver
 import requests
-
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
@@ -94,15 +93,15 @@ class DomainCheckerApp(APIApplication):
     async def check_domain_registration(self, domain: str) -> dict[str, Any]:
         """
         Determines a domain's availability by querying DNS and RDAP servers. For registered domains, it returns details like registrar and key dates. This function provides a comprehensive analysis for a single, fully qualified domain name, unlike `check_keyword_across_tlds_tool` which checks a keyword across multiple domains.
-        
+
         This method performs a comprehensive domain availability check by first checking DNS records
         and then querying RDAP (Registration Data Access Protocol) servers for detailed registration
         information. It provides detailed information about registered domains including registrar,
         registration date, and expiration date.
-        
+
         Args:
             domain: String representing the domain name to check (e.g., "example.com")
-        
+
         Returns:
             Dictionary containing domain availability information with the following keys:
             - domain: The domain name that was checked
@@ -113,12 +112,12 @@ class DomainCheckerApp(APIApplication):
             - has_dns: Boolean indicating if DNS records exist
             - rdap_data_available: Boolean indicating if RDAP data was retrieved
             - note: Additional information when needed
-        
+
         Raises:
             DNSException: When DNS resolution fails due to network issues or invalid domain format
             RequestException: When RDAP queries fail due to network issues or server errors
             ValueError: When the domain parameter is empty or contains invalid characters
-        
+
         Tags:
             domain, availability, registration, dns, rdap, important
         """
@@ -206,15 +205,15 @@ class DomainCheckerApp(APIApplication):
     async def find_available_domains_for_keyword(self, keyword: str) -> dict[str, Any]:
         """
         Checks a keyword's availability across a predefined list of popular TLDs. Using DNS and RDAP lookups, it generates a summary report of available and taken domains. This bulk-check differs from `check_domain_registration`, which deeply analyzes a single, fully-qualified domain.
-        
+
         This method systematically checks a given keyword across 14 popular TLDs including .com, .net,
         .org, .io, .co, .app, .dev, .ai, .me, .info, .xyz, .online, .site, and .tech. It performs
         DNS lookups and RDAP queries to determine domain availability and provides a comprehensive
         report of available and taken domains.
-        
+
         Args:
             keyword: String representing the keyword to check across TLDs (e.g., "myapp")
-        
+
         Returns:
             Dictionary containing TLD availability information with the following keys:
             - keyword: The keyword that was checked
@@ -224,12 +223,12 @@ class DomainCheckerApp(APIApplication):
             - available_domains: List of available domain names
             - taken_domains: List of taken domain names
             - tlds_checked_list: Complete list of TLDs that were checked
-        
+
         Raises:
             DNSException: When DNS resolution fails due to network issues or invalid domain format
             RequestException: When RDAP queries fail due to network issues or server errors
             ValueError: When the keyword parameter is empty or contains invalid characters
-        
+
         Tags:
             tld, keyword, domain-search, availability, bulk-check, important
         """
@@ -267,7 +266,4 @@ class DomainCheckerApp(APIApplication):
         """
         Lists the available tools (methods) for this application.
         """
-        return [
-            self.check_domain_registration, 
-            self.find_available_domains_for_keyword
-            ]
+        return [self.check_domain_registration, self.find_available_domains_for_keyword]

universal_mcp/applications/e2b/README.md

@@ -1,12 +1,12 @@
-# E2b MCP Server
+# E2bApp MCP Server
 
-An MCP Server for the E2b API.
+An MCP Server for the E2bApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the E2b API.
+This is automatically generated from OpenAPI schema for the E2bApp API.
 
 
 | Tool | Description |
 |------|-------------|
-| `execute_python_code` | Executes Python code in a sandbox environment and returns the formatted output |
+| `execute_python_code` | Executes a Python code string in a secure E2B sandbox. It authenticates using the configured API key, runs the code, and returns a formatted string containing the execution's output (stdout/stderr). It raises specific exceptions for authorization failures or general execution issues. |

universal_mcp/applications/e2b/app.py

@@ -131,19 +131,19 @@ class E2bApp(APIApplication):
     ) -> str:
         """
         Executes a Python code string in a secure E2B sandbox. It authenticates using the configured API key, runs the code, and returns a formatted string containing the execution's output (stdout/stderr). It raises specific exceptions for authorization failures or general execution issues.
-        
+
         Args:
             code: String containing the Python code to be executed in the sandbox.
-        
+
         Returns:
             A string containing the formatted execution output/logs from running the code.
-        
+
         Raises:
             ToolError: When there are issues with sandbox initialization or code execution,
                        or if the E2B SDK is not installed.
             NotAuthorizedError: When API key authentication fails during sandbox setup.
             ValueError: When provided code string is empty or invalid.
-        
+
         Tags:
             execute, sandbox, code-execution, security, important
         """

universal_mcp/applications/elevenlabs/README.md

@@ -9,80 +9,6 @@ This is automatically generated from OpenAPI schema for the ElevenlabsApp API.
 
 | Tool | Description |
 |------|-------------|
-| `get_generated_items` | Retrieves historical data based on specified parameters, including page size and voice ID, using the "GET" method at the "/v1/history" endpoint. |
-| `get_history_item_by_id` | Retrieves a specific history item by its identifier using the API defined at "/v1/history/{history_item_id}" with the GET method. |
-| `delete_history_item` | Deletes a specific history item identified by its ID using the DELETE method. |
-| `get_audio_from_history_item` | Retrieves audio data for a specific history item identified by `{history_item_id}` using the `GET` method at the `/v1/history/{history_item_id}/audio` endpoint. |
-| `download_history_items` | Initiates a historical data download process and returns a success status upon completion. |
-| `delete_sample` | Deletes a specific voice sample identified by the `sample_id` from a voice with the given `voice_id` using the DELETE method. |
-| `get_audio_from_sample` | Retrieves the audio file for a specific sample associated with a given voice using the specified voice_id and sample_id. |
-| `convert` | Converts text into speech using a specified voice, allowing for optimization of streaming latency and selection of output format. |
-| `text_to_speech_with_timestamps` | Generates speech from text with precise character or word-level timing information using the specified voice, supporting audio-text synchronization through timestamps. |
-| `convert_as_stream` | Converts text to speech stream using the specified voice ID with configurable latency and output format. |
-| `stream_text_with_timestamps` | Converts text to speech using the specified voice ID, streaming the audio output with timestamps. |
-| `voice_generation_parameters` | Retrieves the parameters required for generating voice using the specified API endpoint. |
-| `generate_arandom_voice` | Generates an audio file by converting text into speech using a specified voice, allowing for customizable voice selection and text input. |
-| `create_voice_model` | Generates a custom voice using the provided parameters via the "/v1/voice-generation/create-voice" endpoint by sending a POST request, allowing users to create unique voice models. |
-| `create_previews` | Generates a voice preview from a given text prompt using the ElevenLabs API. |
-| `create_voice_from_preview` | Creates a new voice entry in the voice library using a generated preview ID and returns voice details. |
-| `get_user_subscription_info` | Retrieves the user's subscription details from the API. |
-| `get_user_info` | Retrieves user information from the API. |
-| `get_voices` | Retrieves a list of voices using the "GET" method at the "/v1/voices" API endpoint. |
-| `get_default_voice_settings` | Retrieves the default voice settings using the "GET" method at the "/v1/voices/settings/default" endpoint. |
-| `get_voice_settings` | Retrieves voice settings for a specific voice identified by `{voice_id}` using the "GET" method, returning the current configuration for that voice. |
-| `get_voice` | Retrieves the details of a specific voice by its ID using the "GET" method at the "/v1/voices/{voice_id}" endpoint. |
-| `delete_voice` | Deletes a voice with the specified ID using the DELETE method at the "/v1/voices/{voice_id}" endpoint. |
-| `edit_voice_settings` | Updates voice settings for a specified voice ID and returns a success status. |
-| `add_voice` | Adds a new voice entry to the voices collection using the provided data. |
-| `edit_voice` | Updates the specified voice by ID using a POST request and returns a success status upon completion. |
-| `add_sharing_voice` | Adds a voice associated with a public user ID and voice ID using the specified API endpoint. |
-| `get_shared_voices` | Retrieves a list of shared voices filtered by parameters like gender and language, with pagination support via page_size. |
-| `get_similar_library_voices` | Generates a list of similar voices using the POST method at the "/v1/similar-voices" endpoint. |
-| `get_aprofile_page` | Retrieves a unified customer profile by handle and returns the associated attributes, identifiers, and traits. |
-| `get_projects` | Retrieves a list of projects using the API defined at the "/v1/projects" endpoint via the GET method. |
-| `add_project` | Creates a new project and returns a status message. |
-| `get_project_by_id` | Retrieves information for a specific project identified by `{project_id}` using the API endpoint at "/v1/projects/{project_id}" via the GET method. |
-| `edit_basic_project_info` | Creates a new project resource by sending data to the specified project identifier using the POST method at the "/v1/projects/{project_id}" endpoint. |
-| `delete_project` | Deletes the specified project and returns a success status upon completion. |
-| `convert_project` | Converts a specified project identified by project_id and returns the conversion result. |
-| `get_project_snapshots` | Retrieves a list of snapshots associated with a specified project. |
-| `streams_archive_with_project_audio` | Archives a project snapshot using the specified project ID and snapshot ID and returns a success status. |
-| `add_chapter_to_aproject` | Adds a new chapter to a specified project using the provided project identifier and returns a success status upon completion. |
-| `update_project_pronunciations` | Updates pronunciation dictionaries for a specified project using the POST method, returning a successful status message upon completion. |
-| `get_chapters` | Retrieves a chapter for a specified project by ID using the GET method. |
-| `get_chapter_by_id` | Retrieves a specific chapter within a project identified by project_id and chapter_id. |
-| `delete_chapter` | Deletes a specific chapter within a project using the "DELETE" method. |
-| `convert_chapter` | Converts a chapter in a project using the POST method and returns a response upon successful conversion. |
-| `get_chapter_snapshots` | Retrieves a snapshot for a specific chapter within a project using the provided project and chapter IDs. |
-| `stream_chapter_audio` | Streams data from a specific chapter snapshot in a project using the API and returns a response indicating success. |
-| `dub_avideo_or_an_audio_file` | Initiates a dubbing process and returns a status message using the API defined at the "/v1/dubbing" endpoint via the POST method. |
-| `get_dubbing_project_metadata` | Retrieves the details of a specific dubbing job using the provided dubbing ID. |
-| `delete_dubbing_project` | Deletes a dubbing project with the specified ID and returns a success status upon completion. |
-| `get_transcript_for_dub` | Retrieves the transcript for a specific dubbing task in the requested language using the "GET" method. |
-| `get_models` | Retrieves a list of models using the GET method at the "/v1/models" endpoint. |
-| `post_audio_native` | Processes audio data using the audio-native API and returns a response. |
-| `get_characters_usage_metrics` | Retrieves character statistics within a specified time frame using the start and end Unix timestamps provided in the query parameters. |
-| `add_apronunciation_dictionary` | Creates a pronunciation dictionary from a lexicon file and returns its ID and metadata. |
-| `add_rules_to_dictionary` | Adds pronunciation rules to a specific pronunciation dictionary identified by its ID using the POST method. |
-| `remove_pronunciation_rules` | Removes specified pronunciation rules from a pronunciation dictionary using a POST request. |
-| `get_dictionary_version_file` | Retrieves and downloads a specific version of a pronunciation dictionary file using its dictionary ID and version ID. |
-| `get_pronunciation_dictionary` | Retrieves a specific pronunciation dictionary by its ID using the "GET" method from the "/v1/pronunciation-dictionaries/{pronunciation_dictionary_id}" endpoint. |
-| `get_pronunciation_dictionaries` | Retrieves a list of pronunciation dictionaries using the GET method at the "/v1/pronunciation-dictionaries" endpoint, allowing users to specify the number of items per page via the "page_size" query parameter. |
-| `invite_user` | Invites a user to join a workspace by sending an invitation, allowing them to access the specified workspace upon acceptance. |
-| `delete_existing_invitation` | Deletes a workspace invite and returns a success response upon completion. |
-| `update_member` | Adds members to a workspace and returns the updated member list upon success. |
-| `get_signed_url` | Generates a signed URL for initiating a conversation with a specific conversational AI agent, identified by the provided `agent_id`, using the ElevenLabs API. |
-| `create_agent` | Creates a conversational AI agent with specified configuration settings and returns the agent details. |
-| `get_agent` | Retrieves information about a specific conversational AI agent by its unique identifier using the GET method at the "/v1/convai/agents/{agent_id}" API endpoint. |
-| `delete_agent` | Deletes a specified Conversational AI agent using the DELETE method. |
-| `patches_an_agent_settings` | Updates an existing conversational AI agent's settings using the specified agent ID, allowing changes to properties such as the agent's name and tool configurations. |
-| `get_agent_widget_config` | Retrieves and configures the Convai widget for the specified agent, but the provided details do not specify the exact functionality of this specific endpoint, suggesting it may relate to integrating or customizing Convai's character interaction capabilities. |
-| `get_shareable_agent_link` | Retrieves and establishes a link for a Convai agent using the specified agent ID, facilitating integration or connectivity operations. |
-| `post_agent_avatar` | Creates and configures a Convai avatar for a specific agent using the POST method, though the exact details of this endpoint are not provided in the available documentation. |
-| `get_agent_knowledge_base` | Retrieves specific documentation for a knowledge base associated with an agent in Convai. |
-| `add_agent_secret` | Adds a secret to a specified conversational AI agent through the API and returns a status confirmation. |
-| `add_to_agent_sknowledge_base` | Adds new content to an agent's knowledge base by uploading a file or resource, which can be used to enhance the agent's conversational capabilities. |
-| `get_agents_page` | Retrieves a list of conversational AI agents available in the Convai system. |
-| `get_conversations` | Retrieves conversation history for a specified agent ID. |
-| `get_conversation_details` | Retrieves and formats the details of a specific conversation based on the provided conversation ID. |
-| `get_conversation_audio` | Retrieves the audio from a specific conversation using the ElevenLabs Conversational AI API. |
+| `generate_speech_audio_url` | Converts a text string into speech using the ElevenLabs API. The function then saves the generated audio to a temporary MP3 file and returns a public URL to access it, rather than the raw audio bytes. |
+| `speech_to_text` | Transcribes an audio file into text using the ElevenLabs API. It supports language specification and speaker diarization, providing the inverse operation to the audio-generating `text_to_speech` method. Note: The docstring indicates this is a placeholder for an undocumented endpoint. |
+| `speech_to_speech` | Downloads an audio file from a URL and converts the speech into a specified target voice using the ElevenLabs API. This function transforms the speaker's voice in an existing recording and returns the new audio data as bytes, distinct from creating audio from text. |

universal_mcp/applications/elevenlabs/app.py

@@ -2,13 +2,13 @@ import uuid
 from io import BytesIO
 
 import requests
-
-from elevenlabs import ElevenLabs
 from universal_mcp.applications.application import APIApplication
-from universal_mcp.applications.file_system.app import FileSystemApp
 from universal_mcp.exceptions import NotAuthorizedError
 from universal_mcp.integrations import Integration
 
+from elevenlabs import ElevenLabs
+from universal_mcp.applications.file_system.app import FileSystemApp
+
 
 class ElevenlabsApp(APIApplication):
     def __init__(self, integration: Integration = None, **kwargs) -> None:
@@ -24,7 +24,11 @@ class ElevenlabsApp(APIApplication):
             credentials = self.integration.get_credentials()
             if not credentials:
                 raise NotAuthorizedError("No credentials found")
-            api_key = credentials.get("api_key") or credentials.get("API_KEY") or credentials.get("apiKey")
+            api_key = (
+                credentials.get("api_key")
+                or credentials.get("API_KEY")
+                or credentials.get("apiKey")
+            )
             if not api_key:
                 raise NotAuthorizedError("No api key found")
             self._client = ElevenLabs(api_key=api_key)
@@ -41,17 +45,17 @@ class ElevenlabsApp(APIApplication):
     ) -> bytes:
         """
         Converts a text string into speech using the ElevenLabs API. The function then saves the generated audio to a temporary MP3 file and returns a public URL to access it, rather than the raw audio bytes.
-        
+
         Args:
             text (str): The text to convert to speech.
             voice_id (str): The ID of the voice to use.
             model_id (str, optional): The model to use. Defaults to "eleven_multilingual_v2".
             stability (float, optional): The stability of the voice.
             similarity_boost (float, optional): The similarity boost of the voice.
-        
+
         Returns:
             bytes: The audio data.
-            
+
         Tags:
             important
         """
@@ -77,13 +81,13 @@ class ElevenlabsApp(APIApplication):
     ) -> str:
         """
         Transcribes an audio file into text using the ElevenLabs API. It supports language specification and speaker diarization, providing the inverse operation to the audio-generating `text_to_speech` method. Note: The docstring indicates this is a placeholder for an undocumented endpoint.
-        
+
         Args:
             audio_file_path (str): The path to the audio file.
-        
+
         Returns:
             str: The transcribed text.
-            
+
         Tags:
             important
         """
@@ -104,15 +108,15 @@ class ElevenlabsApp(APIApplication):
     ) -> bytes:
         """
         Downloads an audio file from a URL and converts the speech into a specified target voice using the ElevenLabs API. This function transforms the speaker's voice in an existing recording and returns the new audio data as bytes, distinct from creating audio from text.
-        
+
         Args:
             voice_id (str): The ID of the voice to use for the conversion.
             audio_file_path (str): The path to the audio file to transform.
             model_id (str, optional): The model to use. Defaults to "eleven_multilingual_sts_v2".
-        
+
         Returns:
             bytes: The transformed audio data.
-            
+
         Tags:
             important
         """
@@ -139,8 +143,7 @@ async def demo_text_to_speech():
     A demonstration function that instantiates the `ElevenlabsApp` to test its `text_to_speech` method. It converts a sample string to audio and prints the resulting file URL to the console, serving as a basic usage example when the script is executed directly.
     """
     app = ElevenlabsApp()
-    audio = await app.generate_speech_audio_url("Hello, world!")
-    print(audio)
+    await app.generate_speech_audio_url("Hello, world!")
 
 
 if __name__ == "__main__":

universal_mcp/applications/exa/README.md

@@ -1,15 +1,15 @@
-# Exa MCP Server
+# ExaApp MCP Server
 
-An MCP Server for the Exa API.
+An MCP Server for the ExaApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Exa API.
+This is automatically generated from OpenAPI schema for the ExaApp API.
 
 
 | Tool | Description |
 |------|-------------|
-| `search` | Searches for data using the specified criteria and returns a list of results. |
-| `find_similar` | Finds and returns similar items using the API at "/findSimilar" via the POST method. |
-| `get_contents` | Creates new content entries via a POST request to the "/contents" endpoint. |
-| `answer` | Provides an answer to a query using the API endpoint at "/answer" via the POST method. |
+| `search_with_filters` | Executes a query against the Exa API's `/search` endpoint, returning a list of results. This function supports extensive filtering by search type, category, domains, publication dates, and specific text content to refine the search query and tailor the API's response. |
+| `find_similar_by_url` | Finds web pages semantically similar to a given URL. Unlike the `search` function, which uses a text query, this method takes a specific link and returns a list of related results, with options to filter by domain, publication date, and content. |
+| `fetch_page_content` | Retrieves and processes content from a list of URLs, returning full text, summaries, or highlights. Unlike the search function which finds links, this function fetches the actual page content, with optional support for live crawling to get the most up-to-date information. |
+| `answer` | Retrieves a direct, synthesized answer for a given query by calling the Exa `/answer` API endpoint. Unlike `search`, which returns web results, this function provides a conclusive response. It supports streaming, including source text, and selecting a search model. |

universal_mcp/applications/exa/app.py

@@ -28,7 +28,7 @@ class ExaApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Executes a query against the Exa API's `/search` endpoint, returning a list of results. This function supports extensive filtering by search type, category, domains, publication dates, and specific text content to refine the search query and tailor the API's response.
-        
+
         Args:
             query (string): The query string for the search. Example: 'Latest developments in LLM capabilities'.
             useAutoprompt (boolean): Autoprompt converts your query to an Exa-style query. Enabled by default for auto search, optional for neural search, and not available for keyword search. Example: 'True'.
@@ -44,10 +44,10 @@ class ExaApp(APIApplication):
             includeText (array): List of strings that must be present in webpage text of results. Currently, only 1 string is supported, of up to 5 words. Example: "['large language model']".
             excludeText (array): List of strings that must not be present in webpage text of results. Currently, only 1 string is supported, of up to 5 words. Example: "['course']".
             contents (object): contents
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             important
         """
@@ -90,7 +90,7 @@ class ExaApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Finds web pages semantically similar to a given URL. Unlike the `search` function, which uses a text query, this method takes a specific link and returns a list of related results, with options to filter by domain, publication date, and content.
-        
+
         Args:
             url (string): The url for which you would like to find similar links. Example: 'https://arxiv.org/abs/2307.06435'.
             numResults (integer): Number of results to return (up to thousands of results available for custom plans) Example: '10'.
@@ -103,10 +103,10 @@ class ExaApp(APIApplication):
             includeText (array): List of strings that must be present in webpage text of results. Currently, only 1 string is supported, of up to 5 words. Example: "['large language model']".
             excludeText (array): List of strings that must not be present in webpage text of results. Currently, only 1 string is supported, of up to 5 words. Example: "['course']".
             contents (object): contents
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             important
         """
@@ -145,7 +145,7 @@ class ExaApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Retrieves and processes content from a list of URLs, returning full text, summaries, or highlights. Unlike the search function which finds links, this function fetches the actual page content, with optional support for live crawling to get the most up-to-date information.
-        
+
         Args:
             urls (array): Array of URLs to crawl (backwards compatible with 'ids' parameter). Example: "['https://arxiv.org/pdf/2307.06435']".
             ids (array): Deprecated - use 'urls' instead. Array of document IDs obtained from searches. Example: "['https://arxiv.org/pdf/2307.06435']".
@@ -162,10 +162,10 @@ class ExaApp(APIApplication):
             subpages (integer): The number of subpages to crawl. The actual number crawled may be limited by system constraints. Example: '1'.
             subpageTarget (string): Keyword to find specific subpages of search results. Can be a single string or an array of strings, comma delimited. Example: 'sources'.
             extras (object): Extra parameters to pass.
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             important
         """
@@ -191,16 +191,16 @@ class ExaApp(APIApplication):
     def answer(self, query, stream=None, text=None, model=None) -> dict[str, Any]:
         """
         Retrieves a direct, synthesized answer for a given query by calling the Exa `/answer` API endpoint. Unlike `search`, which returns web results, this function provides a conclusive response. It supports streaming, including source text, and selecting a search model.
-        
+
         Args:
             query (string): The question or query to answer. Example: 'What is the latest valuation of SpaceX?'.
             stream (boolean): If true, the response is returned as a server-sent events (SSS) stream.
             text (boolean): If true, the response includes full text content in the search results
             model (string): The search model to use for the answer. Exa passes only one query to exa, while exa-pro also passes 2 expanded queries to our search model.
-        
+
         Returns:
             dict[str, Any]: OK
-        
+
         Tags:
             important
         """
@@ -219,8 +219,8 @@ class ExaApp(APIApplication):
 
     def list_tools(self):
         return [
-            self.search_with_filters, 
-            self.find_similar_by_url, 
-            self.fetch_page_content, 
-            self.answer
-            ]
+            self.search_with_filters,
+            self.find_similar_by_url,
+            self.fetch_page_content,
+            self.answer,
+        ]

universal_mcp/applications/falai/README.md

@@ -1,17 +1,18 @@
-# Falai MCP Server
+# FalaiApp MCP Server
 
-An MCP Server for the Falai API.
+An MCP Server for the FalaiApp API.
 
 ## 🛠️ Tool List
 
-This is automatically generated from OpenAPI schema for the Falai API.
+This is automatically generated from OpenAPI schema for the FalaiApp API.
 
-| Tool             | Description                                                                                                                                                  |
-| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `run`            | Run a Fal AI application directly and wait for the result. Suitable for short-running applications with synchronous execution from the caller's perspective. |
-| `submit`         | Submits a request to the Fal AI queue for asynchronous processing and returns a request ID for tracking the job.                                             |
-| `status`         | Checks the status of a previously submitted Fal AI request and retrieves its current execution state                                                         |
-| `result`         | Retrieves the result of a completed Fal AI request, waiting for completion if the request is still running.                                                  |
-| `cancel`         | Asynchronously cancels a running or queued Fal AI request.                                                                                                   |
-| `upload_file`    | Uploads a local file to the Fal CDN and returns its public URL                                                                                               |
-| `generate_image` | Asynchronously generates images using the 'fal-ai/flux/dev' application with customizable parameters and default settings                                    |
+
+| Tool | Description |
+|------|-------------|
+| `run` | Executes a Fal AI application synchronously, waiting for completion and returning the result directly. This method is suited for short-running tasks, unlike `submit` which queues a job for asynchronous processing and returns a request ID instead of the final output. |
+| `submit` | Submits a job to the Fal AI queue for asynchronous processing, immediately returning a request ID. This contrasts with the `run` method, which waits for completion. The returned ID is used by `check_status`, `get_result`, and `cancel` to manage the job's lifecycle. |
+| `check_status` | Checks the execution state (e.g., Queued, InProgress) of an asynchronous Fal AI job using its request ID. It provides a non-blocking way to monitor jobs initiated via `submit` without fetching the final `result`, and can optionally include logs. |
+| `get_result` | Retrieves the final result of an asynchronous job, identified by its `request_id`. This function waits for the job, initiated via `submit`, to complete. Unlike the non-blocking `check_status`, this method blocks execution to fetch and return the job's actual output upon completion. |
+| `cancel` | Asynchronously cancels a running or queued Fal AI job using its `request_id`. This function complements the `submit` method, providing a way to terminate asynchronous tasks before completion. It raises a `ToolError` if the cancellation request fails. |
+| `upload_file` | Asynchronously uploads a local file to the Fal Content Delivery Network (CDN), returning a public URL. This URL makes the file accessible for use as input in other Fal AI job execution methods like `run` or `submit`. A `ToolError` is raised if the upload fails. |
+| `run_image_generation` | A specialized wrapper for the `run` method that synchronously generates images using the 'fal-ai/flux/dev' model. It simplifies image creation with common parameters like `prompt` and `seed`, waits for the task to complete, and directly returns the result containing image URLs and metadata. |