# Bitly MCP for AI Agents MCP

> Bitly connects your link campaigns directly into your AI agent. Instantly shorten long URLs into branded Bitlinks while automatically tracking click performance metrics. You can analyze geographic data, identify traffic sources, and manage entire groups of links using natural conversation.

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

## Description

Managing a campaign means constantly checking link performance across dozens of platforms. This MCP lets you talk to your AI agent about your links like talking to a marketing intern: 'What did the summer sale link do in California?' or 'Show me all the tags we used last month.' You get immediate, detailed analytics without copy-pasting URLs into separate dashboards.

It handles everything from generating branded short links and creating associated QR codes to deep diving into metrics. Need to know which site drove the traffic? It finds your referrers. Want a global view? It breaks down clicks by country. You connect this MCP through Vinkius, giving any compatible AI client access to these powerful link management tools right inside your chat window.

## Tools

### shorten_url
Shortens a long URL, allowing you to optionally set a custom domain or title for the resulting link.

### create_qr_code
Generates a scannable QR code image that directs users to your specified short link.

### get_bitlink
Retrieves the full details and metadata for a specific Bitlink you already manage.

### update_bitlink
Changes the visible title or custom identifier of an existing, live link without changing its destination URL.

### get_clicks
Retrieves overall click analytics for a given link, providing total counts and historical performance data.

### get_countries
Provides detailed click metrics that are broken down by the country where the user came from.

### get_referrers
Analyzes and lists all external sites or networks responsible for sending traffic to your links.

### list_groups
Lists every group that has been created within your Bitly account structure.

### list_bitlinks
Displays all the specific links contained within a chosen organizational group.

### get_user
Retrieves basic account information and metadata for your Bitly profile.

## Prompt Examples

**Prompt:** 
```
What was the click summary for my main landing page link last month?
```

**Response:** 
```
**📊 Bitlink Performance Summary (Last 30 Days)**

*   **Total Clicks:** 1,452
*   **Unique Viewers:** 1,198
*   **Top Source:** LinkedIn (34% of traffic)
*   **Status:** Active

The link is performing well. The highest volume came from professional networks, suggesting we should boost our focus there.
```

**Prompt:** 
```
I need to find out where my links are being clicked globally.
```

**Response:** 
```
Here’s the breakdown of traffic by country:

| Country | Clicks | % of Total |
| :--- | :---: | :---: |
| United States | 510 | 35% |
| Canada | 290 | 20% |
| Germany | 180 | 12% |
| UK | 152 | 10% |

Overall, North American traffic makes up the majority of clicks.
```

**Prompt:** 
```
List all my groups and tell me how many links are in 'Marketing Team'.
```

**Response:** 
```
I found three main groups:
*   **Personal Links:** 12 assets
*   **Marketing Team:** 45 assets (This is the group you asked about.)
*   **Internal Assets:** 3 assets

The Marketing Team group has a total of 45 links ready for use.
```

## Capabilities

### Create and brand short links
Generates branded or generic Bitlinks from long URLs, sometimes allowing you to set custom titles.

### Generate link-specific QR codes
Creates a scannable image (QR code) that directs users to your chosen short URL.

### View detailed click counts
Provides a summary of total clicks for any specific link over time, giving you performance metrics.

### Analyze traffic by geography
Shows where your link traffic originates, breaking down the total clicks into country-specific data.

### Identify traffic sources (Referrers)
Lists which specific websites or networks are sending users to your links.

### Manage and list link groups
Allows you to see the structure of your organization's Bitly groups and manage their contents.

### Discover used tags
Retrieves a complete list of all tags currently applied across your entire inventory of links for better organization.

## Use Cases

### Analyzing a regional ad campaign's success
A marketing analyst needs to know if an ad spend targeting Germany actually worked. The agent uses the MCP to pull data by country (`get_countries`) and cross-references it with which source drove that traffic (`get_referrers`), providing immediate proof points for budget reallocation.

### Quickly deploying content across social channels
A social media manager writes a blog post and needs links ready for Twitter, LinkedIn, and Instagram. The agent uses `shorten_url` to create branded Bitlinks and then generates physical QR codes (`create_qr_code`) for print materials, all in one conversational flow.

### Auditing link usage across departments
A growth team lead wants to know if the 'Q2 Product' group is getting overlooked. The agent uses `list_bitlinks` and then runs `get_clicks` on those specific links, allowing them to identify underperforming assets quickly.

### Preparing a quarterly performance review
A manager needs to compile all metrics for the quarter. The agent uses the MCP to pull aggregate data from multiple sources, listing groups and then getting click totals (`get_clicks`) across everything in one go.

## Benefits

- You get instant, actionable analytics. Instead of logging into a dashboard to find out how many clicks 'short-term campaign' received, your agent just tells you the number using `get_clicks`.
- It saves time on reporting. Combining geographic insights (`get_countries`) with referrer data (`get_referrers`) for a single report eliminates manual cross-checking in spreadsheets.
- Your content is always optimized. You can use the MCP to quickly generate branded links and associated QR codes (`create_qr_code`) right when you're drafting copy.
- It keeps your brand consistent. When you need to update a link title or fix a typo, `update_bitlink` lets you make those changes instantly without needing backend access.
- You maintain structure. By listing and managing groups (`list_groups`, `list_bitlinks`), the MCP helps you keep track of hundreds of links assigned to different departments.

## How It Works

The bottom line is you tell your AI client what link data you need, and it runs the necessary analytics against Bitly's live records.

1. Subscribe to this MCP and provide your Bitly Generic Access Token.
2. Connect the credentials to your preferred AI client (Claude, Cursor, etc.).
3. Ask your agent a question using natural language. For example: 'What were the click metrics for my top 5 links last month?'.

## Frequently Asked Questions

**How does Bitly help me analyze link performance with AI agents?**
It gives you comprehensive, conversational access to your link metrics. Instead of viewing static dashboards, you ask the agent questions like 'Show me traffic from Brazil' and get a detailed, instant breakdown.

**Can I use Bitly MCP with my existing marketing tools?**
Yes. You connect this through your AI client (like Claude or Cursor). This means you don't have to switch between multiple apps; all link data and analytics happen right where you are working.

**What if I need to change a link title? Does Bitly MCP support that?**
Absolutely. You can use the MCP to update a link's visible title or custom identifier without having to access the main Bitly dashboard, keeping your workflow fast.

**Does this MCP track where my links are being clicked from? (Geographic data)**
Yes. You get detailed click metrics broken down by country, which is crucial for regional campaign planning and optimizing ad spend in specific markets.

**How do I make a link that works both online and on print materials?**
You can use the MCP to shorten your URL and immediately generate an associated QR code. This means you get a single asset that works across digital chat messages, emails, and printed flyers.