# Short.io MCP

> Short.io manages your branded links, letting you build, track, and analyze all your URLs from one place. Connect this MCP to any AI agent to handle complex link campaigns—from generating bulk links for product launches to pulling detailed click statistics by geography. It’s complete URL orchestration without ever opening the dashboard.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** url-shortening, link-management, branded-domains, click-tracking, analytics, redirects

## Description

Managing branded links used to mean jumping between a web dashboard, an analytics platform, and your content calendar. Now, you can talk to your agent and get it done. This MCP lets you treat link management like any other workflow task—just ask for it.

You tell your AI client what you need; it handles the rest. Need a batch of 10 links for an upcoming campaign? You just prompt it. Want to know which links are performing best in California compared to Texas? Ask that too. The agent pulls the raw data and spits out a summary you can use instantly. This capability makes your entire link-based content pipeline manageable through natural conversation, letting you focus on strategy instead of manual dashboard entry. Because this connection lives within the Vinkius catalog, you get access to all your branded domains and analytics tools in one place, no matter which AI client you prefer.

## Tools

### create_bulk_links
Creates a large number of shortened links at the same time.

### delete_link
Removes an existing shortened link from your account.

### get_domain
Retrieves specific details about a custom branded domain name you own.

### get_link_clicks
Provides click analytics and performance metrics for a single, specified link.

### list_tags
Lists all the categories or tags currently used across your links.

### create_short_link
Generates a single, unique shortened URL for any given destination link.

### get_link_details
Retrieves full information and metadata about one specific short link.

### get_link_statistics
Pulls aggregate click statistics for a given set of links or domain.

### list_short_domains
Lists all the branded domains you have connected to your account.

### list_short_links
Retrieves a list of existing short links associated with a specific domain name.

### update_link
Modifies the destination URL or settings for an already shortened link.

## Prompt Examples

**Prompt:** 
```
List all links for the domain 'my.link' in Short.io.
```

**Response:** 
```
I've retrieved your links. You have 10 links for my.link, including 'my.link/sale' and 'my.link/blog'.
```

**Prompt:** 
```
Show me the click analytics for all shortened links created this month with geographic breakdown.
```

**Response:** 
```
45 links created this month. Total clicks: 12,340. Top 5 links: "Product Launch" (3,456 clicks, 28% CTR), "Blog Post" (2,890 clicks), "Webinar Signup" (1,234 clicks), "Case Study" (987 clicks), "Pricing Page" (876 clicks). Geographic breakdown: US 42%, UK 15%, Germany 8%, Brazil 7%, India 6%, Others 22%. Devices: Mobile 58%, Desktop 38%, Tablet 4%. Top referrers: Twitter 34%, LinkedIn 22%, Email 18%, Direct 15%. Peak time: Tuesday 2 PM.
```

**Prompt:** 
```
Create a batch of 5 branded short links for our upcoming product launch campaign.
```

**Response:** 
```
5 branded links created for product launch campaign. 1) go.brand.co/launch-announce → Landing page (tagged: launch, social). 2) go.brand.co/launch-demo → Demo video (tagged: launch, video). 3) go.brand.co/launch-pricing → Pricing page (tagged: launch, conversion). 4) go.brand.co/launch-blog → Blog post (tagged: launch, content). 5) go.brand.co/launch-press → Press release (tagged: launch, PR). All links: UTM parameters auto-appended, password protection available, expiry set to June 30.
```

## Capabilities

### Generate link batches
Create multiple shortened links simultaneously for a campaign rollout.

### Retrieve detailed click metrics
Get comprehensive analytics, including total clicks and geographic breakdowns, for specific links or groups of links.

### Manage branded domains
Query your existing custom domain catalog to ensure you use the right context for each link.

### Build new short links
Programmatically create single, shortened URLs with custom paths (slugs) on demand.

### Update existing links
Modify the destination or details of an active short link without manual dashboard interaction.

## Use Cases

### Analyzing quarterly content performance
A Content Strategist needs to see which blog posts drove the most traffic across all brands. They ask their agent to 'Get click statistics for links created last quarter.' The agent uses `get_link_statistics` and returns a ranked list showing total clicks and top-performing slugs, saving hours of manual data aggregation.

### Launching an immediate product feature
The Product Manager needs 15 temporary links for a beta test launch. They prompt the agent to 'Create a batch of 15 branded short links' using `create_bulk_links`. The agent instantly returns all 15 active URLs, ready to paste into documentation.

### Fixing broken or outdated campaign links
The Marketing Manager finds an old link pointing to a dead page. They tell the agent to 'Update the short link for the old tutorial page.' The agent uses `update_link` and confirms the new destination, keeping the brand path intact.

### Preparing domain reports for investors
An SEO Specialist needs to prove they control a specific branded TLD. They ask their agent to 'List all available short domains.' The agent uses `list_short_domains` and returns the full, organized list of controlled assets.

## Benefits

- Get instant metrics without dashboard hopping. Instead of clicking through multiple reports to find out who is clicking what, your agent pulls the data for you using `get_link_statistics` and organizes it into a readable summary.
- Save time building campaigns. Use `create_bulk_links` to generate dozens of branded links in one prompt, rather than manually creating each one and pasting them into a spreadsheet.
- Maintain brand control effortlessly. You can use the agent to query your domain catalog with `list_short_domains`, confirming you're using the right branded context before generating any link.
- Understand performance depth. Need to know exactly what happened on a specific URL? The `get_link_details` tool gives you all the metadata, while `get_link_clicks` shows you the actual traffic breakdown.
- Adapt links as needed. If a campaign changes direction, you don't need to log in just to fix it. Use `update_link` and tell your agent where to send the link instead.

## How It Works

The bottom line is you bypass the UI and talk directly to your branded link data.

1. Subscribe to this MCP and get your Short.io Secret API Key from your account settings.
2. Enter that key into your preferred AI client (Claude, Cursor, etc.) through the Vinkius connection process.
3. Ask your agent to perform a link action—for example, 'List all links for my.brand.com' or 'Get click statistics for the latest product page'.

## Frequently Asked Questions

**How do I check my branded domains using Short.io MCP?**
You use the `list_short_domains` tool to see every custom domain connected to your account. This confirms which brand contexts you can use for linking.

**Can I get statistics for a single link using Short.io MCP?**
Yes, run the `get_link_clicks` tool and provide the specific short link slug. It returns detailed click analytics just for that one URL.

**How do I create multiple branded links at once with Short.io MCP?**
Use the `create_bulk_links` tool in a single prompt. You'll provide a list of source URLs and the agent handles creating all corresponding short, tracked links for you.

**What if I need to change a link's destination? Does Short.io MCP handle that?**
The `update_link` tool lets you modify an existing shortened URL. You simply tell the agent which link to change and what its new destination should be.

**Is it possible to get details for a specific link using Short.io MCP?**
Yes, run `get_link_details`. This retrieves all the metadata about that single short URL, including creation dates and current status.