# TinyURL MCP by usefulapi

> TinyURL MCP by usefulapi is an MCP server. Create and manage TinyURL short links: aliases, destinations, tags, archive, click analytics. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/tinyurl/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/tinyurl
- **MCP Registry name:** io.usefulapi/tinyurl
- **Listing updated:** 2026-11-13

## About

Create and manage TinyURL short links: aliases, destinations, tags, archive, click analytics.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tinyurl https://tinyurl.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://tinyurl.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tinyurl": {
      "url": "https://tinyurl.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tinyurl": {
      "type": "http",
      "url": "https://tinyurl.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tinyurl": {
      "serverUrl": "https://tinyurl.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tinyurl": {
      "type": "http",
      "url": "https://tinyurl.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `tinyurl_get_link`: Details of one short link: destination URL, tiny_url, tags, created/expires dates, archived/deleted flags, analytics settings, total hits and owner. GET /alias/{domain}/{alias}.
- `tinyurl_list_links`: List the account's short links (type available = active, archived = archived), optionally created within a date range or filtered by alias or tag. The TinyURL API does not page this list: at most `limit` items (default 50, max 200) are returned together with the total, so narrow with from/to/search when truncated is true. GET /urls/{type}.
- `tinyurl_count_links`: How many short links the account has (active or archived), optionally within a creation date range or filtered by alias or tag. GET /urls/{type}/count.
- `tinyurl_get_analytics`: Aggregated click analytics for the account, or for one link (alias) or one tag, from a start date. report: timeline (clicks over time; interval minute/hour/day/week/month), general (browsers, operating systems, devices), weekday and hour (popularity), top_sources (referrers), top_languages, location (countries, or the regions of one country via region = ISO 3166 alpha-2 code). Which reports are av
- `tinyurl_create_link`: WRITE: create ONE new short link for an http(s) destination URL. Optional custom alias (5-30 characters on tinyurl.com), domain (tinyurl.com or a branded domain), tags, expiry and description. Not idempotent: calling it again without an alias creates another link. Returns the new tiny_url. POST /create.
- `tinyurl_update_link`: WRITE: change an existing short link's alias, tags, expiry, description or click-analytics switch. At least one new_* field is required. DESTRUCTIVE for what it replaces: new_tags REPLACES all existing tags, and renaming the alias (new_alias) makes the old short URL stop working. The destination URL is changed with tinyurl_change_destination. PATCH /update.
- `tinyurl_change_destination`: WRITE: point an existing short link at a new destination. DESTRUCTIVE: everyone who opens the short link is sent to the new URL from now on and the old destination is overwritten. The new URL must be http(s). PATCH /change.
- `tinyurl_set_link_archived`: WRITE: archive an active short link (archived = true) or restore an archived one (archived = false). Archiving moves the link to the archived list; nothing is deleted and it can be restored. The API's archive endpoint is a toggle, so the link's current state is read first and nothing is changed when it already matches, and the state afterwards is checked. Do not run two archive calls for the same 

## FAQ

### How do I add TinyURL MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http tinyurl https://tinyurl.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/tinyurl-mcp-by-usefulapi
