Skip to content
MCP server

TinyURL MCP by usefulapi

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

Install
Runs
Remotely
Version
1.27.0
Listing updated
4 days ago

About TinyURL MCP by usefulapi

TinyURL MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://tinyurl.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tinyurl": {
      "url": "https://tinyurl.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (8)

Read directly from the server.

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

TinyURL MCP by usefulapi 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