tinyurl-mcp


Nametinyurl-mcp JSON
Version 1.0.0 PyPI version JSON
download
home_pageNone
SummaryMCP Server for tinyurl.com
upload_time2025-09-05 10:47:40
maintainerNone
docs_urlNone
authorNone
requires_python>=3.13
licenseNone
keywords mcp tinyurl url shortener
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ## TinyURL MCP Server

This MCP server provides tools to interact with [tinyurl.com](https://tinyurl.com) to manage short URLs.

### Prerequisites

- For Option 1:
  - [uv](https://docs.astral.sh/uv/) from Astral
  - [Python 3.13](https://www.python.org/downloads/) or higher
- For Option 2:
  - [Docker](https://www.docker.com/)


### Configuration

Use either of the below option to configure your MCP client. To understand the configuration options, please refer to the [documentation](https://gofastmcp.com/integrations/mcp-json-configuration).

**Option 1: Via uvx**
```json
{
  "mcpServers": {
    "tinyurl-mcp": {
      "command": "uvx",
      "args": [
        "tinyurl-mcp"
      ],
      "env": {
        "TINY_URL_API_KEY": "__API_KEY__"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```


**Option 2: Via docker**

```json
{
  "mcpServers": {
    "tinyurl-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--env",
        "TINY_URL_API_KEY=__API_KEY__",
        "vimalpaliwal/tinyurl-mcp:latest"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

**Note:** Replace `__API_KEY__` with your actual API key.


### Available Tools

- `generate_short_url`: Generate a new short URL
- `update_long_url`:  Update the long URL of an existing short URL
- `delete_short_url`: Delete an existing short URL
- `list_short_urls`: Llist all the available or archived short URLs

### Basic Usage Examples

- Shorten linkedin.com/in/xxxxx for me please
- Please create a short URL for medium.com/blog/xxxxx that expires next week
- Update the long URL of tinyurl.com/xxxx to medium.com/blog/zzzzz
- Delete the short URL for tinyurl.com/xxxx for me please
- List all the archived short URLs

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "tinyurl-mcp",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.13",
    "maintainer_email": null,
    "keywords": "mcp, tinyurl, url shortener",
    "author": null,
    "author_email": "Vimal Paliwal <vimalpaliwal.me@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/f1/30/d0cbd3056b1e3c409a5ce4fa39e07b32dce4bda344f9abe9eb2d3a9db6d8/tinyurl_mcp-1.0.0.tar.gz",
    "platform": null,
    "description": "## TinyURL MCP Server\n\nThis MCP server provides tools to interact with [tinyurl.com](https://tinyurl.com) to manage short URLs.\n\n### Prerequisites\n\n- For Option 1:\n  - [uv](https://docs.astral.sh/uv/) from Astral\n  - [Python 3.13](https://www.python.org/downloads/) or higher\n- For Option 2:\n  - [Docker](https://www.docker.com/)\n\n\n### Configuration\n\nUse either of the below option to configure your MCP client. To understand the configuration options, please refer to the [documentation](https://gofastmcp.com/integrations/mcp-json-configuration).\n\n**Option 1: Via uvx**\n```json\n{\n  \"mcpServers\": {\n    \"tinyurl-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"tinyurl-mcp\"\n      ],\n      \"env\": {\n        \"TINY_URL_API_KEY\": \"__API_KEY__\"\n      },\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\n\n**Option 2: Via docker**\n\n```json\n{\n  \"mcpServers\": {\n    \"tinyurl-mcp\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"--env\",\n        \"TINY_URL_API_KEY=__API_KEY__\",\n        \"vimalpaliwal/tinyurl-mcp:latest\"\n      ],\n      \"env\": {},\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\n**Note:** Replace `__API_KEY__` with your actual API key.\n\n\n### Available Tools\n\n- `generate_short_url`: Generate a new short URL\n- `update_long_url`:  Update the long URL of an existing short URL\n- `delete_short_url`: Delete an existing short URL\n- `list_short_urls`: Llist all the available or archived short URLs\n\n### Basic Usage Examples\n\n- Shorten linkedin.com/in/xxxxx for me please\n- Please create a short URL for medium.com/blog/xxxxx that expires next week\n- Update the long URL of tinyurl.com/xxxx to medium.com/blog/zzzzz\n- Delete the short URL for tinyurl.com/xxxx for me please\n- List all the archived short URLs\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "MCP Server for tinyurl.com",
    "version": "1.0.0",
    "project_urls": null,
    "split_keywords": [
        "mcp",
        " tinyurl",
        " url shortener"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "767052c83024b21c1b5ee1c7fbd4352d000a91d9d30ea2210bb142504d60226f",
                "md5": "7d474ce0516b05be399643805973e820",
                "sha256": "fb49460d5dc5a445b81bfde7abeca9fb8386c67bcc20f00aa1c6a440f9e61aea"
            },
            "downloads": -1,
            "filename": "tinyurl_mcp-1.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7d474ce0516b05be399643805973e820",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.13",
            "size": 6966,
            "upload_time": "2025-09-05T10:47:39",
            "upload_time_iso_8601": "2025-09-05T10:47:39.030251Z",
            "url": "https://files.pythonhosted.org/packages/76/70/52c83024b21c1b5ee1c7fbd4352d000a91d9d30ea2210bb142504d60226f/tinyurl_mcp-1.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "f130d0cbd3056b1e3c409a5ce4fa39e07b32dce4bda344f9abe9eb2d3a9db6d8",
                "md5": "539f91c38d4955045a52b3aba7330e7c",
                "sha256": "1c0c5429695e63bb429fc6052bddd7311efe4576cb2edc257e6a90a7ebb23218"
            },
            "downloads": -1,
            "filename": "tinyurl_mcp-1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "539f91c38d4955045a52b3aba7330e7c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.13",
            "size": 29345,
            "upload_time": "2025-09-05T10:47:40",
            "upload_time_iso_8601": "2025-09-05T10:47:40.353769Z",
            "url": "https://files.pythonhosted.org/packages/f1/30/d0cbd3056b1e3c409a5ce4fa39e07b32dce4bda344f9abe9eb2d3a9db6d8/tinyurl_mcp-1.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-09-05 10:47:40",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "tinyurl-mcp"
}
        
Elapsed time: 1.14209s