---
updatedAt: 2026-09-04T08:54:08.000Z
agentTools:
  projectIndex: https://developers.rebrandly.com/llms.txt
---

# MCP tools reference

A catalog of Rebrandly MCP tools organized by category.

For best results, be specific in your prompts. For example, when referring to a link, use both the word link and the URL. The AI assistant will likely understand you anyway, but it's better to guide it in this way.

> In these tools and our API references, "slashtag" refers to the back half of the link, which is the term we use in our app and other documentation. It's just the way our systems refer to that field.

## Link management

### Create a link

Create a new branded short link\
**Required:** Destination URL\
**Optional:** Slashtag (back half), title, domain, tags, workspace\
**Example:** "Create a short link for example.com/blog with the slashtag 'blog-post'"

### Update a link

Modify an existing link's settings\
**Required:** Short link URL\
**Optional:** Destination, title, tags, slashtag\
**Example:** "Update brandyour.link/campaign to point to newdomain.com/updated-page"

### Get link details

Retrieve information about a specific link\
**Required:** Short link URL\
**Example:** "Show me details for rebrandly.rocks/summer-sale"

### List links

View your links with optional filtering\
**Optional:** Workspace, domain, tags, search term, limit\
**Example:** "Show me all links tagged 'marketing' from my Campaign workspace"

### Count links

Get the total number of links in your account\
**Optional:** Workspace, domain, tags\
**Example:** "How many links do I have in my Marketing workspace?"

### Delete a link

Remove a link from your account\
**Required:** Short link URL\
**Example:** "Delete link brandyour.link/old-campaign"

### Move link between workspaces

Get instructions for moving links between workspaces\
**Required:** Short link URL, source workspace name, destination workspace name\
**Example:** "Move link rebrandly.rocks/promo from Personal to Marketing workspace"

***

## Analytics

Ask about clicks on your links in plain language — the assistant translates your question into a metric query, choosing the right metrics, dimensions, and time range automatically.

### Query metric

Answer questions about clicks on your links: how many, when, from where, and by whom\
**Required:** One or more metrics, for example `total_clicks`, `unique_clicks`, `bot_rate`, `active_links`\
**Optional:** Dimensions to group by (country, city, device, browser, referrer, and more), date range (defaults to last 30 days), time grain (hour, day, week, or month), filters, sort order, result limit\
**Returns:** The metric values, plus a data-coverage window — the earliest and latest click Rebrandly holds for your account — so a period with no results outside that window is reported as no data held for that range, not as zero clicks\
**Example:** "How many clicks did I get last week, by country?"

### List available metrics

List every click metric available, grouped by family (volume, quality, reach)\
**Example:** "What metrics can you tell me about my link performance?"

### Get metric details

Get the full definition of a metric: what it measures, its unit, and which dimensions it supports\
**Required:** Metric name\
**Example:** "What exactly does 'bot rate' mean?"

### Get dimension details

List every dimension click data can be grouped or filtered by, with sample values and available time grains\
**Example:** "What can I break my click data down by?"

### Search dimension values

Resolve loose wording to the exact stored value for a dimension, before using it as a filter\
**Required:** Dimension, search term\
**Example:** "Show me clicks from Mexico City" (resolves to the exact stored `city` value)

***

## Workspaces

### List workspaces

View all workspaces in your account\
**Example:** "List all my workspaces"

### Get workspace details

Retrieve information about a specific workspace\
**Required:** Workspace name\
**Example:** "Show me details for my Marketing workspace"

### Create a workspace

Create a new workspace\
**Required:** Workspace name\
**Example:** "Create a workspace named 'Q1 Campaign'"

### Update a workspace

Modify workspace settings\
**Required:** Workspace name\
**Optional:** New name, settings\
**Example:** "Rename my Campaign workspace to 'Summer Campaign'"

### Delete a workspace

Remove a workspace from your account\
**Required:** Workspace name\
**Example:** "Delete my Archive workspace"

### List workspace domains

View domains available in a specific workspace\
**Required:** Workspace name\
**Example:** "Show me all domains in my Marketing workspace"

### Attach domain to workspace

Connect a domain to a workspace\
**Required:** Domain name, workspace name\
**Example:** "Attach domain brandyour.link to my Marketing workspace"

***

## Domains

### List domains

View all domains available to you\
**Optional:** Workspace filter\
**Example:** "List all my branded domains"

### Get domain details

Retrieve information about a specific domain\
**Required:** Domain name\
**Example:** "Show me details for brandyour.link"

### List all domains

View all domains including attached and detached ones\
**Example:** "Show me all domains in my account"

***

## Tags

### Attach tag to link

Add a tag to a link\
**Required:** Short link URL, tag name\
**Example:** "Tag link rebrandly.rocks/promo with 'summer-campaign'"

### Detach tag from link

Remove a tag from a link\
**Required:** Short link URL, tag name\
**Example:** "Remove tag 'old-campaign' from brandyour.link/sale"

***

## Scripts (retargeting)

### Create a script

Create a new retargeting script\
**Required:** Script name, script code\
**Example:**\
Create a link with destination rebrandly.com and link retargeting:
`window.fbAsyncTracker = window.fbAsyncTracker || function() {
var api = 'https://www.facebook.com/actions/your-website-url/your-website-id/your-website-identifier';
var data = { action: 'pageview', pageId: 'your-page-id', tracking: 'true', trackingParams: 'your-tracking-params' };
var response = api + '?' + api_encode(data);`

### Attach script to link

Add a retargeting script to a link\
**Required:** Short link URL, script identifier

### Detach script from link

Remove a retargeting script from a link\
**Required:** Short link URL, script identifier

***

## Routing rules

### Create a link rule

Create a conditional routing rule for a link\
**Required:** Short link URL, rule conditions\
**Example:** Create a link with a destination google.com if the country of origin is Italy go for <https://maps.google.com/>

### List link rules

View all routing rules for a specific link\
**Required:** Short link URL\
**Example:** "Show me all routing rules for brandyour.link/mobile"

***

## Custom attributes

### Create an attribute

Create a custom attribute for link metadata\
**Required:** Attribute name\
**Optional:** Attribute type

### Get attribute details

Retrieve information about a custom attribute\
**Required:** Attribute identifier

### List attributes

View all custom attributes in your account\
**Example:** "List all my custom attributes"

### Count attributes

Get the total number of custom attributes\
**Example:** "How many custom attributes do I have?"

### Delete an attribute

Remove a custom attribute\
**Required:** Attribute identifier

***

## Plans and account

### List plans

View available Rebrandly subscription plans\
**Example:** "Show me all available Rebrandly plans"

### Get plan details

Retrieve information about a specific plan\
**Required:** Plan name\
**Example:** "Show me details for the Professional plan"

### Get account plan

View your current subscription plan\
**Example:** "What plan am I currently on?"

### Get account info

View account information and usage limits\
**Example:** "Show me my account details and current usage"

***

## Teammates

### List teammates

View all teammates in your account\
**Optional:** Workspace filter\
**Example:** "List all teammates in my Marketing workspace"