# Rebrandly MCP

> Rebrandly MCP Server manages your branded short URLs. You can create custom links, organize them across multiple domains, update link metadata programmatically, and pull real-time click stats for campaign tracking. It's an API layer that gives your AI client full control over your brand's online presence.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** link-shortener, rebrandly, branded-links, url-management, marketing-api, analytics, ai-agents, mcp

## Description

The Rebrandly MCP Server gives your AI client total control over your branded URLs and domains. You don't have to mess with the web dashboard; you just tell your agent what needs doing, and it handles everything through our tools.

**Testing and Setup**
First off, you'll run `test_rebrandly_auth` to make sure your client can actually talk to Rebrandly. After that, if you need basic account context, the agent pulls profile information using `get_account_details`. If you're working with multiple teams, it lists all available environments or workspaces via `list_account_workspaces`. You also get a simple count of how many branded links are set up across your entire workspace by calling `get_link_count`.

**Domain Management**
You own several custom domains for branding, and the server manages them. To see every single domain name you control, run `list_branded_domains`. If you need to know the specific status or technical details of one particular domain—like its metadata—the agent fetches that data with `get_domain_info`. This lets your client verify if a domain is set up correctly before using it.

**Creating and Updating Links**
Need a new custom link? The agent shortens any standard URL into a unique, branded slug using `create_branded_link`. You can't just create and forget it, though. If you need to change the final destination URL or update descriptive metadata for an existing link without changing its actual branded slug, use `update_link_metadata`. This is key because it lets you pivot your marketing strategy on the fly. Finally, if a link is retired, the agent permanently deletes it using `delete_short_link`.

**Monitoring and Searching Assets**
The server gives you several ways to check what links you've deployed. To get an overall roster of every branded link in the current workspace, the client runs `list_short_links`. If you know part of the title assigned to a link, the agent searches specifically using `search_links_by_title` to pinpoint it. For deep performance analysis, calling `get_link_details` pulls everything—the full information, destination details, and real-time click statistics for that specific slug. You can also view all the detailed stats for any existing link by running this same tool.

**Summary of Control**
You've got comprehensive control over your entire online presence with these tools. The client checks basic account data (`get_account_details`), verifies authentication (`test_rebrandly_auth`), and manages multiple team workspaces (`list_account_workspaces`). You can check domain health (`get_domain_info`) and list all owned domains (`list_branded_domains`). When it comes to links, you can create them (`create_branded_link`), update their backend settings without touching the slug name (`update_link_metadata`), find them by title (`search_links_by_title`), get a full overview of everything deployed (`list_short_links`), check the total count (`get_link_count`), and pull detailed performance data, including click counts, using `get_link_details`. Don't forget you can always clean up old assets with `delete_short_link`.

## Tools

### get_link_count
Checks how many total branded links are currently set up in your workspace.

### create_branded_link
Shortens a standard URL into a custom, branded slug.

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

### get_account_details
Retrieves basic profile information for the connected Rebrandly account.

### get_domain_info
Fetches metadata and status details about a specific custom domain you own.

### get_link_details
Retrieves the full information and statistics for one specific short link.

### list_branded_domains
Lists every custom domain name you own and manage within Rebrandly.

### list_short_links
Retrieves a list of all branded links in the current workspace.

### list_account_workspaces
Shows all separate team environments or workspaces linked to your account.

### search_links_by_title
Finds specific short links by searching against their assigned title.

### test_rebrandly_auth
Verifies that your AI client can successfully authenticate and connect to Rebrandly.

### update_link_metadata
Changes the destination URL or metadata of an existing link without changing its slug.

## Prompt Examples

**Prompt:** 
```
Create a branded link for our new summer collection landing page at https://fashion-hub.com/collections/summer-2024 and use the slashtag 'summer-vibes'.
```

**Response:** 
```
Successfully created your branded link: https://fshn.link/summer-vibes. It is now active and ready to be shared in your marketing campaigns.
```

**Prompt:** 
```
How many branded links have we generated in our account so far?
```

**Response:** 
```
You have generated a total of 1,248 branded links across your current workspace.
```

**Prompt:** 
```
Find the link titled 'Q3 Investor Update' and update its destination to https://investors.techcorp.com/reports/q3-final.
```

**Response:** 
```
I found the link 'Q3 Investor Update' and successfully updated its destination URL to the new report location.
```

## Capabilities

### Create branded links
The agent generates a short, custom URL pointing to any destination.

### Manage domain information
You can check metadata about your custom domains or list all available ones.

### Retrieve link performance data
The agent pulls detailed info, including click counts and destination details, for any given link.

### Modify existing links
You update a link's final URL or its descriptive metadata without recreating the slug.

### List and search assets
The agent lists all your branded links, checks how many you have used, or searches for specific titles.

## Use Cases

### The expiring campaign link
A product manager needs to update a link for an old summer sale. Instead of logging into the dashboard, they ask their agent: 'Find the link titled 'Summer Sale 2024' and change its destination URL to our new evergreen page.' The agent runs `search_links_by_title` then uses `update_link_metadata`, solving it in two steps.

### New product launch requiring custom domains
The dev team needs a branded link structure for a new B2B service. They first use `list_branded_domains` to confirm the available custom TLDs, then use `create_branded_link` multiple times with specific slugs and domain identifiers.

### Mass cleanup of old assets
A brand manager is retiring a product line. They ask their agent to list all links associated with that line using `list_short_links`, then send the full list to be deleted via `delete_short_link` to prevent confusion.

### Checking account boundaries
A team needs to know if another department has created links in their space. They first use `list_account_workspaces` and then scope down using tools like `get_link_count` within the correct workspace ID.

## Benefits

- Create custom slugs instantly. Use `create_branded_link` to launch new, trackable URLs for every campaign phase. No more generic bit.ly links—you own the brand slug.
- Keep your domains organized. You can use `list_branded_domains` and `get_domain_info` to see exactly which custom domains are active, ensuring no marketing efforts point to a stale or unverified domain.
- Adapt campaigns on the fly. Instead of having to recreate a link when a landing page changes, just run `update_link_metadata`. The slug stays; the destination updates.
- Check performance fast. Use `get_link_details` and `list_short_links` to pull immediate click stats or find exactly which links are underperforming without building complex reports.
- Audit your setup easily. Run `list_account_workspaces` if you manage multiple teams, keeping link assets separated and controlled within specific team environments.

## How It Works

The bottom line is, your agent sends a command to Rebrandly via MCP, and this server executes it using the appropriate API tool.

1. First, the AI client uses `test_rebrandly_auth` to confirm the connection and get necessary credentials.
2. Next, it calls a management tool (like `create_branded_link`) using specific parameters—the target URL and desired slug—to perform an action.
3. Finally, the server returns status codes and data payloads, confirming if the link was created, updated, or deleted.

## Frequently Asked Questions

**How do I check if my custom domain is valid using Rebrandly MCP Server?**
You use the `get_domain_info` tool. This function pulls metadata about your specific branded domain, confirming its status and helping you verify it's ready to be used for links.

**What is the best way to update a link’s destination URL?**
Use `update_link_metadata`. This tool lets you change the final target URL or modify other metadata fields of an existing short link without having to recreate the entire branded slug.

**Can I see all my links across different client teams?**
Yes. First, run `list_account_workspaces` to get a list of all team environments. Then, you can use tools like `list_short_links` scoped to the specific workspace ID.

**How do I find a link if I don't know its slug?**
Use `search_links_by_title`. This tool lets you search for links based on their assigned title, which is much easier than trying to remember the exact branded slug.

**Rebrandly MCP Server, how do I check if my API credentials are working correctly?**
You run the `test_rebrandly_auth` tool. This confirms that your provided API Key and Workspace ID are active and formatted correctly for immediate agent use.

**Using Rebrandly MCP Server, what is the proper way to delete a branded short link?**
Call `delete_short_link` with the specific URL or ID. Your agent sends a direct API call that removes the branded link from your account immediately.

**With Rebrandly MCP Server, how can I check my current usage limits for branded links?**
Use `get_link_count` to see the total number of links you've generated. This metric helps you track your link consumption against plan capacity.

**Rebrandly MCP Server, how do I list all the custom domains registered under my account?**
Run the `list_branded_domains` tool. It returns a full roster of every custom domain name associated with your Rebrandly account for review.

**What is a slashtag?**
A slashtag is the custom alias that comes after the domain in a short link (e.g., rebrand.ly/myslash).

**Can I track clicks via API?**
Yes, every link object returned by the API includes a 'clicks' property with the total number of visits.