Skip to main content

A Universal MCP Application: universal_mcp_shortcut

Project description

Shortcut Universal MCP Server

This repository contains an implementation of an Shortcut Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Shortcut's SEO and backlink analysis tools through a unified API.

The server is built using the Universal MCP framework.

This implementation follows the MCP specification, ensuring compatibility with other MCP-compliant services and tools.

Usage

You can start using Shortcut directly from agentr.dev. Visit agentr.dev/apps and enable Shortcut.

If you have not used universal mcp before follow the setup instructions at agentr.dev/quickstart

Available Tools

The full list of available tools is at ./src/universal_mcp_shortcut/README.md

Local Development

📋 Prerequisites

Ensure you have the following before you begin:

  • Python 3.11+ (recommended)
  • uv (install globally with pip install uv)

🛠️ Setup Instructions

Follow the steps below to set up your development environment:

  1. Sync Project Dependencies

    uv sync
    

    This installs all dependencies from pyproject.toml into a local virtual environment (.venv).

  2. Activate the Virtual Environment

    For Linux/macOS:

    source .venv/bin/activate
    

    For Windows (PowerShell):

    .venv\Scripts\Activate
    
  3. Start the MCP Inspector

    mcp dev src/universal_mcp_shortcut/mcp.py
    

    This will start the MCP inspector. Make note of the address and port shown in the console output.

  4. Install the Application

    mcp install src/universal_mcp_shortcut/mcp.py
    

📁 Project Structure

.
├── src/
│   └── universal_mcp_shortcut/
│       ├── __init__.py       # Package initializer
│       ├── mcp.py            # Server entry point
│       ├── app.py            # Application tools
│       └── README.md         # List of application tools
├── tests/                    # Test suite
├── .env                      # Environment variables for local development
├── pyproject.toml            # Project configuration
└── README.md                 # This file

📄 License

This project is licensed under the MIT License.


Generated with MCP CLI — Happy coding! 🚀

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

universal_mcp_shortcut-0.1.1.tar.gz (143.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

universal_mcp_shortcut-0.1.1-py3-none-any.whl (25.8 kB view details)

Uploaded Python 3

File details

Details for the file universal_mcp_shortcut-0.1.1.tar.gz.

File metadata

File hashes

Hashes for universal_mcp_shortcut-0.1.1.tar.gz
Algorithm Hash digest
SHA256 75034f131396c42bca70712847df3968614a1290dddd968c34bce8d548a16bff
MD5 1e60e5a20667cdd04349f8a669e6f7d7
BLAKE2b-256 fc98d511f9849a1063e5e2fb10e99a561df05edbbca2d085478b43dcb28119ea

See more details on using hashes here.

File details

Details for the file universal_mcp_shortcut-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for universal_mcp_shortcut-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3305035dfe33a7eb2989d5206702259861f762427683fe5c6b22ba5a9a2f0f3f
MD5 ebbee0415491219c4a3c88451eb7744e
BLAKE2b-256 24e91a3be8860f1f228e254103847f8e55dbbb0757248002a336db11c175221a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page