universal-mcp-applications 0.1.1__tar.gz

universal_mcp_applications-0.1.1/.gitignore

@@ -0,0 +1,40 @@
+# Jinja template: universal_mcp_applications/.gitignore
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Environment variables
+.env
+.env.local
+
+
+dump/
+
+
+# SQLite database
+*.db
+*.sqlite
+*.sqlite3
+*.db-shm
+*.db-wal
+
+
+# Pyright
+.pyright
+
+# Ruff
+.ruff_cache
+
+# Pytest
+.pytest_cache
+
+
+# Local config
+local_config.json

universal_mcp_applications-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Agentr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

universal_mcp_applications-0.1.1/PKG-INFO

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: universal-mcp-applications
+Version: 0.1.1
+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
+Author-email: Manoj Bajaj <manoj@agentr.dev>
+License: MIT
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+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: fal-client>=0.5.9
+Requires-Dist: firecrawl-py>=3.0.3
+Requires-Dist: google-search-results>=2.4.2
+Requires-Dist: gql[all]>=3.5.2
+Requires-Dist: httpx-aiohttp>=0.1.8
+Requires-Dist: markitdown[all]>=0.1.1
+Requires-Dist: office365-rest-python-client>=2.6.2
+Requires-Dist: openai>=1.75.0
+Requires-Dist: pyairtable>=3.1.1
+Requires-Dist: pytest-asyncio>=1.1.0
+Requires-Dist: pytest>=8.3.5
+Requires-Dist: pytest>=8.4.1
+Requires-Dist: python-dotenv>=1.0.0
+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
+Provides-Extra: dev
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: pytest-cov; extra == 'test'
+Requires-Dist: pytest<9.0.0,>=7.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Universal MCP Applications
+
+**A collection of 80+ installable application wrappers for the Universal MCP framework.**
+
+This package provides a unified collection of all individual Universal MCP applications. It allows you to install every available tool at once and use them either as Python libraries in your own code.
+
+## Installation
+
+It is recommended to use `uv` for faster installation.
+
+```bash
+# Recommended using uv
+uv pip install universal-mcp-applications
+
+# Or using standard pip
+pip install universal-mcp-applications
+```
+
+## Usage
+
+The primary way to use the tools in this package is give below :-
+
+### 1. As a Library
+
+Each application can be imported and used directly in your Python projects. This is useful for integrating with other scripts or building more complex workflows.
+
+**Example:**
+
+```python
+from universal_mcp_applications.falai import FalaiApp
+from universal_mcp.utils import process_output
+
+# Instantiate the application
+# You may need to provide credentials via an integration
+app = FalaiApp() 
+
+# Call a method
+result = app.some_method(param1="value1")
+
+# Process and print the output
+process_output(result)
+```
+
+## Included Applications
+
+This package includes the following 82 applications:
+
+- `ahrefs`
+- `airtable`
+- `apollo`
+- `asana`
+- `aws-s3`
+- `bill`
+- `box`
+- `braze`
+- `cal-com-v2`
+- `calendly`
+- `canva`
+- `clickup`
+- `coda`
+- `confluence`
+- `contentful`
+- `crustdata`
+- `dialpad`
+- `digitalocean`
+- `domain-checker`
+- `e2b`
+- `elevenlabs`
+- `exa`
+- `falai`
+- `figma`
+- `firecrawl`
+- `fireflies`
+- `fpl`
+- `ghost-content`
+- `github`
+- `gong`
+- `google-ads`
+- `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`
+- `twillo`
+- `twitter`
+- `unipile`
+- `whatsapp`
+- `whatsapp-business`
+- `wrike`
+- `youtube`
+- `zenquotes`

universal_mcp_applications-0.1.1/README.md

@@ -0,0 +1,129 @@
+# Universal MCP Applications
+
+**A collection of 80+ installable application wrappers for the Universal MCP framework.**
+
+This package provides a unified collection of all individual Universal MCP applications. It allows you to install every available tool at once and use them either as Python libraries in your own code.
+
+## Installation
+
+It is recommended to use `uv` for faster installation.
+
+```bash
+# Recommended using uv
+uv pip install universal-mcp-applications
+
+# Or using standard pip
+pip install universal-mcp-applications
+```
+
+## Usage
+
+The primary way to use the tools in this package is give below :-
+
+### 1. As a Library
+
+Each application can be imported and used directly in your Python projects. This is useful for integrating with other scripts or building more complex workflows.
+
+**Example:**
+
+```python
+from universal_mcp_applications.falai import FalaiApp
+from universal_mcp.utils import process_output
+
+# Instantiate the application
+# You may need to provide credentials via an integration
+app = FalaiApp() 
+
+# Call a method
+result = app.some_method(param1="value1")
+
+# Process and print the output
+process_output(result)
+```
+
+## Included Applications
+
+This package includes the following 82 applications:
+
+- `ahrefs`
+- `airtable`
+- `apollo`
+- `asana`
+- `aws-s3`
+- `bill`
+- `box`
+- `braze`
+- `cal-com-v2`
+- `calendly`
+- `canva`
+- `clickup`
+- `coda`
+- `confluence`
+- `contentful`
+- `crustdata`
+- `dialpad`
+- `digitalocean`
+- `domain-checker`
+- `e2b`
+- `elevenlabs`
+- `exa`
+- `falai`
+- `figma`
+- `firecrawl`
+- `fireflies`
+- `fpl`
+- `ghost-content`
+- `github`
+- `gong`
+- `google-ads`
+- `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`
+- `twillo`
+- `twitter`
+- `unipile`
+- `whatsapp`
+- `whatsapp-business`
+- `wrike`
+- `youtube`
+- `zenquotes`

universal_mcp_applications-0.1.1/bump_and_release.sh

@@ -0,0 +1,97 @@
+#!/bin/bash
+
+set -e
+set -x
+
+# Ensure dependencies are installed
+echo "Syncing dependencies..."
+uv sync
+
+# Run tests with pytest
+echo "Running tests with pytest..."
+uv run pytest
+
+echo "Tests passed!"
+
+# Get the current branch name
+BRANCH=$(git branch --show-current)
+
+# Read the current version from pyproject.toml
+CURRENT_VERSION=$(grep -E '^version = "[0-9]+\.[0-9]+\.[0-9]+.*"' pyproject.toml | cut -d'"' -f2)
+
+# Split version into major, minor, patch
+IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT_VERSION"
+
+# Remove any rc suffix from PATCH if it exists
+PATCH_NUM=$(echo $PATCH | sed 's/-rc[0-9]*//')
+
+if [ "$BRANCH" = "master" ]; then
+    # On main branch - bump patch version
+    if [[ $PATCH == *"-rc"* ]]; then
+        NEW_VERSION="$MAJOR.$MINOR.$PATCH_NUM"
+    else
+        # Increase patch number by 1
+        PATCH_NUM=$((PATCH_NUM + 1))
+        NEW_VERSION="$MAJOR.$MINOR.$PATCH_NUM"
+    fi
+else
+    # On dev branch - bump rc version
+    if [[ $PATCH == *"-rc"* ]]; then
+        # If already has rc, increment rc number
+        RC_NUM=$(echo $PATCH | grep -o 'rc[0-9]*' | sed 's/rc//')
+        NEW_VERSION="$MAJOR.$MINOR.$PATCH_NUM-rc$((RC_NUM + 1))"
+    else
+        echo "No rc suffix found, adding rc1"
+        # Increase patch number by 1
+        PATCH_NUM=$((PATCH_NUM + 1))
+        # Add rc1
+        NEW_VERSION="$MAJOR.$MINOR.$PATCH_NUM-rc1"
+    fi
+fi
+
+# Update version in pyproject.toml
+sed -i '' "s/^version = ".*"/version = \"$NEW_VERSION\"/" pyproject.toml
+
+echo "Version bumped from $CURRENT_VERSION to $NEW_VERSION"
+
+# Stage the changed file
+git add pyproject.toml
+
+# Commit the change
+git commit -m "bump: version $CURRENT_VERSION → $NEW_VERSION"
+
+# Create and push tag if on main
+if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "develop" ] || [ "$BRANCH" = "master" ] || [ "$BRANCH" = "dev" ]; then
+    git tag -a "v$NEW_VERSION" -m "Release version $NEW_VERSION"
+    # Push both the branch and tag in one command
+    git push origin $BRANCH "v$NEW_VERSION"
+else
+    # Push only the branch if not on main/develop
+    git push origin $BRANCH
+fi
+
+
+# Either release is passed as arg or not
+if [ "$1" = "release" ]; then
+    # Execute release steps
+    echo "Releasing version $NEW_VERSION..."
+    rm -rf dist
+    rm -rf build
+    rm -rf *.egg-info
+    rm -rf .pytest_cache
+    rm -rf .ruff_cache
+    rm -rf .mypy_cache
+    rm -rf .venv
+    rm -rf .cache
+    rm -rf .DS_Store
+    rm -rf .idea
+    rm -rf .vscode
+
+    uv sync && uv build && uv publish
+    echo "Release complete!"
+else
+    echo "Skipping release steps"
+fi
+
+
+ 

universal_mcp_applications-0.1.1/pyproject.toml

@@ -0,0 +1,105 @@
+[build-system]
+requires = [
+    "hatchling",
+]
+build-backend = "hatchling.build"
+
+[project]
+name = "universal-mcp-applications"
+version = "0.1.1"
+description = "A Universal MCP Application: universal_mcp_applications"
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [
+    { name = "Manoj Bajaj", email = "manoj@agentr.dev" },
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "boto3>=1.38.32",
+    "dnspython>=2.4.0",
+    "e2b-code-interpreter>=1.2.1",
+    "fal-client>=0.5.9",
+    "firecrawl-py>=3.0.3",
+    "google-search-results>=2.4.2",
+    "gql[all]>=3.5.2",
+    "httpx-aiohttp>=0.1.8",
+    "markitdown[all]>=0.1.1",
+    "office365-rest-python-client>=2.6.2",
+    "openai>=1.75.0",
+    "pyairtable>=3.1.1",
+    "pytest-asyncio>=1.1.0",
+    "pytest>=8.3.5",
+    "pytest>=8.4.1",
+    "python-dotenv>=1.0.0",
+    "replicate>=1.0.6",
+    "requests>=2.31.0",
+    "resend>=2.10.0",
+    "twilio>=9.8.0",
+    "universal-mcp",
+]
+
+[project.license]
+text = "MIT"
+
+[project.optional-dependencies]
+test = [
+    "pytest>=7.0.0,<9.0.0",
+    "pytest-cov",
+]
+dev = [
+    "ruff",
+    "pre-commit",
+]
+
+[project.urls]
+Homepage = "https://github.com/universal-mcp/applications"
+Repository = "https://github.com/universal-mcp/applications"
+
+[tool.hatch.envs.default]
+dependencies = [
+    "pytest",
+    "pytest-cov",
+]
+
+[tool.hatch.envs.default.scripts]
+test = "pytest {args:tests}"
+test-cov = "pytest --cov-report term-missing --cov-config=pyproject.toml --cov=src/universal_mcp --cov=tests {args:tests}"
+lint = "ruff check . && ruff format --check ."
+format = "ruff format ."
+
+
+[tool.hatch.build.targets.wheel]
+packages = [
+    "src/universal_mcp",
+]
+
+[tool.coverage.run]
+source = [
+    "src",   
+]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 70
+
+[tool.ruff]
+line-length = 88
+select = [
+    "E", "W", "F", "I", "UP", "PL", "T20",
+]
+ignore = []
+
+
+[tool.ruff.format]
+quote-style = "double"
+
+[tool.pytest.ini_options]
+pythonpath = [
+    "src",
+]

universal_mcp_applications-0.1.1/src/tests/test_applications.py

@@ -0,0 +1,7 @@
+from universal_mcp.applications.zenquotes import ZenquotesApp
+
+def test_zenquotes():
+    app = ZenquotesApp()
+    quote = app.get_quote()
+    assert quote is not None
+    assert quote != ""

universal_mcp_applications-0.1.1/src/universal_mcp/applications/ahrefs/README.md

@@ -0,0 +1,51 @@
+# Ahrefs MCP Server
+
+An MCP Server for the Ahrefs API.
+
+## 🛠️ Tool List
+
+This is automatically generated from OpenAPI schema for the Ahrefs API.
+
+
+| Tool | Description |
+|------|-------------|
+| `crawler_ips` | Retrieve the list of public crawler IP addresses from the API. |
+| `crawler_ip_ranges` | Fetches the current public crawler IP ranges from the API, optionally specifying output format. |
+| `limits_and_usage` | Retrieves current API subscription limits and usage statistics from the service. |
+| `batch_analysis` | Submits a batch analysis request with specified parameters and returns the analysis results as a dictionary. |
+| `serp_overview` | Retrieves a SERP (Search Engine Results Page) overview report based on specified selection, country, and keyword criteria. |
+| `overview` | Retrieves rank tracking overview data for a specified project, date, and device. |
+| `competitors_overview` | Retrieves an overview of competitor rankings for a specified project and criteria. |
+| `projects` | Retrieves a list of site audit projects from the configured base URL, optionally specifying an output format. |
+| `domain_rating` | Fetches the domain rating and related metrics for a specified target and date. |
+| `backlinks_stats` | Retrieves backlink statistics for a specified target and date, with optional filters for protocol, mode, and output format. |
+| `outlinks_stats` | Retrieves outbound link statistics for the specified target from the site explorer API. |
+| `metrics` | Retrieves metrics data from the site explorer API endpoint. |
+| `refdomains_history` | Retrieves the historical data of reference domains from a specified site. |
+| `domain_rating_history` | Retrieves historical domain rating data for a specified target within a given date range. |
+| `url_rating_history` | Retrieves URL rating history data for a specified target within a date range. |
+| `pages_history` | Retrieves historical page data for a target using specified filters. |
+| `metrics_history` | Retrieves historical metrics based on specified parameters. |
+| `keywords_history` | Fetches the historical keyword rankings and performance data for a specified target within an optional date range and set of filters. |
+| `metrics_by_country` | Fetches site metrics grouped by country for a specified target and date. |
+| `pages_by_traffic` | Retrieves a list of top pages for a specified target domain or URL, ranked by estimated organic search traffic. |
+| `all_backlinks` | Retrieves all backlinks information for a specified target using various query parameters. |
+| `broken_backlinks` | Fetches broken backlink data for the specified target from the site explorer API endpoint. |
+| `refdomains` | Retrieves referring domains data for a specified target using the Site Explorer API endpoint. |
+| `anchors` | Fetches anchor text distribution data for a specified target using given query parameters. |
+| `linkeddomains` | Retrieves linked domains for a specified target using the site explorer API endpoint. |
+| `linked_anchors_external` | Fetch linked external anchor data for a specified target using provided selection and filtering criteria. |
+| `linked_anchors_internal` | Fetches internal linked anchor data for a specified target from the site explorer API, applying optional filtering and query parameters. |
+| `organic_keywords` | Retrieve organic keyword data for a specified target and date from the Site Explorer API endpoint. |
+| `organic_competitors` | Retrieves organic competitors data for a specified target using the Site Explorer API. |
+| `top_pages` | Retrieves top pages data for a specified target and date from the site explorer API with customizable query parameters. |
+| `paid_pages` | Fetches paid pages data from the Site Explorer API based on specified filters. |
+| `best_by_external_links` | Fetches data about the best-performing pages of a target site based on external links, with various filtering and output options. |
+| `best_by_internal_links` | Retrieves the best-performing internal links for a specified target using the site explorer API endpoint. |
+| `total_search_volume_history` | Fetches the total historical search volume data for a specified target within a given date range and optional filters. |
+| `keyword_explorer_overview` | Retrieves an overview of keyword metrics and data from the keywords explorer API endpoint based on the specified filters and parameters. |
+| `volume_history` | Fetches the historical search volume for a given keyword in a specified country. |
+| `volume_by_country` | Retrieves search volume by country for a given keyword. |
+| `matching_terms` | Retrieves matching keyword terms from the keywords explorer API based on specified filters and search parameters. |
+| `related_terms` | Retrieves related keyword terms for a given selection and country, with optional filtering and pagination. |
+| `search_suggestions` | Fetches keyword search suggestions from the keywords explorer API based on the provided filtering and query parameters. |

universal_mcp_applications-0.1.1/src/universal_mcp/applications/ahrefs/__init__.py

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