universal-mcp-applications 0.1.1__tar.gz → 0.1.3__tar.gz

{universal_mcp_applications-0.1.1 → universal_mcp_applications-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: universal-mcp-applications
-Version: 0.1.1
+Version: 0.1.3
 Summary: A Universal MCP Application: universal_mcp_applications
 Project-URL: Homepage, https://github.com/universal-mcp/applications
 Project-URL: Repository, https://github.com/universal-mcp/applications
@@ -15,8 +15,10 @@ Requires-Python: >=3.11
 Requires-Dist: boto3>=1.38.32
 Requires-Dist: dnspython>=2.4.0
 Requires-Dist: e2b-code-interpreter>=1.2.1
+Requires-Dist: elevenlabs>=2.14.0
 Requires-Dist: fal-client>=0.5.9
 Requires-Dist: firecrawl-py>=3.0.3
+Requires-Dist: google-genai>=1.33.0
 Requires-Dist: google-search-results>=2.4.2
 Requires-Dist: gql[all]>=3.5.2
 Requires-Dist: httpx-aiohttp>=0.1.8
@@ -32,7 +34,7 @@ Requires-Dist: replicate>=1.0.6
 Requires-Dist: requests>=2.31.0
 Requires-Dist: resend>=2.10.0
 Requires-Dist: twilio>=9.8.0
-Requires-Dist: universal-mcp
+Requires-Dist: universal-mcp>=0.1.24rc17
 Provides-Extra: dev
 Requires-Dist: pre-commit; extra == 'dev'
 Requires-Dist: ruff; extra == 'dev'

universal_mcp_applications-0.1.3/examples/children_story_builder.py

@@ -0,0 +1,146 @@
+import asyncio
+
+from langgraph.checkpoint.memory import MemorySaver
+
+from universal_mcp.agentr.registry import AgentrRegistry
+from universal_mcp.agents import ReactAgent
+
+SYSTEM_PROMPT = """
+You are an world renowned storyteller. You write stories for children. You will be given a task to write a story and its anciallary functions. You will need to follow the steps below to complete the task.
+Always use easy to understand language and simple words. The stories are meant for children. 
+
+IMPORTANT:
+- Do not ask for user confirmation in between, in case of confusion make assumptions and move one.
+- For file paths, use the /tmp directory.
+
+"""
+
+
+async def main():
+    registry = AgentrRegistry()
+    tools = {
+        # "reddit": ["r_subreddit_top", "get_subreddit_posts"],
+        "google_gemini": ["generate_image", "generate_audio"],
+        "file_system": ["write_file"],
+    }
+    checkpointer = MemorySaver()
+    agent = ReactAgent(
+        name="My Agent",
+        instructions=SYSTEM_PROMPT,
+        registry=registry,
+        tools=tools,
+        model="azure/gpt-5-chat",
+        memory=checkpointer,
+    )
+    tasks = [
+        """Task 1: Story Creation
+        Write a captivating children's fairy tale story about a brave princess who rescues a prince from a dragon. 
+        
+        Requirements:
+        - Target audience: Children aged 4-8 years
+        - Use simple, age-appropriate vocabulary and sentence structure
+        - Create 6-8 distinct scenes that flow logically from beginning to end
+        - Include classic fairy tale elements: setting, characters, conflict, and resolution
+        - Make the princess the hero of the story, showcasing courage and problem-solving
+        - Ensure the story has a positive, uplifting message
+        - Each scene should be 2-3 sentences long for easy comprehension
+        - Include dialogue to make the story engaging
+        
+        Structure each scene with:
+        - Scene number and descriptive title
+        - Brief narrative text
+        - Clear progression toward the rescue and happy ending""",
+        """Task 2: Image Generation
+        Generate high-quality images for each scene of the fairy tale story you just created.
+        
+        Requirements:
+        - Create one image per scene (6-8 images total)
+        - Style: Animated webtoon comic style with bright, cheerful colors
+        - Include all main characters: princess, prince, and dragon in relevant scenes
+        - Ensure visual consistency across all images (same character designs, art style)
+        - Make images child-friendly and non-frightening
+        - Include relevant background settings for each scene
+        - Each image should clearly represent the key moment or action of its corresponding scene
+        
+        For each image prompt, include:
+        - Scene description and key visual elements
+        - Character descriptions and positions
+        - Setting and background details
+        - Mood and atmosphere
+        - Specific mention of "webtoon comic style, animated, colorful, child-friendly"
+
+        To ensure consisteny pass the previous image path as reference to next image generation.
+        Generate all the scenes one by one.
+        Verify that all scenes have corresponding images before proceeding.""",
+        """Task 3: Story Narration Writing
+        Transform the fairy tale story into an engaging audio narration script suitable for children.
+        
+        Requirements:
+        - Write in a warm, friendly storytelling voice
+        - Use varied sentence rhythms and pacing for audio delivery
+        - Include natural pauses and emphasis points
+        - Add descriptive language that paints vivid mental pictures
+        - Use sound words and onomatopoeia where appropriate (whoosh, roar, etc.)
+        - Create emotional engagement through tone and word choice
+        - Ensure smooth transitions between scenes
+        - Keep language simple but expressive
+        - Add narrative cues that work well when spoken aloud
+        - Total narration should be 3-5 minutes when read aloud
+        
+        Format the narration with:
+        - Clear scene breaks
+        - Emphasis markers for important moments
+        - Natural breathing points
+        - Engaging opening and satisfying conclusion""",
+        """Task 4: Audio Generation
+        Generate high-quality audio narration of the complete fairy tale story.
+        
+        Requirements:
+        - Use the narration script from Task 3
+        - Select a warm, friendly voice suitable for children's stories
+        - Ensure clear pronunciation and appropriate pacing
+        - Use natural storytelling rhythm with appropriate pauses
+        - Maintain consistent volume and tone throughout
+        - Generate as a single audio file containing the complete story
+        - Save the audio in a web-compatible format (WAV or MP3)
+        - Ensure the audio duration matches the 3-5 minute target length
+        
+        Voice characteristics:
+        - Gender-neutral or female voice preferred
+        - Warm, nurturing tone
+        - Clear articulation
+        - Moderate speaking pace suitable for children
+        - Expressive delivery that brings the story to life""",
+        """Task 5: Markdown Story Compilation
+        Create a comprehensive markdown file that combines all story elements into a beautiful, complete presentation.
+        
+        Requirements:
+        - Create a well-structured markdown document with proper formatting
+        - Include an engaging title for the fairy tale
+        - Organize content with clear headings and sections
+        - Embed all generated images in their corresponding scenes
+        - Include the audio narration file with proper markdown audio player syntax
+        - Use proper markdown syntax for images: ![Alt text](image_path)
+        - Use proper markdown syntax for audio: 🎧 [Listen to the Story](audio_path)
+        - Add scene dividers and visual breaks for readability
+        - Include a table of contents if helpful
+        - Ensure all file paths are correct and accessible
+        - Add any necessary alt text for accessibility
+        
+        Structure:
+        - Title and introduction
+        - Scene-by-scene presentation with embedded images
+        - Audio narration section
+        - Optional: Character descriptions or story themes
+        
+        Save the final markdown file with an appropriate filename like '/tmp/fairy_tale_story.md'
+        Verify all embedded media files are properly linked and accessible.""",
+    ]
+
+    for task in tasks:
+        result = await agent.invoke(task)
+        print(result["messages"][-1].content)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

{universal_mcp_applications-0.1.1 → universal_mcp_applications-0.1.3}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "universal-mcp-applications"
-version = "0.1.1"
+version = "0.1.3"
 description = "A Universal MCP Application: universal_mcp_applications"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -23,8 +23,10 @@ dependencies = [
     "boto3>=1.38.32",
     "dnspython>=2.4.0",
     "e2b-code-interpreter>=1.2.1",
+    "elevenlabs>=2.14.0",
     "fal-client>=0.5.9",
     "firecrawl-py>=3.0.3",
+    "google-genai>=1.33.0",
     "google-search-results>=2.4.2",
     "gql[all]>=3.5.2",
     "httpx-aiohttp>=0.1.8",
@@ -40,7 +42,7 @@ dependencies = [
     "requests>=2.31.0",
     "resend>=2.10.0",
     "twilio>=9.8.0",
-    "universal-mcp",
+    "universal-mcp >= 0.1.24rc17",
 ]
 
 [project.license]

universal_mcp_applications-0.1.3/src/tests/test_applications.py

@@ -0,0 +1,96 @@
+import pytest
+
+from universal_mcp.applications.utils import app_from_slug
+from universal_mcp.utils.testing import check_application_instance
+
+ALL_APPS = [
+    "ahrefs",
+    "airtable",
+    "aws_s3",
+    "apollo",
+    "asana",
+    "bill",
+    "box",
+    "braze",
+    # "cal_com_v2",
+    "confluence",
+    "calendly",
+    "canva",
+    "clickup",
+    "coda",
+    "contentful",
+    "crustdata",
+    "dialpad",
+    "digitalocean",
+    "domain_checker",
+    "e2b",
+    "elevenlabs",
+    "exa",
+    "falai",
+    "figma",
+    "file_system",
+    "firecrawl",
+    "fireflies",
+    "fpl",
+    "ghost_content",
+    "github",
+    "gong",
+    "google_calendar",
+    "google_docs",
+    "google_drive",
+    "google_gemini",
+    "google_mail",
+    "google_searchconsole",
+    "google_sheet",
+    "hashnode",
+    "heygen",
+    "http_tools",
+    "hubspot",
+    "jira",
+    "klaviyo",
+    "linkedin",
+    "mailchimp",
+    "markitdown",
+    "miro",
+    "ms_teams",
+    "neon",
+    "notion",
+    "openai",
+    "outlook",
+    "perplexity",
+    "pipedrive",
+    "posthog",
+    "reddit",
+    "replicate",
+    "resend",
+    "retell",
+    "rocketlane",
+    "semanticscholar",
+    "semrush",
+    "sendgrid",
+    "sentry",
+    "serpapi",
+    "sharepoint",
+    "shopify",
+    "shortcut",
+    "slack",
+    "spotify",
+    "supabase",
+    "tavily",
+    "trello",
+    "twilio",
+    "twitter",
+    "unipile",
+    "whatsapp",
+    "whatsapp_business",
+    "wrike",
+    "youtube",
+    "zenquotes",
+]
+
+
+@pytest.mark.parametrize("app_name", ALL_APPS)
+def test_application(app_name):
+    app_class = app_from_slug(app_name)
+    app_instance = app_class(integration=None)
+    check_application_instance(app_instance, app_name)

{universal_mcp_applications-0.1.1 → universal_mcp_applications-0.1.3}/src/universal_mcp/applications/airtable/app.py

@@ -14,6 +14,7 @@ from pyairtable.api.types import (
     WritableFields,
 )
 from pyairtable.formulas import Formula, to_formula_str
+
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 

{universal_mcp_applications-0.1.1 → universal_mcp_applications-0.1.3}/src/universal_mcp/applications/apollo/app.py

@@ -1,6 +1,7 @@
 from typing import Any
 
 from loguru import logger
+
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 

{universal_mcp_applications-0.1.1/src/universal_mcp/applications/aws-s3 → universal_mcp_applications-0.1.3/src/universal_mcp/applications/aws_s3}/app.py

@@ -4,7 +4,8 @@ from typing import Any
 
 import boto3
 from botocore.exceptions import ClientError
-from universal_mcp.applications import BaseApplication
+
+from universal_mcp.applications.application import BaseApplication
 from universal_mcp.integrations import Integration
 
 
@@ -22,7 +23,7 @@ class AwsS3App(BaseApplication):
             aws_secret_access_key (str, optional): AWS secret access key.
             region_name (str, optional): AWS region name.
         """
-        super().__init__(name="aws-s3", integration=integration, **kwargs)
+        super().__init__(name="aws_s3", integration=integration, **kwargs)
         self._client = client
         self.integration = integration
 
@@ -135,9 +136,7 @@ class AwsS3App(BaseApplication):
         except ClientError:
             return False
 
-    def list_prefixes(
-        self, bucket_name: str, prefix: str | None = None
-    ) -> list[str]:
+    def list_prefixes(self, bucket_name: str, prefix: str | None = None) -> list[str]:
         """
         Lists common prefixes ("folders") in the specified S3 bucket and prefix.
 

{universal_mcp_applications-0.1.1 → universal_mcp_applications-0.1.3}/src/universal_mcp/applications/bill/app.py

@@ -244,7 +244,7 @@ class BillApp(APIApplication):
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
 
         Tags:
-            bills
+            bills, , important
         """
         url = f"{self.base_url}/v3/bills"
         query_params = {
@@ -356,7 +356,7 @@ class BillApp(APIApplication):
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
 
         Tags:
-            bills
+            bills, important
         """
         if billId is None:
             raise ValueError("Missing required parameter 'billId'.")
@@ -2927,7 +2927,7 @@ class BillApp(APIApplication):
             HTTPStatusError: Raised when the API request fails with detailed error information including status code and response body.
 
         Tags:
-            customers
+            customers, important
         """
         if customerId is None:
             raise ValueError("Missing required parameter 'customerId'.")

{universal_mcp_applications-0.1.1 → universal_mcp_applications-0.1.3}/src/universal_mcp/applications/box/app.py

@@ -3155,9 +3155,7 @@ class BoxApp(APIApplication):
         except ValueError:
             return None
 
-    def delete_folders_id(
-        self, folder_id: str, recursive: bool | None = None
-    ) -> Any:
+    def delete_folders_id(self, folder_id: str, recursive: bool | None = None) -> Any:
         """
         Delete folder
 
@@ -11630,9 +11628,7 @@ class BoxApp(APIApplication):
         except ValueError:
             return None
 
-    def create_shield_barriers(
-        self, enterprise: Any | None = None
-    ) -> dict[str, Any]:
+    def create_shield_barriers(self, enterprise: Any | None = None) -> dict[str, Any]:
         """
         Create shield information barrier
 

{universal_mcp_applications-0.1.1 → universal_mcp_applications-0.1.3}/src/universal_mcp/applications/braze/app.py

@@ -927,9 +927,7 @@ class BrazeApp(APIApplication):
         except ValueError:
             return None
 
-    def add_email_to_blocklist(
-        self, email: list[str] | None = None
-    ) -> dict[str, Any]:
+    def add_email_to_blocklist(self, email: list[str] | None = None) -> dict[str, Any]:
         """
         Blocklist Email Addresses
 
@@ -2367,9 +2365,7 @@ class BrazeApp(APIApplication):
         except ValueError:
             return None
 
-    def list_scheduled_broadcasts(
-        self, end_time: str | None = None
-    ) -> dict[str, Any]:
+    def list_scheduled_broadcasts(self, end_time: str | None = None) -> dict[str, Any]:
         """
         List Upcoming Scheduled Campaigns and Canvases
 

universal_mcp_applications-0.1.3/src/universal_mcp/applications/cal_com_v2/__init__.py

@@ -0,0 +1 @@
+from .app import CalComV2App