add_tags_to_link
Attach one or more existing tags to a link.
LABSCO SUMMARY
A shortener with the campaign plumbing attached — routing rules, UTM builders, folders and QR codes.
The two tools that make it worth an agent's attention are set_link_routing_rules, which targets by device, OS, country or language with A/B weights, and preview_url_metadata, which lets a link be auto-titled from the page it points at. Because OPN_BASE_URL is a plain switch, the same conversation works against your own deployment.
What it is
An MCP server for opn.onl, an open-source URL shortener. It covers the full link lifecycle in natural language — create, schedule, protect, route and retire links — plus per-link and account-wide analytics, and it works against the hosted service or your own instance.
What you get
- shorten_url and shorten_urls_bulk — one link with an optional custom alias, title, notes, scheduling, click limit, password, burn-after-reading, folder and tags; or many at once with per-URL errors reported
- list_links, update_link, delete_link, clone_link and toggle_link_pin — browse and filter your links, change any field (with remove_ flags to clear one), duplicate a link under a fresh code, or pin it to the top
- check_alias_available — confirm a custom slug is free before you use it
- get_link_routing_rules and set_link_routing_rules — send visitors matching a device, OS, country or language to a different destination, with A/B weighting; empty match fields mean any
- get_link_stats and get_dashboard_stats — clicks, unique visitors, geography, cities, devices, browsers, OS and referrers for one link, or the same aggregated across all of them
- get_qr_code — the link's QR image, optionally branded with a colour and centre logo, as PNG or SVG
- check_url_health, build_utm_url and preview_url_metadata — confirm a destination is reachable, append UTM parameters, and read a page's Open Graph title, description and image
- list_tags, create_tag, add_tags_to_link, remove_tags_from_link, list_folders, create_folder and move_links_to_folder — the organising layer
- export_links_csv — every link as raw CSV
Requirements
An opn.onl API key, created under Settings > API Keys and shown once; set it as OPN_API_KEY. Clients run npx -y opn-mcp over stdio and it talks to the hosted API by default. Point OPN_BASE_URL at your own instance's API host to use a self-hosted opn.onl.
Setup effort
One command plus a key — npx -y opn-mcp, then supply credentials
USE CASES
01
Launching a campaign
Build the UTM-tagged URL, check the alias is free, then shorten it into the campaign folder with tags.
02
Shortening a batch of links
Create them all in one call into a new folder, then confirm what failed.
03
Reporting on how a link performed
Read the clicks, unique visitors and country breakdown for the window you care about.
04
Sending different audiences to different pages
Set routing rules by device, OS or country, and check what is already configured first.
05
Putting a link on printed material
Generate a branded SVG QR code after confirming the destination is reachable.
24 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
build_utm_url
Append UTM campaign parameters to a URL. Returns the tagged URL (does not create a link).
check_alias_available
Check whether a custom alias/slug is available before shortening with it.
check_url_health
Check whether a destination URL is reachable (status + timing) before shortening it.
clone_link
Duplicate an existing link (same destination and settings) under a fresh short code.
create_folder
Create a folder for grouping links.
create_tag
Create a tag for organizing links.
delete_link
Delete a short link.
export_links_csv
Export all your links as CSV (returns the raw CSV text).
get_dashboard_stats
Get account-wide analytics across all your links: totals, top links, and aggregate click breakdowns.
get_link_routing_rules
Get the smart-routing rules for a link (device/OS/country/language targeting and A/B weighting).
get_link_stats
Get click analytics for a link (clicks, unique visitors, geography, cities, devices, browsers, OS, referrers).
get_qr_code
Get the QR code for a link, optionally branded with a colour, centre logo, and PNG/SVG format.
list_folders
List your folders (each with its link count).
list_links
List your short links (most recent first). Filter by folder, tag or free-text search.
list_tags
List your tags (each with its link count).
move_links_to_folder
Move one or more links into a folder.
preview_url_metadata
Fetch Open Graph metadata (title, description, image, site name) for a URL — handy for auto-titling a link before shortening it.
remove_tags_from_link
Detach one or more tags from a link.
set_link_routing_rules
Replace ALL smart-routing rules for a link. Each rule sends visitors matching the given device/OS/country/language to its destination; empty match fields mean 'any'. Send an empty array to clear all rules.
shorten_url
Create a short link on opn.onl. Supports scheduling, click limits, folders, tags and one-time (burn-after-reading) links. Returns the short URL and its code.
shorten_urls_bulk
Shorten many URLs in one call. Returns the created links plus any per-URL errors.
toggle_link_pin
Pin or unpin a link (pinned links surface first in the dashboard). Toggles the current state.
update_link
Update a link's destination, title, notes, scheduling, click limit, folder or protections. Use the remove_* flags to clear a field.
BEFORE YOU INSTALL
What to know first
Tools you get
24 tools when we connected. get_link_routing_rules, set_link_routing_rules and export_links_csv are undocumented. About half the tools write, including delete_link and move_links_to_folder.
Requires
- npx on PATH
- OPN_API_KEY in your environment
Where it runs
All 3 documented setups run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 24 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y opn-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"opn": {
"command": "npx",
"args": [
"-y",
"opn-mcp"
],
"env": {
"OPN_API_KEY": "<YOUR_OPN_API_KEY>"
}
}
}
}<YOUR_OPN_API_KEY> is your API key: on opn.onl, open Settings → API Keys and create one (it starts with opn_ and is shown once).
Claude Desktop — self-hosted
CLAUDE DESKTOP — SELF-HOSTED · JSON
{
"mcpServers": {
"opn": {
"command": "npx",
"args": [
"-y",
"opn-mcp"
],
"env": {
"OPN_API_KEY": "<YOUR_OPN_API_KEY>",
"OPN_BASE_URL": "<YOUR_OPN_BASE_URL>"
}
}
}
}For your own opn.onl instance: OPN_BASE_URL is that instance's API host, and <YOUR_OPN_API_KEY> a key created under its Settings → API Keys. Leave OPN_BASE_URL out to use the hosted service at https://l.opn.onl.
Claude Desktop — from GitHub
CLAUDE DESKTOP — FROM GITHUB · JSON
{
"mcpServers": {
"opn": {
"command": "npx",
"args": [
"-y",
"github:ysalitrynskyi/opn-mcp"
],
"env": {
"OPN_API_KEY": "<YOUR_OPN_API_KEY>"
}
}
}
}This form installs straight from the GitHub repository, which builds on install.
