# AB.GL MCP

> AB.GL lets you shorten URLs, track clicks, and manage all your branded campaign links in one place. It provides real-time analytics for every link, letting you know exactly where traffic comes from—down to the device and country level.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** url-shortener, link-management, click-tracking, analytics, branded-links

## Description

Managing multiple campaigns means juggling dozens of links, tracking performance across different dashboards, and manually updating URLs when things change. This MCP changes that by connecting your entire link shortening and analytics workflow directly into natural conversation. You can automatically generate short, branded links for specific marketing efforts and then get detailed click statistics on those links without leaving your agent. Need to check which custom domains you’ve set up or see the contents of a bio page? Just ask. Vinkius hosts this MCP in its catalog, meaning any compatible AI client—whether it's Claude, Cursor, or Windsurf—gives you access to this whole suite of link management tools from one place.

## Tools

### check_abgl_status
Verifies if your API key is connected correctly to the AB.GL platform.

### create_short_link
Generates a new short link from a long URL, allowing you to assign a custom alias.

### delete_link
Permanently removes an existing short link from your account.

### get_bio_link
Retrieves specific details about one of your bio link pages.

### get_link_stats
Pulls detailed click analytics for a specific short link, including geographic data.

### get_link
Gets the core information and status for a single, specified short link.

### list_bio_links
Lists all the bio pages you have created and provides summary view counts.

### list_domains
Shows every custom domain name you’ve connected to your short links.

### list_links
Retrieves a full list of all your short links, showing creation dates and click counts.

### update_link
Modifies the destination URL or alias for an existing short link.

## Prompt Examples

**Prompt:** 
```
Shorten https://example.com/long-campaign-url with alias 'q4sale'.
```

**Response:** 
```
Done! Your short link is https://ab.gl/q4sale (ID: lnk_4921). It redirects to the campaign URL. Would you like to check its analytics later?
```

**Prompt:** 
```
Show me click statistics for link lnk_4921.
```

**Response:** 
```
Link lnk_4921 has 1,247 total clicks. Top referrers: LinkedIn (42%), Twitter (31%), Direct (27%). Devices: Mobile 68%, Desktop 32%. Top country: United States (580 clicks).
```

**Prompt:** 
```
List all my bio link pages.
```

**Response:** 
```
You have 3 bio pages: 'Marketing Team' (12 links, 3.4k views), 'Product Launch Q4' (8 links, 1.2k views), and 'Personal Portfolio' (5 links, 890 views). Would you like to inspect any of them?
```

## Capabilities

### Build and Control Links
Generate new short links with custom aliases, update existing ones, delete old links, and manage entire collections of branded URLs.

### View Link Assets
List all active short links in your account, view details on specific bio link pages, or check which custom domains you've configured for your brand.

### Track Campaign Performance
Retrieve detailed click statistics on any given link, including the top referring websites, device type breakdown, and geographic source data.

### Verify Account Status
Check API connectivity to ensure your account is active and ready for immediate use.

## Use Cases

### Tracking Q4 Sales Funnel Performance
A marketing manager needs to know if their new 'sale' link is performing better than last year’s. They ask their agent to use `get_link_stats` on the specific campaign URL, which instantly reports total clicks, top referrers (e.g., LinkedIn vs. Instagram), and device breakdown.

### Auditing Brand Link Consistency
An SEO specialist realizes they might have old or unused links floating around. They use the MCP to run `list_links` across their account, quickly identifying every short URL and its last recorded click count for an immediate audit.

### Updating a Campaign Destination
The content team moves a product page. Instead of manually updating dozens of links, they tell their agent to use `update_link` on the master link alias, redirecting all traffic instantly without touching the web portal.

### Organizing Multi-Platform Content
A creator needs a centralized view of all their 'About Me' sections. They ask the agent to run `list_bio_links`, getting an overview of every bio page and how many links are active on each, helping them organize content streams.

## Benefits

- Stop guessing about campaign performance. Use `get_link_stats` to see real click metrics, including where users came from (referrers) and what device they used.
- Keep your brand consistent by using the MCP to list all custom domains (`list_domains`) and ensure every link uses approved branding.
- Need a new campaign URL fast? Use `create_short_link` to generate branded links instantly, giving you an optional custom alias for targeted tracking.
- Maintain clean records. You can use `list_links` to audit your entire library of short URLs and see when they were created or last updated.
- Handle link changes without the dashboard. If a campaign URL changes, simply use `update_link` via conversation instead of logging into the web portal.

## How It Works

The bottom line is: you talk to your AI client, and it handles all the API calls to get you the link data you need.

1. First, subscribe to this MCP on Vinkius and enter the API Key from your AB.GL settings.
2. Next, tell your AI client what you want to do—for example, 'Show me stats for my Q4 promo link.'
3. Your agent executes the command, reads the data (clicks, referrers, etc.), and gives you a clean, summarized answer.

## Frequently Asked Questions

**How do I use `get_link_stats` for a specific campaign?**
You tell your agent the link ID or alias. It executes `get_link_stats` to pull total clicks, top referrers (like LinkedIn), and device split into one summary.

**What is the difference between `list_links` and `list_bio_links`?**
`list_links` shows a raw inventory of every short URL you own. `list_bio_links` specifically lists your 'About Me' style pages, showing link counts and views for those specific landing spots.

**Can I change the destination after creating a link using `update_link`?**
Yes. You use `update_link` to modify an existing short URL. This lets you redirect traffic from an old page to a new one without having to recreate the entire link.

**How do I check my custom domains with `list_domains`?**
`list_domains` displays all the branded domain names connected to your account, confirming they are set up correctly for use in campaigns.

**How do I verify if my API key is active before using tools like `create_short_link`?**
You use the `check_abgl_status` tool first. This confirms your connection and credentials are valid, saving you time troubleshooting failed requests later on.

**If I try to use `create_short_link` with an alias that is already taken, what happens?**
The system returns a clear error message indicating the alias conflict. You'll need to generate a new unique alias or use a different URL for your short link.

**Is deleting a link using `delete_link` permanent, and can I restore it?**
Yes, using `delete_link` permanently removes the short link from your account. There is no recovery process; ensure you've backed up the necessary data before running this command.

**When I run `list_links`, are there any limits to how many links I can retrieve in one call?**
The API handles large datasets, but if your account has thousands of links, you may need to paginate the results. Check the documentation for specific rate limit instructions.

**Can my AI create branded short links with custom aliases?**
Yes. Use the `create_short_link` tool with the URL and an optional alias parameter. For example, ask your agent to shorten 'example.com/campaign' with alias 'summer24'.

**How do I view click analytics for a specific link?**
Use the `get_link_stats` tool with the link ID. The agent returns total clicks, referrer sources, device breakdown, and geographic distribution.

**Can I manage and delete links through the AI?**
Yes. The `update_link` tool changes the destination URL of an existing link, and `delete_link` permanently removes it from your account. Both require the link ID.