# Capsulink MCP

> Capsulink manages your entire link infrastructure: creating short URLs, tracking clicks, and monitoring analytics. Connect this MCP to any agent to manage links—you can list all assets, check daily click counts, change a destination URL on the fly, or shorten new links using plain conversation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** url-shortener, link-tracking, click-analytics, digital-marketing, redirect-management, metadata-tracking

## Description

You shouldn't have to log into a dashboard just to see link performance. This MCP lets you handle your entire digital marketing asset library through natural language commands. Instead of clicking through separate tabs for stats, metadata, and folders, you talk to your agent about what you need.

Need to launch a campaign? Your agent can create the short link and then pull up its current click count in one go. Need to redirect an old link because the landing page changed? You just ask it to update the destination URL for that specific asset. Managing links moves from a multi-step dashboard process to a single conversational query. This level of control is what makes Vinkius such a useful catalog, letting you connect and orchestrate this kind of utility with minimal friction.

## Tools

### delete_link
Permanently removes a specified short link from your account.

### edit_link_destination
Changes the final destination URL of an existing shortened link.

### get_account_info
Retrieves general information about your Capsulink account setup.

### get_link_daily_stats
Gets a detailed breakdown of click statistics for a specific link day by day.

### get_link_details
Retrieves basic metadata and details about one shortened link.

### get_link_stats
Pulls the total click count statistics for a specific, identified link.

### list_link_folders
Lists all organized folders you use to categorize your marketing links.

### list_links
Retrieves a complete list of every shortened link in your account.

### shorten_url
Creates a new short link from any long URL you provide.

## Prompt Examples

**Prompt:** 
```
Shorten https://vinkius.com/blog/new-feature with title 'Blog Feature'.
```

**Response:** 
```
I've shortened the URL. Your new link is https://clnk.to/abcde (ID: cap_123).
```

**Prompt:** 
```
Show click stats for link with ID cap_123.
```

**Response:** 
```
Link cap_123 ('Blog Feature') has received 450 total clicks since it was created on March 15th.
```

**Prompt:** 
```
Change the destination of link cap_123 to https://vinkius.com/pricing.
```

**Response:** 
```
The destination URL for link cap_123 has been successfully updated to the pricing page.
```

## Capabilities

### Create Short Links
Generate new short URLs with custom titles or back-halves instantly.

### Track Click Performance
Get total click counts for a link, or retrieve a granular daily breakdown of clicks.

### Update Link Destinations
Change the target URL for an existing short link without changing its unique identifier.

### View Asset Inventory
List all active links, or navigate through organized folders to find specific assets.

### Manage Account Metadata
Retrieve core account information and list all link folders used in your marketing setup.

### Remove Links Permanently
Delete a short link directly from the agent's workspace.

## Use Cases

### Fixing a Broken Campaign Link
A campaign link is pointing to an outdated product page. Instead of logging in and manually changing the destination, the engineer just prompts: 'Change the destination for my main sales link.' The agent uses `edit_link_destination` to update it immediately.

### Pre-Launch Performance Check
Before launching a new ad, you need to know if your target page is ready. You run 'Show click stats for the link I just created.' The agent uses `get_link_stats` right away, letting you verify performance before spending money.

### Inventory Audit
The team needs to know every single short URL they've ever made. You ask the agent to list all links and their folders using `list_links` and `list_link_folders`, giving you a full audit log.

### Debugging Analytics
A client complains about weird click spikes on Tuesday. Instead of checking logs, you ask the agent to pull up the daily breakdown using `get_link_daily_stats` for that specific week.

## Benefits

- Stop manually checking dashboards. You can get total click counts for any link immediately using `get_link_stats`—no dashboard refresh required.
- Need to update a broken link? Use `edit_link_destination` to point it at the correct landing page instantly, keeping the short back-half address consistent.
- Organize your assets better. You can use `list_link_folders` and then `list_links` to see exactly what's stored where in your marketing library.
- Launching a new campaign? Use `shorten_url` with custom titles, all while having the agent track its performance using `get_link_daily_stats`.
- Don't have time for link cleanup? Your agent can list every asset and then use `delete_link` to permanently remove old links in bulk.
- The system knows your account status. Check your core details with `get_account_info` before you build a large new campaign.

## How It Works

The bottom line is you get to run complex marketing operations by simply talking to your agent.

1. Subscribe to this MCP and provide your Capsulink API key.
2. Connect your preferred AI client (like Cursor or Claude) using the Vinkius catalog.
3. Give a natural language command, for example: 'What were the daily clicks for my link in the Q3 folder?'

## Frequently Asked Questions

**How do I shorten a URL using the `shorten_url` tool?**
You simply ask your agent to 'Shorten this long URL.' The agent uses `shorten_url` and returns the new link immediately. You don't need to manually navigate the site.

**What is the difference between `get_link_stats` and `get_link_daily_stats`?**
`get_link_stats` gives you the total number of clicks since creation. If you need to see click counts broken down for specific dates, use `get_link_daily_stats`.

**Can I update a link's destination easily? Use `edit_link_destination`.**
Yes. You tell the agent which link ID needs fixing and what the new URL should be. The agent then calls `edit_link_destination` to make the change for you.

**How do I see all my links? Use `list_links`.**
Just ask your agent to list all current assets by calling `list_links`. This gives you a quick inventory of everything in your account, and you can then use that list to check stats.

**How do I check the folders available using the `list_link_folders` tool?**
It immediately returns a list of every folder name associated with your account. This lets you maintain a clear, structured library for organizing all your marketing links.

**Is deleting a link irreversible? What does `delete_link` do?**
Yes, the action is permanent and cannot be undone. The `delete_link` tool removes the short URL entirely from your account records. Use it only when you are sure the link is obsolete.

**What specific information does `get_link_details` provide?**
This tool retrieves core metadata about a single link, going beyond just click counts or existence. You get key details like its creation date and associated folder ID.

**How do I check the status of my account with `get_account_info`?**
Running this tool fetches your core account information. This is helpful for verifying your current API usage, checking global limits, or ensuring your credentials are active.

**Can I change the destination of a link without changing the short URL?**
Yes! Use the `edit_link_destination` tool with the Link ID. Your agent will update the target URL in Capsulink, and the existing short link will immediately point to the new destination.

**How do I check how many clicks a link received today?**
Simply ask the agent to `get_link_daily_stats` and provide the Link ID. It will retrieve the click breakdown by day from your Capsulink account.

**Does the integration allow using a custom back-half for my links?**
Yes. When using the `shorten_url` action, you can provide the `short_url` parameter (e.g., 'summer-promo'). If available, Capsulink will create the link with that specific back-half.