MCP tools reference

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"

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"