Metadata-Version: 2.4
Name: tinyurl-mcp
Version: 1.0.0
Summary: MCP Server for tinyurl.com
Author-email: Vimal Paliwal <vimalpaliwal.me@gmail.com>
License-Expression: Apache-2.0
Keywords: mcp,tinyurl,url shortener
Requires-Python: >=3.13
Requires-Dist: dateparser>=1.2.2
Requires-Dist: httpx>=0.28.1
Requires-Dist: loguru>=0.7.3
Requires-Dist: mcp[cli]>=1.13.1
Requires-Dist: pydantic>=2.11.7
Description-Content-Type: text/markdown

## 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
